使用 Fastlane 实现 IOS 持续集成

简介

持续集成是个“一次配置长期受益”的工作。但很多小公司都没有。以前在做Windows开发配置感觉简单一些，这次配置iOS的，感觉步骤还挺多。整理出来，分享给大家，不正确的地方请及时指正。

本文主要使用fastlane配置iOS的持续集成，自动编译、打包出多个版本。

最近转行iOS开发，首要任务是使用Jenkins（算是hudson的兄弟）配置iOS工程的持续集成。查找各种资料后，整理出以下几个关键词。

jenkins搭建。

使用fastlane中提供的工具修改工程配置。

gym 或 ipa 工具编译工程。

目标

配置一台电脑自动获取代码，并定时打包出以下版本的ipa文件。

内部测试版本：使用标准开发者的Developer证书签名的ipa文件。
公开测试版本：使用企业账户的Distribute InHouse证书签名的ipa文件。
AppStore版本：使用标准开发者的AppStore证书签名的ipa文件。
渠道版本：内部测试版本，但Info.plist中增加每个渠道的标示符（因为渠道例如fir.im会使用自己的证书重新签名ipa，因此侧部测试版本就可以）

保留每个版本的dSYM调试符号文件。

源代码

https://github.com/everettjf/ios_ci_fastlane_demo

安装

fastlane和shenzhen都需要gem安装，把gem更换为淘宝源。

安装fastlane

sudo gem install fastlane

fastlane是ruby编写，使用gem安装。
https://fastlane.tools/

安装shenzhen

sudo gem install shenzhen

如果只使用了gym命令，而不使用ipa命令，可以不安装。
https://github.com/nomad/shenzhen

示例步骤

在xcodeproj文件同级目录下，执行

fastlane init

fastlane 很强大，甚至能自动截图，自动提交AppStore审核，不过我只用最简单的打包功能。这里会有一系列提问。

* Do you want to get started...? y * Do you have everything commited... ? y * App Identifier (com.krausefx.app): com.everettjf.fastlanedemo * Your Apple ID (fastlane@krausefx.com): xxxxxxxx@xxxx.com * ... updates to the App Store or Apple TestFlight? (y/n) n * Do you want to setup 'snapshot'... n * Do you want to use 'sigh'... n （是否自动下载provisioning文件） * The scheme name of your app: fastlanetest （如果就一个工程，也可不输入）

上面有一步要输入AppleID，是因为fastlane（的一个工具sigh，这个字母是H）会自动下载对应的provisioning文件。自动下载provisioning文件，对于经常增加测试设备的Developer证书挺方便。不过，示例就不自动下载了。

执行完成后，会在工程目录下生成fastlane文件夹。

drwxr-xr-x 5 everettjf staff 170B Sep 8 22:32 fastlane drwxr-xr-x 10 everettjf staff 340B Sep 8 22:00 fastlanedemo drwxr-xr-x 5 everettjf staff 170B Sep 8 22:38 fastlanedemo.xcodeproj drwxr-xr-x 4 everettjf staff 136B Sep 8 22:00 fastlanedemoTests

我们需要修改fastlane文件夹的两个配置文件：Appfile和Fastfile。（实际是ruby代码）

1. 修改Appfile

app_identifier "com.everettjf.fastlanedemo" apple_id "aaa@aaa.com" for_lane :inhouse do app_identifier "com.everettjf.fastlanedemoqiye" apple_id "bbb@bbb.com" end

企业InHouse版本与AppStore的app_identifier、apple_id不同。这里for_lane 就是为后面Fastfile中定义的:inhouse版本设置单独的信息。

2. 修改Fastfile

这个文件中要编写每个版本的编译和打包代码（Developer版本、AppStore版本、InHouse版本、多个渠道版本），每个版本要经过以下几个步骤： - 修改版本号和build号（修改为外部传入的版本，例如：1.0.0和100）

def prepare_version(options) #say 'version number:' #say options[:version] increment_version_number( version_number: options[:version], xcodeproj: PROJECT_FILE_PATH, ) #say 'build number:' #say options[:build] increment_build_number( build_number: options[:build], xcodeproj: PROJECT_FILE_PATH, ) end

修改app identifier（就是bundle id，例如：com.everettjf.fastlanedemo）

def update_app_identifier(app_id) update_info_plist( xcodeproj:PROJECT_FILE_PATH , app_identifier:app_id, plist_path:"#{PLIST_FILE_PATH}" ) update_info_plist( xcodeproj:PROJECT_FILE_PATH , app_identifier:app_id, plist_path:"#{UNITTEST_PLIST_FILE_PATH}" ) end

修改签名的配置，配置对应的provision file

def update_provision(typePrefix) update_project_provisioning( xcodeproj:PROJECT_FILE_PATH , profile:"./fastlane/provision/#{typePrefix}.mobileprovision", ) end

渠道版本修改Info.plist文件中对应的字符串

def set_info_plist_value(path,key,value) sh "/usr/libexec/PlistBuddy -c /"set :#{key} #{value}/" #{path}" end def set_channel_id(channelId) set_info_plist_value( "./../fastlanedemo/#{PLIST_FILE_PATH}", 'ChannelID', "#{channelId}" ) end

编译打包为ipa

这步使用了工具shenzhen，也可以使用fastlane推荐的gym。

sudo gem install shenzhen

3.?编写shell脚本

sudo gem install shenzhen

sudo gem install shenzhen

我们传入主版本号和一个自增的id（一般是jenkins的build number）。

配置Jenkins

有了能一键编译的脚本，让Jenkins在获取代码后，调用build.sh就可以了。

安装

sudo gem install shenzhen

配置获取代码，获取代码后调用shell：

sudo gem install shenzhen

苹果开发者证书配置

假设我们有两个开发者账号，一个是标准开发者账户（99刀，个人或公司），一个是企业账户（299刀）。 - 标准开发者账户：aaa@aaa.com

sudo gem install shenzhen

企业账户：bbb@bbb.com

sudo gem install shenzhen

相关文档

fastlane：https://github.com/KrauseFx/fastlane/tree/master/docs
shenzhen : https://github.com/nomad/shenzhen

其他途径

Jenkins的xcode插件：Jenkins有个xcode插件，网上有些文章，不过自己没有使用。不知道能否动态的更换证书。
一次编译多次签名：在没有使用fastlane之前，看到fastlane提供了一套工具集，就使用gym先编译一个Developer证书签名的ipa，之后使用其他证书分别签名。

重要补充

安装jenkins的机器上的Xcode要导入开发者账户（存在私钥的账户信息，通过首次创建证书的电脑上的Xcode导出）

文章首次发布于：everettjf.github.io

链接：

使用 Fastlane 实现 IOS 持续集成

巴特西

使用 Fastlane 实现 IOS 持续集成

最新文章

热门文章