← 所有開發手記

家人共享沒有解鎖時,我們檢查了什麼

· Hui Ma

這次排查從一個問題開始:家裡已經有人購買了 Flick Pro 終身版,為什麼另一位成員仍然看到付費頁面?如果這位成員是未成年人,家長核准和系統購買限制會不會影響解鎖?

我們沿著購買、回復購買項目、啟動和回到前景的流程檢查了程式碼。最後找到了一個啟動時序的潛在問題,也補上了兩個家庭使用情境中的遺漏。

先確認:Apple 是否已經提供權益

共享使用資格、等待家長核准、尚未完成的兌換,與已經取得有效購買權益,是不同的狀態。App 應根據 Apple 提供的交易解鎖,不能僅憑一段「可以免費取得」的提示就認定購買已經完成。App 本身可以免費下載,也不代表 Pro 這項非消耗型 App 內購買項目已取得共享權益。

我們最初檢查的是 Transaction.currentEntitlements。Flick 已經讀取這個序列,檢查交易驗證結果、產品 ID 和撤銷狀態;沒有按 ownershipType == .purchased 篩選,因此 .familyShared 原本就能解鎖。產品 ID 是 me.mahui.app.Flick.pro.lifetime。

回復購買項目也已經呼叫 AppStore.sync(),之後重新讀取權益。Apple 說明,部分非消耗型 App 內購買項目的家人共享,需要成員主動回復購買項目;sync() 應由使用者點按「恢復購買」按鈕觸發,而不是在啟動時自動顯示認證提示。參見 家人共享說明與 AppStore.sync()。

實際找到的問題:價格請求擋住了首次權益讀取

原本的初始化工作先載入商品名稱與價格,再讀取既有權益:

Task {
    await loadProduct()
    await refreshEntitlements()
}

這讓兩個用途不同的請求產生了等待關係。商品資訊請求遲遲沒有回傳結果時,首次權益讀取也無法開始,而 isPurchased 的初始值仍然是 false。自行購買和家人共享都會受到這段等待影響。

App 回到前景時還有一次獨立更新,可能掩蓋這個問題,但啟動時能否正確讀取權益,不應依賴那次生命週期通知。我們將兩項工作獨立啟動:

Task { await refreshEntitlements() }
Task { await loadProduct() }

修正不依賴這兩項工作誰先執行;關鍵在於讀取既有權益不再等待價格請求完成。在模擬測試中,我們讓商品請求持續暫停:舊程式碼在啟動時讀取權益的次數是 0,修正後的程式碼能在價格仍未載入時,解鎖有效的共享權益。請求回報錯誤後,舊程式碼原本仍會繼續更新權益,因此這裡定位的是等待期間的辨識延遲。

未成年人的情境要區分「等待核准」和「禁止新購買」

「購買前詢問」(Ask to Buy)使用的是 StoreKit 的待處理購買流程。Flick 收到 .pending 時不會提前解鎖,會結束購買按鈕的載入狀態,並說明可能需要家長核准或其他驗證。購買完成後,通過驗證的交易由 Transaction.updates 送達,再更新權益。

家長拒絕請求不會產生一筆已完成的交易,所以 App 會維持未解鎖,也無法據此顯示確定的「家長已拒絕」。我們沒有把待核准狀態儲存成永久停用購買的鎖,避免遭拒後使用者無法再次嘗試。參見 Apple 的 Ask to Buy 測試說明。

另一種情況是「螢幕使用時間」或裝置管理禁止 App 內購買。我們補上了 AppStore.canMakePayments 檢查:付費頁面不再提供可發起新購買的按鈕,並顯示購買受限說明;實際呼叫購買之前,也會再讀取一次系統狀態,避免頁面開啟後限制發生變化。

禁止新購買不會關閉既有的自行購買或家人共享權益。權益讀取照常執行,也保留回復購買項目的入口。這個開關也不是年齡判斷,裝置管理限制同樣可能讓它回傳 false。參見 canMakePayments。

回復購買項目的提示,也要適用於家人

原本沒有找到權益時的提示只說「登入購買時使用的帳號」。對自行購買的使用者可以理解,對家人卻可能讓人誤以為應該在孩子的裝置上登入家長的帳號。

現在的提示分開說明:自行購買的使用者核對「媒體與購買項目」所用的 Apple 帳號;透過家人共享使用的成員,則確認家人已購買,並檢查家庭的購買項目共享設定。家人應使用自己用於家人共享的 Apple 帳號。暫時未找到可回復的權益,也不代表這個家庭從未購買過。

本機 Products.storekit 中的 familyShareable: true 只說明開發測試設定允許共享,不能證明線上 App 內購買項目已開啟共享。線上開關、家人自己的購買帳號、共享設定,以及交易是否已送達,都仍需核對。參見 Apple 的共享購買排查步驟。

驗證了什麼,還有哪些尚未驗證

這次程式碼調整解決了已經重現的啟動等待問題,並補上新購買限制處理與家人回復購買項目的提示。文章上線只代表這份開發紀錄已經公開,不能作為 App 更新已上架或真實家庭成員帳號測試已完成的證據。

如果你現在仍然沒有解鎖

先在 Flick 的付費頁面點按「恢復購買」。如果是家人共享,核對自己用於家人共享的 Apple 帳號、「媒體與購買項目」和家庭購買項目共享設定;如果正在等待家長核准或兌換尚未完成,先完成 Apple 的系統流程。仍有問題時,可以向 Flick 支援提供 App 版本、系統版本、自行購買或家人共享,以及回復後顯示的提示,以便進一步排查。