mirror of
https://github.com/flutter/flutter.git
synced 2025-06-03 00:51:18 +00:00
5d5e633c44
**This is a WIP**, and the only reason it is not a draft PR is so that Flutter (Skia) Gold is executed. --- Closes https://github.com/flutter/flutter/issues/148269. Work towards https://github.com/flutter/flutter/issues/148269.
38 lines
1.3 KiB
Markdown
38 lines
1.3 KiB
Markdown
# native_driver_test
|
|
|
|
This directory contains a sample app and tests that demonstrate how to use the
|
|
(experimental) _native_ Flutter Driver API to drive Flutter apps that run on
|
|
Android or iOS devices or emulators, interact with and capture screenshots of
|
|
the app, and compare the screenshots against golden images.
|
|
|
|
## Running the apps and tests
|
|
|
|
Each `lib/{prefix}_main.dart` file is a standalone Flutter app that you can run
|
|
on an Android or iOS device or emulator:
|
|
|
|
### `flutter_rendered_blue_rectangle`
|
|
|
|
This app displays a full screen blue rectangle. It mostly serves as a test that
|
|
Flutter can run at all on the target device, and that the Flutter (native)
|
|
driver can take a screenshot and compare it to a golden image. If this app or
|
|
test fails, it's likely none of the other apps or tests will work either.
|
|
|
|
```sh
|
|
# Run the app
|
|
$ flutter run lib/flutter_rendered_blue_rectangle_main.dart
|
|
|
|
# Run the test
|
|
$ flutter drive lib/flutter_rendered_blue_rectangle_main.dart
|
|
```
|
|
|
|
Files of significance:
|
|
|
|
- [Entrypoint](lib/flutter_rendered_blue_rectangle_main.dart)
|
|
- [Test](test_driver/flutter_rendered_blue_rectangle_main_test.dart)
|
|
|
|
## Debugging tips
|
|
|
|
- Use `flutter drive --keep-app-running` to keep the app running after the test.
|
|
- USe `flutter run` followed by `flutter drive --use-existing-app` for faster
|
|
test iterations.
|