Flutter测试跟踪插件test_track的使用

test_track 是一个用于 TestTrack 系统的 Dart 客户端库。它提供了客户端侧的分组测试和功能切换，通过简单的 API 来管理访客会话和分配。

配置

在使用 test_track 之前，必须调用 TestTrack.initialize() 方法来初始化客户端。以下是一个示例：

import 'package:test_track/test_track.dart';

Future<void> main() async {
  final testTrack = await TestTrack.initialize(
    baseUrl: 'https://example.com/',
    appVersionBuild: AppVersionBuild(
      appName: 'example',
      version: '0.0.1',
      buildTimestamp: '2020-01-01T00:00:00Z',
    ),
    dataStorageProvider: DummyDataStorageProvider(),
    analyticsProvider: DummyAnalyticsProvider(),
    logger: const ExampleTestTrackLogger(),
  );
}

初始化说明

• baseUrl: TestTrack 服务器的基础 URL。
• appVersionBuild: 应用程序的名称、版本和构建时间戳。
• dataStorageProvider: 数据存储提供者，用于缓存访客信息和分割注册表。
• analyticsProvider: 分析提供者，用于记录实验数据。
• logger: 日志记录器，用于记录调试信息。

初始化时，客户端会自动获取已存在的缓存访客配置。如果没有找到缓存访客，则会生成一个新的匿名访客并存储，同时获取最新的分割配置。

API 使用

Vary 方法

vary 方法用于执行分组测试。它接受三个参数：

final variant = testTrack.vary(
  splitName: 'homepage_redesign_q1_2022_experiment',
  defaultVariant: 'control',
  context: 'home',
);

• splitName: 分割名称，例如 "homepage_redesign_q1_2022_experiment"。
• defaultVariant: 默认变体，当用户被分配到未表示的变体时使用。
• context: 开发者提供的字符串，用于记录分配首次创建的位置。

AB 方法

ab 方法专用于两路分割和功能开关。它接受两个或三个参数：

final isFeatureGateEnabled = testTrack.ab(
  splitName: 'homepage_chat_bubble_enabled',
  context: 'home',
  trueVariant: 'specialTrueVariant', // 可选参数
);

• splitName: 分割名称，例如 "homepage_chat_bubble_enabled".
• context: 同上。
• trueVariant: 指定哪个变体为“真”变体，默认情况下假定变体名为 'true' 和 'false'。

登录方法

为了确保跨设备的一致体验，当用户登录新设备时应调用 logIn 方法：

await testTrack.logIn(identifier: 'myapp_user_id', value: '12345');

示例 Demo

下面是一个完整的示例 demo，展示了如何集成 test_track 到你的 Flutter 应用中：

import 'package:test_track/test_track.dart';

void main() async {
  final testTrack = await TestTrack.initialize(
    baseUrl: 'https://testtrack.test',
    appVersionBuild: AppVersionBuild(
      appName: 'example',
      version: '0.0.1',
      buildTimestamp: '2020-01-01T00:00:00Z',
    ),
    dataStorageProvider: DummyDataStorageProvider(),
    analyticsProvider: DummyAnalyticsProvider(),
  );

  if (testTrack.ab(splitName: 'some_feature_flag_enabled', context: 'app startup')) {
    print('Feature enabled!');
  } else {
    print('Feature disabled.');
  }
}

class DummyDataStorageProvider implements DataStorageProvider {
  // 实现细节...
}

class DummyAnalyticsProvider implements AnalyticsProvider {
  @override
  Future<void> identify({required String visitorId}) async {
    // 实现细节...
  }

  @override
  Future<void> trackAssignment({
    required String visitorId,
    required Assignment assignment,
  }) async {
    // 实现细节...
  }
}

此代码片段展示了如何初始化 test_track 并检查某个功能是否启用。根据返回值，你可以决定应用的行为路径。请根据实际需求调整 DummyDataStorageProvider 和 DummyAnalyticsProvider 的实现。