Flutter 集成

引入 Flutter 插件

在 Flutter 项目的 pubspec.yaml 文件,dependencies里添加插件配置:

dependencies:
  flutter:
    sdk: flutter
  # 添加插件配置
  hina_flutter_plugin:
    git:
      url: https://github.com/hinadt/hina-flutter-abtest-plugin.git
      ref: master

初始化 SDK

说明:flutter 安卓和iOS端初始化方法及参数如下:

void main() {
  WidgetsFlutterBinding.ensureInitialized();
    // 确保先初始化海纳嗨数埋点 Flutter SDK
    HinaFlutterPlugin.initForMobile(
        serverUrl: "#数据接收地址",
        enableLog: true,
        autoTrackTypeList: {
          HAAutoTrackType.APP_START,
          HAAutoTrackType.APP_END
        });
    // 初始化海纳嗨数AB测 Flutter SDK
    HinaFlutterAbtestPlugin.initForMobile('#分流接口');
    ...
  runApp(const MyApp());
}

Flutter 中获取试验变量

初始化 SDK 之后,通过 API 获取具体试验的变量值,根据获取试验变量值的方式,可分为下面三种策略:

  • fetchCacheABTest :读取本地缓存,缓存不存在时使用默认值
  • asyncFetchABTest :忽略本地缓存,从服务端获取数据
  • fastFetchABTest :优先读取本地缓存,缓存不存在时从服务端获取数据

示例:

// 注意试验变量类型,目前支持:数字、文本、布尔、json四种类型
String? color = await HinaFlutterAbtestPlugin.fetchCacheABTest('color', '#111111');

调试试验

获取设备id

通过海纳嗨数埋点 Flutter SDK 获取设备id,详见:【获取设备唯一ID】

建议:为方便产品/运营查看,接入方可在app内预留查看设备id后门功能,比如:接入方APP->设置页面->快速点击“版本号”5次,弹出一个弹窗,弹窗上显示设备id并支持复制。【由接入方自主实现】

录入设备列表

在海纳云平台找到调试页面,将设备id录入到调试设备管理列表中,在创建试验时,可以将指定调试设备录入到对应试验分组,这样就可以在调试设备看到分流后的试验效果了。

作者:王建华  创建时间:2024-09-04 15:53
最后编辑:王建华  更新时间:2024-09-14 18:04