用途:首次把 RevenueCat 接入项目,或用公开 API Key 重新配置 Purchases SDK。集成分两半,需按顺序执行:仪表盘侧通过 RevenueCat MCP 创建项目、注册应用、获取公开 API Key;应用侧安装 Purchases SDK、在入口调用 Purchases.configure(…),并在日志中确认配置横幅。即使用户只要求“安装 SDK”,也通常需要两半,因为 SDK 需要来自仪表盘的 API Key。若项目与应用已存在、只想接 SDK,可跳到第 3 节;若要新建项目(应用+产品+权益+Offering),改用 create-revenuecat-project 技能后再回来安装 SDK。
参数:platform 可选 ios、android、kmp、flutter、react-native,省略时按 3a 检测;app_identifier 可选,为 iOS Bundle ID 或 Android 包名,省略时从 Info.plist、AndroidManifest.xml、app.json、pubspec.yaml 读取;project_name 可选,省略时通过 MCP 列出项目并询问。
仪表盘侧:用 RevenueCat MCP 调用 list-projects 获取或创建项目,保存 project_id;检查项目中已有应用(test_store 始终存在,app_store 与 play_store 仅在用户完成商店侧配置后存在),确认商店配置后可调用 create-app(iOS 用 app_store 与 bundle_id,Android 用 play_store 与 package_name);再用 list-public-api-keys 获取公开 API Key(iOS 前缀 appl_,Android goog_,Amazon amzn_)。公开 Key 可嵌入客户端代码,secret key 仅限服务端,严禁放入客户端。
应用侧:按顺序检测平台(React Native、Flutter、KMP、Android、iOS),读取对应的 platforms/*.md,其中含安装命令、精确的 configure 片段及入口位置。通用要点:每次启动只调用一次 Purchases.configure(…),尽早执行;默认匿名用户,只有启动时已有认证用户才传 appUserID,否则稍后调用 logIn(…);集成期间启用调试日志,发布构建关闭;密钥不应进入源码管理,可用 .env、xcconfig、local.properties/gradle.properties 或 dart-define。
验证:需项目构建成功(Xcode、./gradlew assembleDebug、flutter run、npx react-native run-ios 或 KMP 等效方式),应用启动后 SDK 输出配置横幅,首次网络调用无认证错误。若用户只要求安装而未运行应用,应告知运行时需在日志中查看的内容。后续可接 paywall、purchase-flow、entitlements-gate、identify-user、testing-setup、troubleshoot 等技能。商店侧配置、价格与收费信息资料未提供。