npx testflight 命令

一个可让你构建、签名并将你的 iOS 应用提交到 TestFlight 的单条命令。

For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.

npx testflight 是一个 CLI 工具，它会引导你完成构建、签名并将你的 iOS 应用提交到 TestFlight 的整个流程。

先决条件

• 一个你想部署到 TestFlight 的 React Native iOS 项目
• 一个付费的 Apple 开发者账号
• 一个 Expo 账号

运行 npx testflight 命令

在你的项目根目录中运行以下命令：

该命令工作流是交互式的，并会使用最新的 EAS CLI 版本引导你完成以下提示：

• 初始化或检测已链接的 EAS 项目。 如果你在一个新项目中运行此命令，CLI 会使用你应用配置文件中的 slug 创建一个新的 EAS 项目。如果 CLI 检测到该项目已经创建在 EAS 上，它将继续使用相同的 slug。
• 确认 bundle 标识符。 如果你在一个新项目中运行此命令，你可以输入一个新的标识符；或者在后续运行命令时，接受 CLI 检测到的标识符。向导还会询问你的应用是否使用标准加密或豁免加密。当此命令后续再次运行时，buildNumber 会自动递增。
• 登录 Apple Developer。 提供你的 Apple ID，完成双重身份验证，并允许 CLI 创建新的或复用现有的分发证书或配置文件。
• 生成凭据。 如果 EAS 尚未为 bundle 标识符管理凭据，CLI 会为你创建或更新分发证书和配置文件。
• 创建生产构建。它会使用默认的 EAS production 配置 启动一个 iOS 构建，以创建一个 iOS 归档（.ipa）文件。
• 验证 App Store Connect 访问权限。 提交步骤会检查是否存在 App Store Connect API 密钥，如有需要会创建一个。
• 将应用提交到 TestFlight。 将生成的 .ipa 文件上传到 App Store Connect，并为你团队的内部测试组启用 TestFlight 分发。

在整个过程中，你会在终端窗口中收到构建和提交状态更新。在 App Store Connect 仪表板中，你可以管理测试人员和分发。

注意：每个提示都与 EAS Build 和 EAS Submit 的流程一致，因此你可以像单独运行 eas build 或 eas submit 时一样作答。这意味着，在构建和提交过程中，会生成 EAS 仪表板链接，你可以使用它们来查看流程。在提交过程成功完成后，你会获得 App Store Connect 的链接，你可以用它来查看你提交到 TestFlight 的内容。

为什么使用 npx testflight

• 无需单独的构建和提交流程，节省开发者时间
• 通过带有 EAS CLI 的引导式提示处理 Apple 凭据、配置文件和 App Store Connect API 密钥
• 生成一个新构建并将其提交到 TestFlight，而无需运行单独的命令
• 在共享机器或 CI 运行器上表现良好，因为在这些环境中安装全局包并不方便

何时使用 npx testflight

• 直接从本地机器快速发布一个 TestFlight 构建
• 在不配置完整 CI 工作流的情况下，触发一个或多个 TestFlight 构建
• 你有内部测试组，并希望尽快让应用中的最新更改可用
• 让 EAS 自动处理证书、配置文件和 API 密钥

常见问题

{
  "submit": {
    "production": {
      "ios": {
        "ascAppId": "your-app-store-connect-app-id"
      }
    }
  }
}