寫在前面
之前寫了一個(gè)很簡(jiǎn)單的ipa打包腳本，主要是用Xcode命令中的xcodebuild和xcrun命令來完成的坞淮，其中打包ipa的命令用了PackageApplication肛著，本來用的好好的诱建，升級(jí)了Xcode9之后带欢，發(fā)現(xiàn)蘋果把PackageApplication這個(gè)東西給刪了邮府，于是腳本就跪了胁塞。咏尝。。
所以啸罢，這兩個(gè)月我用了一個(gè)很原始的方法來打ipa包编检。大家也可以試試（大家常用的直接用Xcode中的Product->Archive的方法我就懶得說了，大家都懂）：
1.自己在Xcode配置好項(xiàng)目的簽名
2.用Generic iOS Device來build工程
3.找到生成的.app包扰才，然后新建一個(gè)名為Payload的文件夾允懂，將.app包放到文件夾里面
4.壓縮Payload文件夾，然后將壓縮包的后綴從.zip改成.ipa衩匣。
然后就可以將ipa包安裝到手機(jī)上測(cè)試了蕾总。
用Generic iOS Device來build工程
壓縮Payload文件夾，然后將壓縮包的后綴從.zip改成.ipa
為什么需要一個(gè)ipa打包腳本
嗯琅捏，因?yàn)橄胪祽小?/p>
直接在Xcode上點(diǎn)擊Product->Archive->此處省略n步選擇.......這種方式確實(shí)是挺方便的生百，估計(jì)很多人也是這么干的。但是柄延，當(dāng)你多次打包了之后你就發(fā)現(xiàn)蚀浆，打包這事好無聊。每次都是同樣的配置拦焚，同樣的操作步驟蜡坊，同樣的選擇，這么簡(jiǎn)單的操作我居然要重復(fù)N遍赎败。秕衙。。而且有時(shí)候要等很久才能進(jìn)行下一步僵刮【萃總之我覺得這種方式操作多了很是蛋疼鹦牛。
我一直秉承一個(gè)理念：能用機(jī)器自動(dòng)解決的問題盡量不用人工操作。
要是有一個(gè)東西勇吊，只要我配置好了一次之后蔓肯，以后直接雙擊就能直接打包持偏，是不是比之前的方式更好？
嗯，有挺多這種工具的秦躯，比如shenzhen，fastlane等等痰腮。
不過我是自己寫了一個(gè)簡(jiǎn)單的shell腳本來實(shí)現(xiàn)功能的赋访，比較簡(jiǎn)單，而且不會(huì)對(duì)項(xiàng)目有侵入性啄枕。借此還可以順便學(xué)習(xí)下shell腳本使用婚陪。
自動(dòng)打包腳本如何使用？
腳本的github地址為:https://github.com/shixueqian/AutoPackageScript
使用方法：
1.將腳本復(fù)制到工程的根目錄
2.用代碼編輯軟件（比如Xcode）打開腳本频祝，然后根據(jù)情況修改腳本內(nèi)的一些參數(shù)
3.打開終端泌参，輸入?sh ${打包腳本的全路徑}就可執(zhí)行打包腳本。
比如我的項(xiàng)目工程在
/Users/mac/Desktop/AutoPackageScriptDemo,
那么我的腳本路徑應(yīng)該是
/Users/mac/Desktop/AutoPackageScriptDemo/AutoPackageScript.sh,
所以我要執(zhí)行的命令是
sh /Users/mac/Desktop/AutoPackageScriptDemo/AutoPackageScript.sh
sh ${打包腳本的全路徑}這行命令的作用是執(zhí)行shell打包腳本常空。
除了這樣執(zhí)行沽一，我們還可以直接雙擊腳本文件就執(zhí)行腳本，不過在這之前我們需要進(jìn)行一些設(shè)置漓糙。
首先锯玛，將AutoPackageScript.sh文件的擴(kuò)展名去掉，變成AutoPackageScript
然后兼蜈，打開終端攘残，執(zhí)行命令?chmod +x ${打包腳本的全路徑},這樣可以給腳本加上可執(zhí)行權(quán)限，并且默認(rèn)的打開方式是終端为狸。
例如：chmod +x /Users/mac/Desktop/AutoPackageScriptDemo/AutoPackageScript
以后歼郭，直接鼠標(biāo)雙擊就可以執(zhí)行腳本了
腳本參數(shù)配置
看了腳本的使用，其中有一個(gè)很關(guān)鍵的東西辐棒，腳本參數(shù)配置病曾。我對(duì)多種情況都有適配，所以腳本參數(shù)會(huì)稍微有點(diǎn)復(fù)雜漾根，以下我們慢慢道來泰涂。
項(xiàng)目的工程結(jié)構(gòu)
我也不知道怎么稱呼這個(gè)東西，簡(jiǎn)單來講就是你的工程里面是不是使用xcworkspace（工作空間）來管理你的工程辐怕。
我們?cè)赬code直接新建一個(gè)iOS工程逼蒙，這個(gè)時(shí)候僅僅只有一個(gè).xcodeproj文件，是沒有.xcworkspace文件的寄疏。
而很多的項(xiàng)目都采用了cocoapods來管理項(xiàng)目是牢，這個(gè)時(shí)候是有.xcworkspace文件的僵井，cocoapods通過xcworkspace來管理了第三方庫。
這兩種結(jié)構(gòu)的參數(shù)配置是不一樣的驳棱。（因?yàn)閷懩_本的時(shí)候有區(qū)別）
# 是否編譯工作空間 (例:若是用Cocopods管理的.xcworkspace項(xiàng)目,賦值true;用Xcode默認(rèn)創(chuàng)建的.xcodeproj,賦值false)is_workspace="false"# .xcworkspace的名字批什，如果is_workspace為true，則必須填社搅。否則可不填workspace_name=""# .xcodeproj的名字驻债，如果is_workspace為false，則必須填形葬。否則可不填project_name="AutoPackageScriptDemo"# 指定項(xiàng)目的scheme名稱（也就是工程的target名稱）却汉，必填scheme_name="AutoPackageScriptDemo"
注釋其實(shí)已經(jīng)寫得很清楚了。舉個(gè)例子荷并，github上的workspace_demo是通過.xcworkspace來管理的：
need-to-insert-img
通過.xcworkspace來管理
need-to-insert-img
項(xiàng)目的scheme_name為AutoPackageScriptDemo
所以這幾個(gè)參數(shù)就是
is_workspace="true"workspace_name="AutoPackageScriptDemo"project_name=""scheme_name="AutoPackageScriptDemo"
否則，像github上面的project_demo里面的單工程結(jié)構(gòu)就是
is_workspace="false"workspace_name=""project_name="AutoPackageScriptDemo"scheme_name="AutoPackageScriptDemo"
method青扔，打包的方式源织。
證書簽名的方式，是通過腳本中的method變量控制的微猖。
分別為 development, ad-hoc, app-store, enterprise 谈息。看到這幾個(gè)參數(shù)估計(jì)都明白了吧凛剥？還不是不太了解的話建議看下蒲公英的這篇文檔
# method侠仇，打包的方式。方式分別為 development, ad-hoc, app-store, enterprise 犁珠。必填method="development"
profile文件的管理方式
一般來說逻炊，證書管理方式，如今應(yīng)該挺多人使用Xcode自動(dòng)管理的犁享。省心而且方便（老實(shí)說余素，由于工作原因，我平常比較少用自動(dòng)管理炊昆，都是手動(dòng)管理的桨吊，所以理解有誤的話請(qǐng)?zhí)岢觯?/p>
在Xcode->Preferrence->Account里面添加開發(fā)者賬號(hào)，然后在工程的General->勾選Automatically manage signing->選擇開發(fā)者賬號(hào)凤巨。就可以自動(dòng)管理了视乐。
另外一種就是古老的手動(dòng)管理方式了。
在開發(fā)者后臺(tái)上面創(chuàng)建BundleID敢茁，然后創(chuàng)建mobileprovision文件佑淀，安裝到Xcode上面選擇使用。
針對(duì)這兩種方式有不同的配置彰檬。
#? 下面兩個(gè)參數(shù)只是在手動(dòng)指定Pofile文件的時(shí)候用到渣聚，如果使用Xcode自動(dòng)管理Profile,直接留空就好# (跟method對(duì)應(yīng)的)mobileprovision文件名独榴，需要先雙擊安裝.mobileprovision文件.手動(dòng)管理Profile時(shí)必填mobileprovision_name=""# 項(xiàng)目的bundleID，手動(dòng)管理Profile時(shí)必填bundle_identifier=""
注釋講得很清楚奕枝，使用Xcode自動(dòng)管理profile的話直接留空就好了棺榔。
如果使用手動(dòng)管理的話就需要填寫對(duì)應(yīng)的參數(shù)了。
源碼解析
腳本代碼其實(shí)很簡(jiǎn)單的隘道。主要講解一下關(guān)鍵代碼症歇。
先把源碼放出來：
#!/bin/sh# 使用方法:# step1: 將該腳本放在工程的根目錄下（跟.xcworkspace文件or .xcodeproj文件同目錄）# step2: 根據(jù)情況修改下面的參數(shù)# step3: 打開終端，執(zhí)行腳本谭梗。（輸入sh 忘晤，然后將腳本文件拉到終端，會(huì)生成文件路徑激捏，然后enter就可）# =============項(xiàng)目自定義部分(自定義好下列參數(shù)后再執(zhí)行該腳本)=================== ## 是否編譯工作空間 (例:若是用Cocopods管理的.xcworkspace項(xiàng)目,賦值true;用Xcode默認(rèn)創(chuàng)建的.xcodeproj,賦值false)is_workspace="false"# .xcworkspace的名字设塔，如果is_workspace為true，則必須填远舅。否則可不填workspace_name=""# .xcodeproj的名字闰蛔，如果is_workspace為false，則必須填图柏。否則可不填project_name="AutoPackageScriptDemo"# 指定項(xiàng)目的scheme名稱（也就是工程的target名稱）序六，必填scheme_name="AutoPackageScriptDemo"# 指定要打包編譯的方式 : Release,Debug。一般用Release蚤吹。必填build_configuration="Release"# method例诀，打包的方式。方式分別為 development, ad-hoc, app-store, enterprise 裁着。必填method="development"#? 下面兩個(gè)參數(shù)只是在手動(dòng)指定Pofile文件的時(shí)候用到繁涂，如果使用Xcode自動(dòng)管理Profile,直接留空就好# (跟method對(duì)應(yīng)的)mobileprovision文件名，需要先雙擊安裝.mobileprovision文件.手動(dòng)管理Profile時(shí)必填mobileprovision_name=""# 項(xiàng)目的bundleID二驰，手動(dòng)管理Profile時(shí)必填bundle_identifier=""echo"--------------------腳本配置參數(shù)檢查--------------------"echo"\033[33;1mis_workspace=${is_workspace}"echo"workspace_name=${workspace_name}"echo"project_name=${project_name}"echo"scheme_name=${scheme_name}"echo"build_configuration=${build_configuration}"echo"bundle_identifier=${bundle_identifier}"echo"method=${method}"echo"mobileprovision_name=${mobileprovision_name}\033[0m"# =======================腳本的一些固定參數(shù)定義(無特殊情況不用修改)====================== ## 獲取當(dāng)前腳本所在目錄script_dir="$( cd "$( dirname "$0"? )"&&pwd)"# 工程根目錄project_dir=$script_dir# 時(shí)間DATE=`date '+%Y%m%d_%H%M%S'`# 指定輸出導(dǎo)出文件夾路徑export_path="$project_dir/Package/$scheme_name-$DATE"
# 指定輸出歸檔文件路徑
export_archive_path="$export_path/$scheme_name.xcarchive"
# 指定輸出ipa文件夾路徑
export_ipa_path="$export_path"
# 指定輸出ipa名稱
ipa_name="${scheme_name}_${DATE}"
# 指定導(dǎo)出ipa包需要用到的plist配置文件的路徑
export_options_plist_path="$project_dir/ExportOptions.plist"
echo "--------------------腳本固定參數(shù)檢查--------------------"
echo "\033[33;1mproject_dir=${project_dir}"
echo "DATE=${DATE}"
echo "export_path=${export_path}"
echo "export_archive_path=${export_archive_path}"
echo "export_ipa_path=${export_ipa_path}"
echo "export_options_plist_path=${export_options_plist_path}"
echo "ipa_name=${ipa_name}\033[0m"
# =======================自動(dòng)打包部分(無特殊情況不用修改)====================== #
echo "------------------------------------------------------"
echo "\033[32m開始構(gòu)建項(xiàng)目? \033[0m"# 進(jìn)入項(xiàng)目工程目錄cd${project_dir}# 指定輸出文件目錄不存在則創(chuàng)建if [ -d "$export_path" ] ; then? ? echo$export_pathelse? ? mkdir -pv$export_pathfi# 判斷編譯的項(xiàng)目類型是workspace還是projectif$is_workspace; then# 編譯前清理工程xcodebuild clean -workspace${workspace_name}.xcworkspace \? ? ? ? ? ? ? ? -scheme${scheme_name}\? ? ? ? ? ? ? ? -configuration${build_configuration}xcodebuild archive -workspace${workspace_name}.xcworkspace \? ? ? ? ? ? ? ? ? -scheme${scheme_name}\? ? ? ? ? ? ? ? ? -configuration${build_configuration}\? ? ? ? ? ? ? ? ? -archivePath${export_archive_path}else# 編譯前清理工程xcodebuild clean -project${project_name}.xcodeproj \? ? ? ? ? ? ? ? -scheme${scheme_name}\? ? ? ? ? ? ? ? -configuration${build_configuration}xcodebuild archive -project${project_name}.xcodeproj \? ? ? ? ? ? ? ? ? -scheme${scheme_name}\? ? ? ? ? ? ? ? ? -configuration${build_configuration}\? ? ? ? ? ? ? ? ? -archivePath${export_archive_path}fi#? 檢查是否構(gòu)建成功#? xcarchive 實(shí)際是一個(gè)文件夾不是一個(gè)文件所以使用 -d 判斷if [ -d "$export_archive_path" ] ; then
? ? echo "\033[32;1m項(xiàng)目構(gòu)建成功 ?? ?? ??? \033[0m"
else
? ? echo "\033[31;1m項(xiàng)目構(gòu)建失敗 ?? ?? ??? \033[0m"
? ? exit 1
fi
echo "------------------------------------------------------"
echo "\033[32m開始導(dǎo)出ipa文件 \033[0m"
# 先刪除export_options_plist文件
if [ -f "$export_options_plist_path" ] ; then
? ? #echo "${export_options_plist_path}文件存在爆土，進(jìn)行刪除"? ? rm -f$export_options_plist_pathfi# 根據(jù)參數(shù)生成export_options_plist文件/usr/libexec/PlistBuddy -c? "Add :method String${method}"$export_options_plist_path/usr/libexec/PlistBuddy -c? "Add :provisioningProfiles:"$export_options_plist_path/usr/libexec/PlistBuddy -c? "Add :provisioningProfiles:${bundle_identifier}String${mobileprovision_name}"$export_options_plist_pathxcodebuild? -exportArchive \? ? ? ? ? ? -archivePath${export_archive_path}\? ? ? ? ? ? -exportPath${export_ipa_path}\? ? ? ? ? ? -exportOptionsPlist${export_options_plist_path}\? ? ? ? ? ? -allowProvisioningUpdates# 檢查ipa文件是否存在if [ -f "$export_ipa_path/$scheme_name.ipa" ] ; then
? ? echo "\033[32;1mexportArchive ipa包成功,準(zhǔn)備進(jìn)行重命名\033[0m"
else
? ? echo "\033[31;1mexportArchive ipa包失敗 ?? ?? ??? ? \033[0m"? ? exit 1fi# 修改ipa文件名稱mv$export_ipa_path/$scheme_name.ipa$export_ipa_path/$ipa_name.ipa# 檢查文件是否存在if [ -f "$export_ipa_path/$ipa_name.ipa" ] ; then
? ? echo "\033[32;1m導(dǎo)出${ipa_name}.ipa 包成功 ??? ??? ??? \033[0m"? ? open$export_pathelse? ? echo "\033[31;1m導(dǎo)出${ipa_name}.ipa 包失敗 ?? ?? ??? ? \033[0m"
? ? exit 1
fi
# 刪除export_options_plist文件（中間文件）
if [ -f "$export_options_plist_path" ] ; then
? ? #echo "${export_options_plist_path}文件存在，準(zhǔn)備刪除"? ? rm -f$export_options_plist_pathfi# 輸出打包總用時(shí)echo "\033[36;1m使用AutoPackageScript打包總用時(shí):${SECONDS}s \033[0m"
exit 0
clean工程
以單工程項(xiàng)目為例(wordspace結(jié)構(gòu)是相似的)诸蚕，參數(shù)配置完成之后步势，clean下工程，用以清除緩存背犯，保證我們的項(xiàng)目是純凈的坏瘩。
跟我們?cè)赬code中Product->Clean這個(gè)命令是一樣的功能。
xcodebuild clean -project${project_name}.xcodeproj \? ? ? ? ? ? ? ? -scheme${scheme_name}\? ? ? ? ? ? ? ? -configuration${build_configuration}
project_name就是我們之前配置的工程的名稱漠魏，
scheme_name就是之前配置的工程的target名稱
build_configuration為之前配置的設(shè)置倔矾，Debug或者Release
以我們demo中的單工程為例，就是這樣的
xcodebuildclean-projectAutoPackageScriptDemo.xcodeproj-schemeAutoPackageScriptDemo-configurationRelease
archive工程
build工程，然后archive到一個(gè)文件夾里面哪自。
xcodebuild archive -project${project_name}.xcodeproj \? ? ? ? ? ? ? ? ? -scheme${scheme_name}\? ? ? ? ? ? ? ? ? -configuration${build_configuration}\? ? ? ? ? ? ? ? ? -archivePath${export_archive_path}
其中丰包，?export_archive_path就是我們存放archive結(jié)果的文件夾。
這條命令執(zhí)行以后壤巷，會(huì)在指定的位置生成.xcarchive文件（其實(shí)這個(gè)是文件夾來的邑彪。里面會(huì)有.app包和dSYM符號(hào)文件等內(nèi)容）
以我們的單工程demo為例：
export_archive_path=/Users/mac/Desktop/簡(jiǎn)書/AutoPackageScript/project_demo/AutoPackageScriptDemo/Package/AutoPackageScriptDemo_20180108/AutoPackageScriptDemo.xcarchivexcodebuild archive -project AutoPackageScriptDemo.xcodeproj -scheme AutoPackageScriptDemo -configuration Release -archivePath ${export_archive_path}
need-to-insert-img
命令執(zhí)行成功會(huì)生成.xcarchive文件
need-to-insert-img
.xcarchive文件里面的內(nèi)容
exportArchive,從xcarchive中導(dǎo)出ipa包
將剛才archive出來的.xcarchive文件，導(dǎo)出成一個(gè)ipa包胧华。
xcodebuild? -exportArchive \? ? ? ? ? ? -archivePath${export_archive_path}\? ? ? ? ? ? -exportPath${export_ipa_path}\? ? ? ? ? ? -exportOptionsPlist${export_options_plist_path}\? ? ? ? ? ? -allowProvisioningUpdates
export_archive_path就是剛才導(dǎo)出.xcarchive文件路徑
export_ipa_path是要導(dǎo)出的ipa文件的文件夾路徑
export_options_plist_path這是一個(gè)plist配置文件路徑寄症。這個(gè)plist配置文件是必須的，不加的話會(huì)報(bào)錯(cuò)的矩动。經(jīng)過我的測(cè)試發(fā)現(xiàn)有巧，主要是需要配置method這個(gè)key。如果是手動(dòng)管理的話悲没，還需要配置bundleID和mobileprovision_name篮迎。其他的key是可以不配置的，如果不配置的話示姿，會(huì)自動(dòng)根據(jù)項(xiàng)目里面的配置進(jìn)行生成甜橱。另外，這個(gè)文件我在腳本中用PlistBuddy命令直接生成了峻凫，不需要用戶自己指定文件。
-allowProvisioningUpdates主要目的是自動(dòng)更新profile文件览露，在Xcode自動(dòng)管理profile的時(shí)候用荧琼。
以我們的單工程demo為例：
export_ipa_path=/Users/mac/Desktop/簡(jiǎn)書/AutoPackageScript/project_demo/AutoPackageScriptDemo/Package/AutoPackageScriptDemo_20180108export_options_plist_path=/Users/mac/Desktop/簡(jiǎn)書/AutoPackageScript/project_demo/AutoPackageScriptDemo/ExportOptions.plistxcodebuild? -exportArchive \? ? ? ? ? ? -archivePath ${export_archive_path} \? ? ? ? ? ? -exportPath ${export_ipa_path} \? ? ? ? ? ? -exportOptionsPlist ${export_options_plist_path} \? ? ? ? ? ? -allowProvisioningUpdates
其中，ExportOptions.plist配置文件我只設(shè)置了method 差牛。
need-to-insert-img
ExportOptions.plist配置文件
命令執(zhí)行成功之后會(huì)生成我們需要的ipa文件和其他的幾個(gè)東西命锄。
need-to-insert-img
exportArchive成功之后生成的文件
其中，
ipa文件就是我們需要的安裝包偏化。
DistributionSummary.plist文件是一些詳細(xì)的簽名信息脐恩。
ExportOptions.plist文件其實(shí)就是我們?cè)趀xportArchive命令時(shí)要用的，但在exportArchive之后會(huì)自動(dòng)生成一個(gè)完整的文件侦讨。如果不知道該怎么寫這個(gè)配置文件的話驶冒，可以直接參考我demo中生成的這個(gè)plist文件。
Packaging.log這個(gè)文件就是打包的時(shí)候產(chǎn)生的log了韵卤，可以查看日志記錄骗污。
參考
腳本和demo都放到github上面去了。https://github.com/shixueqian/AutoPackageScript
