Mac上实现iOS自动化打包和分发
起初想法：
基于公司原有的Jenkins服务的基础上，最近在公司自动化打包的时，遇到一个尴尬的问题？为什么不能直接通过Jenkins直接打包出来不同类型的ipa（常见的ad-hoc、enterprise、development、app store）？
1、公司之前同事集成的只能支持development
2、通过深入查看，对.xcodeproj和.xcworkspace 的兼容性也不是很好。
直入正题：
一、需要的环境
1、Jenkins
版本信息：Jenkins ver. 2.5
不要问我是什么，可以直接问题“度娘”、“Google” 也行。因为我是基于公司已有的环境，这里对于安装过程自行百度。需要注意一点，既然是一个服务，建议安装到新的电脑上，独立操作。有一段时间在自己开发的电脑上折腾了一个node，后面由于内存不够，已弃疗。。。
2、Xcode
Version 8.3.2
3、蒲公英
官网
主要参考使用 Jenkins 实现持续集成 (iOS)
二、支持的功能
1、不同类型的ipa enterprise、development
2、兼容性.xcodeproj、.xcworkspace
3、解决证书导入问题（新的工程无须每次都去装有Jenkins的电脑上导入证书）
三、命令行介绍及使用
1、xcodebuild
使用 xcodebuild -h 来看看 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 部分太多没有截取。
主要介绍常用到的命令：
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 方案一联合使用。
但是，在 macos10.12 和 Xcode8 的环境下会出现一个警告warning: PackageApplication is deprecated, use xcodebuild -exportArchive instead.
说明 PackageApplication 已经被弃用了。
不过其实这一步可以几乎等价于将 xx.app 放入一个 payload 的文件夹下然后压缩文件夹为 xx.ipa，当然这样做缺失一些信息，不过并不影响程序的运行。
5、xcodebuild -exportArchive ...
生成ipa
xcodebuild -exportArchive -archivePath testApp.xcarchive -exportPath . -exportOptionsPlist ~/Downloads/build.plist
主要与 未加入cocoa pods 方案二、已加入cocoa pods 方案二联合使用。
总结：以上是两种工程类型的两种命令行操作的例子，其中testApp
为工程名，build.plist
主要用于输出不同的打包类型。其他参数或关键字见官方文档说明。
build.plist内容
<?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，目的用于输出不同类型的包。当然这个和证书有关，后续会有描述。
操作方法：通过命令行方式进入与.xcodeproj（.xcworkspace）文件同级目录，输入以上代码即可实现命令行打包。
四、脚本代码
以下是通过shell脚本方式实现
#!/bin/bash
echo "ios build"
token="842d5082c885df71a1a99ce4fd352cb5" #fir token,对应fir账号
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
#打包类型选择
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): 第一步：构建"
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): 第二步：打包分发"
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自动打包成功，下载链接为："
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、由于涉及到描述文件、证书替换问题，Jenkins界面操作如下（方便用户操作）：
Jenkins界面操作.png
则需要在Jenkins 项目仓库的配置中作如下操作：
（1）、主要用于参数输入的配置
参数输入的配置.png
（2）、主要用对输入后的文件进行更名操作，方便Xcode自动读取配置文件
文件进行更名操作.png
代码如下：
> 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 脚本替换文件中的内容，此处需要注意
正常操作： 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
六、暂时不能有点疑问的地方
通过以上获知，若项目首次打包需要提供两个.mobileprovision文件（开发、发布）发布可以直接通过苹果开发者官网生成得出。但是在Xcode8以后开发证书自动获取，通过查找没有合适的、比较科学的方式获取此证书。目前比较简单、粗暴的方式获取：删除/Users/XWH/Library/MobileDevice/Provisioning Profiles
目录下的所有文件，通过xcode自动生成获取。
以上就是对于iOS 通过Jenkins自动化打包留下的经历！！！
