📱 让 Aemulo 1.2.5 在 iOS 18 上重新连接 Apple Wallet 与原生 NFC 交互
Bringing Aemulo 1.2.5 back to Apple Wallet and native NFC interaction on iOS 18
实机效果 / Tested on a real iOS 18.2 device
Aemulo iOS 18 Wallet Compatibility 是一个为越狱 iOS 18 设备准备的兼容补丁。它在不重画 Wallet 界面、不替换原生 NFC 元素的前提下，让 Aemulo 1.2.5 适配 iOS 18 中已变化的 PassKitUI 私有接口。
目标很直接：
- 💳 让 Aemulo 卡片继续出现在 Apple Wallet。
- 📡 保留 Wallet 原生的“靠近读卡器”界面与状态动画。
- 🔐 由系统管理 NFC 会话、支付状态和对象生命周期。
- 🧩 兼容 arm64/arm64e 与 Rootless 越狱目录。
- 📦 提供可直接安装的 Debian 软件包。
Aemulo 1.2.5 调用的旧 PassKitUI 初始化接口是：
initWithPass:context:paymentSession:paymentService:
在本项目的 iOS 18.2 测试环境中，Apple 将它改为了：
initWithPass:passView:context:paymentSession:paymentService:
补丁在运行时恢复旧选择器，再把调用转发给 iOS 18 真正存在的新初始化接口。返回的仍然是系统原生 PKPassPaymentContainerView，因此界面、动画、NFC 会话和销毁流程都由 Wallet 自己处理。
项目没有自绘“靠近读卡器”图标，也没有从 Wallet 复制私有图片资源。
- Aemulo 1.2.5
- iOS 18.2 Beta（测试基线：
22C5125e） - Rootless 越狱目录：
/var/jb - arm64 与 arm64e
- ElleKit / MobileSubstrate 兼容的 Tweak 注入环境
其他 iOS 18 版本可能包含更多 PassKitUI 变化，建议在对应设备上独立测试。
从 Release/ 下载 DEB，复制到手机后执行：
sudo dpkg -i "/var/mobile/Media/Downloads/com.amywhile.aemulo_1.2.5+ios18compat1.0_iphoneos-arm64.deb"
sudo sbreload安装包包含本次兼容测试使用的 Aemulo 1.2.5 载荷，安装过程不会主动删除现有 Aemulo 数据。
macOS 需要 Xcode Command Line Tools、iPhoneOS SDK、ldid、xz、tar 和 ar。向脚本传入原始 Aemulo 1.2.5 DEB：
./Scripts/build.sh /absolute/path/to/com.amywhile.aemulo_1.2.5_iphoneos-arm64.deb生成的包会出现在 Release/ 目录。
Assets/ Aemulo App Icon
Package/ ElleKit / MobileSubstrate 注入配置
Release/ 可安装 DEB
Scripts/ 重建脚本
Source/ iOS 18 兼容补丁源码
Aemulo iOS 18 Wallet Compatibility is a compatibility patch for jailbroken iOS 18 devices. It adapts Aemulo 1.2.5 to changed private PassKitUI interfaces without redrawing Wallet UI or replacing its native NFC elements.
The goals are simple:
- 💳 Keep Aemulo cards available inside Apple Wallet.
- 📡 Preserve Wallet's native Hold Near Reader interface and state animations.
- 🔐 Leave NFC sessions, payment state, and object lifecycle management to the system.
- 🧩 Support arm64/arm64e and rootless jailbreak layouts.
- 📦 Provide a directly installable Debian package.
Aemulo 1.2.5 calls the former PassKitUI initializer:
initWithPass:context:paymentSession:paymentService:
On the iOS 18.2 test baseline, Apple changed it to:
initWithPass:passView:context:paymentSession:paymentService:
The compatibility dylib restores the removed selector at runtime and forwards the invocation to the initializer that actually exists on iOS 18. The returned object remains the real system PKPassPaymentContainerView, so Wallet continues to own the UI, animations, NFC session, and teardown path.
This project does not draw a replacement Hold Near Reader icon and does not copy private artwork from Wallet.
- Aemulo 1.2.5
- iOS 18.2 Beta test baseline (
22C5125e) - Rootless jailbreak layout (
/var/jb) - arm64 and arm64e
- ElleKit/MobileSubstrate-compatible tweak injection
Other iOS 18 builds may contain additional PassKitUI changes and should be tested independently.
Download the DEB from Release/, copy it to the device, and run:
sudo dpkg -i "/var/mobile/Media/Downloads/com.amywhile.aemulo_1.2.5+ios18compat1.0_iphoneos-arm64.deb"
sudo sbreloadThe package includes the Aemulo 1.2.5 payload used during compatibility testing. Existing Aemulo data is not intentionally removed during installation.
macOS requires Xcode Command Line Tools, an iPhoneOS SDK, ldid, xz, tar, and ar. Pass an original Aemulo 1.2.5 DEB to the build script:
./Scripts/build.sh /absolute/path/to/com.amywhile.aemulo_1.2.5_iphoneos-arm64.debThe rebuilt package is written to Release/.
Assets/ Aemulo App Icon
Package/ ElleKit / MobileSubstrate injection configuration
Release/ Installable DEB
Scripts/ Rebuild script
Source/ iOS 18 compatibility source
This is an independent compatibility project and is not affiliated with the Aemulo project. Aemulo and its original binaries, name, icon, and artwork remain the property of their respective owner.
本项目是独立兼容工程，与 Aemulo 官方没有从属关系。Aemulo 原始二进制、名称、图标与美术资源的权利归原权利人所有。
🔗 Official Aemulo project / Aemulo 官方项目: https://github.com/Aemulo