storekit2
iOS StoreKit 2 Flutter Plugin
参考官方demo，实现商店功能
Features
- 获取产品列表
- 获取用户购买的产品列表
- 获取某个订阅组的状态
- restore购买
- 监听购买状态的变化
说明
- Transaction, RenewalInfo等等这些类并没有返回iOS平台完整的字段，有些字段暂时没用到，或者有些字段高于iOS 15以后才有，就没有添加。
- 在iOS层会自动执行本地验证，服务端验证需要App层自己实现。
- iOS原生的StoreKit接口调用throw exception时会直接传递给Flutter Plugin Platform Exception, 但是Flutter插件层，没有解析和处理这个Exception, 所以如果调用插件接口的时候不try catch可能会导致程序崩溃
StoreKit2 资料
subscriptionGroupStatus
subscriptionGroupStatus 是一个用来表示订阅组状态的变量。在 StoreKit 2 中，Product.SubscriptionInfo.Status.State 枚举用来描述这个状态。它可以有以下几种可能的值：
.subscribed: 用户当前有一个活跃的订阅。.expired: 用户之前订阅过，但现在订阅已过期。.revoked: 用户的订阅被撤销（例如，由于退款）。.inGracePeriod: 用户的订阅处于宽限期，通常是因为付款问题。.inBillingRetryPeriod: 系统正在尝试再次收费。
举些例子来说明：
-
新用户首次订阅：
- 订阅前：
subscriptionGroupStatus可能是nil - 订阅后：
subscriptionGroupStatus变为.subscribed
- 订阅前：
-
用户的订阅到期：
- 到期前：
subscriptionGroupStatus是.subscribed - 到期后：
subscriptionGroupStatus变为.expired
- 到期前：
-
用户的付款方式失效，进入宽限期：
- 正常订阅时：
subscriptionGroupStatus是.subscribed - 进入宽限期：
subscriptionGroupStatus变为.inGracePeriod
- 正常订阅时：
-
用户在应用内请求退款，苹果批准了退款：
- 退款前：
subscriptionGroupStatus是.subscribed - 退款后：
subscriptionGroupStatus变为.revoked
- 退款前：
-
用户的订阅即将到期，但由于某些原因（如信用卡过期）无法续费：
- 正常订阅时：
subscriptionGroupStatus是.subscribed - 系统尝试续费：
subscriptionGroupStatus可能变为.inBillingRetryPeriod
- 正常订阅时：
在您的代码中，subscriptionGroupStatus 被用来确定用户的订阅状态。这对于管理用户访问权限、显示适当的UI、或者决定是否提供某些功能非常有用。
例如，您可以根据 subscriptionGroupStatus 的值来决定是显示"订阅"按钮还是"续订"按钮，或者是否允许用户访问某些仅限订阅者的内容。
订阅变化的规则
变化类型 | 生效时间 | 自动行为 升级 | ✅ 立即生效 | 旧订阅结束，折算新订阅 降级 | ⏳ 到期后生效 | 当前周期结束后自动切换 横向切换 | ⏳ 到期后生效 | 当前周期结束后自动切换 自动续费 | ✅ 每期自动续 | 到期前一天自动尝试扣费
transactionId和originalTransactionId
行为 | transactionId | originalTransactionId 原订阅（第一次） | 10000000001 | 10000000001 续订1 | 10000000002 | 10000000001 用户取消，订阅结束 | — | — 重新订阅（例如5月） | 10000000010 | 10000000010 续订2（6月） | 10000000011 | 10000000010
- transactionId：每一笔交易都不一样，就像“订单号”
- originalTransactionId：同一生命周期用一个，就像“会员卡号”
服务端验证
- https://developer.apple.com/documentation/appstoreserverapi
- 如何创建下载密钥：https://developer.apple.com/documentation/appstoreserverapi/creating-api-keys-to-authorize-api-requests
- 如何利用密钥创建jwt token:https://developer.apple.com/documentation/appstoreserverapi/generating-json-web-tokens-for-api-requests
- 在 App Store Connect 中创建一个 App Store Server API 密钥
发布命令
dart pub publish --server=https://pub.dartlang.org