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都配置好了，那么你就会看到如下页面：

jenkins.png

首先：新建任务-构建一个自由风格的软件项目,然后进入任务配置界面。
配置源码：在"源码管理"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.

参数配置.png

保存配置，任务的"Build"会变成"Build with Parameters", 点击后界面如下：

参数化构建摁.png

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后台，如果发版文案被成功修改即说明此次自动化集成完美成功！

控制台输出.png

FAQ

1、拉取代码失败，提示：ERROR: Error fetching remote repo 'origin'

一般是填写的帐号访问Git仓库的权限问题。如果你的远程CI机器上集成过别的项目，那么你需要查看CI机器的keychain，其中存放的gitlab帐号密码是否有访问你目前配置的这个项目的权限。因为在jenkins上配置Credentials时，如果keychain中没有帐号会添加你新配置的帐号，如果已经有了不会配置新的。即jenkins会使用keychain中现有的帐号来拉取代码。

写在最后

下一篇文章会介绍如何优化打包项目，包括自动获取AppVersion，自动升build号，自动触发构建，配置自动发送邮件，定制邮件内容等功能。

下一篇：iOS打包自动化实践（三）