Flutter自动化测试辅助插件fast_flutter_driver_tool的使用

Flutter自动化测试辅助插件fast_flutter_driver_tool的使用

快速Flutter Driver (Fast Flutter Driver)

插件	Pub
Command Line Tool
UI Helper

弃用警告 (Deprecation Warning)

Flutter Driver 测试正在被新的集成测试取代。我将继续支持此包，只要它可行，但建议开始使用集成测试。

您可以在此处阅读更多关于新Flutter集成测试的优点和缺点。

工具包介绍 (Toolkit for running rapidly flutter driver tests on desktop/mobile)

此工具包简化了创建可以在不重启或重建应用程序的情况下批量运行的Flutter Driver测试。您可以通过这篇文章了解工具包的工作原理。

桌面测试的理由 (The reasoning for Desktop tests)

桌面构建在UI方面几乎与Android/iOS构建相同。在模拟器/仿真器上运行测试可能会很痛苦，在CI上可能会更糟。您的CI通常是docker化的Linux机器——在Linux上针对Linux Flutter应用程序运行flutter driver测试既快速又可靠。此工具允许您比在模拟器/仿真器上更快、更可靠地运行flutter driver测试。

对于需要Android/iOS插件的应用程序流程，仍然应该在模拟器/仿真器或真实设备上运行测试。

也在Android/iOS上运行 (Running also on Android/iOS)

虽然在桌面平台上运行测试可以发现大多数错误，但建议有时也在实际设备上运行测试。某些Dart中的错误（例如以无效方式实现泛型）可能会导致移动设备上的原生崩溃，但在桌面上正常工作。因此，在每次发布之前，在移动设备上运行fastdriver测试是明智的选择。

示例 (Example)

您可以构建并执行一个示例，该示例可以在任何桌面系统和Docker上运行。

使用方法 (Usage)

1. 添加dev依赖项

在pubspec.yaml中添加fast_flutter_driver作为开发依赖项：

dev_dependencies:
  fast_flutter_driver: ^2.0.0

2. 创建配置类

创建一个配置类test_driver/generic/test_configuration.dart：

import 'package:fast_flutter_driver/tool.dart';
import 'package:meta/meta.dart';

class TestConfiguration implements BaseConfiguration {
  const TestConfiguration({
    required this.resolution,
    this.platform,
  });

  factory TestConfiguration.fromJson(Map<String, dynamic> json) {
    return TestConfiguration(
      resolution: Resolution.fromJson(json['resolution']),
      platform: TestPlatformEx.fromString(json['platform']),
    );
  }

  @override
  final TestPlatform? platform;
  @override
  final Resolution resolution;

  @override
  Map<String, dynamic> toJson() {
    final p = platform;
    return <String, dynamic>{
      'resolution': resolution,
      if (p != null) 'platform': p.asString(),
    };
  }
}

3. 创建Dart文件

创建一个Dart文件test_driver/generic/generic.dart，内容如下，并将MyApplication作为您的主（根）应用程序小部件：

import 'dart:convert';

import 'package:fast_flutter_driver/driver.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/scheduler.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_driver/driver_extension.dart';

import 'test_configuration.dart';

void main() {
  timeDilation = 0.1; // 减慢动画速度，使测试更稳定
  enableFlutterDriverExtension(
    handler: (playload) async {
      await configureTest(
        TestConfiguration.fromJson(json.decode(playload ?? '{}')),
      );
      return '';
    },
  );

  runApp(
    RestartWidget<TestConfiguration>(
      builder: (_, config) => MyApplication(),
    ),
  );
}

4. 创建测试文件

创建一个测试文件test_driver/main_test.dart：

import 'dart:convert';

import 'package:fast_flutter_driver/tool.dart';
import 'package:flutter_driver/flutter_driver.dart';
import 'package:test/test.dart';

import 'generic/test_configuration.dart';

void main(List<String> args) {
  late FlutterDriver driver;
  final properties = TestProperties(args);

  setUpAll(() async {
    driver = await FlutterDriver.connect(dartVmServiceUrl: properties.vmUrl);
  });

  tearDownAll(() async {
    await driver.close();
  });

  Future<void> restart() {
    return driver.requestData(
      json.encode(
        TestConfiguration(
          resolution: properties.resolution,
          platform: properties.platform,
        ),
      ),
    );
  }

  test('main application', () async {
    await restart();

    await driver.waitFor(find.byType('MyApplication'));
  });
}

5. 安装fast_flutter_driver脚本

安装fast_flutter_driver脚本：

pub global activate fast_flutter_driver_tool

6. 运行测试

运行测试：

fastdriver --dart-args "--no-sound-null-safety" --flutter-args "--no-sound-null-safety"