StoreKit 和 App 内购买项目的新功能

嗨 我叫 Rudy 很高兴为大家介绍 StoreKit 的新功能 并演示如何将 App Store Server Library 和全新的 StoreKit 2 API 集成到开发工作流中 首先 我将介绍 StoreKit 全新的核心框架功能 接着展示如何用 App Store Server Library 为 App 内购买请求签名

最后讲解如何通过 SwiftUI 和 StoreKit 视图 来推广订阅服务

我们先从三个关键类型的更新开始： AppTransaction、Transaction 和 RenewalInfo 这些类型能帮助你 深入理解 App 购买行为 让你能够追踪购买历史记录 并管理订阅状态 AppTransaction 可提供 App 原始购买信息 包括最初购买日期、 顾客下载的 App 版本号 以及在 App 正式发布 到 App Store 前的 预售日期等信息 例如 你可以通过 appVersion 提示顾客 升级 App 确保他们 始终使用最新版本 要获取 AppTransaction 数据 请查询 AppTransaction.shared API 并使用经过验证的结果 StoreKit 会自动验证 AppTransaction 的 JSON Web 签名 并在验证结果中返回一个 经过认证的值 AppTransaction 若经过验证 表示 StoreKit 已确认 AppTransaction 由 App Store 签名 且确实属于你的 App 和顾客的设备 我们致力于为你的商业策略 提供尽可能详尽的订阅和优惠信息 今年 我们在 AppTransaction 类型 中新增了两个字段 从 iOS 18.4 开始 AppTransaction 新增了 appTransactionID 字段 并向后兼容至 iOS 15 appTransactionID 是一个全局唯一值 对应每个下载你 App 的 Apple 账户 对于支持“家人共享”的 App appTransactionID 还会为家庭组中 的每个成员生成独立的值 借助 appTransactionID 你现在无需进行服务器间调用 就能执行一些操作 如关联不同的原始交易 ID

iOS 18.4 还引入了 originalPlatform 字段 originalPlatform 属于一种名为 AppStore.Platform 的新类型 这个值表示 顾客最初购买你的 App 时 所使用的平台 包括 iOS、macOS、Apple tvOS 或 visionOS 这些值与 App Store Connect 中 的目标平台一致 用户在 watchOS 上下载的 App originalPlatform 字段被设为 iOS 借助 originalPlatform 字段 你现在能更灵活地调整商业模式 例如从付费 App 转型为 含 App 内购买项目的免费 App 随着业务发展 originalPlatform 字段还能帮助你 为顾客提供适当的授权 接下来是 Transaction 类型的更新 Transaction 代表一笔 成功的 App 内购买项目 并包含有关购买的有用信息 Transaction 包含 App 内购买项目 的购买日期、商品 ID 等信息 对于自动续期订阅 还提供订阅到期时间 Transaction 的主要作用是 验证顾客权限并解锁相应内容 你的 App 通过 productID 字段 来确定应解锁的内容 系统会在购买成功后 即时返回一个 Transaction 或通过 Transaction 序列 如 Transaction.currentEntitlements 提供交易记录 无论你如何获取 Transaction 与 AppTransaction 类似 它始终会被封装在一个验证结果中 这意味着你无需手动验证交易 因为 StoreKit 2 会自动为你处理 关于当前权益 从 iOS 18.4 开始 productID API 的 Transaction.currentEntitlement 已被弃用并替换为新的 Transaction.currentEntitlements API 调用这个新 API 时 只需传入 productID 它将返回一个 Transactions 异步序列 授权顾客获取指定产品 由于一个顾客可能拥有多个 授予产品访问权的 Transaction 例如他们既持有订阅 又通过“家人共享”获得访问权限 建议你在项目中采用这一新 API 今年 Transaction 模型 新增了三个字段

首先是 appTransactionID 字段 它向后兼容至 iOS 15 是 App 下载 Transaction 的 唯一标识符 与之前提到的 AppTransaction 类型中的值一致 iOS 18.4 还引入了 “优惠期”字段 它包含在 offer 成员中 “优惠期”是指顾客在购买时 所兑换的订阅优惠关联的订阅期 最后 iOS 18.4 新增了 advancedCommerceInfo 字段 AdvancedCommerceInfo 仅适用于使用 Advanced Commerce API 的 App 对于未使用 Advanced Commerce API 的 App 这个字段始终为 nil Advanced Commerce API 可帮助你更轻松地为 大型内容库、创作者体验 以及支持可选附加功能的订阅服务 提供 App 内购买项目支持 为了支持 Advanced Commerce API StoreKit 2 提供了新的原生 API 包括 iOS 18.4 推出的 AdvancedCommerceProduct 以及 Transaction、 SubscriptionStatus 等现有 API 要了解更多关于 Advanced Commerce API 的信息 请访问本次讲座提供的网页资源列表 最后 我们来回顾 RenewalInfo 类型的更新 这个类型专为自动续期订阅设计 包含订阅是否会自动续订、 下次续订日期、 以及针对已过期订阅用户的 到期原因说明 订阅到期原因的一个典型使用场景是 当你近期上调服务价格 到期原因为 didNotConsentToPriceIncrease 此时可向顾客推送回头客优惠方案 鼓励他们重新订阅你的服务 StoreKit 将 RenewalInfo 数据封装 为 SubscriptionStatus 实例中的 VerificationResult 成员 你可通过多种方式获取 SubscriptionStatus 如调用 SubscriptionStatus updates API 或者使用订阅组 ID 向 StoreKit 查询订阅状态 请注意 当使用订阅组 ID 向 StoreKit 查询状态时 请务必根据业务模型中 定义的服务等级规则 始终以当前 SubscriptionStatus 中 最高级别的服务为准 来授予对 App 服务的访问权限 从 iOS 18.4 开始新增 支持 Transaction ID 的 SubscriptionStatus API 现在 你可以使用任意订阅 关联交易的 Transaction ID 向 StoreKit 查询订阅状态 今年 我们为 RenewalInfo 类型 新增了四个字段： appTransactionID 字段 已向后兼容至 iOS 15 “优惠期”和 advancedCommerceInfo 字段从 iOS 18.4 开始可用 我们还新增了 appAccountToken 字段用于将订阅关联至 你服务中的顾客账户 你可以在购买时 通过 appAccountToken 购买选项 选择性提供 appAccountToken App Store 会在与订阅关联的 RenewalInfo 的 新 appAccountToken 中 返回相同的值 要访问这些新增字段 你只需使用最新版 Xcode 构建 App 即可 我们相信这些新增字段 将简化 App 开发流程 帮助你打造更优质的用户体验 现在 让我们将焦点转向优惠代码 这些字母数字代码 可让你提供 限时折扣或免费订阅服务 顾客可以使用一次性兑换 URL 在 App Store 中兑换优惠代码 也可在你集成优惠代码 Redemption StoreKit API 的 App 中兑换 值得兴奋的是 优惠代码 现已支持消耗型商品、 非消耗型商品以及非续期订阅 顾客可通过 offerCodeRedemption API 在 App 内直接兑换优惠代码 若你的 App 基于 UIKit 则可使用 presentOfferCodeRedeemSheet API 对于消耗型商品、非消耗型商品 及非续期订阅的优惠代码兑换 可回溯至 iOS 16.3 系统版本 通过 StoreKit 2 API 成功兑换 优惠代码产生的 Transaction 可在任意操作系统版本中获取 若你的 App 支持 更早版本的操作系统 自动续期订阅的优惠代码兑换 可支持至 iOS 14.2 为支持非自动续期类商品的 优惠代码兑换 我们在 Transaction.Offer.PaymentMode 类型中 新增了一种支付模式 这描述了在优惠期内 根据优惠类型的不同 顾客是否会被收取费用的情况 这种类型表示多种支付模式 包括像 freeTrial 这样 无需付款的情况 其他付款方式还包括 payAsYouGo 和 payUpFront 现在在 iOS 中 你可以使用 oneTime 支付模式 处理 App 内购买项目优惠代码 这一模式向下兼容至 iOS 17.2 版本 如果你的 App 需支持 17.2 之前的系统版本 可通过 Transaction 的 offerPaymentModeStringRepresentation 成员访问这个支付模式 这一特性向下兼容至 iOS 15 如需深入了解如何设置 App 内购买项目优惠代码 请观看 2025 年讲座 “App Store Connect 的新功能？” 此外 自 iOS 18.2 起 StoreKit 新增了需要 UI 上下文的购买方法 App 需明确指定购买行为 发起的 UI 上下文 以确保系统能在设备 当前活跃场景的最直观区域 显示支付页面和成功对话框 这些新的购买方式从 iOS 18.2 及同期发布的 系统版本开始提供 你需要提供的 UI 上下文因平台而异 在 iOS、macCatalyst、Apple tvOS 和 visionOS 上 UI 上下文是 UIViewController 在 macOS 上则是 NSWindow 而 watchOS 开发 则无需提供 UI 上下文 若你基于 SwiftUI 视图购买 无需自行计算上下文 只需读取购买环境值 获取 PurchaseAction 实例即可 当准备执行购买时 直接调用 PurchaseAction 实例 因为它定义了 callAsFunction 方法 Swift 会在调用实例时 自动执行这个方法 若使用 StoreKit 视图 你完全无需考虑 UI 上下文问题

系统会自动处理 要了解如何通过 ProductView、StoreView 和 SubscriptionStoreView 为顾客打造一流的 App 内购买体验 请观看我们的 WWDC 23 讲座： “认识 StoreKit 与 SwiftUI” 在探讨完核心 API 增强功能后 我想请你关注另一个重要更新 今年 我们推出了需要 JSON 网页签名的新 API 下面让我们深入了解这些新 API 以及如何利用 App Store Server Library 来简化开发流程中的签名过程 今年新增的功能包括 通过 introductoryOfferEligibility 购买选项 设置顾客对推介促销优惠的 资格 使用 JWS 格式和新增的 promotionalOffer 购买选项 签署促销优惠 这两个新购买选项 都需要紧凑型 JWS 字符串 并向后兼容至 iOS 15 我们还为每个购买选项配套 推出了新的 SwiftUI 视图修饰符 使用 JWS 可帮助 App Store 验证你是否已授权 特定用例的购买行为 例如设置顾客对 促销优惠或推介促销优惠的获取资格 为简化签名流程 我们有 App Store Server Library 等优质开源工具 让请求签名变得轻松便捷 要了解为 App 创建签名请求的 速度有多快 让我们以 SKDemo 中的 促销优惠签名流程为例 开始前 你需要先从 App Store Connect 获取 App 内购买项目签名密钥 具体步骤为： 进入“用户和访问”标签页 点按“集成”导航栏

在左侧菜单中选择 “App 内购买项目” 你可以使用任意有效密钥 或创建新密钥 请务必记录 App 内购买项目 签名密钥的 颁发者 ID 和密钥 ID 现在你已获取 App 内购买项目签名密钥 下面来看看 SKDemo 中的 App 内订阅商店 订阅商店展示了顾客可购买的 订阅方案 我想重新吸引订阅已过期的顾客 为此 我将使用基于 JWS 的 subscriptionPromotionalOffer 修饰符 在 Pro 方案上展示促销优惠 这个修饰符需要两个闭包 第一个闭包 提供 适用于购买指定订阅的订阅优惠 本例中 我通过预先创建的辅助方法 选择为 Pro 方案提供 最长免费试用期的促销优惠 第二个闭包 需要包含签名优惠详情的 紧凑型 JWS 字符串 这里由 NetworkLayer 类型 提供给我们 让我们仔细看看具体是如何实现的 在我们的 NetworkLayer 中 我们将产品和订阅优惠的 productID 和 offerID 作为 查询参数传递给请求 接着 我们向服务器上的 促销优惠签名路由 发起 GET 请求 最后对响应进行解码 在服务器项目中 你需要首先添加 App Store Server Library Swift 包依赖 并导入 App Store Server Library 在实现处理促销优惠 签名请求的路由时 需要创建一个促销签名上下文 方法是使用 App 的套装 ID、 之前从 App Store Connect 获取的 签名密钥、密钥 ID 和颁发者 ID 来初始化 PromotionOfferV2SignatureCreator 然后调用 createSignature 函数 并提供 待购买订阅的 productID 订阅优惠的 offerID 最佳实践是同时为 Transaction ID 字段提供一个值 这个值可以是 appTransactionID 或属于顾客的 任意 Transaction 的 TransactionID 虽然 TransactionID 字段是可选的 但建议包含这个字段

回到 App 此时促销优惠 即可成功兑换 购买流程也将顺利完成 这些就是使用 App Store Server Library 创建 签名版 App 内购买请求的全流程 对 App 内购买请求 进行签名可确保 App Store 验证交易的授权有效性 而与 App Store Server Library 的集成让请求签名变得简单高效 最棒的是 App Store Server Library 目前支持四种编程语言： Java、Python、 Node.js 和 Swift 要开始使用 App Store Server Library 请观看 WWDC24 讲座 “探索适用于 App 内购买项目的 App Store Server API” 对于最后一组更新 我们来了解一种使用 SwiftUI 与 App 顾客互动的新方式 我很高兴向大家介绍 StoreKit 视图家族的新成员 SubscriptionOfferView 这是一款专为推广 自动续期订阅服务设计的 SwiftUI 视图 旨在有效吸引顾客 关注你的 App 服务 你可以使用已载入的自动续期订阅或 直接传入自动续期订阅的 productID 来声明 SubscriptionOfferView 以这种方式声明时 视图会从 App Store 载入产品元数据 你还可将 prefersPromotionalIcon 标志设为 true 选择使用在 App Store Connect 中 设置的订阅图标 来装饰视图 当系统完成订阅元数据加载后 装饰性图标便会显示 若你希望使用自定义图标 可通过这个 API 的替代写法实现 只需传入一个尾随的 ViewBuilder 闭包即可 你还可以提供自定义占位图标 这个图标将在从 App Store 服务器 下载订阅元数据期间显示 SubscriptionOfferView 的功能 远不止展示单个订阅方案 当与新的 subscriptionOfferViewDetailAction 修饰符配合使用时 这个视图还能将顾客引导至 App 内的订阅商店等场景 声明这个修饰符 会在视图上绘制 detailLink 按钮 当顾客轻点这个按钮时 视图将调用 修饰符的路径关闭逻辑 这是 SKDemo 中的一个示例 我在 ContentView 中 修改了某些状态量 这些状态控制着 App 用户流程的呈现方式 当顾客轻点 detailLink 按钮时 App 会将用户导航至订阅商店 展示可购买的订阅方案 在使用这个 API 时需重点考虑 选择哪种订阅方案进行推广 或者是否应该完全展示出来 让我们回到代码 通过示例 了解这个 API 的使用方法 在使用 SubscriptionOfferView 推广订阅方案前 首先需要确定顾客的订阅状态 对于基于 SwiftUI 构建的 App 最佳实践是 在 App 协议的实现中进行这一判断 进而将数据传递至 视图层级的其他部分 具体步骤为 声明 iOS 17 引入的 subscriptionStatusTask 修饰符 然后在修饰符中将 StoreKit 返回的订阅状态 转换为 App 能理解的模型 在 SKDemo 中 这个模型名为 SKDemoPlusStatus 接着更新视图中 用于跟踪订阅状态的可信数据源 并通过环境变量将它 注入到视图层级中

现在 我已获取顾客订阅状态 接下来将在 ContentView 中 展示 SubscriptionOfferView 此处通过读取 包含用户状态的环境变量 决定如何呈现订阅选项： 若用户未订阅 则推广标准套餐 若已订阅 则展示更高阶套餐 为保持代码简洁 我将采用订阅组 ID 构造器 创建 SubscriptionOfferView 这种方式下系统会自动 从订阅组中选择对应套餐 你还需指定所推广套餐 与顾客当前套餐的关联关系 visibleRelationship 参数支持 五种取值：升级、 降级、平级转换、 当前套餐和全部套餐 这个 API 的行为会随顾客状态而异 我们来仔细看看每种关联关系 首先从“升级”开始 为便于演示 假设示例中的顾客 当前订阅了中档套餐 若指定升级关系 视图将向顾客推广 比当前套餐高一级的订阅方案 而降级则呈现相反逻辑 在本例中 无论顾客是否订阅 看到的都是同一档位套餐 若顾客已关闭自动续期 你可能希望 在续费周期结束前推广 更经济的套餐以留住用户 平级转换会筛选订阅组中 与当前套餐同档位的方案 并自动选择性价比最优选项 若使用当前套餐关系 则直接展示 顾客正在使用的方案 默认会禁用所有交互操作 除非存在可兑换的订阅优惠 你可以通过任意优惠修饰符 例如新增的 subscriptionPromotionalOffer 或 preferredSubscriptionOffer 来标记顾客是否符合优惠条件 这种关系的典型应用场景是 当订阅即将到期时 通过展示折扣优惠来提高留存率 最后是“全部套餐”关系 这种关系对所有顾客的行为始终一致 以这种方式初始化后 视图会展示订阅组中 所有套餐的价格信息 你需要通过声明 subscriptionOfferViewDetailAction 修饰符 来指定视图的交互行为 无论你以哪种关系创建 SubscriptionOfferView 都可以像本讲座之前提到的示例那样 使用自定义图标或占位图标进行装饰 使用 App 的图标也非常方便 只需将 useAppIcon 标志 设为 true 即可 至此 我们已介绍完新的 SubscriptionOfferView 它让你以一种创新的方式与顾客互动 今天 我介绍了多项 StoreKit API 增强功能 这些功能将帮助你为顾客提供 出色的 App 内购买体验 如果你尚未采用 StoreKit 2 现在正是将它 集成到项目中的最佳时机 要获取最新设计并在 你的 App 中打造出色的商店 使用 StoreKit 视图来展示 App 内购买项目和订阅服务 查看 GitHub 上的 App Store Server Library 并将它集成到项目中 轻松实现 App 内购买请求签名 要深入了解 App Store Server API 推荐观看 WWDC25 全新讲座 “深入探索适用于 App 内购买项目 的 App Store Server API” 要开始使用 StoreKit 2 可从 WWDC21 讲座“了解 StoreKit 2” 入门 感谢大家今天的参与 期待看到你 使用 StoreKit 构建的成果