rc-setup

RevenueCat Android 设置

配置 RevenueCat 项目，让 Android SDK 能够获取产品方案、验证购买并授予权益。本技能涵盖仪表板端的设置，以及与 Google Play 的服务账号连接。

本技能的范围到“仪表板已就绪，API 密钥已拿到”为止。SDK 初始化代码属于 rc-configuring-the-sdk 技能。

阶段 1：信息确认

在操作 RevenueCat 仪表板之前，先确认以下事项。缺少任何一项都会导致连接步骤无法完成。

前置条件	所在位置	RevenueCat 需要它的原因
Google Play Console 应用	Play Console	仪表板通过包名进行连接
包名	Play Console 应用列表	必须与 Android 应用完全一致
应用内商品或订阅	Play Console 盈利设置	RevenueCat 会导入商品目录
订阅的基础方案	Play Console 订阅设置	Billing Library 6+ 要求提供基础方案
Google Cloud 服务账号 JSON	Google Cloud Console	RevenueCat 需要通过身份验证访问 Play Developer API
财务数据查看者权限	Play Console 用户和权限	服务账号需要读取订阅状态

询问用户：

• 应用是否已在 Play 上发布（包括仅限内部测试的发布）？
• 商品是否已在 Play Console 中上线，还是仍处于草稿状态？
• 是否已有服务账号 JSON，还是需要创建步骤？

如果商品尚不存在，请暂停。商品创建属于 Play Console 任务，不在本技能范围内。

阶段 2：规划

根据用户的当前状态选择相应路径。

状态	路径
没有 RevenueCat 账号	从步骤 1 开始，创建账号和项目
已有账号，但项目中没有 Android 应用	从步骤 2 开始，添加 Android 应用
已有应用，但尚未连接 Play	跳至步骤 3，上传服务账号
已连接 Play，但没有权益或产品方案	跳至步骤 4
配置已全部完成，只需获取 API 密钥	跳至阶段 4 验证

以下默认流程会从头到尾执行。用户已完成的步骤可以跳过。

阶段 3：执行

步骤 1：创建 RevenueCat 项目和 Android 应用

1. 在 app.revenuecat.com 注册或登录。
2. 创建项目。同一项目可以为同一产品容纳 Android、iOS 和 Web 应用。
3. 在项目中添加 Android 应用。输入 Play Console 中的包名。

RevenueCat 会为每个平台生成一个公开 SDK API 密钥。最后复制 Android 密钥。不要在 Android 应用中重复使用 iOS 或 Web 密钥。

步骤 2：创建 Google Cloud 服务账号（如有需要）

在 Google Cloud Console 中，进入与 Play Console 关联的项目：

1. 启用 Google Play Android Developer API。
2. 创建服务账号。跳过 Cloud 端的角色授权。
3. 为服务账号创建 JSON 密钥并下载。

在 Play Console 的“用户和权限”下：

1. 邀请服务账号邮箱。
2. 授予其对应用的应用级访问权限。
3. 授予“财务数据查看者”权限。RevenueCat 需要此权限来读取订阅状态。

步骤 3：在 RevenueCat 中连接 Google Play

在 RevenueCat 仪表板中，打开 Android 应用设置：

1. 确认包名与 Play Console 中的包名一致。
2. 上传服务账号 JSON 密钥文件。
3. 保存。

RevenueCat 会通过调用 Play Developer API 来验证凭据。如果验证失败，常见原因包括未启用 API、项目错误，或服务账号尚未在 Play 中生效（最多等待 24 小时）。

步骤 4：创建权益

权益是应用检查的访问级别。定义一次，即可在客户端代码中随处引用。

在仪表板的“权益”下，为每个访问层级创建一个权益。大多数应用只需一个权益。

标识符	描述
pro_access	解锁高级功能
team_access	解锁团队功能（可选的第二层级）

使用稳定的标识符。之后重命名权益，就意味着必须重写每个功能门控。

步骤 5：导入产品并关联权益

在 Products 下，点击 Import。RevenueCat 会通过已连接的服务账号拉取 Google Play 商品目录。

1. 选择要由 RevenueCat 管理的每个产品。
2. 将每个产品关联到一个权益。购买该产品即可获得相应权益。

一个权益可以关联多个产品（月度、年度和终身产品都可解锁 pro_access）。

步骤 6：创建一个 Offering

Offerings 决定用户在付费墙上看到的内容。一个 Offering 可包含多个套餐。

在 Offerings 下：

1. 创建一个 Offering（例如 default）。
2. 添加套餐。选择套餐类型（月度、年度、终身或自定义），并分配一个产品。
3. 将一个 Offering 标记为 Current。

Android SDK 会获取 offerings.current 以显示默认付费墙。之后可在控制面板中更换当前 Offering，无需发布应用更新。

步骤 7：复制 Android API 密钥

在 Android 应用设置中，复制公开 SDK API 密钥。此值是 PurchasesConfiguration.Builder 的第二个参数。技能 configuring-the-sdk 会用到它。

// Handed off to configuring-the-sdk
val revenueCatApiKey = "goog_xxxxxxxxxxxxxxxxxxxxxxxx"

第 4 阶段：验证

在开始 SDK 工作前，确认控制面板与 Play Console 已正确连接。

检查项	验证方法	通过信号
服务账号已接受	RevenueCat 应用设置中的 Google Play 部分	显示已连接，并带有绿色指示标记
产品已导入	控制面板中的 Products 标签页	显示 Play 产品及其实时价格
已关联权益	打开每个产品	显示已关联的权益
Offering 为当前项	Offerings 标签页	有一个 Offering 标记为 Current
套餐产品链接	打开当前 Offering	每个套餐都显示一个产品标识符
API 密钥范围	项目设置中的 API keys	Android 密钥与 iOS 和 Web 密钥不同

请用户确认每一行。如果产品未显示价格，说明服务账号已连接，但该产品在 Play 中未启用。修复 Play 商品信息，然后重新导入。

移交给 rc-configuring-the-sdk，并提供：

• Android API 密钥
• 当前 Offering 标识符
• 应用将检查的权益标识符

参考资料

• 完整章节