iOS持续集成:jenkins+gitlab+蒲公英+邮件通知(Part 2)

iOS持续集成:jenkins+gitlab+蒲公英+邮件通知(Part 2)

Jenkins 系统设置 前期准备

Jenkins 插件安装

  • 安装GitLab插件

    因为我们项目用的是GitLab来管理源代码,jenkins本身并没有自带GitLab插件,所以我们需要依次选择 ***系统管理 -> 管理插件*** 在"***可选插件***"中选择GitLab Plugin 和 Gitlab Hook Plugin 这两项,然后安装
    
  • 安装Xcode插件
    同安装GitLab插件步骤一样,我们一次选择 系统管理 -> 管理插件 在”可选插件“中选择Xcode integration这两项,然后安装

  • 安装签名证书管理插件
    iOS打包内测版时,需要发布证书及相关签名文件,因此这两个插件对于管理iOS证书非常方便。还是在系统管理->管理插件,在“可选插件”中选中“Credentials Plugin”和“Keychains and Provisioning Profiles Management”安装。

    • 安装FTP插件
      此插件可用于上传FTP服务器,也可以上传到公司内网的FTP服务器中。”Publish over FTP”

    • 安装脚本插件
      这个插件主要用于build后执行先关脚本.”Publish over FTP”

jenkins 系统配置

jenkins 安全设置:注册,登录

进入 系统管理->Configure Global Security 首次设置如图所示:

首次设置

首次设置完点击保存,然后点击注册->登录账号,在进入该界面进行账号权限设置,如图

权限设置

jenkins 系统设置

进入 系统管理->系统设置 界面:

  • 首先设置一下 jenkins 内部shell 执行编码,目的当在jenkins执行shell命令时,有时候会报 utf-8 编码错误。主要是pod install的时候报错。

    1
    WARNING: CocoaPods requires your terminal to be using UTF-8 encoding.

    设置如下:

    编码设置

  • jenkins Location 设置
    主要设置 jenkins 外部访问的URL 和 系统管理员的邮箱地址。用来发送 错误报告的邮箱地址:如图

    url设置

  • 系统错误报告的邮箱设置,上面只设置了邮箱发送的地址(From地址),下面设置,邮箱的服务器,协议,邮箱,密码。如图

    email设置

Jenkins 任务(Jobs)搭建

新建任务 job

在Jenkins中,所有的任务都是以“item”为单位的。接下来我们就新建一个iOS的项目来开始自动化构建。点击“新建”,输入item的名称,选择“构建一个自由风格的软件项目”,然后点击“OK”。如图:

新建Job设置

设置构建信息

构建信息设置

源码管理

这里用到的是GitLab,先需要配置SSH,我们可以在Jenkins的证书管理中添加SSH。在Jenkins管理页面,选择“Credentials”,然后选择“Global credentials (unrestricted)”,点击“Add Credentials”,如下图所示,我们填写自己的SSH信息,然后点击“Save”,这样就把SSH添加到Jenkins的全局域中去了。
这边需要注意的是如何获取SSH key:这个问题需要参考 gitLab 上配置SSH 的方法。

  1. 查看是否已经有了ssh密钥:cd ~/.ssh,如果没有密钥则不会有此文件夹,有则备份删除
  2. 生成密钥:$ ssh-keygen -t rsa -C “haiyan.xu.vip@gmail.com” 生成过程中必须设置秘钥密码 否则jenkins 设置会不成功。最后得到两个文件:id_rsa和id_rsa.pub
  3. 添加密钥到SSH :ssh-add 文件名 需要输入管理密码
  4. 在gitlab 上添加 ssh 密钥,这里添加的是 “id_rsa.pub”里面的公钥。
  5. 在jenkins上配置密钥到SSH ,这里添加的是id_rsa里面的私钥。具体设置如图所示:

接下来,我们再回到刚刚新建的任务中,在源码管理中,选择Git,按下图填好相关信息。PS:Credentials不需要选择。如图

构建触发器设置

该设置主要是为了实现自动触发 jenkins 构建过程 真正实现自动化设置:
这边主要处理的是 gitlab hook 的设置。主要目的是当项目中有人git push 提交过代码之后,就会自动的触发 jenkins 的本Job的构建,实现自动化打包。

  1. 首选需要在gitlab 项目管理官网上设置 添加git hook 的地址:如图:该地址是jenkins 上 提示的地址 下面会提到

  1. jenkins 上对 gitlab hook 进行相关配置 如图所示:

构建环境

在该模块中 主要设置 xcode build 打包时需要的 keychains 和 Provision Profiles 配置文件。
如果不配置 就会使用 xcode 自动的配置,来去系统中查找相应的配置,不过有一点需要注意,就是钥匙串中,登陆钥匙串中的证书 要复制到 系统钥匙串中,因为jenkins 访问的是系统中的钥匙串 这样在第一次打包的时候,会提示 是否授权访问钥匙串,点击始终允许就可以了。
注意:在电脑上安装好 xcode 配置相关的证书和配置文件,配置文件也要安装到系统目录下。
具体操作如下:从该用户目录下的所有描述文件

1
/Users/用户名/Library/MobileDevice/Provisioning Profiles

复制到系统目录下

1
/Library/MobileDevice/Provisioning Profiles

构建

该模块开始设置 iOS打包相关的配置。

  1. 点击增加构建步骤-> Execute Shell .首先 在build 之前需要先 pod install ,并且最理想的情况是每次构建的时候 build号都改变。如图所示
    需要注意的是,使用全局变量时 必须找到绝对路径才能调用相关的命令:版本号增加参考链接

  2. 点击增加构建步骤 xcode ,具体配置如图:
    该配置中需要注意 在OS X 10.10.XX版本 jenkins xcode 插件不支持 生成ipa文件,但 OS X 10.11 支持 这个时候 需要手动进行打包,具体的就是在build 完成之后 添加EXecute Shell ,利用shell脚本打包:代码如下:

    1
    xcrun -sdk iphones PackageApplication -v [工程目录] -o [ipa输出目录]/xx.ipa
![](http://7xsugd.com2.z0.glb.clouddn.com/runningyoungBlog/images/xcode.png)
  1. Code signing & OS X keychain options 配置:如图

  2. Advanced Xcode build options 配置:如图

构建后操作

打包完成之后 需要执行 上传到蒲公英 和 发送邮件 通知开发人员。
具体操作我用python写的脚本来完成此功能:需要的童鞋可以去github上下载:在文章最后!!
具体调用如图:

最后设置 通知邮件 E-mail Notification 填写接受邮箱即可 每次构建失败都会发生邮件通知!!!

python 脚本地址!!! 不要吝啬 star!!!不胜感激!!!

文章目录
  1. 1. iOS持续集成:jenkins+gitlab+蒲公英+邮件通知(Part 2)
    1. 1.1. Jenkins 系统设置 前期准备
      1. 1.1.1. Jenkins 插件安装
      2. 1.1.2. jenkins 系统配置
        1. 1.1.2.1. jenkins 安全设置:注册,登录
        2. 1.1.2.2. jenkins 系统设置
    2. 1.2. Jenkins 任务(Jobs)搭建
      1. 1.2.1. 新建任务 job
      2. 1.2.2. 源码管理
      3. 1.2.3. 构建触发器设置
      4. 1.2.4. 构建环境
      5. 1.2.5. 构建
      6. 1.2.6. 构建后操作
,