RevenueCat/purchases-ios 开源项目使用教程

1. 项目介绍

RevenueCat 是一个强大的、可靠的、免费使用的应用内购买服务器，支持跨平台。其开源框架为 iOS、watchOS、tvOS、macOS 和 visionOS 提供了后端和 StoreKit 的封装，使得实现应用内购买和订阅变得简单。无论你是构建新应用还是已经有大量用户，RevenueCat 都能帮助你：

• 通过原生 SDK 获取产品、进行购买和检查订阅状态。
• 通过仪表板远程托管和配置产品。
• 在一个地方分析应用业务的关键指标。
• 查看客户交易历史、计算生命周期价值并授予促销订阅。
• 通过 Webhooks 实时接收事件通知。
• 通过简单的集成将丰富的购买事件发送到分析和归因工具。

2. 项目快速启动

安装

首先，使用 Swift Package Manager (SPM) 安装 RevenueCat SDK：

// 在 Xcode 中，选择 File > Swift Packages > Add Package Dependency
// 输入以下 URL:
https://github.com/RevenueCat/purchases-ios

初始化

在你的应用启动时初始化 RevenueCat SDK：

import Purchases

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    Purchases.configure(withAPIKey: "your_revenuecat_api_key")
    return true
}

获取产品

获取应用内购买产品：

Purchases.shared.getProducts(["your_product_id"]) { (products, error) in
    if let products = products {
        // 处理产品列表
    }
}

进行购买

进行应用内购买：

Purchases.shared.purchaseProduct(product) { (transaction, purchaserInfo, error, userCancelled) in
    if let purchaserInfo = purchaserInfo {
        // 处理购买成功
    }
}

检查订阅状态

检查用户的订阅状态：

Purchases.shared.purchaserInfo { (purchaserInfo, error) in
    if let purchaserInfo = purchaserInfo {
        // 检查订阅状态
    }
}

3. 应用案例和最佳实践

应用案例

• 订阅管理：使用 RevenueCat 管理应用的订阅服务，包括自动续订订阅和非续订订阅。
• 促销活动：通过 RevenueCat 的 Webhooks 和分析工具，实时跟踪促销活动的效果。
• 跨平台同步：在 iOS、macOS 和 tvOS 等多个平台上同步用户的订阅状态。

最佳实践

• 配置 In-App Purchase Key：在升级到 v5 时，确保在 RevenueCat 仪表板中配置 In-App Purchase Key，否则购买将失败。
• 使用 Webhooks：通过 Webhooks 实时接收购买事件，以便及时更新用户状态和发送通知。
• 集成分析工具：将 RevenueCat 与第三方分析工具集成，以便更好地了解用户行为和购买模式。

4. 典型生态项目

• Firebase Analytics：通过 Firebase Analytics 集成，跟踪用户行为和购买事件。
• Segment：使用 Segment 将 RevenueCat 数据发送到多个分析和归因工具。
• Mixpanel：通过 Mixpanel 分析用户留存和购买转化率。

通过这些生态项目的集成，可以更全面地分析和优化应用的盈利模式。