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:


iOS持续构建环境搭建


iOS持续构建环境搭建


 保存.certSigningRequest 文件。

2)创建证书

登录Apple开发者网站,创建证书(期间需要上传上一步生成的.certSigningRequest 文件):


iOS持续构建环境搭建
 

3)导入证书

下载上一步生成的证书到Mac中,双机证书,证书打开时会启动“钥匙串访问”工具:


iOS持续构建环境搭建
 

4)下载profile

打开Xcode——>Preferences...,登录开发者账号,选中相应Team,View Details...:


iOS持续构建环境搭建
 点击相应签名后面的“Reset”按钮,将对应的Profile下载到本地(下载完只会Reset按钮将消失,如下图):


iOS持续构建环境搭建

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路径:


iOS持续构建环境搭建
 

4)配置证书

系统管理——>Keychains and Provisioning Profiles Management,分别上传~/Library/Keychains/login.keychain,~/Library/MobileDevice/Provisioning Profiles/前面下载到本地的对应profile文件,

并填写证书名称(在钥匙串访问中右击证书“显示简介”,把常用名称复制下来):


iOS持续构建环境搭建
 

5)任务配置

新建一个自由风格的Jenkins任务,配置Git等项。继而进行以下配置:

a、证书选择

选中Keychain and Code Signing Identities,选择相应的keychain(其它项保存后会自动更新),如下图;

选中Mobile Provisioning Profiles,选择想过要的Profile(其它项保存后会自动更新),如下图


iOS持续构建环境搭建
 

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打包不选中,后续通过命令行实现),


iOS持续构建环境搭建
 配置证书和keychain,


iOS持续构建环境搭建
 高级选型,注意通过Cocoapods依赖必须指定Workspace File文件,


iOS持续构建环境搭建
 

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

ios

相关推荐