Flutter优化实验与数据分析插件optimizely_dart的使用

Flutter优化实验与数据分析插件optimizely_dart的使用

optimizely_dart

Flutter/Dart 插件用于 Optimizely 原生 SDK。

入门指南

目前，Optimizely 没有为 Flutter 提供专用的 SDK。这个 Flutter 插件充当了 Flutter 应用程序和 Optimizely 的原生 FULL STACK SDKs（适用于 Android 和 iOS）之间的桥梁。

使用方法

在使用任何功能之前，你需要初始化并设置用户。

支持的功能包括：

• isFeatureEnabled：检查某个特性是否启用。
• getAllFeatureVariables：获取所有特性变量。
• getAllEnabledFeatures：获取所有已启用的特性。
• activategetVariable：激活并获取变量值。
• getVariable：获取特定变量值。
• trackEvent：跟踪事件。

import 'package:optimizely_dart/optimizely_dart.dart';

await OptimizelyPlugin.initOptimizelyManager('your_optimizely_sdk_key');
...
unawaited(OptimizelyPlugin().setUser(_personManager.person?.id, {'isLoggedIn': true}));
...
bool featureEnabled = await OptimizelyPlugin.isFeatureEnabled('your_flag', 'some_user@xyz.com');

var variation = await OptimizelyPlugin().getVariation('your_flag', 'some_user@xyz.com', {});

await OptimizelyPlugin().trackEvent('name', 'some_user@xyz.com', {});

安装

在项目的 pubspec.yaml 文件中添加 optimizely_dart 作为依赖项：

dependencies:
  optimizely_dart: ^0.1.0

然后在项目目录中运行 flutter pub get。

注意： 该插件是开源的，并由 HOMEX 贡献。

感谢： 这个插件源自于 optimizely_plugin 仓库。

示例代码

以下是完整的示例代码：

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:optimizely_dart/optimizely_dart.dart';

Future<void> main() async {
  runApp(MyApp());
}

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

class _MyAppState extends State<MyApp> {
  String _priceFilterFlag = '未知';
  String _minPriceVariable = '未知';
  final OptimizelyPlugin optimizelyPlugin = OptimizelyPlugin();

  [@override](/user/override)
  void initState() {
    super.initState();
    setupOptimizelyAsync();
  }

  void setupOptimizely() async {
    // 使用 Optimizely 示例数据文件：
    // https://docs.developers.optimizely.com/full-stack/docs/example-datafile
    final dataFile = await DefaultAssetBundle.of(context).loadString('assets/datafile.json');
    await optimizelyPlugin.initOptimizelyManager(
      'your_optimizely_sdk_key',
      dataFile,
    );
  }

  void setupOptimizelyAsync() async {
    await optimizelyPlugin.initOptimizelyManagerAsync(
      'your_optimizely_sdk_key',
    );
  }

  // 平台消息是异步的，因此我们初始化在一个异步方法中。
  Future<void> getPriceFilterFlag() async {
    String priceFilterFlag;
    // 平台消息可能会失败，所以我们使用一个 try/catch PlatformException。
    try {
      bool? featureEnabled = await optimizelyPlugin.isFeatureEnabled(
        'price_filter',
      );
      priceFilterFlag = '价格过滤器特性已启用: $featureEnabled.';
    } on PlatformException catch (e) {
      priceFilterFlag = "无法获取特性: '${e.message}'.";
    }

    // 如果在异步平台消息处理过程中，小部件从树中移除，则丢弃回复而不是调用 setState 来更新我们的非存在的外观。
    if (!mounted) return;

    setState(() {
      _priceFilterFlag = priceFilterFlag;
    });
  }

  Future<void> getPriceFilterMinPrice() async {
    String minPriceVariable;
    Map<String, dynamic> variables;
    try {
      variables = await optimizelyPlugin.getAllFeatureVariables(
        'price_filter',
      );
      int? minPrice = variables['min_price'];
      minPriceVariable = "最小价格变量为: ${minPrice.toString()}";
    } catch (e) {
      minPriceVariable = "无法从特性中获取最小价格变量: '$e'";
    }

    if (!mounted) return;

    setState(() {
      _minPriceVariable = minPriceVariable;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Optimizely 示例应用'),
        ),
        body: SafeArea(
          child: Column(
            children: [
              SizedBox(height: 32),
              Center(
                child: Text(_priceFilterFlag),
              ),
              ElevatedButton(
                child: Text('获取价格过滤器标志'),
                onPressed: () {
                  getPriceFilterFlag();
                },
              ),
              SizedBox(height: 16),
              Center(
                child: Text(_minPriceVariable),
              ),
              ElevatedButton(
                child: Text('获取价格过滤器最小价格'),
                onPressed: () {
                  getPriceFilterMinPrice();
                },
              )
            ],
          ),
        ),
      ),
    );
  }
}