使用 Fastlane 实现 IOS 持续集成
Posted On1Key
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了使用 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 ([email protected].com): [email protected].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 "[email protected]" for_lane :inhouse do app_identifier "com.everettjf.fastlanedemoqiye" apple_id "[email protected]" 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
0
3.?编写shell脚本
- sudo gem install shenzhen
1
- sudo gem install shenzhen
2
我们传入主版本号和一个自增的id(一般是jenkins的build number)。
配置Jenkins
有了能一键编译的脚本,让Jenkins在获取代码后,调用build.sh就可以了。
安装
- sudo gem install shenzhen
3
配置获取代码,获取代码后调用shell:
- sudo gem install shenzhen
4
苹果开发者证书配置
假设我们有两个开发者账号,一个是标准开发者账户(99刀,个人或公司),一个是企业账户(299刀)。 - 标准开发者账户:[email protected]
- sudo gem install shenzhen
5
企业账户:[email protected]
- sudo gem install shenzhen
6
相关文档
- 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 持续集成的主要内容,如果未能解决你的问题,请参考以下文章
iOS持续集成大比拼:Xcode ServerJenkinsTravis和fastlane