Flutter测试辅助插件test

Flutter测试辅助插件test_builder的使用

Test Builder 是一个Dart包，它为Flutter测试提供了Builder模式。它简化了Flutter小部件和屏幕的测试用例创建和管理过程。

特性

使用Builder和Director模式实现灵活的测试设置。
支持Material小部件和屏幕。
简单管理测试参数和小部件构建。
提供可重用组件以处理常见的测试场景。

安装

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

dependencies:
  test_builder: ^0.1.2

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

flutter pub get

使用

基本用法

导入包：

import 'package:test_builder/test_builder.dart';

为您的小部件或屏幕创建一个Director：

late MaterialScreenWidgetDirector<(String, String, String, VoidCallback)> director;

// 初始化Director并设置单元工厂
setUp(() => director = MaterialScreenWidgetDirector<(String, String, String, VoidCallback)>()
  ..setUnitFactory((args) => CustomScreen(
        title: args.$1,
        message: args.$2,
        buttonText: args.$3,
        onButtonPressed: args.$4,
      )));

设置测试用例：

group('Display confirmation', () {
  // 设置测试参数工厂
  setUp(() => director.setArgsFactory(() => ('Test Title', 'Test Message', 'Test Button', () {})));

  testWidgets('CustomScreen is displayed correctly', (WidgetTester tester) async {
    // 构建并渲染小部件
    await tester.pumpWidget(director.construct());
    await tester.pumpAndSettle();

    // 验证文本是否正确显示
    expect(find.text('Test Title'), findsOneWidget);
    expect(find.text('Test Message'), findsOneWidget);
    expect(find.text('Test Button'), findsOneWidget);
  });
});

高级用法

对于更复杂的场景，您可以创建自定义的Director：

class OtherCustomScreenDirector extends MaterialScreenWidgetDirector<(String, String, List<String>, VoidCallback)> {
  bool pressed = false;

  OtherCustomScreenDirector() {
    // 设置单元工厂
    setUnitFactory((args) => OtherCustomScreen(
          title: args.$1,
          subtitle: args.$2,
          items: args.$3,
          onButtonPressed: args.$4,
        ));
  }

  // 设置默认屏幕
  void useDefaultScreen() => setArgs(('Test Title', 'Test Subtitle', ['Item 1', 'Item 2', 'Item 3'], () {}));

  // 设置带有可按压按钮的屏幕
  void useScreenWithPressableButton() =>
      setArgs(('Test Title', 'Test Subtitle', ['Item 1', 'Item 2', 'Item 3'], () => pressed = true));
}

h691938207 1楼•1 个月前

更多关于Flutter测试辅助插件test_builder的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

test_builder 是一个 Flutter 插件，它可以帮助你自动生成测试代码，特别是对于 UI 组件的测试。它可以自动生成 widget_test.dart 文件中的测试代码，减少手动编写测试的工作量。以下是如何使用 test_builder 插件的步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 test_builder 插件的依赖：

dev_dependencies:
  build_runner: ^2.1.0
  test_builder: ^0.1.0

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

2. 创建测试文件

在你的项目中，创建一个 widget_test.dart 文件（如果还没有的话）。这个文件将用于存放生成的测试代码。

3. 使用 `test_builder` 生成测试代码

你可以在你的代码中使用 [@TestBuilder](/user/TestBuilder) 注解来标记你想要生成测试的 Widget。例如：

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

[@TestBuilder](/user/TestBuilder)()
class MyWidget extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container(
      child: Text('Hello, World!'),
    );
  }
}

4. 运行 `build_runner`

接下来，你需要运行 build_runner 来生成测试代码。在终端中运行以下命令：

flutter pub run build_runner build

这将生成一个 widget_test.dart 文件，其中包含自动生成的测试代码。

5. 查看生成的测试代码

生成的 widget_test.dart 文件可能看起来像这样：

import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:my_app/my_widget.dart';

void main() {
  testWidgets('MyWidget renders correctly', (WidgetTester tester) async {
    await tester.pumpWidget(MaterialApp(home: MyWidget()));

    expect(find.text('Hello, World!'), findsOneWidget);
  });
}

6. 运行测试

你可以使用以下命令来运行生成的测试：

flutter test

7. 自定义生成的测试代码

test_builder 提供了一些选项来自定义生成的测试代码。你可以在 [@TestBuilder](/user/TestBuilder) 注解中使用这些选项。例如：

[@TestBuilder](/user/TestBuilder)(
  description: 'Custom test description',
  skip: false,
)
class MyWidget extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container(
      child: Text('Hello, World!'),
    );
  }
}

Flutter测试辅助插件test_builder的使用