最近在研究 App 的自動化生成流程:用 Python 腳本替換圖示、名稱等資源,產出全新的應用程式。要做到這件事,首先得把打包環節完全命令列化。
打包主要依賴兩個工具:xcodebuild 負責編譯,xcrun 負責把 .app 打包成 .ipa。
# 1. 清理專案 /usr/bin/xcodebuild -target targetName clean # 2. 編譯專案 /usr/bin/xcodebuild -target targetName # 3. 打包成 ipa /usr/bin/xcrun -sdk iphoneos PackageApplication -v path/To/xxx.app -o xxx.ipa
若需要簽章,兩個指令都要補上參數:
xcodebuild -target targetName CODE_SIGN_IDENTITY="iPhone Distribution:XXXXXX"
xcrun -sdk iphoneos PackageApplication -v 來源app路徑 -o 輸出的ipa路徑 \
--sign "iPhone Distribution:XXXXXX"
步驟一:先用 Xcode 手動編譯出一個 App,作為後續的模板,以下假設為 MyApp.app。
步驟二:把憑證匯入 Mac 的鑰匙圈。
# 建立鑰匙圈 security create-keychain -p myapp myapp.keychain # 解鎖,否則會跳出等待輸入密碼的提示框 security unlock-keychain -p myapp myapp.keychain # 匯入憑證 security import /opt/myapp.p12 -k myapp.keychain -P mypassword -T /usr/bin/codesign
步驟三:以 MyApp.app 為模板複製一份,然後替換各項資源,例如圖片檔。
步驟四:把對應的 *.mobileprovision 檔複製到 MyApp.app 目錄。
步驟五:刪除 MyApp.app 底下的簽章資訊 _CodeSignature。
步驟六:修改 Info.plist 的 Bundle Identifier,使其與 mobileprovision 一致。
步驟七:修改 MyApp.xcent 中 application-identifier 的值為對應的憑證名稱。可以準備一個 xcent 作為模板,特別注意:若缺少 aps-environment 這個鍵,打出的 ipa 將不含 APNs 推播模組。格式如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"https://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>application-identifier</key>
<string>Z4LR7CBRUD.com.yesun.vic</string>
<key>aps-environment</key>
<string>production</string>
<key>get-task-allow</key>
<false/>
</dict>
</plist>
步驟八:重新簽章。
/usr/bin/codesign --force --sign 9c8b212f6a2c2382847b104e387a01b246d4ce42 \ --resource-rules=MyApp.app/ResourceRules.plist \ --entitlements MyApp.xcent MyApp.app
步驟九:產出 ipa。
/usr/bin/xcrun -sdk iphoneos PackageApplication -v MyApp.app -o MyApp.ipa \ --sign 9c8b212f6a2c2382847b104e387a01b246d4ce42 \ --embed MyApp.app/embed.mobileprovision
步驟十:刪除暫時建立的鑰匙圈,避免憑證殘留在機器上。
security delete-keychain myapp.keychain
整個流程中最容易出錯的是簽章環節,而簽章失敗的原因通常不是指令寫錯,而是描述檔(mobileprovision)的 Bundle Identifier、App ID 與 xcent 中的 application-identifier 三者不一致。建議在腳本中把這三個值抽成同一個變數,從單一來源產生,能省下大量排查時間。
另外,若你的專案同時有多個 target 或需要動態萬用,改用 -scheme 搭配 -configuration 會比 -target 更靈活;而在較新的 Xcode 中,PackageApplication 已被 xcodebuild -exportArchive 取代,新專案建議直接採用 exportArchive 搭配 ExportOptions.plist 的方式。