iOS可持续集成:Jenkins + fastlane + 蒲公英

说到持续集成,那么很多人就会问,什么是可持续集成?可持续集成可以为我们开发者做什么?

持续集成是一种软件开发实践:许多团队频繁地集成他们的工作,每位成员通常进行日常集成,进而每天会有多种集成。每个集成会由自动的构建(包括测试)来尽可能快地检测错误。许多团队发现这种方法可以显著的减少集成问题并且可以使团队开发更加快捷。

CI是一种开发实践。实践应该包含3个基本模块:

  • 自动构建、自动编译、自动分发、部署和测试;
  • 代码版本仓库(SVN或者Git);
  • 持续集成的服务器;

通过持续集成,可以让我们通过自动化等手段高频率地去获取产品反馈并响应反馈的过程。接下来是iOS可持续集成的实践。

安装fastlane

1. 查看Ruby版本,需要2.0及以上版本

$ ruby -v

2. 需要将gem的source改为:https://gems.ruby-china.com/

#查看gem的source
$ gem sources

*** CURRENT SOURCES ***

https://gems.ruby-china.com/

3. 检查Xcode命令行工具是否安装:

$ xcode-select --install

如果没有安装会进行安装。如果已经安装了则会提示:

xcode-select: error: command line tools are already installed, use "Software Update" to install updates

4. 安装fastlane:

$ sudo gem install fastlane --verbose

如果出现以下错误:

ERROR:  While executing gem ... (Gem::FilePermissionError) You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.

则在终端输入:

$ sudo gem install -n /usr/local/bin fastlane

检查是否安装正确:

$ fastlane --version

5. 安装插件

直接使用gem install貌似有问题,改用bundle安装:

bundle install --path vendor/bundle
# 版本号
bundle exec fastlane add_plugin versioning
# 蒲公英
bundle exec fastlane add_plugin pgyer

6. Fastlane配置

在工程目录下:

$ fastlane init

中间会让你输入苹果开发者账号的账号和密码,之后会在你项目工程的目录下生成一个fastlane文件夹,里面有Fastlane的配置文件,一个是Appfile文件,一个是Fastfile文件(如果要上传AppStore的话还有Deliverfile文件)。Appfile保存苹果开发者的相关信息、项目的相关信息等。Fastfile是运行脚本。
2.编辑Fastfile文件
有时候一天需要打好几个包,为了区分,我们这里实现一个递增build号的功能。
(1)修改项目工程配置
修改Build Settings中的Versioning配置,Current Project Version随便填一个,Versioning System选择Apple Generic。

image

(2)定义一个递增build号的函数,添加到Fastfile中

def updateProjectBuildNumber

currentTime = Time.new.strftime("%Y%m%d")
build = get_build_number()
if build.include?"#{currentTime}."
# => 为当天版本 计算迭代版本号
lastStr = build[build.length-2..build.length-1]
lastNum = lastStr.to_i
lastNum = lastNum + 1
lastStr = lastNum.to_s
if lastNum < 10
lastStr = lastStr.insert(0,"0")
end
build = "#{currentTime}.#{lastStr}"
else
# => 非当天版本 build 号重置
build = "#{currentTime}.01"
end
puts("*************| 更新build #{build} |*************")
# => 更改项目 build 号
increment_build_number(
build_number: "#{build}"
)
end

实现自动打包的完整Fastfile如下:

# 定义fastlane版本号
fastlane_version “2.46.1” 

# 定义打包平台
default_platform :ios

def updateProjectBuildNumber

currentTime = Time.new.strftime("%Y%m%d")
build = get_build_number()
if build.include?"#{currentTime}."
# => 为当天版本 计算迭代版本号
lastStr = build[build.length-2..build.length-1]
lastNum = lastStr.to_i
lastNum = lastNum + 1
lastStr = lastNum.to_s
if lastNum < 10
lastStr = lastStr.insert(0,"0")
end
build = "#{currentTime}.#{lastStr}"
else
# => 非当天版本 build 号重置
build = "#{currentTime}.01"
end
puts("*************| 更新build #{build} |*************")
# => 更改项目 build 号
increment_build_number(
build_number: "#{build}"
)
end

#指定项目的scheme名称
scheme=“TestCI”
#蒲公英api_key和user_key
api_key=“”
user_key=“”

# 任务脚本
platform :ios do
lane :development_build do|options|
branch = options[:branch]

puts “开始打development ipa”

updateProjectBuildNumber #更改项目build号

# 开始打包
gym(
#输出的ipa名称
output_name:”#{scheme}_#{get_build_number()}”,
# 是否清空以前的编译信息 true:是
clean:true,
# 指定打包方式,Release 或者 Debug
configuration:"Release",
# 指定打包所使用的输出方式,目前支持app-store, package, ad-hoc, enterprise, development
export_method:"development",
# 指定输出文件夹
output_directory:"./fastlane/build",
)

puts "开始上传蒲公英"
# 开始上传蒲公英
pgyer(api_key: “#{api_key}”, user_key: “#{user_key}”)

end
end

注意:蒲公英的 api_key 和 user_key,开发者在自己账号下的 账号设置-API信息 中可以找到。打其它类型的包的方法与development类似,可自定义一个新的lane实现。

在终端输入

fastlane development_build

便会进行自动打包并上传蒲公英了。

7. 双重认证

单独跑fastlane是没什么问题,就是提示需要双重认证(two factor)
因为使用的是Jenkins,只能执行脚本无法输入内容。

  1. 访问AppId管理网站,生成专用密码。

2. 我们需要用到 spaceship(可以访问Apple Developer Center和iTunes Connect API), 获取session:fastlane spaceauth -u abc@qq.com(APPID)

配置环境变量:

$ vim ~/.bash_profile
# App专用密码
export FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD=专用密码
# 
export FASTLANE_SESSION='YOUR SESSION'

session有过期时间,打包失败的时候记得去打包机更新一下

8. CodeSign

在执行fastlane打包脚本的时候会遇到代码签名的问题,不同Xcode版本貌似有区别,现在基本上应该都在9.0以上了,所以就按照9.0以上版本进行配置:

  • 使用match的情况:
    进入工程目录
$ fastlane match init

会要求你输入用来存放证书和描述文件的git仓库地址:

fastlane match supports multiple storage modes, please select the one you want to use:
1. git
2. google_cloud

这里选择1,

[14:59:31]: Please create a new, private git repository to store the certificates and profiles there
[14:59:31]: URL of the Git Repo:

输入git仓库URL地址,,之后会在fastlane文件夹下生成一个MatchFile。
修改FastFile文件:

# 添加 match 
 match(type: "development") #type can be: appstore, adhoc, enterprise or development
  • 不适用match的情况,需要在gym函数中添加export_options参数,将bundleid和provisioningProfiles映射起来:
gym(
      clean: true, 
      configuration: "Debug", 
      scheme: "Rain", 
      export_method: "development", 
      output_directory:"./fastlane/build",
      export_options: {
         provisioningProfiles: {
            "com.passion.raining" => "Development_com.passion.raining.mobileprovision"
         }
       }
      )

重置证书:

# development, distribution and enterprise
$ fastlane match nuke distribution

持续化集成工具——Jenkins

Jenkins 是一个开源项目,提供了一种易于使用的持续集成系统,使开发者从繁杂的集成中解脱出来,专注于更为重要的业务逻辑实现上。同时 Jenkins 能实施监控集成中存在的错误,提供详细的日志文件和提醒功能,还能用图表的形式形象地展示项目构建的趋势和稳定性。

安装Jenkins

安装过程如下:
1.点击 http://mirrors.jenkins.io/war-stable/latest/jenkins.war 下载最新的Jenkins.war,也可以从官网https://jenkins.io/ 上下载最新的pkg安装包进行安装。

2.打开终端,进入war包所在目录,执行以下命令:

java -jar jenkins.war

注意:Jenkins依赖于Java运行环境,因此需要首先安装JDK,下载地址:http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

3.执行完成之后打开浏览器输入http://localhost:8080/

4.弹出Jenkins安装界面,会让你输入安全密码,输入完成之后选择默认安装。

5.新建管理员账号密码

对以上过程有疑问的话可以参考手把手教你利用Jenkins持续集成iOS项目

安装插件

还是登录http://localhost:8080/ ,选择系统管理 - 管理插件。

安装GitLab插件
在可选插件中选择GitLab Plugin和Gitlab Hook Plugin进行安装。

安装Xcode插件
在可选插件中选择Xcode integration进行安装。

安装完成之后,我们就可以配置构建项目了。

构建任务

1.点击新建,输入名称,构建一个自由风格的软件项目

image

2.配置Git

image

添加Git仓库地址,可以是HTTP也可以是SSH。点击Add

如果是HTTP

image

如果是SSH

image

注意:UserName是取一个名字,填写的Key是私钥。

3.配置脚本

image

因为我的Git仓库的目录是这样的

image

所以在执行fastlane development_build之前需要进入TestCI目录,即fastlane文件夹所在目录。

4.添加完成之后点击立即构建

image

5.执行成功显示如下

image

可以点击进入查看控制台输出

image

参考链接

https://www.jianshu.com/p/0a113f754c09
https://www.jianshu.com/p/41ecb06ae95f
https://mp.weixin.qq.com/s/4I9lHEf5TvwwGtVPTjKFUw

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,108评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,699评论 1 296
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,812评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,236评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,583评论 3 288
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,739评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,957评论 2 315
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,704评论 0 204
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,447评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,643评论 2 249
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,133评论 1 261
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,486评论 3 256
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,151评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,108评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,889评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,782评论 2 277
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,681评论 2 272

推荐阅读更多精彩内容