Flutter 接入RevenueCat后台配置相关

前言 RevenueCat (RC) 是目前 Flutter 开发内购 (IAP) 的首选方案,它帮我们抹平了 Apple 和 Google 支付接口的巨大差异。代码集成其实很简单,最折磨人的往往是后台配置------尤其是 Google Play 那繁琐的权限、API 开关和服务账号配置。

本文将手把手带你从零开始,走通 RevenueCat 的后台配置流程,特别是那些官方文档没细说、但很容易报错的坑。

RevenueCat地址:https://app.revenuecat.com/login

第一部分:RevenueCat 核心概念 (先懂逻辑,再动手)

在配置之前,必须理解 RevenueCat 的"套娃"逻辑,否则后面会乱:

  1. Products (商品) :商店里的原始商品(如 monthly_vip)。

  2. Entitlements (权益) :用户买到的是什么?(如 unlock_pro_features)。这是代码判断用户是否是 VIP 的唯一依据。

  3. Offerings (套餐) :把商品包装成套餐(如 Default 套餐下有月卡、年卡)。

  4. Packages (包):套餐里的具体选项(Monthly / Annual)。

逻辑链条 :App 展示 Offerings -> 用户购买 Package -> 对应到商店 Product -> 激活 Entitlement -> 代码解锁功能。

第二部分:iOS (App Store) 配置

1. 创建iOS:项目 -> Apps & providers -> New App Store app

  • 路径:项目 -> Apps & providers -> New App Store app

2、生成.p8文件

第一步:登录苹果后台
  1. 打开浏览器,访问 App Store Connect 并登录。

  2. 点击图标列表中的 "用户和访问" (Users and Access)。

第二步:生成密钥
  1. 在顶部导航栏,点击 "集成" (Integrations) 标签页。

  2. 在左侧菜单栏,选择 "App 内购买项目" (In-App Purchase)。

    • 注意:如果没有这个选项,请选择"App Store Connect API"并在生成时选择权限。但在 RevenueCat 中,推荐使用专门的"App 内购买项目"密钥。
  3. 点击列表右上角的 "+" (加号) 按钮生成新密钥。

  4. 名称 :随便填,建议填 RevenueCat 以便识别。

  5. 点击 "生成" (Generate)。

第三步:下载文件 (.p8)
  1. 在刚刚生成的密钥列表里,你会看到你新建的 RevenueCat 密钥。

  2. 点击右侧的 "下载 API 密钥" (Download API Key) 链接。

  3. ⚠️ 重要警告 :这个文件只能下载一次!下载后请妥善保存,不要丢失。如果不小心弄丢了,你只能撤销并重新生成一个新的。

  4. 下载下来的文件通常是以 AuthKey_ 开头,以 .p8 结尾的文件。


第四步:回到 RevenueCat 填空

回到你截图的那个 RevenueCat 页面:

  1. P8 key file from App Store Connect : 把刚才下载的 .p8 文件拖进去,或者点击上传。

  2. Key ID : 回到 App Store Connect 的那个列表页面,在刚才生成的密钥旁边有一列叫 "密钥 ID" (Key ID) ,复制那串字符(比如 ABC123DEFG)填入。

  3. Issuer ID : 回到 App Store Connect 的同一个页面,在标题的上方 (通常在"App 内购买项目"几个字的旁边或下方),有一行长长的 UUID 字符串,写着 "Issuer ID"。复制这串字符填入。

  4. 填写完两个.p8文件后点击save changes就创建成功了

3. iOS"商品和付费墙"相关的配置

第 1 步:导入/创建商品 (Product Catalog)
  • 点击左侧菜单的 Product Catalog (或者叫 Products)。

  • 点击 + New。

  • 你需要填入你在 App Store Connect 里申请的那个商品 ID。

  • 注意:这一步是告诉 RC 你有哪些货

第 2 步:创建权益 (Entitlements) ------ 最重要的一步
  • 点击左侧菜单的 Entitlements (在 Product Catalog 下面或者里面找)。

  • 点击 + New。

  • ID : 填 pro (或者 premium,这个字符串你会写在 Flutter 代码里)。

  • Description: 填 "Unlock all PDF features"。

  • Add Products: 把刚才第 1 步创建的商品选进去。

  • 注意:这一步是定义"买了商品后能得到什么"。

第 3 步:配置展示列表 (Offerings)
  • 点击左侧菜单的 Offerings。

  • 通常默认有一个 Default,点进去。

  • 在 Packages (比如 Monthly / Annual) 里,关联你刚才的商品。

  • 注意:这一步是决定"付费墙上显示哪几个按钮"。

第 4 步:设计付费墙 (Paywalls)
  • 做完上面三步,你才有资格点左侧的 Paywalls。

  • 进去选一个你喜欢的模板,把刚才的 Offering 选上,就能看到预览图了!

第三部分:Android(Google Play)配置

步骤 1:创建 Google Cloud 服务账号 (Service Account)

RevenueCat 需要这个账号作为"替身"去谷歌后台查账。

  • 操作路径 :Google Cloud Console -> IAM & Admin -> Service Accounts。

  • 创建一个账号,并下载 JSON 文件保存好。

步骤 2:开启 Developer API
  • 操作路径 :Google Cloud Console -> APIs & Services -> Enabled APIs -> 搜索 Google Play Android Developer API。

步骤 3:Play Console 赋予"查账"权限

光有账号不行,得去 Play Console 里授权。

  • 操作路径 :Google Play Console -> Users and permissions -> 点击你邀请的那个服务账号 -> Account permissions 标签页。

  • Financial data (财务数据) 下面的 View financial data 是勾选状态。

    • 不勾选这个,RevenueCat 只能看不能操作,数据回传会失败。
步骤 4:验证凭证有效性
  • 操作路径 :RevenueCat 后台 -> Project Settings -> Apps & providers -> Play Store。


第四部分:进阶避坑 ------ 实时通知 (Pub/Sub)

这是你之前卡得最久的地方(那个 Topic 选不上、按钮不亮的问题),这部分写出来价值连城。

步骤 5:创建 Topic 并授权
  • 操作路径 :Google Cloud Console -> Pub/Sub -> Topics -> 点击你的 Topic 进入详情 -> Permissions 面板。

  • 点击 Edit Principals 或查看列表,重点圈出 Principals 这一栏填的是: google-play-developer-notifications@system.gserviceaccount.com

    • 重点! 很多人这里习惯性填成了自己的服务账号,错! 必须填谷歌官方的这个发信机器人邮箱,赋予它 Pub/Sub Publisher 角色。不填这个,RevenueCat 永远收不到消息。
步骤 6:Play Console 最终联调
  • 操作路径 :Google Play Console -> Monetization setup -> Real-time developer notifications。

相关推荐
好的佩奇2 小时前
蓝牙之设备角色与连接
android·flutter·蓝牙
SoaringHeart1 天前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
恋猫de小郭2 天前
Flutter 3.50.0 Release 的第一个崩溃,修好了,还没 hotfix
android·前端·flutter
程序员老刘2 天前
跨平台开发地图 | 2026年11月
flutter·ai编程·客户端
传奇开心果编程3 天前
【Flutter踩坑排雷】第30课:异常未捕获坑|未捕获异常直接闪退,全局兜底故障处理
android·flutter·ios·移动开发·dart·ui框架·声明式ui
恋猫de小郭3 天前
Flutter Native Interop 稳定了,Platform Channel 要退场了
android·前端·flutter
好的佩奇3 天前
Dart 之可迭代对象与生成器
android·flutter·dart
恋猫de小郭4 天前
Flutter Analyzer 系列坑推进,必看,AI 时代这玩意最吃你内存
android·前端·flutter
LinXunFeng4 天前
拿竞品 App 一扫,技术栈全暴露了
android·flutter·开源
传奇开心果编程5 天前
【Flutter踩坑排雷】第28课:平台目录缺失与修复坑|`flutter create` 的“重建”与“覆盖”边界
android·flutter·ios·移动开发·跨平台·dart·声明式ui