fastlane一键打包
#fastlane #持续集成
在项目目录下执行命令,并按照提示选择所需功能,输入应用信息以及Apple开发账号信息。
fastlane init
执行完成后,项目目录下会自动生成
fastlane
文件夹,文件夹中生成两个文件Appfile
和 Fastfile

- Appfile 中包含该应用的基本信息(app id,开发者账号信息)
app_identifier("com.zm.OCTest") # The bundle identifier of your app
apple_id("*********") # Your Apple email address
itc_team_id("*******") # App Store Connect Team ID
team_id("******") # Developer Portal Team ID
# For more information about the Appfile, see:
# https://docs.fastlane.tools/advanced/#appfile
- Fastfile 中包含持续集成的步骤配置
一个命名的
lane
代表一个持续集成的任务,每个任务由多个步骤组成,步骤通常是已经定义好的action
工具。执行lane:
fastlane lanename
常用的action工具:
- match : 证书和配置文件的管理
- gym(build_app) : 打包和签名
- poilt(upload_to_app_store):app store 发布
default_platform(:ios)
# 以下是FastFile的配置示例
platform :ios do
desc "Push a new release build to the App Store"
lane :release do
build_app(scheme: "OCTest")
upload_to_app_store(skip_metadata: true, skip_screenshots: true)
end
end
# 一个lane代表一个CI的配置,可以看到release中包括两个步骤build_app,upload_to_app_store。
# build_app,upload_to_app_store 这俩个步骤是fastlane中已经定义好的action工具
接下来,我们会使用
match
,gym
,pilot
等fastlane
中已经定义好的action
。查看某个action具体参数,请使用命令fastlane action actionName
match(sync_code_signing) 在github仓库中加密保存证书和描述配置文件,用于开发成员之间共享
- 1.在github上创建一个仓库用于保存证书
- 2.在项目目录下执行
fastlane match init
,输入仓库地址;在fastlane目录下会生成Matchfile
文件,包含match的配置信息

- 1.执行这些命令
fastlane match development
,fastlane match adhoc
,fastlane match enterprise
,fastlane match appstore
,首次执行自动在apple store connect
中创建provisioning file,证书并下载加密保存在git仓库,并上传. - 2.其他开发者就可以使用
fastlane match
命令共享github中的证书和配置文件。

type
: 同步的配置文件类型:appstore
,adhoc
,development
,enterprise
,默认development
readonly
: 默认false,如果是true
,不会生成新的证书和描述配置文件app_identifier
: 指定描述配置文件的bundle id;如果不指定则使用 AppFile 中的 app_identifiergit_url
: 证书保存的github地址keychain_name
: 保存证书的keychain,默认login.keychain
在一次CI中首先就是要同步证书和描述配置文件:
# match 中需要配置参数
# 证书类型 appstore , adhoc 还是 development
# app id
# kaychain 证书保存的keychain
# git_url 证书保存的github远端库
lane :github_action_testFlight do
match(type: "appstore",
readonly: true,
app_identifier: "com.zm.ZLGitHubClient",
keychain_name: ENV['MATCH_KEYCHAIN_NAME'],
keychain_password: ENV['MATCH_PASSWORD'],
git_url: ENV['MATCH_GITHUB_URL'])
end
# ENV['MATCH_GITHUB_URL'] 是加密保存的参数
gym
是fastlane
提供的用于构建,打包,签名的action
,是build_app
的别名。workspace
: 如果工程在workspace中需要指定,例如使用cocoapods的工程project
: 如果工程不在workspace中指定工程名字schema
: schema名clean
: 是否在打包前clean工程export_method
: 指定打包方式:app-store
,ad-hoc
,package
,enterprise
,development
,developer-id
export_options
: 可以指定更详细的打包配置,可以是配置文件路径skip_build_archive
: 跳过构建,打包阶段,直接签名;使用archive_path
作为输入skip_archive
:仅构建skip_codesigning
: 仅构建,打包,不签名archive_path
: 读取xarchive的路径output_directory
: 保存ipa的目录output_name
: 保存ipa的名字
# 使用gym的参数
# 打包的工程
# 打包的方式 app-store,adhoc还是development
# 打包文件的目录
lane :github_action_testFlight do
gym(workspace: "ZLGitHubClient.xcworkspace",
scheme: "ZLGitHubClient",
clean: true,
include_symbols: true,
include_bitcode: true,
skip_build_archive: true,
archive_path: "./fastlane/archive/ZLGitHubClient.xcarchive",
output_directory: "./fastlane/ipa/TestFlight",
output_name: "ZLGitHubClient.ipa",
export_options: {
method: "app-store",
provisioningProfiles: {
"com.zm.ZLGitHubClient" => "*** AppStore com.zm.ZLGitHubClient"
}
})
end
pilot
是可以与 TestFlight
交互的 action
, 通过 piolt
你可以上传和发布新版本,添加和删除测试员。pilot
在与 App store 交互之前需要双因素认证,这样就没有办法做自动化;不过苹果在 App Store Connect API 中提供Json Web Token的认证方法;具体在下面会介绍。api_key_path
: App Store Connect API Key JSON 文件的路径api_key
: App Store Connect API Key, 通过app_store_connect_api_key
action 生成app_identifier
: 上传版本的bundle idipa
: 上传的ipa文件路径
# pilot 需要提供apple开发者账号信息,以及上传文件目录
lane :github_action_testFlight do
pilot(
username: "[email protected]",
app_identifier: "com.zm.ZLGitHubClient",
changelog: "release to TestFlight",
ipa: "./fastlane/ipa/TestFlight/ZLGitHubClient.ipa"
)
end
在早先,访问App Store Connect信息需要双因素认证。而在持续集成的过程中一般无法人机交互(例如github-action),导致持续集成无法完成。在
WWDC18
中,苹果提出了App Store Connect API,提供另外的认证方式。Fastlane
也对App Store Connect API提供了支持,具体查看Using App Store Connect API必须拥有访问权限才能访问 App Store Connect API
- 1.申请访问权限

- 1.生成API密钥


- 1.密钥生成后需要关注
Issuer ID
,密钥 ID
以及下载密钥文件(.p8); 密钥文件只能下载一次。
app_store_connect_api_key
是用来为其他 action
生成 App Store Connect API token
的 action
; match
,pilot