http://www.cocoachina.com/ios/20150916/13433.html
简介
持续集成是个“一次配置长期受益”的工作。但很多小公司都没有。以前在做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，因此侧部测试版本就可以）PS: 2015年11月24日补充，fir.im 不会重新签名ipa。
- 保留每个版本的dSYM调试符号文件。
源代码
https://github.com/everettjf/ios_ci_fastlane_demo
安装
fastlane和shenzhen都需要gem安装，把gem更换为淘宝源。
安装fastlane
1
|
sudo gem install fastlane
|
安装shenzhen
1
|
sudo gem install shenzhen
|
示例步骤
在xcodeproj文件同级目录下，执行
fastlane 很强大，甚至能自动截图，自动提交AppStore审核，不过我只用最简单的打包功能。 这里会有一系列提问。
1
2
3
4
5
6
7
8
|
* 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]): [email protected]
* ... 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文件夹。
1
2
3
4
|
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
1
2
3
4
5
6
7
|
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）
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
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）
1
2
3
4
5
6
7
8
9
10
11
12
|
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
1
2
3
4
5
6
|
def update_provision(typePrefix)
update_project_provisioning(
xcodeproj:PROJECT_FILE_PATH ,
profile:"./fastlane/provision/#{typePrefix}.mobileprovision",
)
end
|
- 渠道版本修改Info.plist文件中对应的字符串
1
2
3
4
5
6
7
8
9
10
|
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
|
这步使用了工具shenzhen，也可以使用fastlane推荐的gym。
1
2
3
4
5
6
7
8
9
10
11
12
13
|
def generate_ipa(typePrefix,options)
#say ‘generate ipa‘
fullVersion = options[:version] + ‘.‘ + options[:build]
channelId = options[:channel_id]
ipa(
configuration:"Release",
scheme:"#{SCHEME_NAME}",
destination:"./build",
ipa:"#{APP_NAME}_#{fullVersion}_#{typePrefix}.ipa",
archive:false
)
sh "mv ./../build/#{APP_NAME}.app.dSYM.zip ./../build/#{APP_NAME}_#{fullVersion}_#{typePrefix}.app.dSYM.zip"
end
|
3.?编写shell脚本
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
#!/bin/sh
#
# usage:
# > sh build.sh 1.0.0 200
#
versionNumber=$1 # 1.0.0
buildNumber=$2 # 2000
rm -rf build
basicLanes="AdHoc AppStore Develop InHouse"
for laneName in $basicLanes
do
fastlane $laneName version:$versionNumber build:$buildNumber
done
channelIds="fir 91"
for channelId in $channelIds
do
fastlane Channel version:$versionNumber build:$buildNumber channel_id:$channelId
done
|
我们传入主版本号和一个自增的id（一般是jenkins的build number）。
配置Jenkins
有了能一键编译的脚本，让Jenkins在获取代码后，调用build.sh就可以了。
安装
配置获取代码，获取代码后调用shell：
1
|
sh build.sh 1.0.0 ${BUILD_NUMBER}
|
苹果开发者证书配置
假设我们有两个开发者账号，一个是标准开发者账户（99刀，个人或公司），一个是企业账户（299刀）。 - 标准开发者账户：[email protected]
1
2
|
Identifier中增加com.everettjf.fastlanedemo
Provisioning Profiles中增加一个 iOS Distribution(AdHoc 和 AppStore) 和 iOS Development
|
企业账户：[email protected]
1
2
|
Identifier中增加com.everettjf.fastlanedemoqiye
Provisioning Profiles中增加一个 iOS Distribution(AdInHouse)
|
相关文档
其他途径
- Jenkins的xcode插件：Jenkins有个xcode插件，网上有些文章，不过自己没有使用。不知道能否 动态的更换证书。
- 一次编译多次签名：在没有使用fastlane之前，看到fastlane提供了一套工具集，就使用gym先编译 一个Developer证书签名的ipa，之后使用其他证书分别签名。
重要补充
- 安装jenkins的机器上的Xcode要导入开发者账户（存在私钥的账户信息，通过首次创建证书的电脑上的Xcode导出）
文章首次发布于：everettjf.github.io
时间： 2024-10-10 19:08:20
