Fastlane是一套使用Ruby写的自动化工具集,用于iOS和Android的自动化打包、发布等工作,可以节省大量的时间。
Fastlane
Github:https://github.com/fastlane/fastlane
官网:https://fastlane.tools/
文档:https://docs.fastlane.tools/
在写这篇文章的时候,他在Github上已经有15000+ star。
安装
1、首先要安装正确的 Ruby 版本。在终端窗口中用下列命令来确认:
ruby -v
2、然后检查 Xcode 命令行工具是否安装。在终端窗口中输入命令:
xcode-select --install
如果未安装,终端会开始安装,如果报错误:
command line tools are already installed, use "Software Update" to install updates.代表已经安装。
3、以上依赖配置好之后就可以通过 rubygem 进行安装了:
$ sudo gem install fastlane
安心等待一会,fastlane就安装完成了。
初始化
打开终端,cd到你的工程目录,然后执行fastlane init:
$ cd to/your/ios/project $ fastlane init[14:21:43]: Detected iOS/Mac projectincurrent directory...[14:21:43]: This setup will help you get upandrunninginno time.[14:21:43]: fastlane will check what tools you're already using and set up
[14:21:43]: the tool automatically for you. Have fun!
[14:21:43]: Created new folder './fastlane'.
[14:21:43]: $ xcodebuild -showBuildSettings -project ./xxx.xcodeproj
[14:21:48]: Your Apple ID (e.g. [email protected]): [email protected]
[14:21:54]: Verifying that app is available on the Apple Developer Portal and iTunes Connect...
[14:21:54]: Starting login with user '[email protected]'
+----------------+--------------------------------------+
| Detected Values |
+----------------+--------------------------------------+
| Apple ID | [email protected] |
| App Name | xxx |
| App Identifier | com.xxx.xxx |
| Project | /Users/lisong/Desktop/xxx/x |
| | xx.xcodeproj |
+----------------+--------------------------------------+
[14:22:06]: Please confirm the above values (y/n)
y
[14:22:09]: Created new file './fastlane/Appfile'. Edit it to manage your preferred app metadata information.
[14:22:09]: Loading up 'deliver', this might take a few seconds
[14:22:09]: Login to iTunes Connect ([email protected])
[14:22:13]: Login successful
+-----------------------+------------------------+
| deliver 2.30.1 Summary |
+-----------------------+------------------------+
| screenshots_path | ./fastlane/screenshots |
| metadata_path | ./fastlane/metadata |
| username | [email protected] |
| app_identifier | com.xxx.xxx |
| edit_live | false |
| platform | ios |
| skip_binary_upload | false |
| skip_screenshots | false |
| skip_metadata | false |
| force | false |
| submit_for_review | false |
| automatic_release | false |
| dev_portal_team_id | WKR87TTKML |
| overwrite_screenshots | false |
+-----------------------+------------------------+
[14:22:21]: Writing to 'fastlane/metadata/zh-Hans/description.txt'
...
[14:22:21]: Writing to 'fastlane/metadata/review_information/notes.txt'
[14:22:21]: Successfully created new configuration files.
[14:22:22]: Successfully downloaded large app icon
[14:22:22]: Downloading all existing screenshots...
[14:22:27]: Downloading existing screenshot '1_iphone4_1.1.jpg' for language 'zh-Hans'
···
[14:22:34]: Downloading existing screenshot '5_iphone6_5.5.jpg' for language 'zh-Hans'
[14:22:34]: Successfully downloaded all existing screenshots
[14:22:34]: Successfully created new Deliverfile at path 'fastlane/Deliverfile'
[14:22:34]: $ xcodebuild -list -project ./xxx.xcodeproj
[14:22:35]: 'snapshot' not enabled.
[14:22:35]: 'cocoapods' enabled.
[14:22:35]: 'carthage' not enabled.
[14:22:35]: Created new file './fastlane/Fastfile'. Edit it to manage your own deployment lanes.
[14:22:35]: fastlane will collect the number of errors for each action to detect integration issues
[14:22:35]: No sensitive/private information will be uploaded
[14:22:35]: Learn more at https://github.com/fastlane/fastlane#metrics
[14:22:35]: Successfully finished setting up fastlane
在 "Your Apple ID" 这一步输入苹果开发者账号。在“Please confirm the above values”这一步,确认信息,没问题输入 y。然后,fastlane 会进行一系列的初始化操作,包括下载 App Store 上的元数据和截屏文件。
等待初始化完成之后,工程目录下就多了一个 fastlane目录,其内容如下:
fastlane目录
咱们来看两个主要的,Appfile和Fastfile。
Appfile
Appfile用来存放app_identifier,apple_id和team_id。了解详情,它的格式是这样的:
app_identifier"com.xxx.xxx"# app的bundle identifierapple_id"[email protected]"# 你的Apple IDteam_id"XXXXXXXXXX"# Team ID···
你也可以为每个lane(后面会讲到)提供不同的app_identifier,apple_id和team_id,例如:
app_identifier"com.aaa.aaa"apple_id"[email protected]"team_id"AAAAAAAAAA"for_lane:inhousedoapp_identifier"com.bbb.bbb"apple_id"[email protected]"team_id"AAAAAAAAAA"end
这里就是为Fastfile中定义的:inhouse设置单独的信息。
Fastfile
Fastfile管理你所创建的 lane,了解详情。它的格式是这样的:
···# 自动更新fastlane 工具# update_fastlane#需要的fastlane的最小版本,在每次执行之后会检查是否有新版本,如果有会在最后末尾追加新版本提醒fastlane_version"2.30.1"#默认使用平台是 ios,也就是说文件可以定义多个平台default_platform:iosplatform:iosdobefore_alldo# ENV["SLACK_URL"] = "https://hooks.slack.com/services/..."cocoapodsenddesc"Runs all the tests"lane:testdoscanenddesc"提交一个新的Beta版本到 Apple TestFlight"desc"This will also make sure the profile is up to date"lane:betado# match(type: "appstore") # more information: https://codesigning.guidegym(scheme:"Docment")# Build your app - more options availablepilot# sh "your_script.sh"enddesc"部署一个新版本到App Store"lane:releasedo# match(type: "appstore")# snapshotgym(scheme:"Docment")# Build your app - more options availabledeliver(force:true)# frameitend# 你可以定义自己的lane#执行lane成功后的回调after_alldo|lane|# slack(# message: "Successfully deployed new App Update."# )end# 如果流程发生异常会走这里并终止errordo|lane, exception|# slack(# message: exception.message,# success: false# )endend
我们也可以定义一个自己的lane:
desc"企业版"lane:inHousedogym(scheme:"XXX",export_method:"enterprise",output_directory:"./build",# 打包后的 ipa 文件存放的目录output_name:"XXX.ipa"# ipa 文件名)end
其中一个lane就是一个任务,里面是一个个的action组成的工作流。
利用目前支持的工具可以做所有包含自动化和可持续化构建的每个环节,例如:
scan自动化测试工具,很好的封装了 UnitTest
sigh针对于 iOS 项目开发证书和 Provision file 的下载工具
match同步团队每个人的证书和 Provision file 的超赞工具
gym针对于 iOS 编译打包生成 ipa 文件
deliver用于上传应用的二进制代码,应用截屏和元数据到 App Store
snapshot可以自动化iOS应用在每个设备上的本地化截屏过程
执行
定义完lane之后怎么执行呢?打开终端,切换到项目的根目录:执行fastlane lane'name就可以了。成功之后会在相应的路径下生成ipa文件,如果报错的话就根据错误信息好好查看文档。
其他
1、这里是官方提供的一些例子。
2、想了解fastlane命令的话可以执行$ fastlane --help
3、查看可用任务的列表,可以执行命令$ fastlane lanes
4、fastlane也提供了很多插件方便我们使用,例如pgyer(发布app到蒲公英)。我们也可以打完包直接传到蒲公英上,具体的可以看蒲公英提供的文档。
如果你感觉有些插件不符合自己的情况,你甚至可以自定义插件
5、多个 lane 的话实际上是可以相互调用的,这个其实特别实用。例如:
default_platform:iosplatform:iosdolane:preparedococoapods matchenddesc'fastlane build''fastlane build type:adhoc'lane:builddo|options|# 调用上面的 prepare 任务preparecaseoptions[:type]when'adhoc'adhocelseappstoreendendlane : adhocdo···endlane : appstoredo···endend
6、我们可以在 Fastfile 文件中添加一个函数来设置version号和build号。
default_platform:iosdefprepare_version(options)increment_version_number(version_number:options[:version] ) increment_build_number(build_number:options[:build] )end
然后可以在一个lane中使用这个函数:
lane:appstoredo|options|··· prepare_version(options) ···end
然后执行这个lane的时候:
$ fastlane appstoreversion:2.4.0build:2.0
好啦,先说到这里吧,Fastlane能做的事情还有很多,大家可以去好好看看文档,研究一些高级的用法吧!
作者:徐凤年_
链接:https://www.jianshu.com/p/abd3d2707b53
來源:
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。