症狀: App Store Connect 分階段發布期間出現疑似嚴重故障,先按風險判斷;可信證據指向資料遺失、安全疑慮或核心功能大範圍失效時,優先暫停推送並準備修復版本。
最快解法: 若只是零散回報、尚未重現,先核對版本、裝置、系統版本、崩潰資料與支援紀錄,再決定是否繼續。暫停只會控制符合條件使用者的自動更新節奏,並不等於撤回版本或阻止所有人手動取得更新。
本文適合剛發布版本、正在檢視崩潰與使用者回報的獨立開發者;也適合管理多個 App 版本的小團隊。
正在準備緊急修復版本的人,可用本文整理暫停、驗收與恢復發布之間的決策。
分階段發布的控制範圍
App Store Connect 的分階段發布,是逐步向符合條件的使用者自動提供版本更新,不是版本撤回機制。Apple 說明此流程按 7 日推進,期間可暫停一次,暫停最長 30 日;期限與操作限制應以Apple 的分階段發布說明及帳戶目前顯示為準。
這些限制會影響處置策略:暫停可爭取調查與修復時間,但不能當成無限期凍結;若已用過暫停機會,就要更謹慎地評估是否繼續原版本的推送,並同步規劃修復版本。
分階段發布暫停後,還能繼續嗎?
可以在允許的期限內恢復發布;但暫停次數有限,不能假設可以反覆按下暫停、恢復來延長觀察。恢復前應先確認問題是否已定位、修復是否驗收,並查看 App Store Connect 顯示的目前狀態。Apple 的 PhasedReleaseState 狀態定義可用來核對 API 層級的發布狀態;實際操作仍應以當前介面和官方說明為準。
依故障風險決定發布動作
核心流程、資料或安全性有可信風險
若多項獨立證據指向同一個高影響問題,暫停通常比繼續推送更穩妥。典型情況包括登入或付款等核心流程無法完成、使用者資料異常,或有合理跡象顯示敏感資料可能暴露。關鍵不是回報數量本身,而是影響嚴重度、可重現程度,以及是否能對應到正在發布的版本。
先保存崩潰報告、裝置診斷記錄與客服回報,再比對受影響版本及系統環境。Apple 的崩潰報告診斷說明介紹如何分析崩潰與裝置記錄;若尚未取得所需資料,可參照取得崩潰報告與診斷記錄的方法收集線索。資料不足時,應記錄不確定性,而不是把推測寫成已確認的回歸問題。
回報零散,尚未確認是否為系統性問題
單一使用者回報值得調查,但不足以單獨證明所有使用者都會遇到相同故障。社群貼文、客服描述或單次崩潰,可能與特定裝置、系統版本、帳戶狀態或操作順序有關;未確認條件前,直接暫停可能打亂原定發布,直接繼續也可能放大真實問題。
App Store Connect 分階段發布出現崩潰時,是否應立即暫停?
先判斷崩潰是否能對應到這次更新,以及是否造成核心功能無法使用。若多筆資料指向相同路徑,且可重現或後果嚴重,優先暫停;若目前只有少量、條件不明的個案,先交叉核對崩潰記錄、使用者回報與分析指標,再作決定。Apple 提供App Store Connect 指標定義,可協助團隊理解可用指標,但任何指標都應與具體版本及診斷資料一併解讀。
核對時至少記下 App 版本、裝置型號、作業系統版本、發生時間、操作路徑及是否能重現。若只有特定條件觸發,就把條件納入測試案例;若資料相互矛盾,先設定下一次復核條件,而非僅憑單一來源繼續或暫停。
修復版本正在準備
是否保留原推送,取決於舊版本的風險與修復驗收進度。若問題影響嚴重、修復尚未完成,暫停原發布可爭取調查時間;若影響有限且原因尚未證實,則可在密切監控下保留原節奏。修復已完成,也不代表應立即恢復:先確認新建置包含預期修正,並測試受影響流程及相關回歸範圍。
建置產物、測試結果與提交版本應能互相對應,避免把未驗證的熱修復送往 App Store Connect。Apple 說明如何在 App 建置中包含除錯資訊,可供檢查診斷所需的建置設定。實務上宜保留建置識別資料、修正項目、測試紀錄與審核提交所對應的版本,讓後續調查可以追溯,而不是只依賴口頭交接。
暫停自動推送不代表舊版本已從 App Store 消失,也不代表使用者無法自行取得更新。若目標是限制特定版本的下載,必須另行檢查版本可用性設定及其影響。
暫停、繼續與停止下載的差異
分階段發布期間,使用者仍可手動下載更新嗎?
可以;分階段發布控制的是自動更新推送,並不等同於禁止使用者主動下載。Apple 的分階段發布操作說明列出相關邊界。因此,若故障風險要求所有使用者都不能取得某版本,不能只按暫停,還要另外核對版本是否仍可下載。
分階段發布和直接向所有使用者發布,如何選擇?
前者保留逐步觀察與暫停空間,適合需要監測新版本表現的情況;直接向所有使用者發布會擴大可取得更新的範圍,適合問題已處理、修復版本完成驗收且決定全面提供的情況。這兩種操作都不等同於下架 App。Apple 分別說明如何讓版本無法下載及管理 App 在 App Store 的供應狀態;如需停止所有使用者取得舊版,應依當前狀態確認可用操作及其影響。
發布復核清單與方案比較
在改變發布狀態前,先完成以下可追溯的決策紀錄。清單不取代 Apple 介面中的實際操作核對,而是協助團隊留下判斷依據:
- [ ] 記錄問題證據:崩潰紀錄、使用者回報、分析指標,以及是否可重現。
- [ ] 記錄影響範圍:受影響版本、裝置與系統條件,以及核心功能或資料風險。
- [ ] 核對目前發布狀態:確認正在分階段發布、已暫停,或已向所有使用者提供。
- [ ] 寫明選擇暫停或繼續的理由,並標示尚未確認的假設。
- [ ] 指定下一次復核條件,例如修復建置完成、回歸測試通過,或取得足以確認影響範圍的新資料。
- [ ] 將修復建置、測試結果與準備提交的版本逐一對應,通過驗收後再考慮恢復或全面發布。
| 處置方案 | 適用判斷 | 主要風險 | 建議分級 |
|---|---|---|---|
| 暫停分階段發布 | 高影響故障已有可信證據,修復仍在調查或驗收 | 暫停次數與期限有限;使用者仍可能手動取得更新 | 優先 |
| 繼續原推送並監測 | 回報零散、未能重現,且目前沒有高影響證據 | 若漏判系統性問題,影響範圍可能擴大 | 有條件 |
| 驗收修復後恢復或全面提供 | 問題已定位,修復與回歸測試完成,版本對應清楚 | 未充分驗收便擴大提供,可能再次引入故障 | 驗收後採用 |
| 調整版本下載可用性 | 目標是限制使用者取得特定版本,而不只是控制自動更新 | 操作範圍不同,可能影響 App 的供應狀態 | 先核對官方設定 |
暫停後若要盡快構建並驗證修復版本,先確認現有 Mac 環境能否穩定完成 Xcode 歸檔、簽名與回歸測試。本地已有可用 Mac,且需要長期持續執行固定建置工作時,自行維護可能更合適;但本地設備會占用硬體預算、儲存空間與維護時間,也需要自行處理長時間運作及遠端存取。若只是短期調查或等待修復驗收,沒有可用 Mac 的團隊可評估ArmMacs 的租用方案,並先確認所需工具鏈與工作方式是否適用。遠端 Mac 不是唯一解法;在選擇前,也可參考遠端 Mac 支援資訊,確認環境需求與連線方式,再決定是否適合用於這次熱修復。
ArmMacs 雲端 Mac
為修復與復核,準備一台專用雲端 Mac
使用 ArmMacs 獨享實體 Mac,按日租用,為版本修復、測試與重新建置安排所需資源。
