Flutter内购插件实战指南：flutter_inapp_purchase全面解析

Flutter内购插件实战指南：flutter_inapp_purchase全面解析

flutter_inapp_purchase (Sun Rised!) Flutter plugin for In App Purchase. 项目地址: https://gitcode.com/gh_mirrors/fl/flutter_inapp_purchase

安装指南

要将flutter_inapp_purchase添加到您的Flutter项目中，请遵循以下步骤：

1. 打开您的Flutter项目中的pubspec.yaml文件。
2. 在dependencies部分添加以下行：

   dependencies:
     flutter_inapp_purchase: ^4.0.0
   

3. 执行flutter pub get命令以下载并安装依赖。

对于旧版本Flutter应用，请确保使用的版本小于4.0.0。

项目使用说明

初始化连接

在进行任何购买操作之前，您需要初始化内购模块。在您的代码中调用：

await InAppPurchase.instance.initConnection();

这对于Android是必需的，在iOS上则会简单地检查是否可以进行支付。

获取商品信息

• 获取普通商品：

  List<IAPItem> products = await InAppPurchase.instance.getProducts(productIds);
  

• 获取订阅商品：

  List<IAPItem> subscriptions = await InAppPurchase.instance.getSubscriptions(subscriptionIds);
  

查询购买历史与现有购买项

• 获取购买历史：

  List<IAPItem> history = await InAppPurchase.instance.getPurchaseHistory();
  

• 恢复已购买的商品（适用于非消耗品或未消费的订阅）：

  List<PurchasedItem> pastPurchases = await InAppPurchase.instance.getAvailablePurchases();
  

请求购买

发起一个购买请求，例如对某个商品：

await InAppPurchase.instance.requestPurchase(sku);

对于订阅的升级或降级，请使用requestSubscription方法，并根据平台提供必要的参数。

API使用文档摘要

| 方法名 | 功能简述 | | --------------------------- | -------------------------------------------------------------------------------------------------------- | | initConnection | 准备IAP模块，Android必备。iOS自动检测是否支持支付。 | | getProducts, getSubscriptions | 分别用于获取商品列表和订阅列表。注意iOS不区分商品与订阅类型。 | | getPurchaseHistory | 获取用户的购买记录。 | | getAvailablePurchases | 获取用户的所有未消费或非消耗性购买。 | | requestSubscription | 请求订阅某一sku，可包含升级/降级逻辑（Android特定参数）。 | | requestPurchase | 请求购买单一商品，含Android特定参数。 |

确保在使用这些功能时处理好错误情况以及监听purchaseUpdatedListener来跟踪购买状态的变化。遵循官方文档和示例代码，以便更好地集成此插件至您的Flutter应用中。

注意：针对Android X迁移等高级操作，请参考官方迁移指南以及具体版本更新日志。始终关注最新文档，以获得最佳实践和可能存在的更新细节。

flutter_inapp_purchase (Sun Rised!) Flutter plugin for In App Purchase. 项目地址: https://gitcode.com/gh_mirrors/fl/flutter_inapp_purchase