iOS可持续化集成: Jenkins + bundler + cocoapods + shenzhen + fastlane + pgyer

工具介绍

1. bundler

bundler用于管理ruby gem的工具，我们用来管理cocoapods以及fastlane的版本。直接sudo gem install bundler就可以。然后在project的根文件夹下，加入Gemfile文件：

source 'http://ruby.taobao.org'

source 'http://ruby.taobao.org'

gem 'cocoapods', '~>0.37.2'

gem 'fastlane', '~>1.4.0'

然后运行，bundle install就可以，运行完同一时候会生成一个Gemfile.lock文件，把这个和Gemfile文件一起加入到git中管理，用这个我们能够非常方便大家一起同步gem source和cocoapods以及fasten的版本。

2. cocoapods

这个不用多说，各方面參考资料已经太多了，这个不了解的话。在iOS开发方面真的是属于比較薄弱了。

Command Line

1). 我是选择fastlane作为打包以及分发的工具，这个是在shenzhen基础之上进行了封装，很easy易用。具体參考官方的资料即能够及另一些其它的对xcodebuild的封装:

1)  https://github.com/nomad/shenzhen

2)  http://fastlane.tools

3)  https://github.com/nomad/cupertino，

4)  https://github.com/facebook/xctool，这是facebook对xcodebuild封装的一个开源库，也能够用来构建安装包。

假设安装有多个Xcode版本号，能够使用xcode-select选择相应的Xcode版本号进行build，这个工具也是很实用的。

使用xcpretty (  https://github.com/supermarin/xcpretty) 对xcodebuild的输出进行格式化。

使用xcodebuild -list查看全部可用的schemes。

xcrun是Xcode自带的一个命令行工具，主要有两个用途: 找到开发工具，运行这些开发工具。

比方 xcrun —find ld，用于定位ld工具的位置。xcrun git —version，则是直接运行git —version命令。

总之来说，当我们使用fastlane和shenzhen之后，这部分就变得很easy，不须要我们再过多关注。

2). agv — Apple Generic Version 工具的使用

Apple官方提供的更改版本的功能。设置參考:

• http://youandthegang.com/2015/continuous-integration-delivery-with-jenkins/
• http://segmentfault.com/a/1190000002423661
• <Pro iOS Continuous Integration>

Jenkins

1. 安装启动

在 https://jenkins-ci.org/或者通过命令: "curl -L http://mirrors.jenkins-ci.org/war/latest/jenkins.war -O" 下载jenkins.war都某个文件夹以下。 通过命名行 "java -jar jenkins.war" 启动jenkins，也能够通过 —httpPort 和 —httpListenAddress 指定port和设定IP来启动。

假设希望jenkins能够开机自启动以及异常自己主动重新启动，能够把jenkins设置为Launch Daemon的方式启动。

1). 执行命令 “sudo touch /Library/LaunchDaemons/org.jenkins-ci.plist” 来创建配置文件

2). 文件的内容例如以下，參考gist:  https://gist.github.com/lihei12345/84a4ed83aa07a9d3a7d7 :

Refer:  http://savvyapps.com/blog/continuous-integration-ios-jenkins/， http://9elements.com/io/index.php/continuous-integration-of-ios-projects-using-jenkins-cocoapods-and-kiwi/

3) 又一次启动jenkins就会在后台自启动了，或者直接使用”sudo launchctl load -w /Library/LaunchDaemons/org.jenkins-ci.plist”命令行

不管通过哪种方式来启动jenkins。启动之后，在浏览器中输入: http://localhost:8080，就能够直接进入jenkins后台了。

2. Jenkins基本设置

进入jenkins之后，须要做一些主要的设置来设置一个管理账户，或者设置LDAP这这种通用身份系统认证系统 (參考一篇非常棒的文章: http://zhuanlan.zhihu.com/prattle/19974568)

1). 进入系统管理 -> Configure Global Security -> 点击”启用安全” 。

启用安全以下选择，“Jenkins专实用户数据库”。勾选同意用户能够注冊。然后在“授权策略”中选择“不论什么用户能够做不论什么事(没有不论什么限制)”。当然，也能够使用LDAP身份认证机制，直接使用外部统一的身份机制来做认证。

2). 返回注冊一个账户。登录之后再次进入安全管理。勾选“登录用户能够做不论什么事”，这样就仅仅有登录用户才干做操作了。

3). 插件管理，我使用的jenkins版本号，发现我所须要的插件都已经加入了，仅仅须要update一下就可以。

3. 设置git

1). “新建” —> 勾选“构建一个自由风格的软件项目”  -> “源代码管理”中勾选“Git”

2).  配置repo的URL以及SSH keys生成的private key填入以下的输入框中。

生成SSH keys的过程详细请參考：https://help.github.com/articles/generating-ssh-keys/，对git比較熟悉的话。这个过程应该不会陌生。记得不要忘记把public key加入 repo的訪问权限中，不管是github/gitlab/bitbucket都是类似的。运行以下两行命令，直接到输入框里粘贴就可以。

ssh-keygen -t rsa -N "" -f ~/Tools/jenkins.key # 生成key

cat ~/Tools/jenkins.key | pbcopy # 把private key copy到粘贴板

 然后返回git设置，”Credentials”选择刚才输入的username就可以。

4. Jenkins Job设置

1). 使用shenzhen測试构建环境是否正常

在项目的根文件夹下，先使用shenzhen直接运行測试。看是否可以成功构建。没有构建成功的话。须要google一下解决掉，再往下进行。运行一下命令进行測试：

”ipa build -c Release -d ~/Desktop”

“cd ~/Desktop"

然后上传到蒲公英或者fir.im平台。之后就能够直接在这些平台上面直接下载了

“ipa distribute:pgyer -u USER_KEY -a APP_KEY” # 上传到蒲公英

"ipa distribute:fir -u USER_TOKEN -a APP_ID” # 上传到fir.im

假设发现可以打包而且下载成功。则在Job的构建里面加入下面shell命令， https://gist.github.com/lihei12345/5076a737261e97ca0856，进行构建測试。

这个測试过程中，我这边总是会报错。在console output中查看一下错误信息: “No schemes found in Xcode project or workspace”，解决的方法例如以下： http://stackoverflow.com/questions/14368938/xcodebuild-says-does-not-contain-scheme，把workspace的shared勾选就可以。修复之后。非常顺利构建成功。

5. fastlane

1) 关于fastlane

在使用shenzhen測试之后。假设一切正常，那我们就能够继续配置Job了，shenzhen已经是一个很方便的工具了。可是更近一步，有一个更加自己主动化和便于使用的工具—fastlane，我们以下基于fastlane配置用于測试分发(fir.im/TestFlight)的AdHoc Job以及上传到Appstore的App Store Job。fastlane官方关于集成Jenkins的文档，  https://github.com/KrauseFx/fastlane/blob/master/docs/Jenkins.md。内部须要安装几个Jenkins插件。

在查看fastlane之后，我发现fastlane的确很强大。能够大大简化我们的工作。尤其适合个人开发人员，可是这个还是有一定学习成本的。

https://github.com/KrauseFx/fastlane

http://www.infoq.com/cn/news/2015/01/fastlane-ios-continuous-deploy

fastlane是一组工具套件，让你能够定义和执行特定环境下各种部署流程的自己主动化，它是由fastlane提供的工具(比如snapshot/sigh/deliver等)以及各种第三方工具(比如cocoapods/xctool等)连接在一起组成的，能够提供一个执行良好的可持续部署流程。例如以下图。在Test / TestFilght Beta /Appstore 这些不同的环境下，执行的部署流程是不一样的。

以下我们说一下由fastlane提供的各种工具：

• delivery：用于上传应用的二进制代码，应用截屏和原数据到 App Store
• snapshot：能够自己主动化iOS应用在每一个设备上的本地化截屏过程
• frameit：用于在应用截屏外加入设备的边框
• PEM：能够自己主动化生成和更新应用推送通知描写叙述文件
• sigh：能够生成并下载开发人员的应用商店配置文件
• product：能够使用命令行在iTunes Connect中创建iOS应用以及Developer Portal
• cert：能够自己主动创建并维护iOS的签名证书
• codes：使用命令行来生成应用的优惠码

2) 配置上传蒲公英的fastlane

进入到项目根文件夹，使用 fastlane init 来初始化fastlane文件，详细步骤能够參考以下的资料： https://github.com/KrauseFx/fastlane/tree/master/docs。能够參考官方提供的各种fastlane脚本的demo来撇仅仅实现自己的项目：

在fastlane文件里。加入直接通过ipa命令蒲公英上传: sh "ipa distribute:pgyer -f XXX.ipa -a XXX -u XXX”。对于fastlane。由于我自身精力有限，所以我眼下仅仅实现了一下简单的脚本进行上传蒲公英的操作，没有实现覆盖測试以及App Store上传的fastlane，关于这些方面的实现能够參考文章:  http://www.jianshu.com/p/9ae446d76271。在fastlane中加入例如以下的脚本，gist地址:  https://gist.github.com/lihei12345/3bc82ced45b267b1bc2c。

还有其它的OTA Distribution分发方式：TestFlight，HockeyApp。amazon S3，fir.im。蒲公英。FTP。邮件。只是因为fastlane眼下仅仅支持amazon s3的上传。其它上传方式必须使用 sh 运行命令。

直接在项目文件夹以下执行”fastlane ios alpha”。查看能否够执行成功而且上传到蒲公英上面。之后打开Jenkins的Job配置，更换我们之前暂时设置的脚本，更换为使用fastlane的脚本来进行构建就可以。

注意我们这里加入的有 “ensure_git_status_clean”，假设我们的gemfile和podfile不是最全面的，在执行Job的时候。执行”bundle install”或者”pod update”命令的时候就会对我们的文件进行改动。这样Jenkins就会报错，“Git repository is dirty! Please ensure the repo is in a clean state by commiting/stashing/discarding all changes first”。这个时候，我们仅仅须要执行一遍 “bundle install” 或者 “pod update”命令，然后把这些改动push到origin上就可以。

6. 实现不同类型的应用

能够參考wikipedia的fastlane脚本:  https://github.com/fastlane/examples/tree/master/Wikipedia，内部实现了无需多个证书就可以实现 beta/alpha版本号实现的方式研究，这部分在<Pro Continuous Integration>有具体说明，在”Multiple Versions of the Application”章节内。

參考资料:

• <Pro iOS Continuous Integration>
• https://medium.com/ribot-labs/continuous-integration-deployment-for-ios-projects-7358b72ca2e9 (翻译:http://www.jianshu.com/p/9ae446d76271)，对于CI的各个方面覆盖很全面，能够參考这个拓展CI的使用
• http://youandthegang.com/2015/continuous-integration-delivery-with-jenkins/
• http://9elements.com/io/index.php/continuous-integration-of-ios-projects-using-jenkins-cocoapods-and-kiwi/
• jenkins + 蒲公英: http://answerhuang.duapp.com/index.php/2015/04/19/jenkins/
• http://williamzang.com/blog/2014/07/23/shi-yong-jenkins-plus-calabash-plus-cocoapodsda-jian-ioschi-xu-ji-cheng-huan-jing/
• https://github.com/artsy/eigen
• http://www.objc.io/issues/6-build-tools/travis-ci/
• dysm分析工具：http://answerhuang.duapp.com/index.php/2014/07/06/dsym_tool/
• <Xcode continuous integration guide>
• http://macminicolo.net/dayone
• http://savvyapps.com/blog/continuous-integration-ios-jenkins/

其它工具

1) PLCrashReport

2)  http://bugly.qq.com/

3)  https://try.crashlytics.com/

4)  http://bughd.com/

总结，搞了两天。最终把我困惑非常久却一直懒得弄的东西搞完了，从jenkins，shenzhen，fastlane以及单元測试了解一遍等。深深感觉能够极大简化我们的工作复杂度。同一时候还有其它一些非常酷的特性，比方说HipChat/Slack这种IM的构建通知，以及github/gitlab/bitbucket的hook等等。snapshot，覆盖測试，上传appstore。可惜我眼下并没有应用场景，也就不再继续学习了。以后有须要再来学习使用。