Flutter订阅管理与支付插件adapty_flutter的使用

发布于 1周前 作者 ionicwang 来自 Flutter

Flutter订阅管理与支付插件adapty_flutter的使用

简介

Adapty SDK 是一个开源框架,旨在简化Flutter应用中内购订阅的实现。它支持iOS、Android和Web平台,提供了一套轻量级且功能强大的工具集来帮助开发者快速集成和管理应用内的订阅服务。

为什么选择 Adapty?

  • 即时付费墙价格测试:无需发布新版本即可同时测试不同的价格、时长、优惠等。
  • 完整的客户支付历史记录:从试用开始到取消订阅或遇到账单问题的所有支付事件都可以追踪。
  • 无缝的数据集成:将订阅事件发送给第三方分析、归因和广告服务,即使用户卸载了应用程序。
  • 无需服务器代码实现:几分钟内完成带有服务器端收据验证的IAP集成,支持Apple促销优惠。
  • 高级分析图表:实时分析应用程序的关键指标,并通过广告网络、广告活动、国家/地区、A/B测试等多种维度进行过滤。

快速集成 IAPs(无需编写服务器端代码)

Adapty处理从免费试用到退款的所有流程,仅需一行代码就能实现复杂的订阅管理功能。包括但不限于:

  • 免费试用、升级、降级、交叉升级、家庭共享、续订、促销优惠、首次购买优惠、促销码等。
  • 支持一次性购买和终身订阅。
  • 跨iOS、Android和Web同步订阅状态。

示例代码

以下是一个简单的示例项目结构,展示了如何在Flutter应用中使用adapty_flutter插件:

import 'package:adapty_flutter_example/purchase_observer.dart';
import 'package:flutter/cupertino.dart';

import 'screens/main_screen.dart';
import 'screens/paywalls_view.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    // 初始化购买观察者
    PurchasesObserver().initialize();

    super.initState();
  }

  Future<void> _showErrorDialog(BuildContext context, String title, String message, String? details) {
    return showCupertinoDialog(
      context: context,
      builder: (ctx) => CupertinoAlertDialog(
        title: Text(title),
        content: Column(
          children: [
            Text(message),
            if (details != null) Text(details),
          ],
        ),
        actions: [
          CupertinoButton(
              child: const Text('OK'),
              onPressed: () {
                Navigator.pop(ctx);
              }),
        ],
      ),
    );
  }

  @override
  Widget build(BuildContext context) {
    return CupertinoApp(
        theme: CupertinoThemeData(
          brightness: Brightness.light,
          scaffoldBackgroundColor: CupertinoColors.systemGroupedBackground,
        ),
        home: CupertinoTabScaffold(
          tabBar: CupertinoTabBar(
            items: [
              BottomNavigationBarItem(
                icon: Icon(CupertinoIcons.home),
                label: 'General',
              ),
              BottomNavigationBarItem(
                icon: Icon(CupertinoIcons.money_dollar_circle_fill),
                label: 'Paywalls',
              ),
            ],
          ),
          tabBuilder: (context, index) {
            switch (index) {
              case 0:
                return CupertinoTabView(
                  builder: (context) {
                    return CupertinoPageScaffold(
                      child: MainScreen(
                          adaptyErrorCallback: (e) => _showErrorDialog(context, 'Error code ${e.code}!', e.message, e.detail),
                          customErrorCallback: (e) => _showErrorDialog(context, 'Unknown error!', e.toString(), null)),
                    );
                  },
                );
              case 1:
                return CupertinoTabView(
                  builder: (context) {
                    return CupertinoPageScaffold(
                      child: PaywallsView(
                        adaptyErrorCallback: (e) => _showErrorDialog(context, 'Error code ${e.code}!', e.message, e.detail),
                        customErrorCallback: (e) => _showErrorDialog(context, 'Unknown error!', e.toString(), null),
                      ),
                    );
                  },
                );
              default:
                return const SizedBox.shrink();
            }
          },
        ));
  }
}

此代码片段创建了一个包含两个标签页的应用程序,分别是“General”和“Paywalls”。每个页面都实现了错误回调函数来处理可能发生的异常情况,并通过PurchasesObserver类初始化了Adapty SDK以准备接收来自用户的购买请求。

社区和支持

加入我们活跃的Discord社区,与其他开发者交流经验,获取更多关于Adapty的帮助和支持。

Join Discord

许可证

Adapty遵循MIT许可证。详情请参阅 LICENSE 文件。


希望这篇文档能够帮助您更好地理解和使用Adapty Flutter插件!如果您有任何疑问或需要进一步的帮助,请随时联系我们的支持团队。


更多关于Flutter订阅管理与支付插件adapty_flutter的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter订阅管理与支付插件adapty_flutter的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter项目中,使用adapty_flutter插件可以方便地实现订阅管理和支付功能。以下是一个简单的代码示例,展示了如何集成和使用adapty_flutter插件。

1. 添加依赖

首先,你需要在pubspec.yaml文件中添加adapty_flutter依赖:

dependencies:
  flutter:
    sdk: flutter
  adapty_flutter: ^最新版本号  # 请替换为实际的最新版本号

然后运行flutter pub get来获取依赖。

2. 初始化Adapty

在你的Flutter应用的入口文件(通常是main.dart)中,初始化Adapty:

import 'package:flutter/material.dart';
import 'package:adapty_flutter/adapty_flutter.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 初始化Adapty
    Adapty.initialize(
      apiKey: '你的Adapty API Key',
      environment: AdaptyEnvironment.sandbox,  // 使用生产环境时,请替换为AdaptyEnvironment.production
      listener: (AdaptyUser user) {
        // 用户状态更新时的回调
        print('Adapty User Updated: $user');
      },
    );

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Adapty Flutter Example'),
        ),
        body: Center(
          child: SubscriptionScreen(),
        ),
      ),
    );
  }
}

3. 获取订阅产品并展示

接下来,你可以创建一个屏幕来展示和购买订阅产品。以下是一个简单的示例:

import 'package:flutter/material.dart';
import 'package:adapty_flutter/adapty_flutter.dart';

class SubscriptionScreen extends StatefulWidget {
  @override
  _SubscriptionScreenState createState() => _SubscriptionScreenState();
}

class _SubscriptionScreenState extends State<SubscriptionScreen> {
  List<AdaptyProduct> _products = [];

  @override
  void initState() {
    super.initState();
    // 获取订阅产品
    fetchProducts();
  }

  void fetchProducts() async {
    try {
      var products = await Adapty.fetchProducts(productIdentifiers: ['product_id_1', 'product_id_2']);
      setState(() {
        _products = products;
      });
    } catch (e) {
      print('Error fetching products: $e');
    }
  }

  void purchaseProduct(AdaptyProduct product) async {
    try {
      var purchase = await Adapty.purchaseProduct(product: product);
      print('Purchase successful: $purchase');
    } catch (e) {
      print('Error purchasing product: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return ListView.builder(
      itemCount: _products.length,
      itemBuilder: (context, index) {
        var product = _products[index];
        return ListTile(
          title: Text(product.localizedTitle),
          subtitle: Text('Price: ${product.localizedPrice}'),
          trailing: IconButton(
            icon: Icon(Icons.shopping_cart),
            onPressed: () => purchaseProduct(product),
          ),
        );
      },
    );
  }
}

4. 处理用户订阅状态

你可以通过监听Adapty用户状态的变化来更新UI或执行其他逻辑。这已经在main.dart中的Adapty.initialize部分进行了设置。

注意事项

  1. API Key: 确保你使用了正确的Adapty API Key。
  2. 产品标识符: 在fetchProducts方法中,使用你实际的产品标识符。
  3. 支付环境: 在生产环境中,记得将AdaptyEnvironment.sandbox替换为AdaptyEnvironment.production
  4. 权限和配置: 确保你的应用已经在App Store和Google Play上配置了相应的支付和订阅权限。

以上是一个基本的示例,展示了如何在Flutter项目中使用adapty_flutter插件进行订阅管理和支付。根据实际需求,你可能需要添加更多的错误处理、用户界面优化等功能。

回到顶部