App Store Connect Group Purchases 沙盒怎麼驗收?2026 指南

購買人完成訂閱,但團隊仍無法確認成員是否取得正確席位與應用權限。
最快的做法:先確認應用採用 StoreKit 2,建立購買、席位與成員權益基線;等 Apple 開放 Group Purchases 沙盒測試後,再驗收真實購買和邀請流程。單一使用者訂閱測試通過,不代表多人席位流程已驗收。

這篇指南適合要把多人席位訂閱接入現有交易與權益邏輯的 iOS 開發者、需要核對訂閱設定和測試帳戶的 App Store Connect 管理者,以及要在 Xcode CI 留下可追溯測試紀錄的工程師。

最後更新於 2026 年 10 月 31 日;開放時程及功能邊界核對自 Apple Developer 公告與 Group Purchases 官方演示。

01 App Store Connect Group Purchases 沙盒驗收時程

截至 Apple 公布的安排,Group Purchases 預計自 2026 年 11 月起可在 Sandbox Apple Account 中設定和測試;App Store 正式提供時間則為 2026 年冬季。公告沒有給出具體開放日,因此不要把計畫寫成某日一定能測,也不要把準備工作描述為功能已全面開放。時程以 Apple 的公告為準,之後還要重新核對實際開放狀態。

這項功能面向使用 StoreKit 2 的自動續期訂閱。你現在可以整理交易驗證、席位授權和成員管理邏輯,但真實的群組購買與邀請驗收,必須等 Apple 開放相應沙盒能力。Apple 的官方演示可用來確認目前已公布的功能範圍;未公開的入口、API 細節和帳戶資格不要自行推定。

目前能先測哪些部分?
先用現有單人訂閱流程驗證交易取得、驗證與應用權益更新,再為多人席位部分建立預期狀態。這能提早發現應用自己的身分、授權或資料模型問題,但不能取代尚未開放的 Group Purchases 沙盒驗收。

02 開始前:固定 StoreKit 2 與席位權益基線

先留下目前單人訂閱的可重現紀錄,避免功能改動後無從判斷是新流程還是既有交易邏輯出錯。StoreKit 2 交易及目前權益的處理方式,應依照 Apple 的 Transaction current entitlements 文件核對;應用端仍須明確定義如何把已驗證的交易映射到自己的帳戶和權限。

把下列角色分開記錄,別只用「訂閱有效」當作驗收結果:

  • 購買人:購買交易如何驗證,購買後可管理哪些應用功能。
  • 受邀成員:接受邀請後,應用如何識別成員,並確認其席位權限。
  • 席位數量與使用狀態:應用資料中如何呈現可用、已分配或待處理的席位;不要假定 Apple 會替你維護產品自己的席位帳本。
  • 應用內授權:會員、工作區、角色或資料存取權限由哪一層服務判定,以及交易狀態變更後如何更新。
  • 失敗與重試:交易驗證、應用服務更新或成員同步失敗時,如何避免顯示已授權、實際卻無法使用的狀態。

這些界線很重要:Apple 的交易證據和應用自己的使用者身分不是同一件事。若你的產品以登入帳戶、組織或工作區分配權限,測試資料也必須能辨認這些對應關係。

03 配置前:核對 App Store Connect 訂閱選項

如何準備 App Store Connect 設定?
先檢查目標自動續期訂閱的購買選項、目前設定與待確認項目。Apple 已公布 Group Purchases 面向 StoreKit 2 自動續期訂閱,但具體可用範圍和設定入口仍應以實際開放後的文件為準。先保存現況,待功能開放後再依訂閱購買選項說明逐項核對。

在變更設定前,將「應用內群組購買」和組織批量採購分開處理。若把 Apple Business 或 Apple School Manager 的 Volume Purchasing 流程直接當成 Group Purchases 邀請流程,測試範圍便會混入另一種採購與部署情境,無法證明個人購買人如何分配席位給成員。

請留下這些資料,方便功能開放後比對:

  • 目標訂閱產品及目前購買選項。
  • App Store Connect 目前顯示的可用狀態與設定頁面。
  • 尚未確認的資格、入口或限制,並標記為「待 Apple 文件確認」,不要當成已知條件。
  • 設定變更前後的時間、操作人和截圖或文字紀錄。

04 沙盒開放後:分角色驗收帳戶、邀請與席位

Sandbox Apple Account 要怎麼準備?
使用專門的 Sandbox Apple Account 測試,並為購買人與受邀成員分配可辨識的測試身分。具體需要哪些帳戶、帳戶資格和操作限制,須以 Group Purchases 實際開放後的 Apple 文件為準;不要預先聲稱固定帳戶數量,也不要拿正式使用者帳戶代替測試帳戶。Apple 的沙盒內購測試文件說明一般沙盒購買測試方式,Group Purchases 的新增行為仍須另行確認。

實際測試時,依照 Apple 屆時提供的預設席位管理路徑操作,不預設尚未公布的畫面名稱或呼叫方式:

  • 記錄購買人發起群組購買時的操作、交易結果和預期應用狀態。
  • 依官方流程發出邀請,記下邀請是否建立、成員是否能接受,以及應用端何時更新授權。
  • 檢查購買人與成員各自看到的席位和應用權益是否符合產品規則。
  • 對邀請未完成、成員狀態改變或訂閱取消等情境,記錄實際狀態和恢復方式。
  • 保留每一步的測試帳戶類型、操作證據、交易驗證結果及應用端權益紀錄。

注意:模擬測試能協助你檢查應用自己的狀態轉換,不能代替 Apple 沙盒中的真實群組購買與邀請流程。將兩類結果分開標記,避免用模擬成功推論沙盒已通過。

05 成員狀態變化後:對齊交易證據與應用授權

購買人和成員的資料要分別核對。交易驗證通過,不等於每位成員的應用權限都已正確更新;成員接受邀請,也不應在尚未完成應用端身分對應時直接視為所有資料都已授權。

如果你的產品使用預設席位管理,依照 Apple 公布的路徑驗收即可。若另有自訂邀請、組織成員或角色管理,請明確區分這些應用邏輯和 Apple 提供的席位功能。Apple 已公開取得群組成員資料的文件,但具體可用方式與實際行為仍須對照正式文件和你的測試結果,不要只憑文件標題推測回傳內容或呼叫條件。

服務端若處理交易與狀態更新,也要檢查通知接收和冪等處理。Apple 的 App Store Server Notifications 文件可作為通知處理依據;通知抵達後,應用要如何更新購買人、成員及席位紀錄,則要依你自己的資料模型驗收。避免只驗證畫面顯示成功,卻沒有核對服務端狀態。

06 Xcode CI:留下可重查的測試證據

怎樣在 Xcode CI 複核交易與使用者權益?
讓 CI 同時記錄程式版本、Xcode 測試結果、測試使用的帳戶類型、交易驗證結果及應用權益狀態。Apple 說明了使用 Xcode 與 Sandbox 分階段測試;你應分清本機或 CI 中的 StoreKit 測試和 Apple 沙盒實際測試,並在報告中註明測試類型。

逐項核對以下項目:

  • 測試執行使用的程式版本和工具鏈可追溯,失敗時能找到對應紀錄。
  • CI 報告能區分模擬交易與沙盒交易,不把兩者合併成單一「購買成功」結果。
  • 交易驗證結果能對應購買人,應用授權紀錄能對應實際成員。
  • 邀請尚未接受、席位狀態未同步或訂閱狀態改變時,測試結果有明確標記。
  • 重跑測試不會因為舊狀態或重複通知,產生無法解釋的權益結果。

遠端 Mac 是否適合承擔這條 CI 工作,要看你的團隊能否安全保存測試憑據、取得完整 Xcode 執行紀錄,並在失敗時重現相同測試條件。本文沒有 CALMVPS 的遠端 Mac 環境與 StoreKit 實測資料,因此不提供特定配置、執行時間或測試成功率;先按團隊現有環境驗收,不以未經實測的環境描述替代證據。

07 發布准入:用證據決定試點或暫緩

以下清單用來決定能否開始試點。所有適用項目都有可複核證據,再進入受控試點;若任一關鍵項目未完成,就暫緩 Group Purchases 上線判定,等補齊測試或 Apple 更新文件後再復核。

  • [ ] StoreKit 2 單人訂閱交易與應用權益已有可重現基線。
  • [ ] App Store Connect 目標訂閱設定已記錄,待確認項目沒有被當成已確認功能。
  • [ ] Sandbox Apple Account 按購買人、受邀成員等角色準備,實際資格以開放後文件為準。
  • [ ] 沙盒中已留存購買、邀請、接受邀請和席位變化的逐步證據。
  • [ ] 交易驗證、服務端狀態和應用成員權限能互相核對。
  • [ ] Xcode CI 報告能區分模擬與沙盒測試,並保留可重查的失敗紀錄。
  • [ ] Apple 尚未公布的設定入口、API 或正式可用狀態已列為復核項目。

只要真實邀請流程尚未能在沙盒重現,或成員權限仍依賴人工補資料,就先限制試點範圍,不要以單次購買成功作為正式上線依據。功能開放後,再按 Apple 更新的公告、演示及 App Store Connect/StoreKit 文件重新核對測試範圍。

如果你目前用自購 Mac 跑驗收,硬體需要自行維護,也可能受單一設備的排程和可用性影響;Linux 伺服器則無法直接取代需要 Xcode 與 macOS 的測試工作。若團隊暫時缺少可執行 Xcode 的 Mac,按週期租用遠端 Mac 可以作為短期驗證選項;但若你需要長期固定滿載或實體裝置介面,先比較自購與其他執行環境會更合適。你可先查看 CALMVPS 方案與價格,再評估是否要用 CALMVPS 遠端 Mac承擔這次建置與測試;正式驗收仍以 Apple 沙盒實測證據為準。