小众平台也能做内购：flutter_inapp_purchase 在 Kindle、Fire TV 与 Horizon OS 上的完整配置指南

小众平台也能做内购flutter_inapp_purchase 在 Kindle、Fire TV 与 Horizon OS 上的完整配置指南【免费下载链接】flutter_inapp_purchaseFlutter In App Purchase plugin that confirms OpenIAP项目地址: https://gitcode.com/gh_mirrors/fl/flutter_inapp_purchaseflutter_inapp_purchase是一款遵循 OpenIAP 规范的 Flutter 内购插件In App Purchase plugin让开发者用同一套 Dart API 同时对接 Google Play、Apple、**AmazonKindle / Fire TV**和 **Meta Horizon OSQuest 系列**四大支付平台。对于想在智能电视、电纸书和 VR 头显上做付费变现的开发者来说这是一份可以直接照着做的完整配置指南 为什么选择 flutter_inapp_purchase 做多端内购大多数 Flutter 内购插件只覆盖 Google Play 和 Apple而 flutter_inapp_purchase 的核心优势在于能力说明 Amazon 平台内置 Amazon 内购 SDK自动检测 Kindle、Fire TV 设备 Horizon OS支持 Meta Quest 2 / Quest 3 / Quest Pro 的 VR 内购 自动路由运行时检测设备自动切换到正确的支付通道 统一 API所有平台共用同一套 Dart 接口无需为不同平台写分支代码它的设备识别逻辑位于 [android/src/main/kotlin/io/github/hyochan/flutter_inapp_purchase/FlutterInappPurchasePlugin.kt]插件启动时会检查是否安装了 Google Play 商店com.android.vending或 Amazon 商店com.amazon.venezia。如果两个都没检测到比如 Quest 头显则默认走 Android 通道由 OpenIAP 的 flavor 机制接管 Horizon 支付。 即使 Amazon 设备上侧载了 Google Play 商店插件也会根据应用是从哪个商店安装的来决定使用哪个支付通道避免误判。如需本地运行示例项目可克隆仓库git clone https://gitcode.com/gh_mirrors/fl/flutter_inapp_purchase一、Amazon Kindle 与 Fire TV 内购配置官方已备好完整的 Amazon 接入文档位于项目根目录的KINDLE.md插件本体也直接内置了 Amazon 内购 SDKandroid/jars/in-app-purchasing-2.0.76.jar。1. 配置 AndroidManifest.xml关键一步在android/app/src/main/AndroidManifest.xml中需要添加两样东西uses-permission android:nameandroid.permission.INTERNET/ receiver android:namecom.amazon.device.iap.ResponseReceiver android:exportedtrue intent-filter action android:namecom.amazon.inapp.purchasing.NOTIFY android:permissioncom.amazon.inapp.purchasing.Permission.NOTIFY / /intent-filter /receiver可参考示例应用的完整写法example/android/app/src/main/AndroidManifest.xml第 52~59 行。2. 零成本测试用 Amazon App TesterAAT好消息测试阶段完全不需要注册 Amazon 开发者账号在 Amazon 商店安装官方工具Amazon App TesterAAT准备一个amazon.sdktester.json测试商品清单文件项目里自带模板ancillary/amazon.sdktester.json在里面填入你自己的 Product ID模板中的商品示例涵盖了三种类型ENTITLED永久权益CONSUMABLE消耗型商品SUBSCRIPTION订阅用 adb 把文件推送到设备存储卡adb push amazon.sdktester.json /sdcard/在 AAT 中打开即可校验文件是否合法并查看商品列表之后你在 App 中发起购买时AAT 会拦截并弹出模拟购买界面——你的 App 会像收到真实支付一样走完整流程非常适合联调 3. 真实付费测试Live App Testing在 Amazon 开发者后台的Live App Testing标签页上传你的 APK在In-App Items标签页创建内购项目填写银行卡信息并提交等待状态变为live邀请测试者后他们会收到一个免付费测试链接⚠️ 一个容易踩的坑如果 Gradle 版本高于 3.4.0 并启用了代码混淆Amazon 支付会失效。解决方案是在android/app下创建proguard-rules.pro写入-dontwarn com.amazon.** -keep class com.amazon.** {*;} -keepattributes *Annotation*然后在build.gradle的 release 配置中引用该 Proguard 文件并关闭资源压缩。4. 上架 Amazon 商店的小贴士Amazon 开发者账号免费审核体验相对宽松应用截图尺寸与 Nexus 7 一致即可提交时系统会提示检测到 Google Billing只需在测试说明中注明使用跨平台工具Google IAP 代码未启用即可通过审核二、Horizon OSMeta Quest内购配置从 7.1.13 版本起插件通过 OpenIAP 的openiap-google-horizon封装支持了 Meta Quest 系列头显。完整教程位于docs/docs/getting-started/setup-horizon.md核心步骤如下1. 三个配置文件一键切换平台第一步在android/gradle.properties中启用 Horizon 模式horizonEnabledtrue第二步在android/local.properties中填入 Meta 后台申请的 App IDHORIZON_APP_IDyour_horizon_app_id_here第三步在AndroidManifest.xml的application标签内注入 App ID 占位符由 Gradle 自动填充meta-data android:namecom.meta.horizon.platform.ovr.HORIZON_APP_ID android:value${HORIZON_APP_ID} /2. 构建与运行命令# 默认构建 → Google PlayhorizonEnabled 默认为 false无需任何配置 flutter build apk --release # 构建 → Meta Horizon Store flutter build apk --flavor horizon --release # 直接连上 Quest 设备运行 flutter run --flavor horizon -d Quest整个切换机制由插件在android/build.gradle中通过product flavors实现playflavor 依赖 Google Play Billinghorizonflavor 依赖 Meta Platform SDK你的 Dart 代码一行都不用改✅3. 在 Quest 设备上测试在 Quest 设备上开启开发者模式电脑端执行adb devices确认设备已连接在 Meta Quest 开发者后台配置测试商品使用 horizon flavor 构建并运行4. 平台功能对照表功能Google PlayMeta Horizon一次性购买✅✅消耗型商品✅✅订阅✅✅购买验证 / 恢复购买✅✅优惠码Promo codes✅✅替代计费Alternative billing✅❌延迟支付Deferred payments✅❌三、统一 API所有平台一套代码无论目标平台是 Kindle、Fire TV 还是 QuestDart 侧调用完全一致// 1. 初始化连接 await FlutterInappPurchase.instance.initConnection(); // 2. 获取商品 final products await FlutterInappPurchase.instance.fetchProductsProduct( skus: [consumable_item], type: ProductQueryType.InApp, ); // 3. 发起购买 await FlutterInappPurchase.instance.requestPurchase( RequestPurchaseProps.inApp(( apple: RequestPurchaseIosProps(sku: consumable_item), google: RequestPurchaseAndroidProps(skus: [consumable_item]), )), );这套接口定义在lib/flutter_inapp_purchase.dart中配套的枚举与类型分别位于lib/enums.dart、lib/types.dart。常见问题速查问题解决方案Quest 上fetchProducts()返回空列表检查HORIZON_APP_ID是否正确、商品在 Meta 后台是否处于激活状态、SKU 是否完全匹配Quest 构建报 flavor 错误执行flutter clean并清理 Gradle 后重新以--flavor horizon构建App 在 Quest 上误走 Google Play确认gradle.properties中horizonEnabledtrue且使用了 horizon flavorAmazon 上支付无响应确认 Manifest 中已添加ResponseReceiver并在 release 包中保留 Amazon 混淆规则写在最后一次编写、多端变现借助 flutter_inapp_purchase 的自动设备检测与 flavor 构建机制你可以用同一份 Dart 代码覆盖 Amazon Kindle、Fire TV 电视以及 Meta Quest VR 头显这些小众却竞争更小、用户付费意愿更强的平台。建议从KINDLE.md和docs/docs/getting-started/setup-horizon.md两份官方文档入手配合example/目录下的示例 App 快速上手 【免费下载链接】flutter_inapp_purchaseFlutter In App Purchase plugin that confirms OpenIAP项目地址: https://gitcode.com/gh_mirrors/fl/flutter_inapp_purchase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考