iOS自動打包并發布腳本

本文最終實現的是使用腳本打 Ad-hoc 包，并發布測試，當然稍微修改一下腳本參數就可以打其他類型的 ipa 包了。另外該腳本還實現了將生成的 ipa 包上傳至蒲公英進行測試分發。

1. xcodebuild 簡介
2. 使用xcodebuild和xcrun打包簽名
3. 將打包過程腳本化

xcodebuild 簡介

xcodebuild是蘋果提供的打包項目或者工程的命令，了解該命令最好的方式就是使用man xcodebuild查看其 man page. 盡管是英文，一定要老老實實的讀一遍就好了。

總結一下:

1. 需要在包含 name.xcodeproj 的目錄下執行xcodebuild命令，且如果該目錄下有多個 projects，那么需要使用-project指定需要 build 的項目。
2. 在不指定 build 的 target 的時候，默認情況下會 build project 下的第一個 target
3. 當 build workspace 時，需要同時指定-workspace和-scheme參數，scheme 參數控制了哪些 targets 會被 build 以及以怎樣的方式 build。
4. 有一些諸如-list,-showBuildSettings,-showsdks的參數可以查看項目或者工程的信息，不會對 build action 造成任何影響，放心使用。

那么，xcodebuild究竟如何使用呢？ 繼續看文檔:

挑幾個我常用的形式介紹一下，較長的使用方式以序列號代替:

• xcodebuild -showsdks: 列出 Xcode 所有可用的 SDKs

• xcodebuild -showBuildSettings: 上述序號6的使用方式，查看當前工程 build setting 的配置參數，Xcode 詳細的 build setting 參數參考官方文檔 Xcode Build Setting Reference ， 已有的配置參數可以在終端中以buildsetting=value的形式進行覆蓋重新設置.

• xcodebuild -list: 上述序號7的使用方式，查看 project 中的 targets 和 configurations，或者 workspace 中 schemes, 輸出如下:

Information about project "NavTabBar":
Targets:
  NavTabBar
  NavTabBarTests
  NavTabBarUITests
Build Configurations:
  Debug
  Release
  Ad-hoc
If no build configuration is specified and -scheme is not passed then "Release" is used.
Schemes:
  NavTabBar

• xcodebuild [-project name.xcodeproj] [[-target targetname] ... | -alltargets] build: 上述序號1的使用方式，會 build 指定 project，其中-target和-configuration參數可以使用xcodebuild -list獲得，-sdk參數可由xcodebuild -showsdks獲得，[buildsetting=value ...]用來覆蓋工程中已有的配置。可覆蓋的參數參考官方文檔 Xcode Build Setting Reference ,action...的可用選項如下, 打包的話當然用 build，這也是默認選項。

  • buildBuild the target in the build root (SYMROOT). This is the default action, and is used if no action is given.

  • analyzeBuild and analyze a target or scheme from the build root (SYMROOT). This requires specifying a scheme.

  • archiveArchive a scheme from the build root (SYMROOT). This requires specifying a scheme.

  • testTest a scheme from the build root (SYMROOT). This requires specifying a scheme and optionally a destination.

  • installsrcCopy the source of the project to the source root (SRCROOT).

  • installBuild the target and install it into the target’s installation directory in the distribution root (DSTROOT).

  • cleanRemove build products and intermediate files from the build root (SYMROOT).

• xcodebuild -workspace name.xcworkspace -scheme schemename build: 上述序號3的使用方式，build 指定 workspace，當我們使用 CocoaPods 來管理第三方庫時，會生成 xcworkspace 文件，這樣就會用到這種打包方式.

使用xcodebuild和xcrun打包簽名

開始之前，可以新建一個測試工程 TestImg 來練習打包，在使用終端命令打包之前，請確認該工程也可以直接使用 Xcode 真機調試成功。

然后，打開終端，進入包含 TestImg.xcodeproj 的目錄下，運行以下命令:

xcodebuild -project TestImg.xcodeproj -target TestImg -configuration Release

如果 build 成功，會看到** BUILD SUCCEEDED **字樣，且在終端會打印出這次 build 的簽名信息，如下:

且在該目錄下會多出一個build目錄，該目錄下有Release-iphoneos和TestImg.build文件，根據我們 build-configuration配置的參數不同，Release-iphoneos的文件名會不同。

在Release-iphoneos文件夾下，有我們需要的TestImg.app文件，但是要安裝到真機上，我們需要將該文件導出為ipa文件，這里使用 xcrun 命令。

xcrun -sdk iphoneos -v PackageApplication ./build/Release-iphoneos/TestImg.app -o ~/Desktop/TestImg.ipa

這里又冒出一個PackageApplication, 我剛開始也不知道這是個什么玩意兒，萬能的google告訴我，這是 Xcode 包里自帶的工具，使用xcrun -sdk iphoneos -v PackageApplication -help查看幫助信息.

如果執行成功，則會在你的桌面生成 TestImg.ipa 文件，這樣就可以發布測試了。如果你遇到以下警告信息:

請參考 stackoverflow 這個回答

將打包過程腳本化

工作中，特別是所做項目進入測試階段，肯定會經常打 Ad-hoc 包給測試人員進行測試，但是我們肯定不想每次進行打包的時候都要進行一些工程的設置修改，以及一系列的 next 按鈕點擊操作，現在就讓這些操作都交給腳本化吧。

1. 腳本化中使用如下的命令打包:

xcodebuild -project name.xcodeproj -target targetname -configuration Release -sdk iphoneos build CODE_SIGN_IDENTITY="$(CODE_SIGN_IDENTITY)" PROVISIONING_PROFILE="$(PROVISIONING_PROFILE)"

或者

xcodebuild -workspace name.xcworkspace -scheme schemename -configuration Release -sdk iphoneos build CODE_SIGN_IDENTITY="$(CODE_SIGN_IDENTITY)" PROVISIONING_PROFILE="$(PROVISIONING_PROFILE)"

1. 然后使用 xcrun 生成 ipa 文件:

`xcrun -sdk iphoneos -v PackageApplication ./build/Release-iphoneos/$(target|scheme).app"

1. 清除 build 過程中產生的中間文件
2. 結合蒲公英分發平臺，將 ipa 文件上傳至蒲公英分發平臺，同時在終端會打印上傳結果以及上傳應用后該應用的 URL。蒲公英分發平臺能夠方便地將 ipa 文件盡快分發到測試人員，該平臺有開放 API，可避免人工上傳。

該腳本的使用可使用python autobuild.py -h查看，與xcodebuild的使用相似:

在腳本頂部，有幾個全局變量，根據自己的項目情況修改。

CODE_SIGN_IDENTITY = "iPhone Distribution: companyname (9xxxxxxx9A)"
PROVISIONING_PROFILE = "xxxxx-xxxx-xxx-xxxx-xxxxxxxxx"
CONFIGURATION = "Release"
SDK = "iphoneos"

USER_KEY = "15d6xxxxxxxxxxxxxxxxxx"
API_KEY = "efxxxxxxxxxxxxxxxxxxxx"

其中，CODE_SIGN_IDENTITY為開發者證書標識，可以在 Keychain Access -> Certificates -> 選中證書右鍵彈出菜單 -> Get Info -> Common Name 獲取，類似iPhone Distribution: Company name Co. Ltd (xxxxxxxx9A), 包括括號內的內容。

PROVISIONING_PROFILE: 這個是 mobileprovision 文件的 identifier，獲取方式：

Xcode -> Preferences -> 選中申請開發者證書的 Apple ID -> 選中開發者證書 -> View Details… -> 根據 Provisioning Profiles 的名字選中打包所需的 mobileprovision 文件 -> 右鍵菜單 -> Show in Finder -> 找到該文件后，除了該文件后綴名的字符串就是PROVISIONING_PROFILE字段的內容。

當然也可以使用腳本獲取, 此處參考 命令行獲取mobileprovision文件的UUID :

#!/bin/bash
if [ $# -ne 1 ]
then
  echo "Usage: getmobileuuid the-mobileprovision-file-path"
  exit 1
fi

mobileprovision_uuid=`/usr/libexec/PlistBuddy -c "Print UUID" /dev/stdin <<< $(/usr/bin/security cms -D -i $1)`
echo "UUID is:"
echo ${mobileprovision_uuid}

USER_KEY,API_KEY: 是蒲公英開放 API 的密鑰。

該腳本可在 github 查看，如有任何問題，請留言回復。

如果覺得本文對你有幫助，就請用微信打賞我吧^_^