使用fastlane自动化打包测试发布

96
逗留
2017.08.31 09:11* 字数 1273

官网:https://docs.fastlane.tools

参考文章:https://www.raywenderlich.com/136168/fastlane-tutorial-getting-started-2

http://www.jianshu.com/p/edcd8d9430f6

http://www.cocoachina.com/ios/20170519/19317.html?utm_source=tuicool&utm_medium=referral

注:

如果要使用最新版本,建议使用rvm来管理ruby

在使用sudo gem install fastlane命令安装时,如果报以下错误

ERROR:  While executing gem ... (Errno::EPERM)

Operation not permitted - /usr/bin/xcodeproj

可以修改命令sudo gem install -n /usr/local/bin fastlane

如果fastlane加载缓慢,可以尝试gem cleanup


fastlane工具:

除fastlane命令,你还可以访问以下fastlane工具

deliver: 上传截图, 元数据, app应用程序到App Store

supply: 上传Android app应用程序和元数据到Google Play

snapshot: 自动捕获iOS app应用程序本地截图

screengrab: 自动捕获Android app应用程序本地截图

frameit: 快速截屏并将截屏放入设备中

pem: 自动生成和更新推送通知配置文件

sigh: 开发证书和描述文件下载

produce: 使用命令行在iTunes Connect上创建新的app和开发入口

cert: 自动创建和配置iOS代码签名证书

spaceship: Ruby 库访问 Apple开发者中心和 iTunes Connect

pilot: 最好的方式管理你的TestFlight 测试人员和从终端构建

boarding: 最简单的方式邀请你的TestFlight beta测试人员

gym: iOS app打包签名自动化工具

match: 使用Git同步你的团队证书和配置文件

scan: 最简单方式测试你的 iOS 和 Mac apps


使用方式,以iOS为例:

cd 到项目根目录

fastlane init

根据提示填写信息(有可能提示错误)

然后会看到生成一个fastlane文件夹,文件夹中会有Appfile,Fastfile等文件

Appfile

Appfile用来存放app_identifier,apple_id和team_id。 它的格式是这样的:

app_identifier "com.xxx.xxx" # app的bundle identifier

apple_id "xxx@xxx.com" # 你的Apple ID

team_id "XXXXXXXXXX" # Team ID

···

你也可以为每个lane(后面会讲到)提供不同的 app_identifier, apple_id 和 team_id,例如:

app_identifier "com.aaa.aaa"

apple_id "aaa@aaa.com"

team_id "AAAAAAAAAA"

for_lane :inhouse do

app_identifier "com.bbb.bbb"

apple_id "bbb@bbb.com"

team_id "AAAAAAAAAA"

end

这里就是为Fastfile中定义的:inhouse设置单独的信息。

Fastfile

Fastfile管理你所创建的 lane 。它的格式是这样的:

···

# 自动更新fastlane 工具

# update_fastlane

#需要的fastlane的最小版本,在每次执行之后会检查是否有新版本,如果有会在最后末尾追加新版本提醒

fastlane_version "2.30.1"

#默认使用平台是 ios,也就是说文件可以定义多个平台

default_platform :ios

platform :ios do

before_all do

# ENV["SLACK_URL"] = "https://hooks.slack.com/services/..."

cocoapods

end

desc "Runs all the tests"

lane :test do

scan

end

desc "提交一个新的Beta版本到 Apple TestFlight"

desc "This will also make sure the profile is up to date"

lane :beta do

# match(type: "appstore") # more information: https://codesigning.guide

gym(scheme: "Docment") # Build your app - more options available

pilot

# sh "your_script.sh"

end

desc "部署一个新版本到App Store"

lane :release do

# match(type: "appstore")

# snapshot

gym(scheme: "Docment") # Build your app - more options available

deliver(force: true)

# frameit

end

# 你可以定义自己的lane

#执行lane成功后的回调

after_all do |lane|

# slack(

#   message: "Successfully deployed new App Update."

# )

end

# 如果流程发生异常会走这里并终止

error do |lane, exception|

# slack(

#   message: exception.message,

#   success: false

# )

end

end

我们也可以定义一个自己的lane:

desc "企业版"

lane :inHouse do

gym(scheme: "XXX",

export_method:"enterprise",

output_directory "./build", # 打包后的 ipa 文件存放的目录

output_name "XXX"  # ipa 文件名

)

end


在调用fastlane 【管道】是后面可以传递参数,一可以自定义action,参考http://www.jianshu.com/p/538cabdf2193

比如可以在Fastfile中定义一个函数来处理接收到的参数

def prepare_version(options)

increment_version_number(

version_number: options[:version]

)

increment_build_number(

build_number: options[:build]

)

end

然后在某个lane中使用它

lane :appstore do |options|

···

prepare_version(options)

···

end

然后执行这个lane的时候:

fastlane appstore version:2.4.0 build:2.0


另外,lane之间是可以相互调用的,就像函数间的调用一样,比如在调用appstore的时候,可以在里面调用test的lane

lane :appstore

test

···

end


fastlane的基本使用就是这样,在使用过程中,有几个常用的action

gym:打包签名自动化工具,fastlane中包含了gym,详情:https://fastlane.tools/gym,以前又个shenzhen的东西,gym是用来代替它的

你可以使用gym的action,但是每次需要传递参数

gym(scheme:"MyApp",workspace:"MyApp.xcworkspace")

也可以创建一个Gymfile来保存这些配置,新建一个Gymfile,使用命令fastlane gym init,这个文件中如何填写,可以参考https://fastlane.tools/gym,https://docs.fastlane.tools/actions/

scheme"Example"

clean true 

output_directory"./build"#store the ipa in this folder

output_name"MyApp"#the name of the ipa file

export_options(

method:"app-store",

provisioningProfiles:{

"com.example.bundleid":"Provisioning Profile Name",

"com.example.bundleid2":"Provisioning Profile Name 2" 

}

)

当然也可以使用自定义action的方式,来提供默认gym配置,自定义action,参考http://www.jianshu.com/p/538cabdf2193

日记本