Flutter A/B 测试插件 ab_testing_firebase 的使用

AB Testing - Firebase

一个简化了与 Firebase Remote Config 实现远程 A/B 测试的 Dart 包。

特性

此包通过添加一个额外的 Firebase 适配器扩展了 ab_testing_core 包，从而实现了与 Firebase Remote Config 的远程 A/B 测试。

开始使用

在项目的 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  ab_testing_core: ^1.0.0
  ab_testing_firebase: ^1.0.0

完成后运行 flutter pub get 来安装依赖。

使用方法

你可以创建一个继承自 ExperimentConfig 的配置类，并为每个实验选择所需的适配器。在初始化时可以直接指定每个实验使用的适配器。

创建实验配置类

// 定义实验配置类
class ExampleExperimentConfig extends ExperimentConfig {
  // 定义本地实验
  final Experiment<bool> localExperiment;
  // 定义远程实验
  final Experiment<bool> remoteExperiment;

  // 初始化实验配置，传入两个适配器
  ExampleExperimentConfig(
    ExperimentAdapter localExperiments,
    ExperimentAdapter remoteExperiments,
  )   : localExperiment = localExperiments.boolean(id: 'localExperiment'),
        remoteExperiment = remoteExperiments.boolean(id: 'remoteExperiment'),
        super([localExperiments, remoteExperiments]);
}

初始化适配器并传递给实验配置

// 初始化本地实验适配器
final _localExperiments = LocalExperimentAdapter(_storage.userSeed);

// 初始化 Firebase 实验适配器
final _remoteExperiments = FirebaseExperimentAdapter();

// 创建实验配置实例
final _experimentConfig = ExampleExperimentConfig(_localExperiments, _remoteExperiments);

访问实验结果

可以通过配置直接获取实验的结果值。

// 获取本地实验的结果
bool get local => _experimentConfig.localExperiment.value;

// 获取远程实验的结果
bool get remote => _experimentConfig.remoteExperiment.value;

完整示例代码

以下是一个完整的示例代码，展示如何使用 ab_testing_firebase 插件进行 A/B 测试：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

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

class _HomePageState extends State<HomePage> {
  late final ExperimentAdapter _localExperiments;
  late final ExperimentAdapter _remoteExperiments;
  late final ExampleExperimentConfig _experimentConfig;

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

    // 初始化本地实验适配器
    _localExperiments = LocalExperimentAdapter('userSeed');

    // 初始化 Firebase 实验适配器（模拟数据）
    _remoteExperiments = FirebaseExperimentAdapter();

    // 创建实验配置
    _experimentConfig = ExampleExperimentConfig(
      _localExperiments,
      _remoteExperiments,
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('A/B Testing Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Local Experiment Value: ${_experimentConfig.localExperiment.value}'),
            SizedBox(height: 20),
            Text('Remote Experiment Value: ${_experimentConfig.remoteExperiment.value}'),
          ],
        ),
      ),
    );
  }
}

// 模拟的 Firebase 实验适配器
class FirebaseExperimentAdapter implements ExperimentAdapter {
  [@override](/user/override)
  T boolean<T>({required String id}) {
    // 模拟从 Firebase Remote Config 中获取值
    if (id == 'localExperiment') {
      return false as T;
    } else if (id == 'remoteExperiment') {
      return true as T;
    }
    throw ArgumentError('Invalid experiment ID: $id');
  }
}