iOS持续构建环境搭建
目录:
一、说明
二、环境信息
三、搭建步骤
1、配置apple证书
1)创建Certificate Signing Request
2)创建证书
3)导入证书
4)下载profile
2、安装Cocoapods
1)更换RubyGems源
2)安装cocoapods
3、Jenkins
1)安装Jenkins
2)安装Jenkins插件
3)环境变量
4)配置证书
5)任务配置
a、证书选择
b、依赖包更新
c、Xcode编译
d、Xcode打包
四、遇到问题
五、参考资料
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
一、说明
该环境的搭建主要是为实现iOS app的自动化打包,无需人工参与。在该环境基础上,可集成SonarQube代码质量检测、单元测试等。
产出物:ipa
本文重点在于iOS相关配置说明,不对基础环境进行介绍。
二、环境信息
系统:Mac OS X 10.10.5
Xcode:7.2
Ruby:2.2.1
RubyGems: 2.4.8
JDK:1.7.0_79
Jenkins:1.636
Cocoapods:0.37.2
三、搭建步骤
1、配置apple证书
1)创建Certificate Signing Request
通过Mac中的“钥匙串访问”创建Certificate Signing Request:
保存.certSigningRequest 文件。
2)创建证书
登录Apple开发者网站,创建证书(期间需要上传上一步生成的.certSigningRequest 文件):
3)导入证书
下载上一步生成的证书到Mac中,双机证书,证书打开时会启动“钥匙串访问”工具:
4)下载profile
打开Xcode——>Preferences...,登录开发者账号,选中相应Team,View Details...:
点击相应签名后面的“Reset”按钮,将对应的Profile下载到本地(下载完只会Reset按钮将消失,如下图):
2、安装Cocoapods
1)更换RubyGems源
$ gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/
查看是否更换成功:
$ gem sources -l
2)安装cocoapods
由于项目需求,本次搭建cocoapods使用0.37.2版本:
$ sudo gem install cocoapods -v 0.37.2 $ pod setup
setup过程会非常缓慢,可通过以下命令查看是否有进度(文件大小是否增长):
$ cd ~/.cocoapods/repos $ du -sh *
3、Jenkins
1)安装Jenkins
使用 homebrew 安装 Jenkins:
$ brew install jenkins
然后链接 launchd 配置文件:
$ ln -sfv /usr/local/opt/jenkins/*.plist ~/Library/LaunchAgents
修改完后,在终端执行:
$ launchctl load ~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist
即可启动 Jenkins。
接着用浏览器访问 http://localhost:8080(默认配置),就可以看到 Jenkins 的 web 界面了。
2)安装Jenkins插件
- Git plugin(Git集成,拉取代码)
- Xcode integation(Xcode集成,编译打包)
- Keychains and Provisioning Profiles Management(证书集成)
3)环境变量
系统设置——>全局属性,勾选Environment variables,新增键值对,配置ruby路径:
4)配置证书
系统管理——>Keychains and Provisioning Profiles Management,分别上传~/Library/Keychains/login.keychain,~/Library/MobileDevice/Provisioning Profiles/前面下载到本地的对应profile文件,
并填写证书名称(在钥匙串访问中右击证书“显示简介”,把常用名称复制下来):
5)任务配置
新建一个自由风格的Jenkins任务,配置Git等项。继而进行以下配置:
a、证书选择
选中Keychain and Code Signing Identities,选择相应的keychain(其它项保存后会自动更新),如下图;
选中Mobile Provisioning Profiles,选择想过要的Profile(其它项保存后会自动更新),如下图
b、依赖包更新
此步骤不通过Cocoapods插件实现,直接通过命令处理。增加构建步骤——Execute shell,添加以下代码:
export LC_ALL="en_US.UTF-8" cd ${WORKSPACE}/xxx/ pod install --verbose --no-repo-update pod update --verbose --no-repo-update
c、Xcode编译
增加构建步骤——Xcode,如下配置:
Configuration可选择Debug或Release(其中ipa打包不选中,后续通过命令行实现),
配置证书和keychain,
高级选型,注意通过Cocoapods依赖必须指定Workspace File文件,
d、Xcode打包
此步骤不通过Xcode插件实现,直接通过命令处理。增加构建步骤——Execute shell,添加以下代码(其中${BUILD_ID}为本次构建ID):
rm -fr ${WORKSPACE}/build/*ipa xcrun -sdk iphoneos PackageApplication -v ${WORKSPACE}/build/Release-iphoneos/xxx.app -o ${WORKSPACE}/build/xxx-${BUILD_ID}.ipa
四、遇到问题
1、直接拉取代码之后,命令行找不到scheme问题处理
详见:http://sailqi.iteye.com/admin/blogs/2283188
2、使用Xcode插件打包失败
Xcode插件选中ipa打包之后,会自动把sign参数加上(暂不知道如何去掉),导致失败,通过直接用命令行打包解决该问题。
五、参考资料
如何在Mac OS X上安装 Ruby运行环境:http://www.cnblogs.com/daguo/p/4097263.html
最新版 CocoaPods 的安装流程:http://www.tuicool.com/articles/7VvuAr3
Cocoapods降低版本及卸载:http://www.meetrue.com/archives/133
在Mac mini上架设Jenkins服务器来运行iOS测试:http://linjunpop.logdown.com/posts/162202-set-up-jenkins-server-on-the-mac-mini-to-run-ios-tests
Jenkins整合XCode详解:http://www.pluto-y.com/jenkins-xcode-configuration/
一步一步构建iOS持续集成:Jenkins+GitLab+蒲公英+FTP:http://www.jianshu.com/p/c69deb29720d
Keychains and Provisioning Profiles Plugin官方配置文档:https://wiki.jenkins-ci.org/display/JENKINS/Keychains+and+Provisioning+Profiles+Plugin