• StoreHelper 文档着陆页 - StoreHelper 文档着陆页
• StoreHelper 快速入门 - StoreHelper 快速入门指南
• StoreHelper 深入指南 - StoreHelper 和 StoreKit2 深入指南
• StoreHelper 演示项目 - Xcode 示例 StoreHelper 项目
• StoreHelper UIKit 演示 - 展示 StoreHelper 在 UIKit 项目中的实验性演示

SKHelper 是一个新的（2024 年 9 月），轻量级的 Swift 软件包，使开发者能够轻松地向其基于 SwiftUI 的应用添加应用内购买和订阅功能。

旨在成为更易于使用的 StoreHelper 重构版本，它利用 Apple 的 StoreKit Views 来提供标准且易于自定义的 UI。

查看 SKHelper 代码仓库 和 快速入门教程，以快速了解其工作原理。

• 2024 年 5 月 5 日
  • 简化订阅显示价格逻辑以使用 Apple 的 subscriptionPeriodFormatStyle，该样式也支持本地化。由 Hengyu 添加（谢谢！）
• 2024 年 4 月 2 日
  • 由 Hengyu 添加了对 tvOS 的基本支持（谢谢！）
• 2024 年 3 月 15 日
  • 重组文档以支持 DocC
• 2024 年 3 月 8 日
  • 添加了隐私政策清单
• 2024 年 1 月 24 日
  • 由 Hengyu 添加了对 visionOS 的基本支持（谢谢！）
• 2023 年 6 月 23 日
  • 改进了在应用未运行时发生的订阅续订和到期处理
  • 请参阅 AppStoreHelper.paymentQueue(_:updatedTransactions:) 和 StoreHelper.handleStoreKit1Transactions(productId:date:status:transaction:)
• 2023 年 2 月 12 日
  • 使订阅产品的配置更加灵活
  • 现在，您可以依赖命名约定（如以前一样），或者在 "Products.plist" 中使用 "Subscriptions" 部分
  • 有关详细信息，请参阅 Samples/Configuration/SampleProducts.plist 文件
  • 向 StoreHelperDemo 项目添加了单元测试
• 2023 年 1 月 27 日
  • 修复了与可消耗产品的 isPurchased 相关的错误。导致 macOS 和 iOS 崩溃（谢谢 Abdullah Kardaş！）
• 2023 年 1 月 18 日
  • 添加了各种活动的其他日志记录
• 2023 年 1 月 17 日
  • 改进了对处理 StoreKit 和 App Store 响应的延长等待时间的支持
  • 改进了购买状态的缓存
  • 更新了许多共享视图以处理未知的购买状态
• 2023 年 1 月 10 日
  • 添加了对在 isPurchased(productId:) 中缓存产品购买状态的支持，使用了 purchasedProductsFallback 集合
  • 使用 purchasedProductsFallback 作为缓存可以使用 StoreHelper.doUsePurchasedProductsFallbackCache 打开/关闭
  • purchasedProductsFallback 属性现在是 public private(set) 而不是 public
  • 向产品列表添加了 "刷新产品" 按钮和对下拉刷新的支持
  • 对各种视图进行了 UI 改进，并改进了 iOS 和 macOS 之间视图的共享
  • 较小的文档更新（StoreHelper 指南）
• 2022 年 12 月 13 日
  • 添加了概念验证演示，展示了 StoreHelper 在 UIKit 项目中
• 2022 年 11 月 27 日
  • 对订阅处理方式的重大更新
  • 订阅价格现在显示价格和续订周期
  • 现在支持订阅的促销和介绍性优惠
  • 最合适的促销或介绍性优惠或标准价格和续订周期会自动显示
  • 添加到 StoreHelper.SubscriptionHelper 的内容：hasLowerValueCurrentSubscription(than:)、isLapsedSubscriber(to:)、allSubscriptionTransactions()
  • 添加了应用内兑换优惠码的功能
  • 在指南中添加了关于 "订阅介绍性和促销优惠" 以及 "支持应用内优惠码兑换" 的新章节
  • 快速入门和指南文档已针对 iOS16/macOS13/Xcode14 和新的订阅功能进行了审查和更新
• 2022 年 11 月 7 日
  • 关于升级到 iOS 16 和 macOS 13 的微小更改
• 2022 年 10 月 19 日
  • 在指南中添加了关于 "恢复以前的购买" 的新章节
• 2022 年 3 月 15 日
  • 由于 Xcode 13.3 中与具有 @MainActor init() 相关的新的警告，更改了初始化流程
  • 通过将一些初始化代码移动到新的 start() 方法，消除了 StoreHelper 的 init 方法在主线程上运行的需要
  • 现在，您应该在初始化 StoreHelper 后尽快调用 StoreHelper.start()
  • start() 方法开始监听交易并从 App Store 获取本地化的产品信息
  • 由于此更改，更新了所有文档
• 2022 年 1 月 25 日
  • 将 StoreHelper 重构为 SPM 软件包
  • 将示例应用移动到单独的代码仓库 (StoreHelperDemo)
  • 关于更改为 SPM 软件包的更新文档
• 2022 年 1 月 19 日
  • 文档的重大更新
  • 添加了 Mac 目标
• 2021 年 12 月 21 日
  • 更新了文档以反映重构更改
• 2021 年 12 月 20 日
  • 进行了全面的重构，以便此非私有版本的 StoreHelper 与在发布到 App Store 的应用中使用的私有 StoreHelper 代码同步

StoreHelper 是一个 Swift Package Manager (SPM) 软件包，使使用 Xcode 13 - 15 的开发者能够轻松地向 iOS 15 - 17 和 macOS 12 - 14 SwiftUI 应用添加应用内购买支持。该软件包还为 visionOS 和 tvOS 提供基本支持。

StoreHelper 用于在 Writerly (iOS/macOS) 中提供应用内购买支持，该应用可在 App Store 上找到。

StoreHelper 提供以下功能

• 多平台（iOS、macOS）SwiftUI 支持购买 Consumable、Non-consumable 和 Subscription 产品
• 详细的文档和一个示例项目
• 支持交易验证、待处理（“请求购买”）交易、已取消 和 失败 交易
• 支持客户退款和订阅管理
• 支持 介绍性优惠、应用内兑换 优惠码 和对 促销优惠 的实验性支持
• 为非消耗品和订阅提供详细的交易信息和历史记录
• 支持直接通过 App Store 购买推广的应用内购买

MIT 许可证，版权所有 (c) 2022、2023、2024 Russell Archer。本软件按 "原样" 提供，不提供任何担保，可以自由使用、复制、修改和重新分发，包括作为商业软件的一部分。

有关详细信息，请参阅 许可证。

StoreHelper 使用 Apple 的 StoreKit2，这需要 iOS 15 - 17、macOS 12 - 14 和 Xcode 13 - 15。

跳转到 StoreHelper 快速入门 指南。