这次排查从一个问题开始:家里已经有人购买了 Flick Pro 终身版,为什么另一位成员仍然看到付费页?如果这位成员是未成年人,家长审批和系统购买限制会不会影响解锁?
我们沿着购买、恢复购买、启动和回到前台的流程检查了代码。最后找到了一个启动时序隐患,也补上了两个家庭使用场景里的遗漏。
先确认:Apple 是否已经提供了权益
共享资格、等待家长批准、尚未完成的兑换,与已经获得有效购买权益,是不同的状态。App 应根据 Apple 提供的交易解锁,不能仅凭一段“可以免费获取”的提示就认定购买已经完成。App 本身可以免费下载,也不等于 Pro 这项非消耗型内购已经获得共享权益。
我们最初检查的是 Transaction.currentEntitlements。Flick 已经读取这个序列,校验交易验证结果、产品 ID 和撤销状态;没有按 ownershipType == .purchased 过滤,因此 .familyShared 原本就能解锁。产品 ID 是 me.mahui.app.Flick.pro.lifetime。
恢复购买也已经调用 AppStore.sync(),之后重新读取权益。Apple 说明,部分非消耗型内购的家庭共享需要成员主动恢复购买;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 测试说明。
另一种情况是“屏幕使用时间”或设备管理禁止内购。我们补上了 AppStore.canMakePayments 检查:付费页不再提供可发起新购买的按钮,并显示购买受限说明;真正调用购买之前还会再读一次系统状态,防止页面打开后限制发生变化。
禁止新购买不会关闭已有的本人购买或家庭共享权益。权益读取照常运行,恢复购买入口仍然保留。这个开关也不是年龄判断,设备管理限制同样可能让它返回 false。参见 canMakePayments。
恢复购买的提示,也要适用于家庭成员
原来的空结果提示只说“登录购买时用的账户”。对本人购买可以理解,对家庭成员却可能让人误以为应该在孩子的设备上登录家长的账户。
现在提示分开说明:本人购买用户核对“媒体与购买项目”所用的 Apple 账户;家庭共享用户确认家人已购买,并检查家庭购买项目共享设置。家庭成员应使用自己的家庭共享账户。恢复暂时没有找到权益,也不等于这个家庭从未购买过。
本地 Products.storekit 的 familyShareable: true 只说明开发测试配置允许共享,不能证明线上内购已经开启。线上开关、家庭成员自己的购买账户、共享设置以及交易是否下发,都仍要核对。参见 Apple 的共享购买排查步骤。
验证了什么,还有什么没有验证
- 25 项模拟交易检查通过。编译实际购买管理代码,替换 StoreKit 数据来源,覆盖价格挂起、失败和空结果,共享与本人购买,交易验证、撤销、恢复、购买限制变化和审批状态处理。这些是应用控制流程测试。
- iOS Simulator 与 Mac Catalyst 的 Debug 编译通过,五语文案检查通过。编译结果不代表购买已经在 Apple 服务端成交。
- 原生 StoreKit Testing 未完成。我们准备了 4 项原生测试,两次测试工程均编译成功,但本机模拟器/XCTest 执行未完成,重跑超时后中断。没有得到完整断言结果,也没有据此判定业务代码失败。
- 真实账号与线上配置仍待验证。包括成年和未成年家庭成员、跨设备和购买账户切换、待批准期间退出后再打开、Apple 实际下发共享与撤销交易,以及 App Store Connect 的线上内购配置。
这次代码修改解决了已经复现的启动等待问题,并补齐了新购买限制和家庭恢复提示。文章上线只代表这份开发记录已经公开,不能作为 App 更新已上架或真实家庭账号测试已完成的证据。
如果你现在仍然没有解锁
先在 Flick 的付费页点按“恢复购买”。如果是家庭共享,核对自己的家庭账户、“媒体与购买项目”和家庭购买共享设置;如果正在等待家长批准或兑换尚未完成,先完成 Apple 的系统流程。仍有问题时,可向 Flick 支持提供 App 版本、系统版本、本人购买还是家庭共享,以及恢复后显示的提示,方便进一步定位。