上一篇:iOS打包自动化实践(一)
把打包项目迁移到Jenkins远程机器上,并增加自动上传发版文案的功能。
准备工作
- 一台远程Mac机器,并在这台CI机器上安装Jenkins,具体安装步骤见:Jenkins安装。
- 远程控制:Mac自带远程功能,使用十分简单。远程控制
- 在CI机器上安装fastlane。
- 在CI机器上配置打包证书和描述文件。
- 在CI机器上跑一遍自动打包上传脚本,确认机器配置没有问题。
Jenkins配置
下载好jenkins的war包之后,在远程机器的shell中执行命令:
java -jar your/jenkins/path/jenkins.war --ajp13Port=-1 --httpPort=9090
命令执行成功后,在本地机器输入CI机器的IP + 端口9090,例如你的CI机器IP是192.168.1.1,那么就在浏览器中输入:192.168.1.1:9090。如果机器和Jenkins都配置好了,那么你就会看到如下页面:
- 首先:新建任务-构建一个自由风格的软件项目,然后进入任务配置界面。
- 配置源码:在"源码管理"tab中选择Git,然后填写项目的Git地址(http),并配置Credentials(使用username和password即可)。在"Branches to build"栏目中填写需要build的分支名。
- 填写构建脚本:在"Execute shell"中,把上篇文章调试成功的shell脚本复制粘贴进去(注意:脚本默认目录是项目根目录),脚本如果之前写了绝对路径需要做一些修改,建议使用"pwd"命令获取项目根目录,然后拼接相对路径。
到这里项目的基本配置就结束了,build一下试试,顺利的话就可以成功在Jenkins上完成自动打包和上传工作了。
上传发版文案功能
fastlane的deliver命令除了上传IPA包,还有上传icon,发版文案,app信息等功能。这个功能的实现类似Git,需要首先把后台的数据下载到本地,然后修改需要修改的文件,然后上传即可。详细步骤:
1、 修改配置:
在Jenkins任务配置界面,选择"General-参数化构建过程-添加参数", 比如你的项目有简体中文和繁体中文国际化语言,就添加两个文本参数,分别命名为release_notes_zhHans和release_notes_zhHant.
保存配置,任务的"Build"会变成"Build with Parameters", 点击后界面如下:
2、 在Execute shell中修改脚本:
在fastlane deliver命令之前增加以下命令。
#下载metadata, 包括icon(目前用不到)和各本地化发版文案。
fastlane deliver download_metadata\
--username ${user_name}\
--app_identifier ${bundle_id}\
--force true
#简中,繁中,发版文案路径
zhHans_notes_path="./fastlane/metadata/zh-Hans/release_notes.txt"
zhHant_notes_path ="./fastlane/metadata/zh-Hant/release_notes.txt"
if [ -n "$release_notes_zhHans" ]; then
echo "$release_notes_zhHans" > $zhHans_notes_path
fi
if [ -n "$release_notes_zhHant" ]; then
echo "$release_notes_zhHant" > $zhHant_notes_path
fi
"fastlane deliver download_metadata"命令的作用是把目前iTunesConnect后台的数据下载到本地,默认路径是"./fastlane/metadata"。我们在"参数化构建"中增加的参数可以在"Execute shell"中作为变量直接使用,因此"$release_notes_zhHans"和"$release_notes_zhHant"就能取到我们填写的简中和繁中发版文案,判断不为空时,使用"echo"命令把他们填写在各自语言目录下的release_notes.txt文件中即可。
3、修改deliver命令:
删掉skip_metadata参数,即:
#上传IPA到App Store Connect
fastlane deliver\
--username ${user_name}\
--app_identifier ${bundle_id}\
--app ${app_id}\
--ipa ${ipa_path}\
--skip_screenshots true\
--app_version ${app_version}\
--force true
这里的app_version也可以通过参数化构建的方式添加参数,每次构建之前填写。
点击某次构建的"控制台输出"可以看到shell的输出。调试成功后,登录iTunesConnect后台,如果发版文案被成功修改即说明此次自动化集成完美成功!
FAQ
1、拉取代码失败,提示:ERROR: Error fetching remote repo 'origin'
一般是填写的帐号访问Git仓库的权限问题。如果你的远程CI机器上集成过别的项目,那么你需要查看CI机器的keychain,其中存放的gitlab帐号密码是否有访问你目前配置的这个项目的权限。因为在jenkins上配置Credentials时,如果keychain中没有帐号会添加你新配置的帐号,如果已经有了不会配置新的。即jenkins会使用keychain中现有的帐号来拉取代码。
写在最后
下一篇文章会介绍如何优化打包项目,包括自动获取AppVersion,自动升build号,自动触发构建,配置自动发送邮件,定制邮件内容等功能。
下一篇:iOS打包自动化实践(三)