前言
開發(fā)一段時(shí)間，每次在測(cè)試上線階段坟奥，你會(huì)發(fā)現(xiàn)有一種酸楚感树瞭，因?yàn)槟慵磳㈤_始一項(xiàng)沒有任何技術(shù)含量的build拇厢，archive，export的過程晒喷，這時(shí)候是最累的時(shí)候孝偎，如果你們的測(cè)試很敬業(yè)，給你一點(diǎn)點(diǎn)的提bug,那么你將面臨的一次接一次的build凉敲，archive衣盾，export的過程，還有上傳第三方分發(fā)平臺(tái)爷抓，這個(gè)酸爽感??势决。。蓝撇。果复。有人說不用啊，直接插我電腦上給裝一下就行了渤昌，而且現(xiàn)在Xcode還有無線調(diào)試了据悔，都不用到我跟前來了，直接給安裝了耘沼。當(dāng)然小團(tuán)隊(duì)開發(fā)這種模式肯定是沒任何毛病的，但當(dāng)你公司有好幾個(gè)測(cè)試朱盐，一個(gè)個(gè)讓你給安裝最新版本群嗤，是不是還是挺煩的！而且你可能還有這樣一個(gè)困窘兵琳，當(dāng)測(cè)試給你提多個(gè)bug 的時(shí)候狂秘，你改著改著等你上線的時(shí)候，你還擔(dān)心這個(gè)提交的包到底是不是最新的版本打的包躯肌，心里多少有點(diǎn)害怕出錯(cuò)者春，這時(shí)候這篇文章可以解決你所有的擔(dān)心以及減輕你所有的工作量，如果你說這個(gè)情況也不存在清女，那你可以關(guān)閉這個(gè)網(wǎng)頁尋找你感興趣的文章了钱烟。
正文
要徹底明白這個(gè)打包的過程我們還需要了解以下幾個(gè)概念
官方文檔中對(duì)這個(gè)有明確的解釋
Xcode Workspace：一個(gè)工作空間包括多個(gè)projects
A workspace is an Xcode document that groups projects and other documents so you can work on them together.
A workspace can contain any number of Xcode projects, plus any other files you want to include.
In addition to organizing all the files in each Xcode project, a workspace provides implicit and explicit relationships among the included projects and their targets.
Xcode Target：多個(gè)Target可以組成一個(gè)project，說白了就是一個(gè)依賴
A target specifies a product to build and contains the instructions for building the product from a set of files in a project or workspace.
A target defines a single product; it organizes the inputs into the build system—the source files and instructions for processing those source files—required to build that product.
Projects can contain one or more targets, each of which produces one product.
Xcode Project：一個(gè)project就是一個(gè)項(xiàng)目曙博，可以包含多個(gè)targets拥刻，而通過 build settings來定義如何build.
An Xcode project is a repository for all the files, resources, and information required to build one or more software products.
A project contains all the elements used to build your products and maintains the relationships between those elements.
It contains one or more targets, which specify how to build products.
A project defines default build settings for all the targets in the project (each target can also specify its own build settings, which override the project build settings).
Xcode Scheme：scheme是來定義一系列targets來build
一個(gè)scheme只能應(yīng)用于一個(gè)workspace。
An Xcode scheme defines a collection of targets to build, a configuration to use when building, and a collection of tests to execute.
You can have as many schemes as you want, but only one can be active at a time.
You can specify whether a scheme should be stored in a project—in which case it’s available in every workspace that includes that project, or in the workspace—in which case it’s available only in that workspace.
When you select an active scheme, you also select a run destination (that is, the architecture of the hardware for which the products are built).
Workspace：簡(jiǎn)單來說父泳，Workspace就是一個(gè)容器般哼，在該容器中可以存放多個(gè)你創(chuàng)建的Xcode Project吴汪， 以及其他的項(xiàng)目中需要使用到的文件。使用Workspace的好處有蒸眠，1),擴(kuò)展項(xiàng)目的可視域漾橙，即可以在多個(gè)項(xiàng)目之間跳轉(zhuǎn)，重構(gòu)黔宛，一個(gè)項(xiàng)目可以使用另一個(gè)項(xiàng)目的輸出近刘。Workspace會(huì)負(fù)責(zé)各個(gè)Project之間提供各種相互依賴的關(guān)系;2),多個(gè)項(xiàng)目之間共享Build目錄。
Project：指一個(gè)項(xiàng)目臀晃，該項(xiàng)目會(huì)負(fù)責(zé)管理生成一個(gè)或者多個(gè)軟件產(chǎn)品的全部文件和配置觉渴，一個(gè)Project可以包含多個(gè)Target。
Target：一個(gè)Target是指在一個(gè)Project中構(gòu)建的一個(gè)產(chǎn)品徽惋，它包含了構(gòu)建該產(chǎn)品的所有文件案淋，以及如何構(gòu)建該產(chǎn)品的配置。
Scheme：一個(gè)定義好構(gòu)建過程的Target成為一個(gè)Scheme险绘√呔可在Scheme中定義的Target的構(gòu)建過程有 Build/Run/Test/Profile/Analyze/Archive
BuildSetting：配置產(chǎn)品的Build設(shè)置，比方說宦棺，使用哪個(gè)Architectures瓣距？使用哪個(gè)版本的SDK？代咸。在Xcode Project中蹈丸，有Project級(jí)別的Build Setting，也有Target級(jí)別的Build Setting呐芥。Build一個(gè)產(chǎn)品時(shí)一定是針對(duì)某個(gè)Target的逻杖，因此，XCode中總是優(yōu)先選擇Target的Build Setting思瘟，如果Target沒有配置荸百，則會(huì)使用Project的Build Setting。
2.build -> archive -> export 到底干了什么
平時(shí)開發(fā)中我們很輕易的點(diǎn)擊了 command + B 執(zhí)行了一次build的過程 滨攻，其實(shí)對(duì)Xcode 來發(fā)你給他下發(fā)了一條指令够话，我們可以將編譯過后的右紅變黑的 項(xiàng)目名.app 點(diǎn)擊
Show in Finder 會(huì)發(fā)現(xiàn)build 文件夾下產(chǎn)生的一系列的文件，你會(huì)發(fā)現(xiàn)多個(gè)tagets 被加載進(jìn)來铡买，并生成了一個(gè) 項(xiàng)目名.app的包更鲁，這轉(zhuǎn)換為為指令如下:
xcodebuild
我們 可以在終端執(zhí)行該條命令對(duì)項(xiàng)目進(jìn)行build,該指令還可以生成項(xiàng)目名.xcarchive文件，對(duì)應(yīng)為我們執(zhí)行選擇真機(jī)點(diǎn)擊archive過程奇钞，對(duì)應(yīng)指令如下
WORKSPACENAME :工作區(qū)名字
SCHEMENAME : scheme名字
CONFIGURATION : release 或者 Debug
ARCHIVEPATH :文件輸入路徑, 一般為cd 路徑下拼接地址
\ : 拼接符號(hào)
- archive
xcodebuild archive \
-workspace ${WORKSPACENAME}.xcworkspace \
-scheme ${SCHEMENAME} \
-configuration ${CONFIGURATION} \
-archivePath ${ARCHIVEPATH}
看到以上命令我們應(yīng)該就豁然了澡为，例如給應(yīng)用商店上傳我們指定Release，在Xcode 8以前還需要指定描述文件以及開發(fā)者景埃，也就是發(fā)布的描述文件媒至，8以后都自動(dòng)管理了顶别，所以會(huì)自己去讀取，不需要我們?nèi)ブ付?
最后一步便是生成 export
看到這個(gè)界面大家更應(yīng)該明白了export拒啰，對(duì)應(yīng)指令如下：
xcodebuild -exportArchive \
-archivePath ${ARCHIVEPATH}.xcarchive \
-exportPath ${IPAPATH} \
-exportOptionsPlist ExportOptions.plist \
需要明確以下幾點(diǎn)：
1.Xcode 8 以后使用以上新命令驯绎，xcrun指令被廢棄了！
2.這里ARCHIVEPATH 對(duì)應(yīng)的.xcarchive文件的輸出路徑谋旦，IPAPATH是ipa 輸出地址
3.ExportOptions.plist對(duì)應(yīng)的已怎樣的方式輸出剩失，相當(dāng)于一個(gè)配置文件，我們需要以什么樣的方式輸出.ipa册着。
對(duì)應(yīng)的是以下我們手動(dòng)打包的方式：
以上生成.ipa的流程我們應(yīng)該明了于心了拴孤，接下來我們用shell腳本將整個(gè)流程自動(dòng)化。
shell 腳本
#!/bin/bash
#workspaceName
WORKSPACENAME='xxx'
#schemeName 可以在工程根目錄下使用 xcodebuild -list 命令查看schemes
SCHEMENAME= 'xxxx'
#(Release or Debug)
CONFIGURATION='xxxxxx '
#獲取時(shí)間甲捏，這個(gè)格式可以自己定義
DATE=`date +%Y%m%d_%H%M`
#源工程的地址演熟，默認(rèn)獲取cd 路徑下的地址
SOURCEPATH=$( cd "$( dirname $0 )" && pwd)
#archieve 輸出地址，這個(gè)路徑可以你自己定義
ARCHIVEPATH=${SOURCEPATH}/AutoBuildIPA/${BRANCHNAME}/${DATE}
#ipa 包輸出地址司顿，這個(gè)路徑也可以你自己定義
IPAPATH=${SOURCEPATH}/AutoBuildIPA/${BRANCHNAME}/${SCHEMENAME}_${DATE}
#ipa 包名
IPANAME=${SCHEMENAME}.ipa
echo "~~~~~~~~~~~~~~~~開始清理~~~~~~~~~~~~~~~~~~~"
# 清理 避免出現(xiàn)一些莫名的錯(cuò)誤
xcodebuild clean \
-workspace ${WORKSPACENAME}.xcworkspace \
-configuration ${CONFIGURATION} \
-scheme ${SCHEMENAME}
echo "~~~~~~~~~~~~~~~~開始構(gòu)建archive~~~~~~~~~~~~~~~~~~~"
# build xxx
xcodebuild archive \
-workspace ${WORKSPACENAME}.xcworkspace \
-scheme ${SCHEMENAME} \
-configuration ${CONFIGURATION} \
-archivePath ${ARCHIVEPATH}
#判斷 'xx.xcarchive' 文件存在芒粹，即 build 成功
if [ -e ${ARCHIVEPATH}.xcarchive ]; then
echo "xcodebuild Successful"
else
echo "erro:Build failed!!"
exit 1 #退出命令執(zhí)行
fi
echo "~~~~~~~~~~~~~~~~開始輸出ipa~~~~~~~~~~~~~~~~~~~"
# xcrun xxx
xcodebuild -exportArchive \
-archivePath ${ARCHIVEPATH}.xcarchive \
-exportPath ${IPAPATH} \
-exportOptionsPlist ExportOptions.plist \
# 如果 xx.ipa 存在則輸出成功
if [ -e ${IPAPATH}/${IPANAME} ]; then
echo "\n-------------------------\n\n\n"
echo "Configurations! Build Successful!"
echo "\n\n\n-------------------------\n\n"
else
echo "\n---------------------------------------------------------------\n"
echo "erro:Create IPA failed!!"
echo "\nPlease check the case of failure and contact developers,thanks!"
echo "Export Error Path : ${IPAPATH}/${IPANAME}"
echo "\n---------------------------------------------------------------\n"
exit 1
fi
以上是便是腳本文件，直接將腳本放在項(xiàng)目工程同級(jí)目錄下大溜，在終端執(zhí)行 sh xxxx.sh(注：xxxx為腳本文件名)化漆，和python 腳本執(zhí)行是一樣的，接下來等待即可輸出ipa包钦奋。(注：大多出錯(cuò)就是路徑定義有問題获三，檢查路徑正確性即可排除問題)
接下來我們需要上傳蒲公英，我們可以查看官網(wǎng)文檔锨苏，發(fā)現(xiàn)很簡(jiǎn)單的執(zhí)行步驟
我們可以在上述shell腳本中將這條命令添加上去
# 是否上傳蒲公英
UPLOADPGYER=false
#上傳ipa到蒲公英
if [ $UPLOADPGYER = true ]
then
echo "~~~~~~~~~~~~~~~~上傳ipa到蒲公英~~~~~~~~~~~~~~~~~~~"
#installType 是安裝類型
#password 是你設(shè)置的安裝密碼
# 上面兩個(gè)新增字段可以具體查看官方文檔
curl -F "file=@${IPAPATH}/${IPANAME}" \
-F "uKey=xxxx" \
-F "_api_key=xxxx" \
-F "installType=2" \
-F "password=1" \
https://www.pgyer.com/apiv1/app/upload --verbose
if [ $? = 0 ]
then
echo "~~~~~~~~~~~~~~~~上傳蒲公英成功~~~~~~~~~~~~~~~~~~~"
else
echo "~~~~~~~~~~~~~~~~上傳蒲公英失敗~~~~~~~~~~~~~~~~~~~"
echo "${IPAPATH}/${IPANAME}"
fi
fi
fi
那么上傳 Appstore 也是相應(yīng)的套路，蘋果官方提供了我們類似的方法棺聊，我們需要利用終端安裝
//安裝 xctool
brew install xctool
//查看版本
xctool -version
同樣我們可以將上傳Appstore 添加到對(duì)應(yīng)的shell 腳本中
# 是否上傳到APPStore
UPLOADAPPStore=false
#對(duì)應(yīng)appid
AppleID='xxx'
#pwd
AppleIDPWD='xxx'
# 上傳AppStore
#首先是驗(yàn)證過程伞租，看你appstore 對(duì)應(yīng)的信息是否正確
if [ $UPLOADAPPStore = true ]
then
altoolPath="/Applications/Xcode.app/Contents/Applications/Application\ Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/altool"
${altoolPath} --validate-app \
-f ${IPAPATH}/${IPANAME} \
-u ${AppleID} \
-p ${AppleIDPWD} \
-t ios --output-format xml
#驗(yàn)證成功后直接上傳
if [ $? = 0 ]
then
echo "~~~~~~~~~~~~~~~~驗(yàn)證ipa成功~~~~~~~~~~~~~~~~~~~"
${altoolPath} --upload-app \
-f ${IPAPATH}/${IPANAME} \
-u ${AppleID} \
-p ${AppleIDPWD} \
-t ios --output-format xml
if [ $? = 0 ]
then
echo "~~~~~~~~~~~~~~~~提交AppStore成功~~~~~~~~~~~~~~~~~~~"
else
echo "~~~~~~~~~~~~~~~~提交AppStore失敗~~~~~~~~~~~~~~~~~~~"
fi
else
echo "~~~~~~~~~~~~~~~~驗(yàn)證ipa失敗~~~~~~~~~~~~~~~~~~~"
fi
以上整個(gè)自動(dòng)化過程已經(jīng)完成了，接下來我們看本地jenkins 搭建限佩，首先安裝
brew install jenkins
安裝完成等待 install,可以在終端使用
jenkins
來啟動(dòng)jenkins,然后在瀏覽器輸入框輸入
http://localhost:8080
打開Jenkins葵诈，我們?nèi)缓笮陆?xiàng)目（注:以上詳細(xì)安裝過程，以及plugin缺失問題祟同，都可以通過百度作喘，google方式解決,我們說具體操作）
第一步：新建項(xiàng)目
第二步：設(shè)置相關(guān)的配置
2.1 填寫項(xiàng)目相關(guān)信息
2.2倉庫地址需要填寫到項(xiàng)目的根路徑那一級(jí)為止
svn 和 git 是一樣的設(shè)置。
2.3 在增加構(gòu)建步驟中選擇Xcode
2.4簽名設(shè)置泞坦，填寫鑰匙串的路徑，通過該路徑Jenkins可以找到打包證書
2.5高級(jí)設(shè)置贰锁，Scheme同shell腳本填寫是一致的
2.6上傳蒲公英或者App Store
App Store 參照腳本命令執(zhí)行赃梧。
附：當(dāng)提交新代碼時(shí)候設(shè)置自動(dòng)打包
完成以上配置，點(diǎn)擊保存后豌熄，點(diǎn)擊立即構(gòu)建則會(huì)輸出同shell 腳本同樣的結(jié)果授嘀。
參照J(rèn)enkins 文章：
[0]http://blog.csdn.net/yaoliangjun306/article/details/72471429
相應(yīng)配置文件的github地址
https://github.com/markdashi/shellIPA
將 package.sh 和 ExportOptions.plist 導(dǎo)入同級(jí)目錄下，設(shè)置好相應(yīng)參數(shù)锣险，執(zhí)行腳本即可蹄皱。
2020-8-27 更新
Xcode更新11之后，不再包含Application Loader芯肤。為了更好的支持ipadOS巷折、macOS、iOS統(tǒng)一管理纷妆。
所以上傳AppStore的命令發(fā)生了變化
如果賬號(hào)沒有開啟雙步驗(yàn)證盔几，可以通過
-u -p賬號(hào)密碼上傳驗(yàn)證，如果開啟了掩幢，需要采取密鑰上傳
# 上傳AppStore
#首先是驗(yàn)證過程逊拍，看你appstore 對(duì)應(yīng)的信息是否正確
if [ $UPLOADAPPStore = true ]
then
xcrun altool --validate-app \
-f ${IPAPATH}/${IPANAME} \
-apiKey ${apiKey} \
-apiIssuer ${apiIssuer} \
-t ios --output-format xml --verbose
fi
#驗(yàn)證成功后直接上傳
if [ $? = 0 ]
then
echo "~~~~~~~~~~~~~~~~驗(yàn)證ipa成功~~~~~~~~~~~~~~~~~~~"
xcrun altool --upload-app \
-f ${IPAPATH}/${IPANAME} \
-apiKey ${apiKey} \
-apiIssuer ${apiIssuer} \
-t ios --output-format xml --verbose
if [ $? = 0 ]
then
echo "~~~~~~~~~~~~~~~~提交AppStore成功~~~~~~~~~~~~~~~~~~~"
else
echo "~~~~~~~~~~~~~~~~提交AppStore失敗~~~~~~~~~~~~~~~~~~~"
fi
else
echo "~~~~~~~~~~~~~~~~驗(yàn)證ipa失敗~~~~~~~~~~~~~~~~~~~"
fi
apiKey apiIssuer 的獲取方式可以參照
