起初想法:
基于公司原有的Jenkins服務(wù)的基礎(chǔ)上晤柄,最近在公司自動(dòng)化打包的時(shí),遇到一個(gè)尷尬的問(wèn)題?為什么不能直接通過(guò)Jenkins直接打包出來(lái)不同類(lèi)型的ipa(常見(jiàn)的ad-hoc吉捶、enterprise、development皆尔、app store)呐舔?
1、公司之前同事集成的只能支持development
2慷蠕、通過(guò)深入查看珊拼,對(duì).xcodeproj和.xcworkspace 的兼容性也不是很好。
直入正題:
一流炕、需要的環(huán)境
1澎现、Jenkins
版本信息:Jenkins ver. 2.5
不要問(wèn)我是什么,可以直接問(wèn)題“度娘”浪感、“Google” 也行昔头。因?yàn)槲沂腔诠疽延械沫h(huán)境,這里對(duì)于安裝過(guò)程自行百度影兽。需要注意一點(diǎn)揭斧,既然是一個(gè)服務(wù),建議安裝到新的電腦上峻堰,獨(dú)立操作讹开。有一段時(shí)間在自己開(kāi)發(fā)的電腦上折騰了一個(gè)node,后面由于內(nèi)存不夠捐名,已棄療旦万。。镶蹋。
2成艘、Xcode
Version 8.3.2
3赏半、蒲公英
官網(wǎng)
主要參考使用 Jenkins 實(shí)現(xiàn)持續(xù)集成 (iOS)
二、支持的功能
1淆两、不同類(lèi)型的ipa enterprise断箫、development
2、兼容性.xcodeproj秋冰、.xcworkspace
3仲义、解決證書(shū)導(dǎo)入問(wèn)題(新的工程無(wú)須每次都去裝有Jenkins的電腦上導(dǎo)入證書(shū))
三、命令行介紹及使用
1剑勾、xcodebuild
使用 xcodebuild -h 來(lái)看看 xcodebuild 到底是干啥的
Usage: xcodebuild [-project <projectname>] [[-target <targetname>]...|-alltargets] [-configuration <configurationname>] [-arch <architecture>]... [-sdk [<sdkname>|<sdkpath>]] [-showBuildSettings] [<buildsetting>=<value>]... [<buildaction>]... xcodebuild [-project <projectname>] -scheme <schemeName> [-destination <destinationspecifier>]... [-configuration <configurationname>] [-arch <architecture>]... [-sdk [<sdkname>|<sdkpath>]] [-showBuildSettings] [<buildsetting>=<value>]... [<buildaction>]... xcodebuild -workspace <workspacename> -scheme <schemeName> [-destination <destinationspecifier>]... [-configuration <configurationname>] [-arch <architecture>]... [-sdk [<sdkname>|<sdkpath>]] [-showBuildSettings] [<buildsetting>=<value>]... [<buildaction>]... xcodebuild -version [-sdk [<sdkfullpath>|<sdkname>] [<infoitem>] ] xcodebuild -list [[-project <projectname>]|[-workspace <workspacename>]] [-json] xcodebuild -showsdks xcodebuild -exportArchive -archivePath <xcarchivepath> -exportPath <destinationpath> -exportOptionsPlist <plistpath> xcodebuild -exportLocalizations -localizationPath <path> -project <projectname> [-exportLanguage <targetlanguage>...] xcodebuild -importLocalizations -localizationPath <path> -project <projectname>
備注:這里我只截取了 usage 部分埃撵,option 部分太多沒(méi)有截取。
主要介紹常用到的命令:
2虽另、xcodebuild -project ...
未加入cocoa pods
方案一:編譯生成build文件夾
xcodebuild -project testApp.xcodeproj -target testApp -configuration Release
方案二:
編譯生成xcarchive
xcodebuild archive -project testApp.xcodeproj -scheme testApp -configuration Release -archivePath testApp.xcarchive
3暂刘、xcodebuild -workspace ...
已加入cocoa pods
方案一:
編譯未生成build文件夾
xcodebuild archive -workspace testApp.xcworkspace -scheme testApp -archivePath testApp.xcarchive
方案二:編譯生成xcarchive
xcodebuild archive -workspace testApp.xcworkspace -scheme testApp -archivePath testApp.xcarchive
4、xcrun -sdk iphoneos -v PackageApplication ...
生成ipa
xcrun -sdk iphoneos -v PackageApplication ./build/Release-iphoneos/testApp.app -o ~/Desktop/testApp.ipa
主要與 未加入cocoa pods 方案一
聯(lián)合使用捂刺。
但是鸳惯,在 macos10.12 和 Xcode8 的環(huán)境下會(huì)出現(xiàn)一個(gè)警告warning: PackageApplication is deprecated, use xcodebuild -exportArchive instead.
說(shuō)明 PackageApplication 已經(jīng)被棄用了。
不過(guò)其實(shí)這一步可以幾乎等價(jià)于將 xx.app 放入一個(gè) payload 的文件夾下然后壓縮文件夾為 xx.ipa叠萍,當(dāng)然這樣做缺失一些信息,不過(guò)并不影響程序的運(yùn)行绪商。
5苛谷、xcodebuild -exportArchive ...
生成ipa
xcodebuild -exportArchive -archivePath testApp.xcarchive -exportPath . -exportOptionsPlist ~/Downloads/build.plist
主要與 未加入cocoa pods 方案二
、已加入cocoa pods 方案二
聯(lián)合使用格郁。
總結(jié):以上是兩種工程類(lèi)型的兩種命令行操作的例子腹殿,其中testApp
為工程名,build.plist
主要用于輸出不同的打包類(lèi)型例书。其他參數(shù)或關(guān)鍵字見(jiàn)官方文檔說(shuō)明锣尉。
build.plist內(nèi)容
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>method</key>
<string>enterprise</string>
<key>compileBitcode</key>
<false/>
</dict>
</plist>
build.plist中enterprise
可替換成為ad-hoc、enterprise决采、development自沧、app store
,目的用于輸出不同類(lèi)型的包树瞭。當(dāng)然這個(gè)和證書(shū)有關(guān)拇厢,后續(xù)會(huì)有描述。
操作方法:通過(guò)命令行方式進(jìn)入與.xcodeproj(.xcworkspace)文件同級(jí)目錄晒喷,輸入以上代碼即可實(shí)現(xiàn)命令行打包孝偎。
四、腳本代碼
以下是通過(guò)shell腳本方式實(shí)現(xiàn)
#!/bin/bash
echo "ios build"
token="842d5082c885df71a1a99ce4fd352cb5" #fir token,對(duì)應(yīng)fir賬號(hào)
function func_log_print(){
local level="$1"
local msg="$2"
case $level in
error) echo -e "${msg} ";;
warn) echo -e "${msg} ";;
info) echo -e "${msg} ";;
concern) echo -e "${msg} ";;
*) echo "${msg}";;
esac
}
function func_ios_build(){
#build.plist路徑
exportOptionsPlistPath=/Users/jenkins/jenkins/shell/build.plist
#打包類(lèi)型選擇
sed -i "" "s/enterprise/${pack_method}/g" $exportOptionsPlistPath
sed -i "" "s/ad-hoc/${pack_method}/g" $exportOptionsPlistPath
sed -i "" "s/development/${pack_method}/g" $exportOptionsPlistPath
sed -i "" "s/app-store/${pack_method}/g" $exportOptionsPlistPath
#更新license.lic文件
if [ -f ../license_local_mid.lic ];then
mv ../license_local_mid.lic ./license_local_mid.lic
fi
local local_path=$1
JOB_NAME=`echo $JOB_NAME|cut -d "-" -f 1`
echo "###############BUILD_TYPE############"
echo " $BUILD_TYPE "
cd "$local_path"
func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO): 第一步:構(gòu)建"
if [ -z $SCHEME ];then
SCHEME=${JOB_NAME}
fi
#輸出xcarchive路徑
outArchivePath=./${BUILD_TYPE}-iphoneos/${SCHEME}.xcarchive
#輸出ipa路徑
outIPAPath=./${BUILD_TYPE}-iphoneos/
outIPAPathFile=${outIPAPath}/${SCHEME}.ipa
#編譯成xcarchive
if [ -e *.xcworkspace ];then
xcodebuild archive -workspace ${SCHEME}.xcworkspace -scheme ${SCHEME} -configuration ${BUILD_TYPE} -archivePath ${outArchivePath}
#-archivePath testApp.xcarchive
else
xcodebuild archive -project ${SCHEME}.xcodeproj -scheme ${SCHEME} -configuration ${BUILD_TYPE} -archivePath ${outArchivePath}
fi
#打印log
func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO):xcodebuild -configuration ${BUILD_TYPE} -scheme $SCHEME clean build SYMROOT=$JOB_NAME"
if [ -e ${outArchivePath} ];then
func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO): 第二步:打包分發(fā)"
if [ ! -e ${outIPAPathFile} ];then
rm -rf ${outIPAPathFile} #刪除老的ipa
else
func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO):${outIPAPathFile} 老IPA不存在"
fi
#簽名后輸出ipa
xcodebuild -exportArchive -archivePath ${outArchivePath} -exportPath ${outIPAPath} -exportOptionsPlist ${exportOptionsPlistPath}
func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO): xcodebuild -exportArchive -archivePath ${outArchivePath} -exportPath ${outIPAPath} -exportOptionsPlist ${exportOptionsPlistPath}"
if [ -e ${outIPAPathFile} ];then
func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO): ipa 生成成功辕录!"
#while [ -z $download_url ]
#do
#ipa=`pwd`/${JOB_NAME}.ipa
#func_log_print "error" "[+] `date +'%H:%M:%S'` debug(@$LINENO):ipa path:$ipa"
#download_url=`/Users/XWH/.rvm/gems/ruby-2.3.2/bin/fir publish -Q -T $token $ipa | grep http | cut -d ":" -f 5-`
json=`curl -F "file=@${outIPAPathFile}" -F "uKey=eeb24ba7660ab63bbc4e3bc094cce3ae" -F "_api_key=50bd1341957a052a280cbf4a4a2f0546" -F "password=sensetime" -F "updateDescription=${DESCRIPTION}" https://www.pgyer.com/apiv1/app/upload`
result_code=`echo $json | /usr/local/bin/jq ".code"`
if [[ $result_code = "0" ]];then
download_url=`echo $json | /usr/local/bin/jq ".data" | /usr/local/bin/jq ".appShortcutUrl"`
download_url=`echo "https://www.pgyer.com/$download_url" | tr -d '"'`
else
echo $json | /usr/local/bin/jq ".message"
exit 1
fi
else
func_log_print "error" "[+] `date +'%H:%M:%S'` error(@$LINENO):IOS Build(xcodebuild -exportArchive): 生成ipa失敗!"
exit 1
fi
else
func_log_print "error" "[+] `date +'%H:%M:%S'` error(@$LINENO):IOS Build(xcodebuild archive -project): 生成archive失敗!"
exit 1
fi
func_log_print "concern" "####################################"
func_log_print "concern"
func_log_print "concern" "ios自動(dòng)打包成功眉尸,下載鏈接為:"
func_log_print "concern" "${download_url}"
func_log_print "concern" #密碼為:sensetime
func_log_print "concern"
func_log_print "concern" "####################################"
func_log_print "concern"
echo $download_url
exit 0
}
func_ios_build $1
五、踩的坑
1鞍陨、由于涉及到描述文件势决、證書(shū)替換問(wèn)題阻塑,Jenkins界面操作如下(方便用戶操作):
則需要在Jenkins 項(xiàng)目倉(cāng)庫(kù)的配置中作如下操作:
(1)、主要用于參數(shù)輸入的配置
(2)徽龟、主要用對(duì)輸入后的文件進(jìn)行更名操作叮姑,方便Xcode自動(dòng)讀取配置文件
代碼如下:
> if [ ! -d ../iOSSTLibrary ];then
mkdir ../iOSSTLibrary
fi
if [ ! -d ../CVFaceSDK ];then
mkdir ../CVFaceSDK
fi
if [ -e "/Users/jenkins/Library/MobileDevice/Provisioning Profiles/distribution" ];then
distributionFile="/Users/jenkins/Library/MobileDevice/Provisioning Profiles/distribution"
mobileprovision_uuid=`/usr/libexec/PlistBuddy -c "Print UUID" /dev/stdin <<< $(/usr/bin/security cms -D -i "${distributionFile}" )`
echo "UUID is:"
echo ${mobileprovision_uuid}
mv "${distributionFile}" "/Users/jenkins/Library/MobileDevice/Provisioning Profiles/${mobileprovision_uuid}.mobileprovision"
fi
if [ -e "/Users/jenkins/Library/MobileDevice/Provisioning Profiles/development" ];then
developmentFile="/Users/jenkins/Library/MobileDevice/Provisioning Profiles/development"
mobileprovision_uuid=`/usr/libexec/PlistBuddy -c "Print UUID" /dev/stdin <<< $(/usr/bin/security cms -D -i "${developmentFile}" )`
echo "UUID is:"
echo ${mobileprovision_uuid}
mv "${developmentFile}" "/Users/jenkins/Library/MobileDevice/Provisioning Profiles/${mobileprovision_uuid}.mobileprovision"
fi
2、涉及用shell 腳本替換文件中的內(nèi)容据悔,此處需要注意
正常操作: sed -i "" "s/enterprise/${pack_method}/g" $exportOptionsPlistPath
與Linux unix中的操作不一樣
sed -i "s/enterprise/${pack_method}/g" $exportOptionsPlistPath
3传透、獲取iOS .mobileprovision文件中的UUID查看mobileprovision命令行:security cms -D -I testApp.mobileprovision
參考:命令行獲取mobileprovision文件的UUID
六、暫時(shí)不能有點(diǎn)疑問(wèn)的地方
通過(guò)以上獲知极颓,若項(xiàng)目首次打包需要提供兩個(gè).mobileprovision文件(開(kāi)發(fā)朱盐、發(fā)布)發(fā)布可以直接通過(guò)蘋(píng)果開(kāi)發(fā)者官網(wǎng)生成得出。但是在Xcode8以后開(kāi)發(fā)證書(shū)自動(dòng)獲取菠隆,通過(guò)查找沒(méi)有合適的兵琳、比較科學(xué)的方式獲取此證書(shū)。目前比較簡(jiǎn)單骇径、粗暴的方式獲惹 :刪除/Users/XWH/Library/MobileDevice/Provisioning Profiles
目錄下的所有文件,通過(guò)xcode自動(dòng)生成獲取破衔。
以上就是對(duì)于iOS 通過(guò)Jenkins自動(dòng)化打包留下的經(jīng)歷G迮!晰筛!