This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

了解如何通过 TestFlight 将 iOS 构建版本安装到测试人员的设备上，以及何时使用内部 TestFlight 测试或外部 TestFlight 测试。

TestFlight 是 Apple 的内部和 Beta 应用分发服务。创建 iOS 生产版本后，您的应用可以在 App Store 上公开发布之前，通过 TestFlight 到达测试人员的设备。

测试分为两种，区别在于您的构建版本到达应用用户的速度。内部测试面向您自己的 App Store Connect 团队，构建版本处理完成后即可使用。外部测试面向其他任何人。不过，您必须将构建版本添加到 App Store Connect 中的一个群组，而该群组的第一个构建版本必须通过 Apple 的 Beta 应用审核流程。

快速开始

如果你拥有 Apple Developer 账户，且尚未完成其他设置，只需一条命令，即可在 App Store Connect 上创建应用记录、构建生产版本 .ipa，并将其提交到 TestFlight：

本指南的其余部分将更详细地介绍内部测试和外部测试。

内部测试与外部测试

在你通过 Apple App Store 公开发布应用之前，可以通过 TestFlight 以两种方式将应用分发给测试人员：内部测试和外部测试。两者的区别在于构建版本到达测试人员手中的速度：

警告 内部分发并不等同于内部测试。这两个术语听起来非常相似。EAS 内部分发会生成一个通过 ad hoc 或企业证书签名的构建版本，该构建版本通过 URL 安装，并且仅限于已注册的唯一设备标识符（UDID）。TestFlight 内部测试需要使用 "distribution": "store"，并且会经过 Apple。

设置内部测试

内部测试面向您自己的 App Store Connect 团队，并且构建完成处理后即可使用。

2

等待处理

Apple 会先处理构建，然后才能分发。通常需要 5 到 10 分钟，但没有保证的处理时间。处理完成后，Apple 会通过电子邮件通知您。

应用处理完成后，登录 App Store Connect，选择您的应用，然后前往 TestFlight。您应该会在 iOS Builds 下看到列出的构建。

3

创建内部测试群组

如果您已经有内部测试群组，请跳过此步骤。您也可以将测试人员添加到现有群组中。

在 App Store Connect 中，前往 TestFlight > 点击 Internal Testing 旁边的加号 (+) 图标 > 输入 Internal Group 的名称 > 点击 Create。

然后，点击 Testers 旁边的加号 (+) 图标，将测试人员添加到群组中。您可以选择 App Store Connect 团队成员的电子邮件地址，然后点击 Add，将他们添加为测试人员。测试人员会收到测试您应用的电子邮件邀请。

提示：如果您已有内部测试群组，也可以直接从 EAS CLI 指定这些群组。例如，命令 eas submit --platform ios --groups "QA Team" --what-to-test "New onboarding flow" 会指定名为“QA Team”的内部测试群组，并为构建设置“测试内容”描述。

设置外部测试

外部测试面向 App Store Connect 团队之外的人员。

在 App Store Connect 允许你创建外部群组之前，你必须先创建一个内部群组。

1

创建外部群组

在 App Store Connect > TestFlight 中，点击 External Testing 旁边的加号 (+) 图标 > 输入外部群组的名称 > 点击 Create。

2

使用现有的内部构建版本

你可以使用现有的内部构建版本进行外部测试。点击 Add Builds > 在 Select a Build to Test 下，选择你想使用的构建版本 > 点击 Next。

3

填写测试信息

在 Apple 接受构建版本进行审核之前，外部测试需要提供测试版 App 描述和反馈电子邮件地址。如果你的 App 需要登录，请启用 Sign-in Information，并提供供 Apple 使用的测试帐户。点击 Next。

4

提交 Beta App 审核

在 What to Test 下提供所需信息，然后点击 Submit for Review。Apple 会审核构建版本，并在批准后通过电子邮件通知你。

5

邀请测试人员

审核通过后，你可以通过电子邮件邀请测试人员、导入 CSV，或启用公开链接。公开链接可以对所有人开放，也可以按设备和操作系统版本进行筛选。

常见问题

{
  "ios": {
    "config": {
      "usesNonExemptEncryption": false
    }
  }
}

jobs:
  build_ios:
    name: 构建 iOS
    type: build
    params:
      platform: ios
      profile: production

  testflight:
    name: 分发到 TestFlight
    type: testflight
    needs: [build_ios]
    params:
      build_id: ${{ needs.build_ios.outputs.build_id }}
      internal_groups: ['QA Team']
      external_groups: ['Public Beta']
      changelog: |
        What's new in this release:
        - New features
        - Bug fixes