官网：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
网友评论