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

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

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

运行 npx testflight 命令

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

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

• 初始化或检测已关联的 EAS 项目。 如果你在新项目中运行此命令，CLI 将使用应用配置文件中的 slug 创建新的 EAS 项目。如果 CLI 检测到该项目已在 EAS 上创建，则会继续使用相同的 slug。
• 确认 bundle identifier。 如果你在新项目中运行此命令，可以输入新的标识符；对于后续运行，可以接受 CLI 检测到的标识符。向导还会询问你的应用使用的是标准加密还是豁免加密。后续再次运行此命令时，buildNumber 会自动递增。
• 登录 Apple Developer。 提供你的 Apple ID，完成双重身份验证，并允许 CLI 创建新的分发证书或配置文件，或重新使用现有的证书和配置文件。
• 生成凭据。 如果 EAS 尚未管理该 bundle identifier 的凭据，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"
      }
    }
  }
}