0%

【iOS 开发】使用 Jenkins + Fastlane 持续集成 iOS 项目

发表于 更新于 分类于

持续集成（Continuous Integration 简称 CI）。Jenkins 是一个开源项目，提供了一种易于使用的持续集成系统，使开发者从繁杂的集成中解脱出来，专注于更为重要的业务逻辑实现上。具体就不多说了，想要更多的了解可以去查一下，下面是集成方法。

本文最终目的：

  • 测试人员可登录 Jenkins 网页自行选择 开发分支 和 打包类型 ，然后自动打包完成并自动上传至 蒲公英 或 iTunes Connect ，不再需要开发人员手动安装或上传。

1. 配置 Fastlane

由于项目的编译打包以及上传全部要依赖 Fastlane 来进行，所以在配置 Jenkins 之前要保证项目已经配置好了 Fastlane ，这里看我的另一篇文章：【iOS 开发】使用 Fastlane 自动化打包并发布 iOS 项目 。

2. 安装 Jenkins

  • Jenkins 依赖于 Java 运行环境，因此需要先保证电脑已经安装了 Java JDK ，如果没有的话前往 这里 下载安装即可。

  • 我这里是使用 homebrew 安装 Jenkins ，没有安装 homebrew 的输入以下命令安装一下。

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  • 千万不要去 Jenkins 官网下载 pkg 安装包安装，因为用安装包安装会自动生成一个共享用户 jenkins，而这个用户的权限和系统登录用户的权限不同，会造成大量的权限问题，我已经被坑惨了，用 homebrew 装是不会生成共享用户的。

  • homebrew 安装完成后输入以下命令安装 Jenkins 。

brew install jenkins

安装

  • 如果想要卸载直接执行以下命令即可卸载 Jenkins 。
brew uninstall jenkins
  • 安装完成后输入以下命令链接 launchd 配置文件。
ln -sfv /usr/local/opt/jenkins/*.plist ~/Library/LaunchAgents
  • 然后执行以下命令启动 Jenkins 。
launchctl load ~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist
  • Jenkins 默认是开机自动启动的，如果想关闭就执行以下命令即可关闭。
launchctl unload ~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist

Jenkins

  • Jenkins 默认端口号是 8080 ，如果想要更改端口号的话可以用 Xcode 打开以下文件，将 httpPort 后面的 8080 改成你想要的端口号即可。
/usr/local/opt/jenkins/homebrew.mxcl.jenkins.plist

修改端口

3. 配置 Jenkins

  • 等待启动完成后 ，会出现以下界面让你输入密码解锁。

Jenkins

  • 密码就在上面提示的 /Users/Jonzzs/.jenkins/secrets/initialAdminPassword 文件中，打开 initialAdminPassword 文件将密码复制到浏览器解锁即可，然后点击第一个 Install suggested plugins。

Jenkins

  • 然后等待插件全部安装完成。

Jenkins

  • 安装完成后会跳出创建用户界面，按照提示创建用户即可。

Jenkins

  • 最后到这个页面就算是安装完成了。

Jenkins

4. 安装插件

  • 在建任务之前需要先安装几个插件，前往 系统管理 - 管理插件 ，在 可选插件 中搜索 GitLab Plugin 、Gitlab Hook Plugin 、Xcode integration 这三个插件，然后安装。

Jenkins

5. 配置环境变量

  • 前往 系统管理 - 系统设置 找到 全局属性 ，然后添加以下三个环境变量。
LANG
en_US.UTF-8
LANGUAGE
en_US.UTF-8
LC_ALL
en_US.UTF-8

环境变量

  • 这三个环境变量是用来修改编码格式的，如果不加下面脚本执行 fastlane 命令时会报错。

6. 创建任务

  • 插件安装完成以后就可以开始创建项目了，点击新建任务，输入你的项目名称。

Jenkins

  • 勾选 参数化构建过程 ，添加一个 String Parameter 和一个 Choice Parameter ，第一个 ARCHIVE_BRANCH 主要是输入要打包的项目分支，第二个 ARCHIVE_TYPE 是选择打包的类型，我这边 beta 是打包发布到 蒲公英 ，release 是打包发布到 iTunes Connect ，如果你不需要这些参数可以跳过。

Jenkins

  • 在 源码管理 输入你的仓库地址，地址为 SSH 方式，然后需要在点击 Add 添加 SSH Key 。

Jenkins

  • 选择 SSH Username with private key 类型，Username 随便填，然后选择 Enter directly ，将自己 SSH Key 的私钥复制进去即可，注意是私钥不是公钥，/Users/Jonzzs/.ssh/id_rsa 在这个文件里。

  • 如果自己电脑没有生成过 SSH Key ，就自己去查一下吧，这里就不重复了。

  • 最后在 构建 中增加一个 Execute Shell ，主要用来填写脚本内容。

Jenkins

  • 填写以下脚本命令，xxx 处填写自己项目相应文件夹名，因为在执行 fastlane 指令之前需要进入 fastlane 文件夹所在目录，如果你的 git 根目录就是在项目目录的话，可以不用这句，然后点击 保存 即可。
git checkout ${ARCHIVE_BRANCH}
git pull
cd ./xxx
fastlane ${ARCHIVE_TYPE}

7. 开始打包

  • 进入你创建的任务，点击 Build with Parameters ，然后输入要打包的项目分支以及类型，然后点击 开始构建 即可开始打包。

Jenkins

  • 如果构建失败，也可以在 Build History 中点击 Console Output 查看控制台输出记录，找到错误原因。

Jenkins