iOS自動打包并發布腳本

本文轉自CaryaLiu's Blog。

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

xcodebuild 簡介

使用xcodebuild和xcrun打包簽名

將打包過程腳本化

xcodebuild 簡介

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

DESCRIPTION

xcodebuild builds one or more targets contained in an Xcode project, or builds a scheme contained in an Xcode workspace or Xcode project.

Usage

To build an Xcode project, run xcodebuild from the directory containing your project (i.e. the directory containing the name.xcodeproj package). If you have multiple projects in the this directory you will need to use -project to indicate which project should be built. By default, xcodebuild builds the first target listed in the project, with the default build configuration. The order of the targets is a property of the project and is the same for all users of the project.

To build an Xcode workspace, you must pass both the -workspace and -scheme options to define the build. The parameters of the scheme will control which targets are built and how they are built, although you may pass other options to xcodebuild to override some parameters of the scheme.

There are also several options that display info about the installed version of Xcode or about projects or workspaces in the local directory, but which do not initiate an action. These include -list, -showBuildSettings, -showsdks, -usage, and -version.

總結一下:

需要在包含 name.xcodeproj 的目錄下執行 xcodebuild 命令，且如果該目錄下有多個 projects，那么需要使用 -project 指定需要 build 的項目。

在不指定 build 的 target 的時候，默認情況下會 build project 下的第一個 target

當 build workspace 時，需要同時指定 -workspace 和 -scheme 參數，scheme 參數控制了哪些 targets 會被 build 以及以怎樣的方式 build。

有一些諸如 -list, -showBuildSettings, -showsdks 的參數可以查看項目或者工程的信息，不會對 build action 造成任何影響，放心使用。

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

NAME

xcodebuild – build Xcode projects and workspaces

SYNOPSIS

xcodebuild [-project name.xcodeproj] [[-target targetname] … | -alltargets] [-configuration configurationname] [-sdk [sdkfullpath | sdkname]] [action …] [buildsetting=value …] [-userdefault=value …]

xcodebuild [-project name.xcodeproj] -scheme schemename [[-destination destinationspecifier] …] [-destination-timeout value] [-configuration configurationname] [-sdk [sdkfullpath | sdkname]] [action …] [buildsetting=value …] [-userdefault=value …]

xcodebuild -workspace name.xcworkspace -scheme schemename [[-destination destinationspecifier] …] [-destination-timeout value] [-configuration configurationname] [-sdk [sdkfullpath | sdkname]] [action …] [buildsetting=value …] [-userdefault=value …]

xcodebuild -version [-sdk [sdkfullpath | sdkname]] [infoitem]

xcodebuild -showsdks

xcodebuild -showBuildSettings [-project name.xcodeproj | [-workspace name.xcworkspace -scheme schemename]]

xcodebuild -list [-project name.xcodeproj | -workspace name.xcworkspace]

xcodebuild -exportArchive -archivePath xcarchivepath -exportPath destinationpath -exportOptionsPlist path

xcodebuild -exportLocalizations -project name.xcodeproj -localizationPath path [[-exportLanguage language] …]

xcodebuild -importLocalizations -project name.xcodeproj -localizationPath path

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

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, 輸出如下:

1

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，這也是默認選項。

build

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

analyze

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

archive

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

test

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

installsrc

Copy the source of the project to the source root (SRCROOT).

install

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

clean

Remove 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 的簽名信息，如下:

Signing Identity: “iPhone Developer: xxx(59xxxxxx)”

Provisioning Profile: “iOS Team Provisioning Profile: *"

且在該目錄下會多出一個 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 查看幫助信息.

Usage:

PackageApplication [-s signature] application [-o output_directory] [-verbose] [-plugin plugin] || -man || -help

Options:

[-s signature]: certificate name to resign application before packaging

[-o output_directory]: specify output filename

[-plugin plugin]: specify an optional plugin

-help: brief help message

-man: full documentation

-v[erbose]: provide details during operation

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

Warning: –resource-rules has been deprecated in Mac OS X >= 10.10! ResourceRules.plist: cannot read resources

請參考 stackoverflow 這個回答

將打包過程腳本化

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

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

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)"

然后使用 xcrun 生成 ipa 文件:

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

清除 build 過程中產生的中間文件

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

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

Usage: autobuild.py [options]

Options:

-h, --help: show this help message and exit

-w name.xcworkspace, --workspace=name.xcworkspace: Build the workspace name.xcworkspace.

-p name.xcodeproj, --project=name.xcodeproj: Build the project name.xcodeproj.

-s schemename, --scheme=schemename: Build the scheme specified by schemename. Required if building a workspace.

-t targetname, --target=targetname: Build the target specified by targetname. Required if building a project.

-o output_filename, --output=output_filename: specify output filename

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

1

2

3

4

5

6

7

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:

1

2

3

4

5

6

7

8

9

10

#!/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 的密鑰。

將autobuild.py腳本放在你項目的根目錄下，進入根目錄，如下使用：

1

./autobuild.py -w yourname.xcworkspace -s schemename -o ~/Desktop/yourname.ipa

或者

1

./autobuild.py -p yourname.xcodeproj -t targetname -o ~/Desktop/yourname.ipa

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

github地址：https://github.com/carya/Util

最后編輯于 ：
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明：文章內容（如有圖片或視頻亦包括在內）由作者上傳并發布，文章內容僅代表作者本人觀點，簡書系信息發布平臺，僅提供信息存儲服務。
  • 人面猴
    序言：七十年代末，一起剝皮案震驚了整個濱河市，隨后出現的幾起案子，更是在濱河造成了極大的恐慌，老刑警劉巖，帶你破解...
    沈念sama閱讀 228,786評論 6贊 534
  • 死咒
    序言：濱河連續發生了三起死亡事件，死亡現場離奇詭異，居然都是意外死亡，警方通過查閱死者的電腦和手機，發現死者居然都...
    沈念sama閱讀 98,656評論 3贊 419
  • 救了他兩次的神仙讓他今天三更去死
    文/潘曉璐 我一進店門，熙熙樓的掌柜王于貴愁眉苦臉地迎上來，“玉大人，你說我怎么就攤上這事?！?“怎么了？”我有些...
    開封第一講書人閱讀 176,697評論 0贊 379
  • 道士緝兇錄：失蹤的賣姜人
    文/不壞的土叔 我叫張陵，是天一觀的道長。 經常有香客問我，道長，這世上最難降的妖魔是什么？ 我笑而不...
    開封第一講書人閱讀 63,098評論 1贊 314
  • ?港島之戀（遺憾婚禮）
    正文 為了忘掉前任，我火速辦了婚禮，結果婚禮上，老公的妹妹穿的比我還像新娘。我一直安慰自己，他們只是感情好，可當我...
    茶點故事閱讀 71,855評論 6贊 410
  • 惡毒庶女頂嫁案：這布局不是一般人想出來的
    文/花漫 我一把揭開白布。 她就那樣靜靜地躺著，像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上，一...
    開封第一講書人閱讀 55,254評論 1贊 324
  • 城市分裂傳說
    那天，我揣著相機與錄音，去河邊找鬼。 笑死，一個胖子當著我的面吹牛，可吹牛的內容都是我干的。 我是一名探鬼主播，決...
    沈念sama閱讀 43,322評論 3贊 442
  • 雙鴛鴦連環套：你想象不到人心有多黑
    文/蒼蘭香墨 我猛地睜開眼，長吁一口氣：“原來是場噩夢啊……” “哼！你這毒婦竟也來了？” 一聲冷哼從身側響起，我...
    開封第一講書人閱讀 42,473評論 0贊 289
  • 萬榮殺人案實錄
    序言：老撾萬榮一對情侶失蹤，失蹤者是張志新（化名）和其女友劉穎，沒想到半個月后，有當地人在樹林里發現了一具尸體，經...
    沈念sama閱讀 49,014評論 1贊 335
  • ?護林員之死
    正文 獨居荒郊野嶺守林人離奇死亡，尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,833評論 3贊 355
  • ?白月光啟示錄
    正文 我和宋清朗相戀三年，在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,016評論 1贊 371
  • 活死人
    序言：一個原本活蹦亂跳的男人離奇死亡，死狀恐怖，靈堂內的尸體忽然破棺而出，到底是詐尸還是另有隱情，我是刑警寧澤，帶...
    沈念sama閱讀 38,568評論 5贊 362
  • ?日本核電站爆炸內幕
    正文 年R本政府宣布，位于F島的核電站，受9級特大地震影響，放射性物質發生泄漏。R本人自食惡果不足惜，卻給世界環境...
    茶點故事閱讀 44,273評論 3贊 347
  • 男人毒藥：我在死后第九天來索命
    文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧，春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,680評論 0贊 26
  • 一樁弒父案，背后竟有這般陰謀
    文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至，卻和暖如春，著一層夾襖步出監牢的瞬間，已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,946評論 1贊 288
  • 情欲美人皮
    我被黑心中介騙來泰國打工， 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留，地道東北人。 一個月前我還...
    沈念sama閱讀 51,730評論 3贊 393
  • 代替公主和親
    正文 我出身青樓，卻偏偏與公主長得像，于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子，可洞房花燭夜當晚...
    茶點故事閱讀 48,006評論 2贊 374

推薦閱讀更多精彩內容

  • 本文最終實現的是使用腳本打 Ad-hoc 包，并發布測試，當然稍微修改一下腳本參數就可以打其他類型的 ipa 包了...
    Crazy2015閱讀 327評論 0贊 0
  • 直接上代碼： 文件：autobuild.py #!/usr/bin/env python# -*- coding:...
    閑云清煙閱讀 738評論 0贊 6
  • 1、xcodebuild 簡介 在終端中輸入man xcodebuild 查看其 man page介紹 NAME ...
    暗物質閱讀 10,608評論 7贊 20
  • 因為需要，最近在研究用腳本編譯.ipa文件，在網上查找了不少資料，發現都是一些比較舊的操作了，在應用的時候難免會有...
    wendy_le閱讀 1,720評論 1贊 2
  • （一）、中西文化的差異 好，說完了中西醫的來源及他的特點，我們從中西文化的差異來看下有什么不同之處。 ①、我們先從...
    古典悠夢閱讀 1,109評論 0贊 2