Testing Flutter apps翻译-单元测试简介

官方文档原文

你如何确保你的应用程序在添加更多功能或更改现有功能时能继续正常工作?答案是写测试。

单元测试可以很容易的测试单个函数、方法、或者类。这个 test 包提供了写单元测试的核心框架,然后这个 flutter_test 包额外提供了更多测试Widget的实用工具。

这个目录演示了 test 包提供的核心功能,关于test包的更多信息请查看这里

目录:

  1. 添加 testflutter_test 依赖
  2. 创建 test 文件
  3. 创建一个类用来测试
  4. 在我们的类里写一个单元测试
  5. 使用 group 来结合多个测试
  6. 运行测试

1. 添加 testflutter_test 依赖

如果你仅仅使用Dart包的代码而不依赖Flutter,你可以仅仅导入 test 包。这个 test 包提供了在Dart里写单元测试的核心功能。这是编写Web、服务器和Flutter应用程序的单元测试的最佳方法。

dev_dependencies:
  test: <latest_version>

2. 创建 test 文件

在这个例子里,创建2个文件: counter.dartcounter_test.dart.

这个 counter.dart文件将会包含一个你想要测试的类,放到 lib 文件夹下面。这个 counter_test.dart 文件将会包含测试本身并且放到 test 文件夹下。

一般来说,test 文件应该保存在 test 文件夹下面,而test 文件夹位置在你的Flutter应用程序或者包的根目录。

当你做完这些以后,这个文件夹架构应该像下面这样:

counter_app/
  lib/
    counter.dart
  test/
    counter_test.dart

3. 创建一个被测试的类

下一步,你需要一个“单元”用来测试,记住,“单元”的意思是一个函数、方法或者类的代称,在这个例子里,在 lib/counter.dart 里创建一个Counter类,它将负责给一个初始为0的值增加值或减小值。

class Counter {
  int value = 0;

  void increment() => value++;

  void decrement() => value--;
}

注意:为了简单起见,本教程没有遵循“测试驱动开发”的方式。如果你更喜欢“测试驱动开发”的方式你也可以使用。

4. 在我们的类里写一个单元测试

在这个 counter_test.dart 文件里,写下我们第一个单元测试。测试定义在顶级函数里,你可以使用顶级 expect 函数检查结果是否正确。这两个函数都来自 test 包。

// Import the test package and Counter class
import 'package:test/test.dart';
import 'package:counter_app/counter.dart';

void main() {
  test('Counter value should be incremented', () {
    final counter = Counter();

    counter.increment();

    //如果counter.value的值等于1则测试通过
    expect(counter.value, 1);
  });
}

5. 使用 group 来结合多个测试

如果你有几个函数彼此相关,你可以使用 test 包的 group 函数。

import 'package:test/test.dart';
import 'package:counter_app/counter.dart';

void main() {
  group('Counter', () {
    test('value should start at 0', () {
      expect(Counter().value, 0);
    });

    test('value should be incremented', () {
      final counter = Counter();

      counter.increment();

      expect(counter.value, 1);
    });

    test('value should be decremented', () {
      final counter = Counter();

      counter.decrement();

      expect(counter.value, -1);
    });
  });
}

6. 运行测试

现在你有了一个 Counter 类的单元测试,你现在可以运行这个测试了。

使用IntelliJ或者VSCode运行测试

IntelliJ和VSCode的Flutter插件支持运行单元测试。
这通常是编写测试时的最佳选择,因为它提供了最快的反馈循环以及设置断点的能力。

IntelliJ
1. 打开 counter_test.dart 文件
2. 选择 Run 菜单
3. 点击 Run 'tests in counter_test.dart' 选项
4. 或者,为您的平台使用适当的键盘快捷方式。

VSCode
1. 打开 counter_test.dart 文件
2. 选择 Debug 菜单
3. 点击 Start Debugging 选项
4. 或者,为您的平台使用适当的键盘快捷方式。

在终端运行测试

你也可以在项目的根目录使用下面的命令在终端运行测试:

flutter test test/counter_test.dart

推荐阅读更多精彩内容