您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

用 xcodebuild 與 xcrun 自動化 iOS 專案打包與發佈

編輯: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"

自動化簽章的完整流程

步驟一:先用 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

含 xcodebuild 編譯的完整流程

  1. 匯入鑰匙圈
  2. 對專案執行 clean
  3. 修改 Info.plist
  4. 修改專案設定
  5. 執行 xcodebuild
  6. 替換各項資源檔
  7. 修改 xcent
  8. 以 codesign 重新簽章
  9. 用 xcrun 打包成 ipa
  10. 刪除鑰匙圈

幾點經驗

整個流程中最容易出錯的是簽章環節,而簽章失敗的原因通常不是指令寫錯,而是描述檔(mobileprovision)的 Bundle Identifier、App ID 與 xcent 中的 application-identifier 三者不一致。建議在腳本中把這三個值抽成同一個變數,從單一來源產生,能省下大量排查時間。

另外,若你的專案同時有多個 target 或需要動態萬用,改用 -scheme 搭配 -configuration 會比 -target 更靈活;而在較新的 Xcode 中,PackageApplication 已被 xcodebuild -exportArchive 取代,新專案建議直接採用 exportArchive 搭配 ExportOptions.plist 的方式。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved