利用Jenkins进行iOS持续集成

首发于个人简书

前言

1、持续集成优势：
一、缩减开发周期，快速迭代版本
二、提供分发效率，测试人员以及相关人员无需等待开发人员打包
三、减小重复操做，高效打包，减轻开发人员工做量。

2、iOS 持续集成的大概原理为：
一、经过Jenkins做为一个触发器，捕捉push等操做或者定时，触发打包动做；
二、GIT plugin 进行项目源码管理；
三、经过Xcode integration进行打包。

目录

1、安装Jenkins
2、Jenkins密码设置

3、初始设置
4、安装Jenkins插件
5、新建项目
6、General参数
7、源码管理
8、构建触发器设置
9、构建环境设置
10、构建
11、打包上传
12、其余

正文

1、安装Jenkins

方法一： 直接到官网下载安装包
经过安装包安装

方法二：经过Homebrew使用命令行安装
一、安装Homebrew
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
二、安装Jenkins
brew install jenkins
三、启动Jenkins

jenkins

安装完成后，浏览器可能自动打开Jenkins，若是没有自动打开，到浏览器输入http://localhost:8080

2、Jenkins密码设置

打开http://localhost:8080 会出现一下界面，经过密码解锁。

/Users/Shared/Jenkins/Home/ 目录下找到secrets
这里存在一个权限问题，须要右击secrets文件夹，选择"简介"，在简介最下面找到共享与权限，进行权限修改，才能打开这个文件夹，
而后在里面找到initialAdminPassword文件，一样地进行权限修改后，打开initialAdminPassword文件，里面的就是初始密码，复制密码到刚才的页面中尽心解锁。
Jenkins 是以一个用户进程存在于电脑中的，你从新开机的时候会发现多了一个Jenkins用户，Jenkeins的相关文件最好在这个用户下进行操做，避免权限问题没法操做。

也能够在管理员帐号下对Jenkins用户帐号的密码进行更改。

3、初始设置

最后进行帐户注册，注册了帐户以后，关掉页面，从新打开输入localhost:8080,这个时候就会让你以帐户形式登陆，进入主页面

4、安装Jenkins插件

在开始新建工程前须要按照一些Jenkins插件，在后面的工程设置中会用到

选择系统管理

在可选插件中选择咱们须要的插件进行安装:
一、Xcode integration
二、GIT plugin
三、GitLab Plugin
四、Gitlab Hook Plugin
五、Keychains and Provisioning Profiles Management

5、新建项目

构建一个自由风格的软件项目：

6、General参数

能够设置包的保留天数和最大保留个数
这些能够根据须要进行调整，能够不要选

7、源码管理

这里须要进行ssh key 设置

   点开Add按钮进行ssh key 设置，与git ssh key设置原理同样

这里要注意用正确的ssh 私钥。

在branch specifier中输入分支名字：图中的分支名为"JekinsTest"

8、构建触发器设置

触发器可自定义的地方不少，Poll SCM最经常使用
图中的日程表标示20分钟检查是否更新进行构建

9、构建环境设置

这里主要是设置签名文件和证书，咱们先要去“Keychains and Provisioning Profiles Managemen”插件进行设置：

到Jenkins 首页，点击
如图：

上传Provisioning Profile

设置login.keychain，login.keychian 在/Users/管理员用户名/Library/keychains/login.keychain中能够拿到，
Code Signing Identity 复制证书名字填上去。

设置完毕后回到刚才的构建环境设置
咱们勾选“Keychains and Code Signing Identities”和“Mobile Provisioning Profiles”

10、构建

这里咱们用Xcode进行构建打包

一、General build settings

二、Code signing & OS X keychain options

三、Advanced Xcode build options

Note：在macOS10.10以上的系统中，用Jenkins的Xcode插件打包，重签名会出现问题，报错：
“Warning: --resource-rules has been deprecated in Mac OS X >= 10.10“
解决方法：
打开/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/usr/bin/PackageApplication ，而后将:

my @codesign_args = ("/usr/bin/codesign", "--force", "--preserve-metadata=identifier,entitlements,resource-rules",
                  "--sign", $opt{sign},
                  "--resource-rules=$destApp/ResourceRules.plist");

替换成

my @codesign_args = ("/usr/bin/codesign", "--force", "--preserve-metadata=identifier,entitlements",
                  "--sign", $opt{sign});

11、打包上传

这里使用的是bugly的内测分发

#!/usr/bin/env bash
cd $WORKSPACE/build

curl —insecure -F "file=@ipa包的名字.ipa" -F "app_id=bugly中的app_id" -F "pid=2" -F "title=标题" -F "description=用于Jekins持续集成测试" -F "secret=2" -F "password=分发时须要填的密码" -F "download_limit=2000" https://api.bugly.qq.com/beta/apiv1/exp?app_key=bugly中的app_key

12、其余

咱们的工程中经过git submodule 进行了模块管理，第一次拉代码的时候须要手动进行git submodule update，添加子模块的内容进去。这个时候必须在Jenkins用户帐号下操做，否则会由于读写权限的限制致使操做失败。