Flutter自动化测试插件testfairy的使用

TestFairy 是一款用于移动应用测试的强大工具，支持捕获用户会话并帮助开发人员快速识别和修复问题。本指南将介绍如何在 Flutter 应用中集成 TestFairy 插件。

安装

首先，在项目的 pubspec.yaml 文件中添加 TestFairy 依赖：

dependencies:
  testfairy: any

然后运行以下命令以安装依赖：

flutter pub get

快速开始

以下是 TestFairy 在 Flutter 中的基本集成步骤：

1. 配置项目

确保您的项目兼容 AndroidX，并且最低支持的 iOS 版本为 9.0。

2. 初始化 TestFairy

在 main.dart 文件中引入必要的库并初始化 TestFairy：

import 'dart:async';
import 'dart:io';
import 'package:testfairy/testfairy.dart';

void main() {
  // 设置全局 HTTP 覆盖
  HttpOverrides.global = TestFairy.httpOverrides();

  // 使用 runZonedGuarded 运行应用
  runZonedGuarded(
    () async {
      try {
        // 捕获 Flutter 错误日志
        FlutterError.onError = (details) => TestFairy.logError(details.exception);

        // 开始 TestFairy 会话（请根据实际需求设置 APP_TOKEN）
        await TestFairy.begin('YOUR_APP_TOKEN');

        // 启动应用
        runApp(TestFairyGestureDetector(child: TestfairyExampleApp()));
      } catch (error) {
        TestFairy.logError(error);
      }
    },
    (e, s) {
      TestFairy.logError(e);
    },
    zoneSpecification: new ZoneSpecification(
      print: (self, parent, zone, message) {
        TestFairy.log(message);
      },
    ),
  );
}

注意：请将 YOUR_APP_TOKEN 替换为您从 TestFairy 获取的实际应用令牌。

示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 中使用 TestFairy 插件进行功能测试：

import 'dart:async';
import 'dart:io';
import 'package:testfairy/testfairy.dart';

void main() {
  HttpOverrides.global = TestFairy.httpOverrides();

  runZonedGuarded(
    () async {
      try {
        // 捕获 Flutter 错误日志
        FlutterError.onError = (details) => TestFairy.logError(details.exception);

        // 开始 TestFairy 会话
        await TestFairy.begin('YOUR_APP_TOKEN');

        // 启动应用
        runApp(TestFairyGestureDetector(child: TestfairyExampleApp()));
      } catch (error) {
        TestFairy.logError(error);
      }
    },
    (e, s) {
      TestFairy.logError(e);
    },
    zoneSpecification: new ZoneSpecification(
      print: (self, parent, zone, message) {
        TestFairy.log(message);
      },
    ),
  );
}

// 示例应用 UI
class TestfairyExampleApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('TestFairy Example')),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              // 模拟一个简单的操作
              await TestFairy.addEvent('Button Clicked');
            },
            child: Text('Click Me'),
          ),
        ),
      ),
    );
  }
}

常见问题及解决方法

1. 如何更新原生 SDK？

要更新 TestFairy 的原生 SDK，请执行以下步骤：

1. 更新 pubspec.yaml 文件。
2. 在终端运行以下命令：

   cd ios && pod update TestFairy && cd ..
   

2. 如何处理 Null-Safe Dart 支持？

从版本 2.0.0 开始，TestFairy 插件仅支持 Null-Safe Dart。如果您的项目不支持 Null-Safe Dart，可以继续使用版本 1.0.32：

dependencies:
  testfairy: ^1.0.32

3. 如何解决 iOS 编译错误？

如果您遇到 iOS 编译错误，请检查以下内容：

• 确保最低支持的 iOS 版本为 9.0。
• 修改 ios/Podfile 文件，添加以下内容：

  platform :ios, '9.0'
  use_frameworks!
  

然后运行以下命令：

pod repo update && pod install