SwiftyStoreKit 技术文档
安装指南
SwiftyStoreKit 支持多种安装方法,推荐使用 Swift Package Manager 以获取最新更新。
Swift Package Manager
对于 Xcode 11 及以上版本:
- 在 Xcode 中选择
File>Swift Packages>Add Package Dependency... - 输入仓库地址:
https://github.com/bizz84/SwiftyStoreKit.git
Carthage
在您的 Cartfile 中添加:
github "bizz84/SwiftyStoreKit"
然后执行 carthage update --platform iOS,tvOS,macOS。
CocoaPods
在 Podfile 添加以下行:
use_frameworks!
pod 'SwiftyStoreKit'
运行 pod install 来集成。
项目的使用说明
SwiftyStoreKit 设计为简单易用,支持 iOS, tvOS, watchOS 和 macOS 的内购处理。
应用启动时完成交易
确保在应用启动时处理未完成的交易,比如在 AppDelegate:
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
SwiftyStoreKit.completeTransactions(atomically: true) { purchases in
// 根据购买状态进行相应的操作
}
return true
}
获取产品信息
查询产品详情以便展示给用户:
SwiftyStoreKit.retrieveProductsInfo(["productID"]) { result in
switch result {
case .success(let products):
for product in products {
print(product.localizedDescription, product.localizedPrice!)
}
case .failure(let error):
print("Error retrieving products: \(error)")
}
}
进行购买
原子性购买,即时交付内容的例子:
SwiftyStoreKit.purchaseProduct("productID", atomically: true) { result in
switch result {
case .success(let purchase):
// 内容解锁并完成交易
SwiftyStoreKit.finishTransaction(purchase.transaction)
case .failure(let error):
print("Purchase failed: \(error)")
}
}
项目API使用文档
购买确认与恢复
为了处理已购项目验证和恢复,你可以这样操作:
SwiftyStoreKit.restorePurchases { result in
switch result {
case .success(let restoredPurchases):
for purchase in restoredPurchases {
// 恢复购买,如需解锁功能等
}
case .failure(let error):
print("Restore purchases failed: \(error)")
}
}
验证收据
SwiftyStoreKit提供了本地验证收据的功能,对于远程验证则需要结合服务器端逻辑实现。
总结
SwiftyStoreKit 是一个轻量级且易用的框架,简化了跨平台的内购流程。通过上述步骤,您应当能够顺利地安装该库,并在其基础上构建内购功能。记得,在实际部署中根据需求调整原子性和非原子性购买策略,并妥善处理交易回调中的各种状态变化。考虑到该项目现为社区维护,可能需要开发者额外的关注和支持来应对新特性的适配。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



