前言
自动化(Automation)是指机器设备、系统或过程(生产、管理过程)在没有人或较少人的直接参与下,按照人的要求,经过自动检测、信息处理、分析判断、操纵控制,实现预期的目标的过程(摘自百科)。软件自动化集成能够提高软件开发效率,是快速迭代过程中必备利器。jenkins是目前用得比较广的自动化工具。本来主要是使用jenkins+svn+xcode来构建自动化集成环境。
jenkins环境搭建
jenkins安装
jenkins下载地址:https://jenkins.io/index.html下载下来是war包的形式(本次使用的是1.642.4版本)。jenkins自带svn插件,如果仓库使用的是Git,可以安装jenkins的Git插件。
jenkinswar包有两种安装方法:
1.下载jenkins.war, 运行java -jar jenkins.war. 在OSX上默认已经安装了java环境,如果没有可以先安装java环境,在运行相关命令。
2.将war包放在tomcat的webapps目录中,运行tomcat。
jenkins启动完毕后,在浏览器中输入http://localhost:8080或http://127.0.0.1:8080或者本机IP加8080端口号,即可访问jenkin web管理界面。
主界面如下,功能划分清晰明了。
jenkins配置
1.创建任务(点击新建 > 输入项目名 > 选择构建多配置项目 > 点击确认)
2.填写描述信息
3.设置项目SVN地址
如果出现认证失败,点击enter credential 输入用户名密码就行了(jenkin也支持其它两种认证方式SSH以及HTTPS,根据情况来认证就行了)
4.设置shell脚本。(jenkin确实很强大除了shell还可以执行其它的任务)
可以增加Execute shell的数量,也可以拖动进行排序,确实是比较方便的。
5.设置构建后的处理。
在这里选择邮件通知,项目构建失败会收到邮件提醒。
6.保存项目配置。
保存后主页多了一个当前添加的构建项目。
你可以点击All之后的添加按钮添加试图,这样分类更明了。
7.启动任务。
a.手动构建。(点击构建按钮,即可构建项目。)
构建次数在历史试图可以查看
构建的时候可以通过Console Output查看命令执行结果。
自动构建。(在配置项目的时候,配置触发时间即可自动构建。可以每隔特定的时间,检查svn变更构建,也可以定时构建,很方便)
1.Poll SCM:定时检查源码变更(根据SCM软件的版本号),如果有更新就checkout最新code下来,然后执行构建动作。例如,表达式中填写H/15 H/30 H/45 * * * *将使Jenkins每隔15,30,45分钟就检查一次您源码仓库的变化。以下配置为每5分钟执行一次源码检查。
2.Build periodically:周期进行项目构建(它不关心源码是否发生变化)。以下设置为定时构建任务。
注意:如果对定时任务设置不太清楚,可以点击问号查看具体如何设置。
iOS自动化脚本
1.利用xcodebuild命令配合xcrun命令生成ipa文件,并上传到指定的svn目录。
build_path="project path" #工程xcodeproj文件目录
xcode_project="project.xcodeproj" #项目工程文件
target_name="iOS Demo" #要编译的target
app_path="${build_path}/build/Release-iphoneos/Demo.app" #生成的.app文件路径
dsymPath="dsym file path" #符号表保存目录
PLIST_NAME="Info.plist" #plist文件路径
bundleVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleVersion" ${PLIST_NAME}.plist)
bundleID=$(/usr/libexec/PlistBuddy -c "print CFBundleIdentifier" ${PLIST_NAME}.plist)
sign_name="4NUGTCBY12" #签名文件秘钥
embed_name="iosdev.mobileprovision" #provision 文件路径
more_argument="PROVISIONING_PROFILE=d449a8c6-94ea-2ec2-31b4-854627893c2f" #provision 文件uuid
ipa_build_time=$(date +"%Y_%m_%d_%H_%M")
ipa_name="${target_name}_V${bundleVersion}_${ipa_build_time}"
#组合打包命令
xcodebuild -project ${xcode_project} -sdk iphoneos -target ${target_name} -configuration Release ${more_argument} clean build || exit -2
xcrun_cmd='xcrun -sdk iphoneos packageapplication -v '${app_path}' -o '${ipa_path}/${ipa_name}.ipa
#增加–sign –embed
if [ "$sign_name" != "" ]; then
xcrun_cmd=${xcrun_cmd}' --sign '${sign_name}
echo "[[ add sign_name : $xcrun_cmd]]"
fi
if [ "$embed_name" != "" ]; then
xcrun_cmd=${xcrun_cmd}' --embed '${embed_name}
echo "[[ add embed_name : $xcrun_cmd]]"
fi
xcrun_cmd || exit -2
#保存更新DSYM文件
if [[ ! -d "${dsymPath}/${bundleID}" ]]; then
mkdir -p "${dsymPath}/${bundleID}"
fi
echo "[[[========= 开始拷贝DSYM文件 =========]]]"
cp -R "${build_path}/build/Release-iphoneos/Demo.app.dSYM" "${dsymPath}/${bundleID}/${bundleID}.dSYM"
#上传到svn
echo "svn://127.0.0.1:3698/Production/iOS/${SVN_DIR}${ipa_name}.ipa"
svn delete --username user --password pass -m "delete old ipa" svn://127.0.0.1:3698/Production/iOS/${SVN_DIR}${ipa_name}.ipa
svn import --username user --password pass -m "new Import ipa" ${ipa_path}/${ipa_name}.ipa svn://127.0.0.1:3698/Production/iOS/${SVN_DIR}${ipa_name}.ipa || exit -1
注意:在编译的时候可能出现以下错误:
解决办法
a.运行xcrun -sdk iphoneos -f PackageApplication,获取PackageApplication文件目录
b.以文本的方式打开PackageApplication文件,做如下修改
my@codesign_args;
if(-e'$destApp/ResourceRules.plist'){# If ResourceRules.plist exists, include it in codesign arguments, for backwards compatability
@codesign_args=("/usr/bin/codesign","--force","--preserve-metadata=identifier,entitlements,resource-rules",
"--sign",$opt{sign},
"--resource-rules=$destApp/ResourceRules.plist");
}else{# If ResourceRules.plist isn't found, don't include it in the codesign arguments
@codesign_args=("/usr/bin/codesign","--force","--preserve-metadata=identifier,entitlements",
"--sign",$opt{sign});
}
2.利用xcodebuild生成ipa文件。
#导出xcarchive文件
xcodebuild archive -project MyApp.xcodeproj -scheme MyApp -archivePath MyApp.xcarchive
#利用xcarchive导出ipa文件
xcodebuild -exportProvisioningProfile "${PROVISIONING_PROFILE_NAME}" -exportArchive -exportFormat IPA -archivePath "MyApp.xcarchive" -exportPath "$IPA_DIR/MyApp.ipa" CODE_SIGN_IDENTITY="${SIGNING_IDENTITY}"
注意:目前的 Xcode 7 中此命令的使用已经变成使用 -exportOptionsPlist 的参数形式了。这种形式支持 bitcode 的功能。
#Xcode7中导出ipa包
xcodebuild -exportArchive -archivePathMyApp.xcarchive-exportPath"$IPA_DIR/MyApp.ipa”-exportOptionsPlist $exportOptionsPlist
OptionsPlist 例子:
http://www.apple.com/DTDs/PropertyList-1.0.dtd">
teamID
MYTEAMID123
method
app-store
uploadSymbols
OptionsPlist 相关参数(更多参数可以使用xcodebuild --help命令查看)
自动化构建
在配置好jenkins,并编写好打包脚本以后,即可在Execute shell中运行打包脚本,构建成功后便会自动生成ipa文件并上传到指定的svn地址或者构建itms-services的安装环境。通过自动化大大简化了打包操作,终于可以利用这个时间写写文章了,感谢jenkins。
参考资料:
1.http://www.jayway.com/2015/05/21/fixing-your-ios-build-scripts/
2.http://www.matrixprojects.net/p/xcodebuild-export-options-plist/