1. 前言
应公司项目要求，需要自动化打包不同App，为了避免重复性的工作和节省时间，以下是研究和学习Fastlane的一些记录和总结，希望可以为初学者提供一些帮助。
1.1. 依赖环境：
Xcode7 +
macOS or Linux with Ruby 2.0.0 +
2. Fastlane简介
Fastlane 是一套使用Ruby写的自动化工具集，为iOS 和 Android 开发者提供的自动化构建工具，它可以帮助开发者将 App 打包、签名、测试、发布、信息整理、提交 App Store 等工作完整的连接起来，实现完全自动化的工作流。
fastlane 强大之处就在于其提供的工具全,基本可以覆盖打包测试发布的所有流程,如下图:
fastlane 的每一个工具都对应一个 Ruby 脚本,用来执行某一特定的任务,而最妙的是可以通过配置文件将不同的工具灵活的结合在一起,从而形成一个完整的自动化流程,实现一键上传 ITC,从而缩短用于构建发布的时间。比如我需要完成一套发布流程：
#发布到AppStore
lane :release do
#增加build版本号,需要先配置build setting
increment_build_number
#pod资源更新
cocoapods
#打包
gym
#发布到AppStore
deliver(force: true)
#发布testflight测试
testflight
end
2.2. Fastlane组件
- 测试
- scan => 自动运行测试工具，并且可以生成漂亮的HTML报告
- 证书，配置文件
- 截图
- 编译
- shenzhen => 当年大名鼎鼎的自动编译工具，现在已经被弃用了
- gym => Fastlane家族的自动化编译工具，和其他工具配合的非常默契
- 发布
-
TestFlight管理 - 辅助工具
-
spaceship => 为
pilot，boarding和deliver等工具提供和 iTC 和 ADC 的交互API。spaceship本来是个独立的项目，后来被Fastlane收编进来 -
WatchBuild => 是一个独立的iTC监控工具，开启
WatchBuild可以监控iTC上的文件状态，弹出MacOS自带的Notification
-
spaceship => 为
- Android
- supply => 自动上传到Google Play工具(如果有时间，我想把国内提供API的Android Store都写个插件自动上传，这个问题从10年我刚开始工作就觉得是个痛点)
- screengrab => Android的自动截图工具
3.安装
3.1 安装正确的Ruby版本，需要2.0及以上版本：
ruby -v
3.2 检查 Xcode CLT 是否安装：
xcode-select --install
##如果已经安装，出现command line tools are already installed, use "Software Update" to install updates.出现command line tools are already installed, use "Software Update" to install updates.
3.3 安装 fastlane:
sudo gem install fastlane
执行命令时，输入用户密码
3.4 检查版本 fastlane:
fastlane --version
3.5 初始化配置
$ cd 项目目录
$ fastlane init
- 期间会让你输入 Apple ID 账号密码(这个信息会存在钥匙串中,后续使用无需再输入密码)
- 会检测当前的 app identifier 是否在 ADC 中
- 会检测当前 app 是否在 ITC 中
- 如果已经在 ADC 和 ITC 中创建相应的信息,那么过程会很顺利
接下来会问你这个app是否需要在iTC和ADC中创建(上一步中如果选择y会自动检测是否需要创建)，fastlane会调用produce进行初始化，如果现在还不想创建，也可以之后再运行fastlane produce init进行这个流程。如果不执行produce的流程，deliver的流程也会被掠过，当然之后也可以fastlane deliver init运行完全一样的流程。
3.6 Fastlane 初始化完成后，工程目录下会自动生成 fastlane 文件夹，如下所示：
fastlane
├── Appfile
├── Deliverfile
├── Fastfile
├── metadata
│ ├── copyright.txt
│ ├── en-US
│ │ ├── description.txt
│ │ ├── keywords.txt
│ │ ├── marketing_url.txt
│ │ ├── name.txt
│ │ ├── privacy_url.txt
│ │ ├── release_notes.txt
│ │ └── support_url.txt
│ ├── primary_category.txt
│ ├── primary_first_sub_category.txt
│ ├── primary_second_sub_category.txt
│ ├── secondary_category.txt
│ ├── secondary_first_sub_category.txt
│ ├── secondary_second_sub_category.txt
│ └── zh-Hans
│ ├── description.txt
│ ├── keywords.txt
│ ├── marketing_url.txt
│ ├── name.txt
│ ├── privacy_url.txt
│ ├── release_notes.txt
│ └── support_url.txt
└── screenshots
├── README.txt
├── en-US
│ ├── 一堆png图片
其他：
这里肯定会被创建的是
Appfile和Fastfile。如果Deliverfile，screenshots和metadata目录没被创建，可以运行deliver init重新初始化，在执行deliver init的过程中，会同步iTC中的所有语言的元数据和截图。fastlane的配置会要求输入开发者账号密码，所有的密码都加密保存在系统的Keychain里
Matchfile: match 这个action的配置文件，fastlane match init 自动生成，存放git地址等
推荐使用Sublime Text工具打开
cd fastlane
open -a /Applications/Sublime\ Text.app/ Appfile Deliverfile Fastfile
操作步骤：在Sublime Text 工作窗口，点击右下角Plain Text区域，出现的下拉菜单中选择Ruby，或者在sublime的菜单中，找到View——>Syntax中选择ruby，即可高亮代码。
4. fastlane 文件配置
fastlane 的各文件解释如下:
- Appfile:用于指定 app_identifier, apple_id, team_id
- Fastfile:配置管理 lane
- Deliverfile:配置应用在 ITC 中的各种信息,和 ICC 中的数据是一一对应的
- metadata:包含应用在 ITC 中的各种信息
- screenshots:包含截图数据
4.1 配置 Fastfile
fastlane_version "2.14.2"
default_platform :ios
platform :ios do
# 当前任务的描述
desc "Creating a code signing certificate and provisioning profile"
# 任务名称
lane :provision do
# 创建 ITC 中的 App 信息
produce(
app_name: 'AD_Demo',
language: 'zh-Hans',
app_version: '1.0',
sku: 'com.3code.ADDemo.Test'
)
# 使用证书创建私钥及签名
cert
# 每次运行时创建新的配置文件
sigh(force: true)
end
error do |lane, exception|
end
# 拍照
desc "Take screenshots"
lane :screenshot do
snapshot
end
#完成后，会自动打开screenshots.html文件查看
desc "Create ipa"
lane :build do
increment_build_number
gym
end
# 提交
desc "Upload to App Store and submit for review"
lane :upload do
deliver(
submit_for_review: true
)
end
# 一键搞定
desc "Provision, take screenshots, build and upload to App Store"
lane :do_everything do
provision
screenshot
build
upload
end
end
如果想创建 ad hoc 配置文件,需要指定sigh(adhoc: true).更多的信息参见:
4.2 配置 metadata 文件夹
需要注意的是,metadata 和 Deliverfile,都可以配置 ITC 的数据,但后者优先级高
下文先在 metadata 文件夹中进行配置用于演示,在文末会删除 metadata 中的配置文本,全部配置在 Deliverfile 中.
- 在 metadata 文件夹中创建分级文件:itunes_rating_config.json,这个和 ICC 中的分级是对应的.
{"CARTOON_FANTASY_VIOLENCE": 0,
"REALISTIC_VIOLENCE": 0,
"PROLONGED_GRAPHIC_SADISTIC_REALISTIC_VIOLENCE": 0,
"PROFANITY_CRUDE_HUMOR": 0,
"MATURE_SUGGESTIVE": 0,
"HORROR": 2,
"MEDICAL_TREATMENT_INFO": 0,
"ALCOHOL_TOBACCO_DRUGS": 0,
"GAMBLING": 0,
"SEXUAL_CONTENT_NUDITY": 0,
"GRAPHIC_SEXUAL_CONTENT_NUDITY": 0,
"UNRESTRICTED_WEB_ACCESS": 0,
"GAMBLING_CONTESTS": 0
}
此处配置参见官方文档
- 将 App 图标添加至文件夹中
4.3 Snapshot 截图和 XCTest
命令行输入：
fastlane snapshot init
生成名为Snapfile的文件，修改内容为：
# A list of devices you want to take the screenshots from
devices([
"iPhone 5",
"iPhone 6",
"iPhone 6 Plus"
])
# A list of supported languages
languages([
'en-US',
'fr-FR'
])
# Where should the resulting screenshots be stored?
output_directory "./fastlane/screenshots"
# Clears previous screenshots
clear_previous_screenshots true
# Latest version of iOS
ios_version '10.1'
然后打开 Xcode 工程,添加截图设置(需要增加 UITest, 因为截图是在 UITest 时截取的):
\\ 1）在项目添加UI测试,已经添加略过
\\ 2）将./fastlane/SnapshotHelper.swift 添加到UI测试中
\\ 3）打开 XXXUITests.swift ,删除setUp和tearDown方法，然后在其中添加以下代码testExample：
let app = XCUIApplication()
setupSnapshot(app)
app.launch()
app.buttons["next"].tap()
snapshot("01firstPage") // 此处截图
app.buttons["back"].tap()
snapshot("02secondPage") // 此处截图
4.3 配置 Deliverfile
其实上传 ITC 最主要的文件是 Deliverfile,配置好 Deliverfile 后,可以删除 metadata 文件夹中的文本配置.最终配置如下图:
[图片上传失败...(image-748b97-1520214221473)]
以下是主要的配置,更多更详细的请戳文件,里面有详细的注释,拿来即可使用
# 1 app_identifier
app_identifier "com.3code.ADDemo"
# 2 用户名,Apple ID电子邮件地址
username "Apple ID电子邮件地址"
# 3 支持语言
supportedLanguages = {
"cmn-Hans" => "zh-Hans"
}
# 4 app 名称
name({
'zh-Hans' => "ADDemo"
})
# 5 描述
description({
'zh-Hans' => "简体中文版"
})
# 6 提交审核信息
submission_information({
export_compliance_encryption_updated: false,
export_compliance_uses_encryption: false,
content_rights_contains_third_party_content: false,
add_id_info_uses_idfa: false
})
# 7 应用审核小组的联系信息 app 审核信息
app_review_information(
first_name: "name",
last_name: "name",
phone_number: "手机号",
email_address: "email",
demo_user: "测试账号用户名",
demo_password: "测试账号密码",
notes: "noting"
)
# 8 copyright
copyright "#{Time.now.year} 3code"
#
5. 插件
Fastlane的插件是一个或者一组action的打包，单独发布在fastlane之外。Fastlane Plugin 指南
#查看所有插件
fastlane search_plugins
# 安装方法
fastlane add_plugin [name]
#常用插件
fastlane add_plugin versioning
fastlane add_plugin firim
fastlane add_plugin pgyer
使用 Fastlane 上传 App 到蒲公英(https://www.pgyer.com/doc/view/fastlane)
fastlane-plugin-versioning: 用来修改build版本号和version版本号。Fastlane内嵌的action
increment_build_number使用的是苹果提供的agvtool，agvtool在更改Build的时候会改变所有target的版本号。这时如果你在一个工程里有多个产品的话，每次编译，所有的Build都要加1，最后就不知道高到哪里去了。
有了fastlane-plugin-versioning不仅可以指定target增加Build，当然也可以直接设定Version。
6. 环境变量Environment Variables
有时候我们希望把账号信息、更新描述和版本号等信息单独放在一个配置文件。在这里Fastlane给我们提供了相应的解决方案。
我们可以在工程目录下创建一个名为 .env 的文件，自定义所需的临时变量，然后Fastlane的三个配置文件（Appfile、Deliverfile和Fastfile）分别从.env文件中读取配置信息。
关于ENV用法可参考以下链接：
https://docs.fastlane.tools/advanced/#environment-variables
https://github.com/bkeepers/dotenv
.env 文件为影藏文件，可使用如下命令查看：
Finder 默认不显示隐藏文件，创建 .env 文件后，若需查看，需要执行两条命令来开启隐藏文件的显示：
$ defaults write com.apple.finder AppleShowAllFiles -boolean true;
$ killall Finder
ls -a
下面给出的 .env 文件配置可做参考：
#APP唯一标识符
APP_IDENTIFIER = "xxx.xxx.TestGitProject"
#发布版本号
APP_VERSION_RELEASE = "1.1.0"
#新版本修改记录
RELEASE_NOTES = "1) 升级测试第一行\n2) 升级测试第二行"
#蒲公英 更新描述
PGY_UPDATE_DESCRIPTION = "fastlane自动打包上传测试"
#自动提交审核
SUBMIT_FOR_REVIEW = false
#审核通过后立刻发布
AUTOMATIC_RELEASE = false
#苹果开发者账号
APPLE_ID = "xxx@xxx.xxx"
#苹果开发者帐号密码
FASTLANE_PASSWORD = "xxxxxx"
#套装ID
TEAM_ID = "94xxxxx02"
#应用名称
SCHEME_NAME = "TestGitProject"
#APP元数据及截图存放路径
METADATA_PATH = "./metadata/TestGitProject"
SCREENSHOTS_PATH = "./screenshots/TestGitProject"
#APP元数据及截图下载时，直接覆盖原有数据，不询问
DELIVER_FORCE_OVERWRITE = true
Appfile、Deliverfile和Fastfile配置文件修改如下：
Appfile ：
app_identifier ENV['APP_IDENTIFIER'] # The bundle identifier of your app
apple_id ENV['APPLE_ID'] # Your Apple email address
team_id ENV['TEAM_ID'] # Developer Portal Team ID
Deliverfile :
app_identifier ENV['APP_IDENTIFIER'] # The bundle identifier of your app
username ENV['APPLE_ID'] # your Apple ID user
Fastfile :
desc "发布 测试版本 到 蒲公英"
lane :beta_pgy do
gym(scheme: ENV['SCHEME_NAME'],
export_method: "ad-hoc",
silent: true, # 隐藏没有必要的信息
clean: true # 在构建前先clean
)
pgyer(api_key: ENV['PGY_API_KEY'],
user_key: ENV['PGY_USER_KEY'],
update_description: ENV['PGY_UPDATE_DESCRIPTION'],
password: "123456",
install_type: "2")
end
参考链接：
