05-revenuecat-setup.md

RevenueCat 設定指南

1. 帳號設定

• 在 RevenueCat 建立帳號。
• 建立一個新專案並加入您的應用程式 (Android/iOS)。
• 使用您的服務帳戶憑證與共用金鑰 (Shared Secrets) 來設定 Google Play Store 與 Apple App Store 連線。

2. 產品設定

• 權限 (Entitlements)：建立一個權限 (例如 'Pro' 或是 'Premium')。
• 方案 (Offerings)：建立一個方案 (例如 'default') 並在其中加入包裹 (Packages)。
• 產品 (Products)：設定訂閱產品，例如 1 個月與 3 個月的方案，對應到應用程式商店的識別碼。

3. SDK 安裝

pubspec.yaml 依賴項目

dependencies:
  purchases_flutter: latest

4. 程式碼整合

在應用程式生命週期中儘早初始化 RevenueCat。

import 'package:purchases_flutter/purchases_flutter.dart';

Future<void> initRevenueCat() async {
  await Purchases.setLogLevel(LogLevel.debug);
  
  PurchasesConfiguration configuration;
  if (Platform.isAndroid) {
    configuration = PurchasesConfiguration('YOUR_ANDROID_API_KEY');
  } else if (Platform.isIOS) {
    configuration = PurchasesConfiguration('YOUR_IOS_API_KEY');
  }
  
  await Purchases.configure(configuration);
}

登入/登出

將 RevenueCat 使用者綁定至您的 Firebase UID：

// 登入時
await Purchases.logIn(firebaseAuth.currentUser!.uid);

// 登出時
await Purchases.logOut();

5. 測試

• 沙盒測試 (Sandbox)：確保您在 Google Play 與 App Store Connect 中使用沙盒帳號。
• 測試使用者：在 RevenueCat 儀表板中建立測試使用者，以驗證認證考試模組的解鎖權限。

6. 必要的環境變數

7. 常見問題排除

• 無法取得產品：確認您的產品在 Google Play Console / App Store Connect 處於「有效 (Active)」狀態，且您已簽署所有待定的協議。
• API 金鑰無效：確保您使用的是公開的應用程式專用 API 金鑰，而非專案層級的私人金鑰。