使用 Fastlane 将 Android 应用分发给测试人员

您可以使用 Fastlane 将构建版本分发给测试人员，Fastlane 是一个开源平台，可自动执行 iOS 和 Android 应用的构建与发布过程。它遵循 Fastfile 中定义的简单说明。设置 Fastlane 和 Fastfile 后，您可以将 App Distribution 与您的 Fastlane 配置进行集成。

第 1 步：设置 Fastlane

安装并设置 Fastlane。
要将 App Distribution 添加到您的 Fastlane 配置中，请从您的 Android 项目的根目录运行以下命令：
```
fastlane add_plugin firebase_app_distribution
```
如果该命令提示您选择某个选项，请选择 Option 3: RubyGems.org。

第 2 步。进行 Firebase 身份验证

您必须首先通过 Firebase 项目进行身份验证，然后才能使用 Fastlane 插件。您可以通过三种方法实现此目的：

通过插件的登录操作登录您的 Google 帐号

运行以下命令：
```
bundle exec fastlane run firebase_app_distribution_login
```
该命令将会输出身份验证链接。
在浏览器中打开该链接。
出现提示时，登录您的 Google 帐号并授予访问您的 Firebase 项目的权限。从登录浏览器复制结果代码，并将其粘贴到命令行中。然后，登录操作将输出一个刷新令牌，App Distribution 插件将使用该令牌对 Firebase 进行身份验证。
将上一步中的令牌传递给插件：可以通过稍后在设置 Fastfile 时使用 firebase_cli_token 参数，也可以通过设置 FIREBASE_TOKEN 环境变量：
```
export FIREBASE_TOKEN=token
```

使用 Firebase 服务帐号凭据

您可以使用服务帐号进行身份验证，这样就能灵活将插件与持续集成 (CI) 系统配合使用。您可以通过两种方式来提供服务帐号凭据：

将您的服务帐号密钥文件传递给 firebase_app_distribution 操作。如果您已在构建环境中拥有服务帐号密钥文件，此方法很方便。
将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为指向您的服务帐号密钥文件。如果您已为其他 Google 服务（例如 Google Cloud）配置应用默认凭据 (ADC)，建议使用此方法。

在 Google Cloud Console 中选择您的项目并创建一个新的服务帐号。
添加 Firebase App Distribution Admin 角色。
创建一个 JSON 私钥并将其移到构建环境可访问的位置。请务必将此文件保存在安全的位置，因为它会向管理员授予对您 Firebase 项目中 App Distribution 的访问权限。
如果您是在 2019 年 9 月 20 日之后创建的应用，请跳过此步骤：在 Google API 控制台中，启用 Firebase App Distribution API。出现提示时，请选择与您的 Firebase 项目同名的项目。
提供或找到您的服务帐号凭据：
1. 要将服务帐号密钥传递给通道的 firebase_app_distribution 操作，请以私钥 JSON 文件的路径设置 service_credentials_file 参数
2. 要使用 ADC 查找凭据，请将环境变量 GOOGLE_APPLICATION_CREDENTIALS 设置为私钥 JSON 文件的路径。例如：
```
 export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
```
  如需详细了解如何使用 ADC 进行身份验证，请参阅向您的应用提供凭据。

使用 Firebase CLI 登录

如需了解如何对项目进行身份验证，请参阅使用 Firebase CLI 登录。

第 3 步。设置 Fastfile 并分发应用

在 ./fastlane/Fastfile 通道中，添加 firebase_app_distribution 代码块。使用以下参数配置分发：

firebase_app_distribution 参数
`app`	必填：您的应用的 Firebase 应用 ID。您可以在 Firebase 控制台的“常规设置”页面中找到应用 ID。 app: "1:1234567890:android:0a1b2c3d4e5f67890"
`firebase_cli_token`	在以下情况时输出的刷新令牌：您运行插件的登录操作（请参见上文的使用 Google 帐号进行身份验证），或者使用 Firebase CLI 对 CI 环境进行身份验证（请参阅将 CLI 与 CI 系统配合使用了解详情）。
`service_credentials_file`	您的 Google 服务帐号 json 文件的路径。要了解如何使用服务帐号凭据进行身份验证，请参见上文。
`apk_path`	您要上传的 APK 文件的绝对路径。如果未指定，则 Fastlane 会根据生成文件的通道确定该文件的位置。
`release_notes` `release_notes_file`	此构建版本的版本说明。您可以直接指定版本说明： release_notes: "Text of release notes" 或者指定一个纯文本文件的路径： release_notes_file: "/path/to/release-notes.txt"
`testers` `testers_file`	您要邀请的测试人员的电子邮件地址。您可以采用以逗号分隔的电子邮件地址列表的形式指定测试人员： testers: "ali@example.com, bri@example.com, cal@example.com" 或者，您可以指定一个纯文本文件的路径，该文件包含以英文逗号分隔的电子邮件地址列表： testers_file: "/path/to/testers.txt"
`groups` `groups_file`	您要邀请的测试人员群组（请参阅管理测试人员）。使用群组别名指定群组，您可以在 Firebase 控制台中查找群组别名。您可以采用以逗号分隔的列表的形式来指定群组： groups: "qa-team, trusted-testers" 或者，您可以指定一个纯文本文件的路径，该文件包含以逗号分隔的群组名称列表： groups_file: "/path/to/groups.txt"
`debug`	布尔值标志。您可以将其设置为 `true` 以显示详细的调试输出。

例如：

platform :android do
    desc "My awesome app"
    lane :distribute do
        build_android_app(...) # build_android_app is a built-in fastlane action.

        firebase_app_distribution(
            app: "1:123456789:android:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!"
        )

    end
end

最后，要让测试人员可以访问此构建版本，请运行您的通道：
```
fastlane <lane>
```

在您分发构建版本后，即可在 150 天（5 个月）内在 Firebase 控制台的“应用分发”信息中心中访问该构建版本。当该版本距离过期还有 30 天的时候，在控制台和测试人员的测试设备上的构建版本列表中都会显示到期通知。

之前未受邀测试应用的测试人员会收到邀请其开始测试的电子邮件，而现有测试人员将收到有关新构建版本已可供测试测试的电子邮件通知（请参阅测试人员设置指南了解如何安装测试应用）。您可以在 Firebase 控制台中监控每个测试人员的状态：他们是否接受了邀请以及是否下载了应用。