您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

用 xcodebuild 與 xcrun 自動化打包 iOS App

編輯:iOS 開發綜合

最近在研究 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"

二、以既有 .app 為模板的自動打包流程

步驟 1:先手動編譯出一個 App

假設產物為 MyApp.app,後續所有自動化都以它為模板。

步驟 2:把憑證匯入 Keychain

# 建立鑰匙鏈
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

步驟 3:複製模板並替換資源

把 MyApp.app 複製一份出來,替換其中的圖片、plist 等資源。

步驟 4~6:置換描述檔、清掉舊簽名、改 Bundle Identifier

  • 把對應的 *.mobileprovision 複製進 MyApp.app 目錄。
  • 刪除 MyApp.app 下的 _CodeSignature 目錄,移除舊的簽名資訊。
  • 修改 Info.plist 的 Bundle identifier,使其與 mobileprovision 一致。

步驟 7:修改 entitlements 檔

把 MyApp.xcent 中的 application-identifier 改為對應的憑證名稱。特別注意:如果缺少 aps-environment 這個 key,打出來的 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>

步驟 8:重新簽名

/usr/bin/codesign --force --sign 9c8b212f6a2c2382847b104e387a01b246d4ce42 \
    --resource-rules=MyApp.app/ResourceRules.plist \
    --entitlements MyApp.xcent MyApp.app

步驟 9:產生 ipa

/usr/bin/xcrun -sdk iphoneos PackageApplication -v MyApp.app -o MyApp.ipa \
    --sign 9c8b212f6a2c2382847b104e387a01b246d4ce42 \
    --embed MyApp.app/embed.mobileprovision

步驟 10:刪除鑰匙鏈

security delete-keychain myapp.keychain

三、含 xcodebuild 的完整打包順序

  1. 匯入鑰匙鏈
  2. 對工程執行 clean
  3. 修改 Info.plist 資訊
  4. 修改 project 設定
  5. 執行 xcodebuild
  6. 替換各項資源檔
  7. 修改 xcent(entitlements)
  8. 重新簽名 codesign
  9. 用 xcrun 打 ipa
  10. 刪除鑰匙鏈

現代化提醒

這套流程反映的是幾年前的工具鏈。目前有幾個部分已經改變或更好用:

  • PackageApplication 已被移除,改用 xcodebuild -exportArchive 搭配 Export Options plist,或直接串 xcrun altool / notarytool 上傳。
  • ResourceRules.plist 已不再需要,簽名指令可簡化。
  • 手工改 Bundle ID 與 entitlements 容易出錯,建議改用 xcodebuild 的多 configuration 或 xcconfig 來注入變數。
  • 如果目標是「大量產出自動化包」,成熟方案是 fastlane(gym / match / pilot),它把上述所有步驟都封裝好了,也處理了憑證管理與 CI 整合。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved