在 ASO.dev 管理 TestFlight Beta 构建版本

构建版本页面是 TestFlight 构建版本的控制中心。

当二进制文件上传到 App Store Connect 后，你可以在这里检查构建状态，编写本地化 测试内容，选择测试受众，保存分发变更，在需要时提交 Apple 审核，通知测试用户，将旧构建标记为非活跃，或把已验证的构建加入可编辑的 App Store 发布版本。

100%

ASO.dev 中的 TestFlight Beta 构建版本

100%

ASO.dev 中的 TestFlight Beta 构建版本

当你需要完成以下工作时，可以使用这个页面：

• 检查处理状态、活跃状态、测试状态和 Apple 审核状态；
• 准备测试用户会看到的本地化 测试内容 文本；
• 将构建分配给内部或外部测试分组；
• 在分组之外添加个人测试用户；
• 从 Excel 或 CSV 导入个人测试用户；
• 在构建可用后通知已分配测试用户；
• 当构建不应继续测试时，将其标记为非活跃；
• 将验证后的构建加入可编辑的 App Store 发布版本；
• 在清理或应用转移前移除构建上的所有个人测试用户。

左侧面板显示已上传的 TestFlight 构建版本。

它适合处理很长的构建历史：可以只看活跃构建，也可以继续加载旧构建用于审计和清理。

主要控件：

• iOS 和 macOS - 切换平台。
• 仅活跃 - 隐藏非活跃或已过期构建。
• 筛选 - 缩小构建列表。
• 加载更多 - 从 App Store Connect 加载下一页。
• +1000 和 加载全部 - 用于加载更早历史。
• 重新加载 - 刷新列表和当前构建。

每一行显示应用版本、构建号、活跃状态、上传日期、过期日期，以及构建是否已关联发布版本。

详情面板会回答分发前的关键问题：

• 构建是否已处理并处于活跃状态；
• 是否可用于内部或外部测试；
• 外部测试是否需要 Apple 审核，以及当前审核状态是什么；
• 是否已关联 App Store 发布版本；
• 构建何时过期；
• 是否有使用、崩溃或反馈数据。

如果 Apple API 返回数据，ASO.dev 还会显示最低系统版本、加密状态、受众、分组、个人测试用户和其他 TestFlight 元数据。

• 保存 - 写入暂存变更，包括测试内容、分组、测试用户和构建设置。
• 重新加载 - 从 App Store Connect 获取最新数据。有未保存变更时，ASO.dev 会先提醒。
• 提交审核 - 在外部 Beta 测试需要时，将所选构建提交到 Apple 的审核流程。
• 加入发布版本 - 将构建分配给可编辑的 App Store 版本。
• 通知测试用户 - 在 Apple 允许时向所有已分配测试用户发送 TestFlight 通知。
• 标记为非活跃 - 让构建不再用于活跃测试。
• 移除全部 - 从当前构建移除已加载的个人测试用户。

Apple 会决定哪些操作可用。只读权限、审核状态不匹配、非活跃构建或没有可编辑发布版本，都可能禁用按钮。

测试内容是测试用户在 TestFlight 中看到的本地化说明。

用它说明改动内容、需要验证的功能、测试账号或数据，以及你希望测试用户提供什么反馈。

常用操作：

• 编辑 - 修改基础语言或其他本地化。
• 显示本地化 和 隐藏本地化 - 展开或收起该字段的全部 Beta 测试本地化。
• 复制上一版 - 复用旧构建中的文本。
• 翻译 - 将基础语言翻译到该字段的全部语言。
• 覆盖翻译 - 重新生成已有本地化文本。
• AI 改写 - 将任意语言的草稿改写成三个更正式的英文版本。
• 保存 - 将本地化变更写入 App Store Connect。

当草稿意思正确、但还需要更清楚的测试用户说明时，可以使用 。AI 提示词可以自定义，便于团队固定语气、结构和细节水平。

Apple 限制每个 测试内容本地化最多 4,000 个字符。ASO.dev 会显示计数，跟踪未保存编辑，并在刷新或离开导致内容丢失前提醒。

Beta 分组组件

Beta 分组会在多个 TestFlight 页面中复用。

在 Beta 测试用户 页面，它用于组织用户。

在 构建 页面，它决定哪个受众可以收到所选构建。

建议用分组维护稳定的测试受众：

• 内部 QA 和开发者；
• 外部客户；
• 代理商或评审人员；
• 媒体和发布合作伙伴；
• 面向某个功能的 Beta 轮次；
• 使用公开链接的测试活动。

组件可以显示：

• 分组名称；
• 内部或外部分组类型；
• 测试用户数量；
• 已关联构建数量；
• 公开链接状态；
• Apple 通过 App Store Connect 暴露的分组设置。

两字母分组头像使用虚线边框表示内部分组，使用实线边框表示外部分组。悬停在分组头像上，可以看到测试类型和已关联构建数量。

主要控件：

• 分组选择器 - 选择当前分组，或选择与当前构建关联的分组。
• 添加 - 创建新的 Beta 分组。
• 删除 - 确认后删除所选分组。
• 保存 - 将暂存的分组变更写入 App Store Connect。
• 公开链接 - 当公开链接访问已启用时显示 TestFlight 公开链接。
• 设置 - 当 Apple 返回可编辑设置时打开分组选项。

创建分组时，ASO.dev 会要求输入分组名称，并选择是否为内部分组。

编辑现有分组时，Apple 可能会返回公开链接选项、测试用户上限、反馈设置、iOS on Mac 可用性和 Apple Vision 可用性。

分组变更会先暂存。检查分组成员或构建分配后，再点击 保存 应用更改。

分组是默认分发方式。它们更容易审计、复用，也更容易在 Beta 结束后清理。

在构建页面，分组组件决定哪些 Beta 分组会收到当前构建。分组变更会先暂存，只有点击 保存 后才会写入 App Store Connect。

个人测试用户用于例外情况：某个利益相关者、评审人员、客户或开发者需要在常规分组之外收到这一构建。

个人测试用户操作：

• 添加 - 输入邮箱、名字和姓氏，添加一个测试用户。
• 导入 - 从 .csv、.xlsx 或 .xls 导入列表。
• 保存 - 创建或关联测试用户，并将他们分配到构建。
• 撤销变更 - 清除暂存编辑。
• 移除全部 - 将当前构建上的已加载个人测试用户标记为移除。

保存时，ASO.dev 会检查邮箱是否已存在为 Beta 测试用户。已有用户会被关联到构建，新用户会先创建再关联。

移除全部 适用于应用转移前、私有 Beta 结束后，或重新整理干净测试受众之前。它会移除构建关系，不一定删除测试用户记录本身。

构建设置与受众分发分开保存：

• 自动通知 - 当 Apple 支持时控制测试用户自动通知。
• 非豁免加密 - 更新构建的加密标志。

当 Apple 返回 TestFlight 使用数据时，ASO.dev 会显示邀请、安装、会话、崩溃、反馈，以及首次或最后使用日期。

发布前可以用这些信号判断测试是否充分：安装太少、重复崩溃或未处理反馈通常意味着还需要一轮测试。

1. 选择最新的活跃构建。
2. 检查处理状态、过期时间、内部测试、外部测试和 Apple 审核状态。
3. 填写或复制本地化 测试内容。
4. 分配正确的测试分组。
5. 只为例外情况添加个人测试用户。
6. 保存文本和受众变更。
7. 如果外部测试需要 Apple 审核，使用 提交审核。
8. Apple 允许测试后，使用 通知测试用户。

1. 查看使用情况、反馈和崩溃数。
2. 确认构建仍然活跃。
3. 确认发布版本可编辑。
4. 使用 加入发布版本。

1. 如果需要审计记录，先记录测试受众。
2. 选择带有个人测试用户的活跃构建。
3. 使用 移除全部。
4. 将不应继续可用的构建标记为非活跃。
5. 重新加载并确认旧测试受众不再关联。

读取构建需要 App Store Connect API 访问 builds 和相关 TestFlight 资源。

Apple 审核、通知、分组分配、个人测试用户、加密设置、加入发布版本和将构建标记为非活跃都需要写权限。

重要限制：

• 普通构建列表加载 200 个构建；
• 批量加载每次最多增加 1,000 个构建；
• 测试内容每个本地化最多 4,000 个字符；
• 非活跃或已过期构建对大多数分发操作是只读的。