132e298335
Towards https://github.com/flutter/flutter/issues/161261 (before I add more tests). This is a 1:1 move, with massaging of `run_flutter_driver_android_tests.dart` to be more automated as tests are added. /cc @reidbaker
38 lines
1.3 KiB
Markdown
38 lines
1.3 KiB
Markdown
# android_engine_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 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 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.
|