跳到正文

先确认设备兼容性

最近核对:

iPhone 系统macOS / Windows 工具iPhone 端配对方式
iOS 18.0–26.x上游声明支持导入配对文件
iOS 27.0–27.0.1上游声明支持导入文件或本机配对
iOS 27.2 beta 1–2上游声明支持导入文件或本机配对
iOS 27.2 beta 3+无法刷写两种配对方式均无法启用刷写

原项目说明:iOS 27.2 beta 3 及之后的版本已修补底层 AirTraffic 能力。配对成功或扫描到卡片,不代表可以写入卡面。

以上为上游兼容性声明,并非本站真机测试结论。未列出的系统版本尚未确认,操作前请查看原项目说明。

上游兼容性说明: macOSWindowsiPhone

下载卡面

在卡面目录挑选图片,点击“下载”,保存为适合导入的 PNG。

浏览卡面

01 · macOS · v1.2.6

安装 AirCard

在 Mac 上安装官方 AirCard 应用,然后连接自己的 iPhone。

  1. 下载应用

    前往开发者的 GitHub Releases,下载 AirCard.dmg。

    打开官方发布页
  2. 拖入应用程序

    打开 AirCard.dmg,将 AirCard.app 拖入 Mac 的“应用程序”文件夹。

  3. 启动应用

    在“应用程序”中打开 AirCard。官方 DMG 同时支持 Apple 芯片和 Intel Mac。

首次打开时遇到安全提示?

在“应用程序”中右键或按住 Control 点击 AirCard.app,选择“打开”,然后再次确认。请先确认安装包来自开发者的官方发布页。

官方 README 也提供终端方式(仅在确认来源可信时使用):

sudo xattr -cr /Applications/AirCard.app
提示需要开发工具或接受 Xcode 许可?

仅在错误明确要求 Developer Tools 时,用下面第一条命令安装 Command Line Tools;已安装 Xcode 且提示接受许可时使用第二条。这与 Gatekeeper 安全拦截是不同问题,不要针对无关错误运行。

xcode-select --install
sudo xcodebuild -license accept

02 · macOS / Apple Wallet

自定义钱包卡片

准备好从本站下载的卡面图片,按照 AirCard 的 Apple Wallet 流程操作。

  1. 连接并信任设备

    用 USB 线将已解锁的 iPhone 连接到 Mac,并在手机上确认信任这台电脑。

  2. 开始扫描

    在 AirCard 的 Apple Wallet 标签页点击 Scan Cards。

  3. 在 iPhone 上触发检测

    双击侧边按钮打开 Apple Pay,使用 Face ID 验证,再点按要更换卡面的卡片;如未识别,可再点按一次。

  4. 选择卡面图片

    点击 AirCard 中对应的卡片预览,或把下载的图片直接拖到卡片上。

  5. 应用卡面

    确认预览后点击 Flash Skins。

  6. 刷新钱包显示

    在 iPhone 的应用切换器中强制关闭“钱包”后重新打开;若仍未更新,请重启 iPhone。

保存的卡片、手动标识与多卡操作

v1.2.6 会恢复当前连接 iPhone 的已保存卡片。列表中有卡片,不代表本轮扫描重新识别到了它;应用前请核对目标设备和卡片。

先用 Deselect All 取消全选,再勾选目标卡片;Set Skin for All… 可统一配图。Flash Skins 可能跳过未改变的卡面;没有改动时,Re-flash All 会重新写入所选卡面。

已有本人设备上确认过的卡片标识时,可通过 Save IDs / Save IDs for Matching 手动添加;发布说明将其称为 Add Card。不要复制他人的标识。

Remove skin 和 Clear All 只清除本地待选图片或记录,不会恢复 iPhone 上的原卡面。

扫描不到卡片?

请使用 v1.2.6。v1.2.5 发布说明已标注扫描、手动添加和缓存问题;遇到这些现象时先升级再排查。

打开 AirCard 的 Log,确认已连接到设备的统一日志流;然后重新双击侧边按钮、完成验证并点按或切换卡片。

如果日志读取中断,重新连接并解锁 iPhone,再开始扫描。某些 iOS 版本可能不会在日志中提供卡片标识;被系统替换为 <private> 的内容也无法由扫描器恢复。

步骤依据上游 README、发布说明与对应版本源码整理,操作细节可能随版本变化。 查看官方 README

03 · Windows · v1.2.4

在 Windows 上使用

使用 AirCard-Windows 在电脑上扫描卡片并应用卡面。

需要 Windows 10/11 64 位,以及 Apple Mobile Device Support 或 64 位 iTunes。首次连接需用 USB 线完成信任与配对。

程序支持英文和简体中文切换;下文保留英文按钮名,便于对应界面。

安装与连接

  1. 准备设备支持

    确认已安装 Apple 设备驱动,并准备 Lightning 或 USB-C 线。

  2. 下载程序

    从 AirCard-Windows 的 GitHub Releases 下载 aircard.exe。

    下载 Windows 版
  3. 连接并运行

    用 USB 连接已解锁的 iPhone,在手机上点击“信任此电脑”,然后运行 aircard.exe。

更换钱包卡面

  1. 扫描卡片

    在程序的 Wallet 标签页点击 Scan。

  2. 在手机上选择卡片

    打开 Apple 钱包,或双击侧边按钮,然后点按要更换卡面的卡片。程序识别后点击 Stop。

  3. 选取图片

    点击 Choose Image… 选取 PNG、JPG 或 WebP。可在预览中拖动裁切位置,程序会缩放到 1536 × 969。

  4. 应用并刷新

    点击 Apply Card Skin,再从 iPhone 应用切换器中强制关闭“钱包”并重新打开。

恢复原卡面

Restore Original 依赖这台电脑上、对应 iPhone 和卡片的有效备份。程序首次应用时会尝试保存原图,但原素材不可读取时可能继续刷写而没有备份;需要恢复能力时,请先确认备份存在。

保留本地备份文件夹。选择对应设备和卡片、停止扫描,再点击 Restore Original;成功后从应用切换器关闭“钱包”并重新打开。

%LOCALAPPDATA%/AirCard/wallet-backups
想改用 Wi‑Fi?

先用 USB 配对,在 Apple Devices 或 iTunes 中开启 Wi-Fi 显示或同步并应用设置,电脑和手机保持同一局域网。点击 Refresh 确认出现 WiFi;拔线后再次 Refresh,再选择 WiFi only。Auto (USB preferred) 会优先使用可用的 USB。

找不到 iPhone 或同步卡住?

先检查 Apple Mobile Device Support / 64 位 iTunes、数据线和“信任此电脑”,重新连接已解锁的 iPhone 后点击 Refresh。上游排障页另有可选的第三方驱动修复说明。

Windows 版官方 README

Windows 版官方 README

04 · iPhone · v1.3.2

直接在 iPhone 上使用

AirCard-iOS 可在手机上扫描卡片并应用图片;安装和配对方式与电脑版本不同。

需要兼容性表列出的系统、本地回环 VPN(LocalDevVPN 或已配置的 WireGuard)及配对记录。iOS 18–26 必须导入配对文件;受支持的 iOS 27 也可在本机配对。

  1. 安装 IPA

    从开发者 Releases 获取 AirCard-iOS.ipa,选择适合当前系统和签名环境的侧载方式,如 SideStore 或 AltStore。

    下载 iOS 版
  2. 连接本地 VPN

    打开 LocalDevVPN 并点击 Connect,或启用已配置的 WireGuard 回环隧道。返回 AirCard-iOS,确认 VPN 状态。

03 · 选择配对方式

导入配对文件 · iOS 18–26 及受支持的 iOS 27

在 Pairing 中点击 Import Pairing File…,选择本人这部设备的配对记录。支持以下文件格式:

.mobiledevicepairing · .plist · .mobilepair

已使用 SideStore 时,在“文件”中按下面路径找到配对文件。看到 Pairing file loaded 后再扫描。

On My iPhone / SideStore / ALTPairingFile.mobiledevicepairing
在本机配对 · 仅限受支持的 iOS 27

在 Pairing 点击 Pair This iPhone,记下六位 PIN。进入“设置 → 隐私与安全性 → 开发者模式 → Pair with AirCard-iOS”,输入 PIN。

回到 AirCard-iOS 等待配对完成。iOS 18–26 没有这个入口,请改用配对文件导入。

扫描并应用卡面

  1. 扫描目标卡片

    在 Wallet Cards 点击 Scan Cards。双击侧边按钮、完成验证并点按目标卡片;确认应用识别后停止扫描。

  2. 选择并调整构图

    点击卡片,从“照片”或“文件”选取已下载的图片,缩放、拖动并确认裁切。Rename 可帮助区分卡片;名称或卡组织标签不等于已核实银行及卡片身份。

  3. 勾选并刷写

    确认仅勾选目标卡片,且每张已分配图片,再点击 Flash。查看最终操作结果,不只看进度条。

  4. 刷新并核验钱包

    从应用切换器强制关闭“钱包”再重新打开,检查目标卡片;仍显示旧图时,可尝试重启 iPhone。

其他配对文件与连接排障

SideStore 位于 LiveContainer 中时,可在 LiveContainer / SideStore / Documents 下查找,具体位置随配置而异。也可导入 iLoader、AltStore、Jitterbug 或 Mac/PC 导出的本人设备记录;路径详见上游指南。

在“设置 → AirCard-iOS”允许本地网络访问,并检查回环 VPN。配对记录失效时,用 Delete Pairing / Unpair 删除后重新导入正确记录,无需先卸载应用。

配对文件包含设备凭据,请私密保存,不要上传到 AirCards,也不要公开完整设备日志。

iOS 版官方 README

iOS 版官方 README