AirCard-macOS README

The project's README from github.com/alejadxr/AirCard-macOS. As one markdown file: README.md.

AirCard macOS

Port nativo para macOS del flujo de personalización de tarjetas de Apple Wallet de AirCard-Windows. La interfaz y la orquestación están escritas en Swift 6.2 y usan Swift Concurrency para la detección del iPhone, preparación de imágenes y escritura atómica.

Estado: probado con un iPhone18,3 en iOS 27.2 (build 24B5084k). El proyecto usa APIs privadas de Apple y es experimental; no es una herramienta oficial.

Ejecutar

Desde esta carpeta:

chmod +x Scripts/build_helpers.sh
Scripts/build_helpers.sh
swift run

Para generar una aplicación universal que puedas abrir con doble clic:

chmod +x Scripts/build_app.sh
Scripts/build_app.sh
open build/AirCardMac.app

Para generar también un instalador .dmg:

chmod +x Scripts/build_dmg.sh
Scripts/build_dmg.sh
open build/AirCardMac.dmg

El DMG contiene la aplicación universal AirCardMac.app para Apple Silicon e Intel.

Conecta un iPhone emparejado por USB, desbloquéalo y pulsa “Confiar”. Abre Apple Books una vez antes del primer flash. Pulsa “Escanear desde Wallet”, abre Apple Wallet y toca la tarjeta; el hash se rellenará solo. También puedes pegar el hash manualmente. Después elige una imagen, añade uno o varios overlays PNG transparentes si quieres, y pulsa “Aplicar skin”. Los overlays se combinan en el orden mostrado y se incluyen en todas las variantes que recibe Wallet. Al terminar, cierra y abre Wallet en el iPhone.

El flujo conserva/restaura los archivos temporales de Books y limpia los artefactos generados. Solo se escriben los assets de la tarjeta seleccionada y se intentan invalidar sus cachés.

Alcance actual

Sobre el color de los números

El repositorio original también soporta paquetes .passthm para el teclado de código de iOS. Los números no son texto recoloreable: son imágenes rasterizadas que se copian a cachés de TelephonyUI con nombres como:

en-2-A B C--white.png
en-2-A B C--white-bold.png

Por tanto, para cambiar el color hay que recolorear o regenerar los PNG de las teclas y después escribir las variantes correspondientes en /var/mobile/Library/Caches/TelephonyUI-10 (o -9/-8, según iOS). La variante -bold es la que usa iOS cuando está activo “Texto en negrita”.

En la app: elige un .passthm, selecciona el color, verifica la previsualización y pulsa “Aplicar color al teclado”. El port conserva los nombres y variantes del paquete, convierte JPG/JPEG a PNG y hace la escritura por lotes con fallback individual. Después bloquea el iPhone para que TelephonyUI recargue la caché.

Además de conservar el nombre original, la variante elegida en la interfaz se escribe como --white o --black; si la imagen es -bold, se usa --white-bold o --black-bold respectivamente.

Para tarjetas Apple Pay, iOS dibuja los números y normalmente decide su color internamente; el port original tampoco modifica pass.json, solo reemplaza el artwork y limpia las cachés de Wallet. La build actual escribe además los assets canónicos diffuse, background y strip, siguiendo el port iOS relacionado, porque algunas variantes de Wallet pueden leer esos nombres en lugar de cardBackgroundCombined.

AirCard-macOS (alejadxr/AirCard-macOS)

Searching Database…

这是做什么用的?AirCard for macOS 是 AirCard-Windows 流程在 Mac 上的原生移植版,用于自定义 Apple Wallet 卡片:它可以把自定义图案刷到 iPhone 钱包应用里的卡片上,还能给 iOS 的密码键盘主题换色。
这是 iPhone 应用还是 Mac 应用?它是一个 macOS 应用(用 Swift 6.2 和 Swift Concurrency 编写),通过 USB 连接并控制已配对的 iPhone。它依赖 Apple 的私有 API,属于实验性项目,并非 Apple 官方工具。
我怎么把它跑起来?在项目文件夹中用 Swift Package Manager 构建通用应用(或生成 .dmg),然后打开 AirCardMac.app。接着用 USB 连接一台已配对的 iPhone 并解锁,点一下“信任”,并在首次刷入之前先打开一次 Apple Books。
有什么我需要知道的限制吗?有——对于 Apple Pay 卡片,只能替换图案:数字的颜色由 iOS 和发卡机构决定,而且 Wallet 会忽略这些资源的 --white/--black 后缀。本移植版从不修改 pass.json。
我需要什么样的 Mac 和 iPhone?.dmg 里包含的通用版 AirCardMac.app 在 Apple Silicon 和 Intel 芯片的 Mac 上都能运行。iPhone 方面,已在运行 iOS 27.2 的 iPhone18,3 上测试过。
刷入会不会动我 iPhone 上的其他东西?不会——只写入所选卡片的资源并使其缓存失效。Apple Books 的临时文件会被保留并还原,生成的临时产物会清理掉,pass.json 也完全不会被改动。
我怎么给一张卡片换上新皮肤?点“Scan from Wallet”,在 Apple Wallet 里选中那张卡片,哈希值就会自动填入(也可以手动粘贴),然后选一张图片,再点“Apply skin”。之后在 iPhone 上把 Wallet 关掉再重新打开,就能看到变化了。
我可以在卡片图案上叠加自己的图片吗?可以。你可以添加一张或多张透明 PNG 叠加层,调整它们的顺序,并在刷入前预览效果;叠加层会按显示的顺序合并,并包含在 Wallet 收到的每一个变体里。
键盘换色功能是干什么的?它为 TelephonyUI-8/9/10 应用 .passthm 密码键盘主题。由于数字是位图图片而不是文字,它会重新给按键的 PNG 上色,并把 --white/--black 变体(开启粗体文字时还有 -bold)写入 TelephonyUI 缓存,然后锁定 iPhone 让缓存重新加载。
它会生成哪些图片尺寸和格式?它会按 1536×969 和 1024×646 准备 PNG 格式的卡片图案外加一个 PDF 变体,并保留图像边缘,同时以 cardBackgroundCombined、diffuse、background 和 strip 这些标准名称,按 3x、2x 和 PDF 写入 Apple Pay 图案。
Creator
alejadxr
Size
4.5 MB
Stars
176
Age
28d
Commits · 90 Days