用途
该技能用于在编写 Android 代码或服务端逻辑时，快速查阅 RevenueCat API 表面。它回答的典型问题包括：哪个 builder 选项控制某项 Purchases.configure 行为；awaitPurchase、awaitOfferings、awaitCustomerInfo、awaitRestore、awaitLogIn、awaitLogOut 的返回类型与签名；如何读取 offering、package、product、entitlement 字段；应针对哪个 PurchasesErrorCode 分支处理；为 customer info 更新注册哪个监听器回调。
该技能定位为速查参考，而非深度教程。需要分步指导或设计理由时，应使用功能专项技能（购买流程、配置 SDK、错误处理、订阅状态）。
主要能力
SDK 初始化
提供最小配置与完整选项示例，包括 appUserID、showInAppMessagesAutomatically、purchasesAreCompletedBy、entitlementVerificationMode、diagnosticsEnabled、pendingTransactionsForPrepaidPlansEnabled 等 builder 选项，以及 logLevel 设置。
核心操作（协程）
覆盖 awaitOfferings、awaitGetProducts、awaitPurchase（含升级/降级与 GoogleReplacementMode）、awaitCustomerInfo（含 CacheFetchPolicy）、awaitRestore、awaitLogIn、awaitLogOut 的调用方式与返回类型。
数据结构字段
列出 Offerings（current、all、按标识符索引、getCurrentOfferingForPlacement）、Offering（identifier、monthly、annual、weekly、availablePackages、metadata）、Package（identifier、packageType、product、webCheckoutURL）、StoreProduct（productId、title、description、price.formatted、price.amountMicros、price.currencyCode、period、subscriptionOptions、defaultOption）、CustomerInfo（entitlements.active/all、activeSubscriptions、nonSubscriptionTransactions、managementURL）、EntitlementInfo（isActive、willRenew、expirationDate、periodType、billingIssueDetectedAt、unsubscribeDetectedAt、store、productIdentifier、productPlanIdentifier、verification）等字段。
错误处理
说明 PurchasesTransactionException（userCancelled、error.code、error.message）与 PurchasesException（error.code），并列出关键错误码：PurchaseCancelledError、ProductAlreadyPurchasedError、PaymentPendingError、NetworkError、StoreProblemError、IneligibleError、ConfigurationError。
监听器
说明 updatedCustomerInfoListener 的注册方式，以及手动调用 showInAppMessagesIfNeeded。
典型代码片段
提供基于 entitlement 的功能门控、购买当前 offering 的月度套餐、区分取消与真实失败、服务端授予后强制刷新 CustomerInfo、登录并检测首次登录、响应后台 entitlement 变化等示例。
使用方式
先判断使用 SDK 表面还是 REST 表面：代码运行在 Android 应用内（Activity、ViewModel 或后台 worker），需要发起购买、恢复购买、读取缓存 CustomerInfo、获取 Offerings、识别或登出用户、监听更新，或进行 UI 中的 entitlement 门控时，使用 SDK。代码运行在后端、webhook 处理器、管理工具或定时任务中，需要授予或撤销促销 entitlement、覆盖订阅、从其他服务查询订阅者、退款或向其他系统投递事件，或集成无法嵌入 SDK 的系统时，使用 REST API。
该技能的表格逐字覆盖 Android SDK 10.x 表面。REST 端点路径、认证与载荷需参见 revenuecat.com 上的完整附录以及 backend 和 webhooks 技能，本文件作为 SDK 索引使用。
适用场景
适用于 Android 应用内购买与订阅相关代码的快速查阅，以及服务端逻辑中需要区分 SDK 与 REST 调用路径时的索引参考。
限制
该技能不是深度教程，不提供分步指导或设计理由。REST 端点路径、认证与载荷未在本技能中展开，需查阅完整附录及相关技能。