package:mockito
。 单元测试通常不会读取/写入磁盘、渲染到屏幕,也不会从运行测试的进程外部接收用户操作。单元测试的目标是在各种条件下验证逻辑单元的正确性。某些Flutter库,如dart:ui
在独立的Dart VM附带的Dart SDK的中是不可用。该flutter test
命令允许您在本地Dart VM中运行测试,使用无头版(不会显示UI)的Flutter引擎。 使用这个命令你可以运行任何测试,不管它是否依赖于Flutter的库。
使用package:test
,编写一个Flutter单元测试。编写单元测试使用的package:test
例如:
将此文件添加到 test/unit_test.dart
:
import 'package:test/test.dart';
void main() {
test('my first unit test', () {
var answer = 42;
expect(answer, 42);
});
}
另外,您必须将以下内容添加到您的pubspec.yaml
:
dev_dependencies:
flutter_test:
sdk: flutter
即使你的测试本身没有明确导入flutter_test
,也需要这样做 ,因为测试框架本身在后台也使用了它。
要运行测试,从您的项目目录(而不是从test
子目录)运行 flutter test test/unit_test.dart
要运行所有测试,请从项目目录运行flutter test
您以类似于单元测试的方式实现widget测试。要在测试中执行与widget的交互,请使用Flutter提供的WidgetTester
。 例如,您可以发送点击和滚动手势。您还可以使用WidgetTester
在widget树中查找子widget、读取文本、验证widget属性的值是否正确。
例子:
将此文件添加到test/widget_test.dart
:
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
void main() {
testWidgets('my first widget test', (WidgetTester tester) async {
// You can use keys to locate the widget you need to test
var sliderKey = new UniqueKey();
var value = 0.0;
// Tells the tester to build a UI based on the widget tree passed to it
await tester.pumpWidget(
new StatefulBuilder(
builder: (BuildContext context, StateSetter setState) {
return new MaterialApp(
home: new Material(
child: new Center(
child: new Slider(
key: sliderKey,
value: value,
onChanged: (double newValue) {
setState(() {
value = newValue;
});
},
),
),
),
);
},
),
);
expect(value, equals(0.0));
// Taps on the widget found by key
await tester.tap(find.byKey(sliderKey));
// Verifies that the widget updated the value correctly
expect(value, equals(0.5));
});
}
运行 flutter test test/widget_test.dart
.
查看所有可用于widget测试的package:flutter_test
API
为了帮助调试widget测试,您可以使用debugDumpApp()
函数来可视化测试的UI状态, 或者只是简单的在您的首选运行时环境(例如模拟器或设备)中运行flutter run test/widget_test.dart
以查看您的测试运行。 在运行flutter run
的测试的会话期间,您还可以交互式地点击Flutter工具的部分屏幕来打印建议的Finder
。
如果您熟悉Selenium/WebDriver(web),Espresso(Android)或UI Automation(iOS),那么Flutter Driver就是Flutter与这些集成测试工具的等价物。 此外,Flutter Driver还提供API以记录测试执行的操作的性能跟踪(又名时间轴)。
Flutter的Driver是:
flutter drive
package:flutter_driver
(API)这两者允许你:
要使用flutter_driver
,您必须将以下块添加到您的pubspec.yaml
:
dev_dependencies:
flutter_driver:
sdk: flutter
一个指令化的应用程序是一个Flutter应用程序,它启用了Flutter Driver 扩展。启用扩展请调用enableFlutterDriverExtension()
。
例:
假设你有一个入口点的应用程序my_app/lib/main.dart
。要创建它的指令化版本,请在my_app/test_driver/
下创建一个Dart文件。 在您正在测试的功能之后命名它; 接下来定位到my_app/test_driver/user_list_scrolling.dart
:
// 这一行导入扩展
import 'package:flutter_driver/driver_extension.dart';
void main() {
// 启用扩展
enableFlutterDriverExtension();
// Call the `main()` of your app or call `runApp` with whatever widget
// you are interested in testing.
}
集成测试是一个简单的package:test
测试,它使用Flutter Driver API告诉应用程序执行什么操作,然后验证应用程序是否执行了此操作。
例子:
为了有意思起见,我们也让我们的测试记录下性能跟踪(performance timeline)。我们创建一个user_list_scrolling_test.dart
测试文件位于my_app/test_driver/
下:
import 'dart:async';
// Imports the Flutter Driver API
import 'package:flutter_driver/flutter_driver.dart';
import 'package:test/test.dart';
void main() {
group('scrolling performance test', () {
FlutterDriver driver;
setUpAll(() async {
// 连接app
driver = await FlutterDriver.connect();
});
tearDownAll(() async {
if (driver != null) {
// 关闭连接
driver.close();
}
});
test('measure', () async {
// 记录闭包中的performance timeline
Timeline timeline = await driver.traceAction(() async {
// Find the scrollable user list
SerializableFinder userList = find.byValueKey('user-list');
// Scroll down 5 times
for (int i = 0; i < 5; i++) {
// Scroll 300 pixels down, for 300 millis
await driver.scroll(
userList, 0.0, -300.0, new Duration(milliseconds: 300));
// Emulate a user's finger taking its time to go back to the original
// position before the next scroll
await new Future.delayed(new Duration(milliseconds: 500));
}
// Scroll up 5 times
for (int i = 0; i < 5; i++) {
await driver.scroll(
userList, 0.0, 300.0, new Duration(milliseconds: 300));
await new Future.delayed(new Duration(milliseconds: 500));
}
});
// The `timeline` object contains all the performance data recorded during
// the scrolling session. It can be digested into a handful of useful
// aggregate numbers, such as "average frame build time".
TimelineSummary summary = new TimelineSummary.summarize(timeline);
summary.writeSummaryToFile('stocks_scroll_perf', pretty: true);
summary.writeTimelineToFile('stocks_scroll_perf', pretty: true);
});
});
}
要在Android设备上运行测试,请通过USB将设备连接到计算机并启用USB调试。然后运行以下命令:
flutter drive --target=my_app/test_driver/user_list_scrolling.dart
该命令将:
--target
应用,并将其安装在设备上my_app/test_driver/
下的user_list_scrolling_test.dart
您可能想知道该命令如何找到正确的测试文件。flutter drive
命令使用一种约定来查找与--target
应用程序在同一目录中具有相同文件名但是具有_test
后缀的测试文件。