App Store Connect Group Purchases 沙盒怎么验收?2026 指南

2026 年 11 月起,Apple 才计划开放 Group Purchases 的沙盒配置与测试;App Store 正式提供时间目前只公布为当年冬季。Apple Developer 的公告没有给出具体开放日。现在先确认 StoreKit 2,并建立购买、席位授权和成员权限的测试基线;真实多人席位验收,等沙盒能力开放后再做。单用户订阅测试通过,不代表多人购买流程已经验收。

这篇 runbook 适合正在接入多人席位订阅、维护 StoreKit 2 交易与权益逻辑的 iOS 开发者。
如果你负责 App Store Connect 设置,或要为构建流水线留存可追溯的测试证据,也可以按时间节点逐项执行。

状态提醒:截至 2026 年 10 月 31 日,Apple 已公布的是未来开放计划,不是“Group Purchases 沙盒已经全面可测”。开放状态、配置入口和实际流程都应在官方资料更新后重新核对。

01 准备期:把单用户基线与成员授权拆开

Group Purchases 面向使用 StoreKit 2 的自动续期订阅。Apple 的官方演示说明,应用自行发起 StoreKit 2 购买流程,并将购买人请求的席位数量传入购买请求;完成分配后,App Store 会为成员分配交易。具体请求细节和可用入口,以开放后的官方文档为准。Apple 的 WWDC26 Group Purchases 演示说明了目前已公开的产品边界。

先保留一条已知可工作的单用户路径,作为后续对照。把购买发起者、受邀成员、席位数量和应用授权分别建模;不要把你的账号体系、团队成员关系或产品权限假定为 Apple 自动维护。

  • [ ] 确认当前订阅购买和交易处理采用 StoreKit 2;若仍依赖旧实现,先排期迁移与回归。
  • [ ] 记录单用户购买成功、取消、恢复及续订状态变化时,应用当前授予和回收权限的规则。
  • [ ] 区分“App Store 交易有效”与“用户在你自己的服务中有权访问哪个团队、资源或功能”。
  • [ ] 为购买人、受邀成员和应用内用户 ID 预留可核对的映射记录,不以邮箱或客户端缓存单独作为授权依据。
  • [ ] 标记当前只能用本地 StoreKit 测试验证的部分,避免误报为 Apple 沙盒端到端结果。

StoreKit 的 currentEntitlements 可用于读取当前具备权益的交易;Apple 同时建议应用处理交易更新,并在发放服务后完成交易。Transaction 文档可用于检查既有单用户基线,但它本身不能替你定义团队授权规则。

02 配置期:复核订阅选项,不混淆两类多人购买

先检查目标订阅的资格与现有设置,再确认它准备在哪些商店提供。App Store Connect 的购买选项设置涉及是否允许多席位购买,以及 App Store、Apple Business 或 Apple School Manager 的可用范围。Apple 的帮助文档指出,部分较早创建、未使用 StoreKit 2 或启用了 Family Sharing 的订阅,默认选项可能不同;不能只依据新建订阅的默认状态推断现有产品设置。App Store Connect 订阅购买选项说明列明了设置路径和相关条件。

还要区分两种流程:

  • App Store 上的 Group Purchases:个人或群组购买订阅,再邀请成员使用席位。
  • Apple Business 或 Apple School Manager 的 Volume Purchasing:组织通过相应的组织采购与设备管理流程购买、分配席位。

两者都涉及多人和席位,但购买入口与管理路径不同。不要把组织批量采购的设备管理步骤写进群组邀请验收,也不要把组织订阅设置等同于已经开放了 Group Purchases 沙盒测试。

  • [ ] 核对订阅详情中的多席位选项、商店可用范围和当前审批状态。
  • [ ] 记录配置人使用的 App Store Connect 角色;如无法查看或编辑设置,先确认权限,不要以应用开发者权限代替管理权限。
  • [ ] 保存当前设置状态及变更前后记录,避免测试期间误改面向正式用户的可用性。
  • [ ] 将 Family Sharing、组织采购和 App Store 群组购买分开列为不同的产品与测试边界。

03 开放前:用 Xcode 本地测试准备逻辑

等待 Apple 沙盒能力开放,并不意味着只能停工。你可以先用 StoreKit Testing in Xcode 验证已有交易处理、权益更新和错误分支。它适合开发早期、持续集成与调试;它与使用 App Store Connect 产品数据、由 Apple 沙盒签发交易的端到端测试不是一回事。

Apple 的测试指南区分了 Xcode 本地测试和 Sandbox:本地测试可在不配置 Sandbox Apple Account 的情况下验证应用逻辑;沙盒则用于检查 App Store Connect 中配置的商品,以及应用到服务端的交易与通知链路。Xcode 与沙盒分阶段测试说明明确了两种环境各自能证明什么。

  • [ ] 用 StoreKit Testing in Xcode 验证购买完成、取消、失败和重复启动后的权益重算。
  • [ ] 测试服务端收到交易数据后,能否将 StoreKit 身份映射到正确的应用账户。
  • [ ] 覆盖成员撤权、离开团队或购买状态变化时的业务处理;这些是应用自身要定义的权限行为。
  • [ ] 在报告中把结果标记为“Xcode 本地模拟”,不要写成“Group Purchases 沙盒验收通过”。

04 沙盒开放后:按购买、邀请、分配逐段留证

官方公告说 Group Purchases 将从 2026 年 11 月起在 Sandbox Apple Account 中配置和测试,但没有承诺具体哪一天,也没有在公告中列出完整的界面、响应字段或错误码。到时先确认账户中是否出现相关能力,并逐项对照届时更新的官方文档;不要提前编写或依赖尚未公开的入口与 API 细节。

准备 Sandbox Apple Account 时,按测试角色区分发起购买的人和接受邀请的成员。记录每个账户的用途、当前购买历史以及对应的测试设备或构建。Apple 的一般沙盒指南说明,测试账户需要在 App Store Connect 中创建;测试环境的购买不会产生实际收费。Apple 沙盒购买测试文档也提醒,账户与创建它的开发者计划账号相关联,不能把测试账户当成任意开发者团队之间通用的凭据。

实际开放后,按下面的顺序跑一遍,并为每一步留存预期结果与实际证据:

  • [ ] 由购买人发起多人席位购买;核对应用传入的席位数量与最终购买结果。
  • [ ] 按官方提供的默认席位管理路径检查邀请链接是否生成、成员是否能接受邀请。
  • [ ] 对照购买人和成员各自看到的订阅交易与应用权益,确认席位被分配后成员获得预期权限。
  • [ ] 记录邀请未接受、成员状态变化、购买取消等产品相关路径的实际结果。
  • [ ] 保存构建版本、代码提交、账户角色、操作时间、客户端日志、服务端日志与交易验证结果。
  • [ ] 如果官方尚未公开某种状态或操作的行为,将其标为“待确认”,不自行推断。

05 成员变化:交易有效不等于业务授权自动正确

购买人和成员的身份、交易与应用权限要分别核对。尤其在服务端授权场景中,不要仅凭“某个群组中存在成员”就授予订阅内容;应先根据经过验证的交易和产品规则计算该用户当前有权使用的功能。

Apple 的 Group Purchases 演示区分了默认席位管理和自定义邀请流程:默认方式可由系统处理邀请链接、成员接受与席位生命周期;若应用已有自定义成员管理,可以关注演示提及的 App Store Server API 群组管理能力。可用接口和行为应以正式开放后的文档为准,而不是从演示推导未说明的调用参数。

若你的产品需要自行查询群组成员,Apple 的 Get Group Members 文档明确提醒:群组成员信息与交易信息是分开的;要解锁内容,应读取用户交易,而不能依赖该成员查询接口单独决定授权。这个边界适合直接写进服务端验收用例。

  • [ ] 对购买人与成员分别记录交易验证结果、席位关联和应用授权结果。
  • [ ] 检查成员接受邀请前后,服务端的访问控制是否按你的产品规则变化。
  • [ ] 覆盖通知重试、状态变化或客户端离线后重新启动时的权益同步。
  • [ ] 把服务端通知中的环境信息与交易环境一起记录,避免将 Sandbox 数据误认成 Production 数据。

Apple 的服务端通知使用签名载荷,应用服务器需要解析并据此更新业务状态;接收 App Store Server Notifications 文档可作为通知验收的基础参考。

06 Xcode CI:用可复现记录区分模拟与沙盒

Xcode CI 可以先承接本地 StoreKit 测试,再在 Group Purchases 沙盒能力开放后承接实际沙盒回归。两者的通过记录必须分开存档。一次本地模拟通过,不能证明 App Store Connect 配置、Sandbox Apple Account、邀请分配或服务端交易校验都已跑通。

每次测试至少关联代码版本、构建标识、Xcode 与运行环境信息、测试环境类型、账户角色、执行结果和关键日志。不要把密码、私钥或完整账户凭据写入构建日志;测试账号应使用专用凭据管理流程。遇到失败时,保留失败步骤、交易环境和服务端响应,避免只留一张“购买成功”截图。

目前没有可核验的 CALMVPS 节点配置、交付连接信息或注明环境与日期的本站 StoreKit/Xcode 实测记录,因此本文不提供远程 Mac 配置参数,也不把任何 CI 结果冒充本站实测。你可以先按自己的运行环境执行上述记录方案;若后续评估远程 Mac,再确认具体节点与测试条件后单独验证。

07 发布准入:按证据决定试点或暂缓

把发布决定建立在证据链上,而不是一次购买按钮返回成功。建议将准入拆成以下检查:

  • [ ] 交易:购买人及成员对应的交易能够验证,且测试环境识别正确。
  • [ ] 席位:购买、邀请、接受、成员变更和取消后的状态,与官方已公布流程及产品规则一致。
  • [ ] 授权:每位用户获得的应用权限来自已验证交易与业务映射,不仅依赖客户端状态或群组成员列表。
  • [ ] 恢复:客户端中断、服务端通知延迟或重复处理后,权益能够按规则恢复或撤销。
  • [ ] 复核:测试报告能由另一名工程师根据构建、账户角色和日志重新检查。

如果沙盒入口尚未开放、关键 API 文档未更新,或成员权限无法从交易证据中复核,就先维持现有单用户功能或仅在内部环境验证。正式发布窗口目前只有“2026 年冬季”这一公开表述,不要据此自行指定某个上线日期。本文最后更新于 2026 年 10 月 31 日;开放时间、功能边界与配置条件核对自上文引用的 Apple Developer 新闻、WWDC26 官方演示及 App Store Connect 订阅设置帮助。

08 验收前的快速答疑

上方 FAQ 按角色、测试阶段和证据类型整理了沙盒开放时间、Sandbox Apple Account 准备、StoreKit 2 邀请与席位检查,以及 Xcode CI 的复核边界。具体入口或接口若尚未出现在 Apple 的公开资料中,应列为待确认,不要用模拟结果替代真实沙盒证据。

如果你已经能在本地完成基础验收,继续用上面的清单记录证据即可。若团队缺少可运行 Xcode 的 Mac 环境,可先查看 CALMVPS 的远程 Mac 方案说明,再对照方案与价格信息评估是否适合承接这条验证任务。远程环境能补足 macOS 与 Xcode 的运行条件,但账户准备、业务授权设计和沙盒行为仍需由你的团队负责;长期固定负载或依赖物理设备的测试,也应先比较自购 Mac 与其他测试方式。