Google 致力于为黑人社区推动种族平等。查看具体举措

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

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

第 1 步:设置 Fastlane

  1. 安装并设置 Fastlane

  2. 要将应用分发添加到您的 Fastlane 配置,请从 iOS 项目的根目录运行以下命令:

    fastlane add_plugin firebase_app_distribution

    如果该命令提示您选择某个选项,请选择 Option 3: RubyGems.org

第 2 步。进行 Firebase 身份验证

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

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

  1. ./fastlane/Fastfile 通道中,添加 firebase_app_distribution 代码块。使用以下参数配置分发:
    firebase_app_distribution 参数
    app

    只有在您的应用不包含 Firebase 配置文件 (GoogleService-Info.plist) 时才需要此参数:您应用的 Firebase 应用 ID。您可以在 Firebase 控制台的“常规设置”页面中找到此应用 ID。

    
    app: "1:1234567890:ios:0a1b2c3d4e5f67890"
    googleservice_info_plist_path

    指向 GoogleService-Info.plist 文件的路径(相对于已归档产品的路径)。默认设置为 GoogleService-Info.plist

    如果未指定 app 参数,系统会使用此文件来获取应用的 Firebase 应用 ID。

    firebase_cli_token

    在以下情况时输出的刷新令牌:您运行插件的登录操作(请参见上文的使用 Google 帐号进行身份验证),或者使用 Firebase CLI 对 CI 环境进行身份验证(请参阅将 CLI 与 CI 系统配合使用了解详情)。

    service_credentials_file

    您的 Google 服务帐号 json 文件的路径。要了解如何使用服务帐号凭据进行身份验证,请参见上文。

    ipa_path

    您要上传的 IPA 文件的绝对路径。如果未指定此路径,则 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 :ios do
        desc "My awesome app"
        lane :distribute do
            build_ios_app(...) # build_ios_app is a built-in fastlane action.
    
            firebase_app_distribution(
                app: "1:123456789:ios:abcd1234",
                testers: "tester1@company.com, tester2@company.com",
                release_notes: "Lots of amazing new features to test out!"
            )
    
        end
    end
    
  2. 最后,要让测试人员可以访问此构建版本,请运行您的通道:
    fastlane <lane>

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

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