Flutter集成AppBoxo服务插件appboxo_sdk的使用

Flutter集成AppBoxo服务插件appboxo_sdk的使用

一个用于在iOS和Android上集成AppBoxo的Flutter插件。

使用方法

import 'package:appboxo_sdk/appboxo_sdk.dart';

Appboxo.setConfig("[client_id]"); // 设置你的AppBoxo client_id

Appboxo.setConfig("[client_id]", sandboxMode: false, multitaskMode: false);
// 'multitaskMode'仅适用于Android，默认为true，每个小程序都会出现在最近的任务列表中。

Appboxo.openMiniapp("[miniapp_id]", data, theme); 
// 通过ID启动小程序。[data]是一个map，theme可以是 "light" | "dark" | "system"

Appboxo.hideAllMiniapps(); // 使用此方法关闭所有小程序屏幕

Appboxo.logout(); // 在从应用中注销时调用此方法以清除所有小程序数据。

示例代码

Appboxo.openMiniapp("[miniapp_id]", "[data]");

使用此方法可以在启动小程序时传递数据。

自定义事件

处理来自小程序的事件并发送到小程序。

Appboxo.customEvents().listen((CustomEvent event) {
  if (event.appId == 'app12345') {
    event.payload = {"foo": "bar"};
    Appboxo.sendEvent(event);
  }
});

支付事件

处理来自小程序的支付事件并发送到小程序。

Appboxo.paymentEvents().listen((PaymentEvent event) {
  if (event.appId == 'app12345') {
    event.status = "success";
    Appboxo.sendPaymentEvent(event);
  }
});

Android 配置

需要AndroidX支持。在android/gradle.properties文件中添加以下配置：

android.useAndroidX=true
android.enableJetifier=true

完整示例代码

import 'package:flutter/material.dart';
import 'package:appboxo_sdk/appboxo_sdk.dart';
import 'package:fluttertoast/fluttertoast.dart';

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  Future<void> Function()? subscription;

  [@override](/user/override)
  void dispose() {
    subscription?.call();
    super.dispose();
  }

  [@override](/user/override)
  void initState() {
    super.initState();
    Appboxo.setConfig("602248",
        userId: "24", multitaskMode: true, theme: 'light');
    // 'multitaskMode'仅适用于Android，默认为true，每个小程序都会出现在最近的任务列表中。
    Appboxo.customEvents().listen((CustomEvent event) {
      print(event.toJson().toString());
      Fluttertoast.showToast(
        msg: event.payload["message"] ?? event.type,
        toastLength: Toast.LENGTH_SHORT,
        timeInSecForIosWeb: 1,
        backgroundColor: Colors.black,
        textColor: Colors.white,
        fontSize: 16.0,
      );
      Appboxo.sendEvent(event);
    });
    Appboxo.paymentEvents().listen((event) {
      event.status = "success";
      Appboxo.sendPaymentEvent(event);
    });

    Appboxo.miniapps().listen((result) {
      print('miniapps - ${result.miniapps.toString()}');
      result.miniapps?.forEach((data) => print(data.name));
      print('error - ${result.error}');
    });
    Appboxo.getMiniapps();

    subscription = Appboxo.lifecycleHooksListener(
      onAuth: (appId) {
        print(appId);
        print('onAuth');
      },
      onLaunch: (appId) {
        print(appId);
        print('onLaunch');
      },
      onResume: (appId) {
        print(appId);
        print('onResume');
      },
      onPause: (appId) {
        print(appId);
        print('onPause');
      },
      onClose: (appId) {
        print(appId);
        print('onClose');
      },
      onError: (appId, error) {
        print(appId);
        print(error);
        print('onError');
      },
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Appboxo SDK 测试'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              Appboxo.openMiniapp("app16973",
                  data: {'title': '标题'},
                  extraUrlParams: {'key': 'value'},
                  colors: {
                    'primary_color': '#000000',
                    'secondary_color': '#0000FF',
                    'tertiary_color': '#00FF00'
                  },
                  enableSplash: false);
            },
            child: const Text(
              '运行小程序',
              style: TextStyle(
                color: Colors.white,
                fontSize: 16,
              ),
            ),
          ),
        ),
      ),
    );
  }
}