iOS 自动打包总结 fastlane +svn+jenkins

国际惯例.jpg

写在前面

  iOS 开发同学在开发过程中都会遇见的一个问题就是重复给测试同学打测试包，打包的过程虽说没有难度，但是程序员都是很拒绝这种重复而没技术含量的工作，虽说我们是码农，但是我们还是希望自己的工作是 去改变世界的！所以这种无聊的工作我们能偷懒就偷懒吧。

  公司控制发版和测试的工具使用的一直是 jenkins ，之前也有接触，但是只局限于 web 页面和服务器端发版提交，懂得一些基础配置。来到公司后，技术总监决定 iOS 也要实现自动打包，方便管理，然后我就接了这个锅！！！

首先你需要一台 mac ， 用你自己的或者是公司能提供一台 mac mini 来充当发版服务器是最好的了，部署 jenkins 的工作我就不具体细说了，虽繁琐，但是不难。下面是我找到部署 jenkins 的文章
mac 下使用 jenkins 自动打包
mac 环境下如何配置 jenkins

• jenkins 配置好后登录会进入这个页面（需要安装好 xcode 插件，我们依次选择系统管理->管理插件，在“可选插件”中选中“Xcode integration”安装，如使用的是 git 管理还需要安装对应的插件） 屏幕快照.png

当然在你那是什么项目都没有的，部署好以后先不用管，我们先配置好打包需要的环境，再来部署 jenkins。

• 首先介绍一下 Fastlane

fastlane 是一套工具，帮助你简化和自动化 App 发布或部署的过程，将之变成一条平直的工作流。通过 fastlane，你可以实现 持续分发（CD，一种用于自动化和改进软件分发过程的设计实践）。 通过 fastlane 内置的工具，你可以创建一个由 build task （又叫做 lane）构成的有序列表，你只需要点击一个按钮就可以将 App 发布到 App 商店。你可以节省大量的时间，用于提升软件质量，或者缩短团队中发布者的发布周期。

Fastlane是用Ruby语言编写的一套自动化工具集和框架，每一个工具实际都对应一个Ruby脚本，用来执行某一个特定的任务，而Fastlane核心框架则允许使用者通过类似配置文件的形式，将不同的工具有机而灵活的结合在一起，从而形成一个个完整的自动化流程。

通过 fastlane 内置的工具，你可以创建一个由 build task （又叫做 lane）构成的有序列表，你只需要点击一个按钮就可以将 App 发布到 App 商店。你可以节省大量的时间，用于提升软件质量，或者缩短团队中发布者的发布周期。

官网链接点这里（翻墙）
gitHub点这里

Fastlane 安装

• 打开终端输入

xcode-select --install

若是出现下图，则说明你之前安装过；没有的话按照步骤安装即可

屏幕快照 .png 如果没有安装过则会出现以下安装页面 屏幕快照.png

• 输入 以下命令查看 ruby 版本要求2.0及其以上版本

ruby -v

出现以下页面就是以安装过了， 屏幕快照.png

没有安装版本太低或者是没有安装的同学请自行百度安装，这里就不过多赘述。

• 上述问题都解决后就需要安装 fastlane

sudo gem install fastlane --verbose

如果出现以下错误：

ERROR:  While executing gem ... (Errno::EPERM)
    Operation not permitted - /usr/bin/rougify

则输入以下命令

 sudo gem install -n /usr/local/bin fastlane

• 检查 fastlane 是否正确安装，输入以下命令

fastlane --version

我的是 fastlane 2.89.0

蒲公英插件的安装

• 打开终端，进入你的项目工程的根目录，输入以下命令：

fastlane add_plugin pgye

出现以下界面

Plugin 'fastlane-plugin-pgyer' was added to './fastlane/Pluginfile'
It looks like fastlane plugins are not yet set up for this project.
fastlane will create a new Gemfile at path 'Gemfile'
This change is necessary for fastlane plugins to work
Should fastlane modify the Gemfile at path 'Gemfile' for you?
(y/n)

输入 y 点击回车出现

Installing plugin dependencies...
Successfully installed plugins

搞定！！！

Fastlane 配置

• 打开终端，cd 到工程的根目录，输入以下命名初始化 fastlane

fastlane init

中间会让你输入苹果开发者账号的账号和密码，之后会在你项目工程的目录下生成一个fastlane文件夹，里面有Fastlane的配置文件，一个是Appfile文件，一个是Fastfile文件(如果要上传AppStore的话还有Deliverfile文件)。Appfile保存苹果开发者的相关信息、项目的相关信息等。Fastfile是运行脚本,目录如下图： 屏幕快照 .png

部署 jenkins

• 新建项目,输入项目名称，选中自由风格项目，然后点击 OK。

  
  屏幕快照.png
  

  可添加描述，其他保持原样就行，有兴趣的同学可以自己研究一下这些选项都是什么意思

• 源码管理
  

  我这里用的是 svn ，所以只介绍 svn 关联版本库的方法，如使用 git 的可百度一下，方法也很简单 屏幕快照.png
  点击 add 添加SVN用户，输入用户名和密码，其他可不输入。 屏幕快照 .png
  点击添加后会回到上一页面 屏幕快照.png 选中之前添加的 svn 用户，没有红色的报错信息，那就是添加正确了，如果报错，请检查 SVN 路径或者是 SVN用户名和密码。
• 构建触发器
  这个是决定在什么情况下会触发自动构建的，目前就 APP 开发而言我们选中 Poll SCM 就行，然后输入

H 8 * * 1-6

意思就是在 SVN仓库代码发生改变的情况下，会在周一至周六每天早上8点自动构建版本，也就是自动打包。 屏幕快照.png

• 构建环境
  我开始使用的是在构建环境这一块来配置打包证书和描述文件，踩了无数的坑，虽然也是弄好了，但是这里不推荐大家使用，fastlane 会自动给我们解决证书的问题

• 构建
  

  选中增加构建步骤-> Execute shell 屏幕快照 .png
  在命令行里输入以下脚本

export LANG=en_US.UTF-8

export LANGUAGE=en_US.UTF-8

export LC_ALL=en_US.UTF-8

export PATH="~/.fastlane/bin:$PATH"

IPANAME="你要打包的scheme 名"
fastlane gym --export_method ad-hoc --output_name ${IPANAME}

curl -F "file=@包名.ipa" -F "_api_key=蒲公英的 app_key" https://qiniu-storage.pgyer.com/apiv2/app/upload

然后点击保存

证书配置

• 必须确保安装 jenkins 的电脑里有安装 xcode 、你要打包项目的证书和描述文件，并且打开钥匙串，找到打包证书，双击将证书修改为始终信任

  
  屏幕快照.png
  证书配置完成后，回到 jenkins 控制面板，点击立即构建，红色代表构建失败，蓝色代表构建成功，构建失败的话我们点击当前构建，进入以下页面 屏幕快照.png 点击 Console OutPut 能够查看失败原因和构建进度！！ 屏幕快照 .png

注意事项

• 你项目中的scheme 必须勾选 shared

  
  屏幕快照 .png
• 提交 SVN 仓库时不能勾选勾选自动证书，手动配置描述文件选中 ad_hot 描述文件。

写在后面

• 当时是遇见了很多的问题，但是没有及时总结，好多问题都忘了如果您碰见什么无法解决的问题可以联系我试试看，可能我之前也碰见过，直接留言或者私信就行！
• 当然 jenkins 和 fastlane 还有很多高级的用法，比如 jenkins 自动化测试和配合一下 jenkins 插件完成一下繁琐重复的工作，fastlane 自动提交 apple store 和自己截图等好多功能，有兴趣的同学可以研究一下。