patrol_cli 0.8.0

Command-line tool for Patrol, a powerful Flutter-native UI testing framework.

patrol_cli

Command-line tool to make working with patrol easier.

Installation

From pub.dev

$ dart pub global activate patrol_cli

From git

1. Make sure that you have Dart >= 2.17 installed.

   $ dart --version
   

2. Clone the repo.

3. Go to packages/patrol_cli.

4. Run dart pub global activate --source path .

Troubleshooting

If you can't run patrol from the terminal and the error is something along the lines of "command not found", make sure that you've added appropriate directories to PATH:

• on Unix-like systems, add $HOME/.pub-cache/bin
• on Windows, add %USERPROFILE%\AppData\Local\Pub\Cache\bin

Usage

First run

On first run, patrol_cli will download artifacts it needs to the artifact path. By default it is $XDG_CACHE_HOME (on Unix-like systems) or $HOME/.patrol (on Windows), but you can change it by setting PATROL_CACHE environment variable.

To learn about commands, run:

$ patrol --help

Bootstrap

To use Patrol in your Flutter project, you need to:

1. add patrol as a dev_dependency in pubspec.yaml
2. add integration_test as a dev_dependency in pubspec.yaml
3. create test_driver/integration_test.dart
4. create integration_test/app_test.dart

Run patrol bootstrap to automatically perform these steps.

First drive

Make sure that you have at least one device attached:

$ patrol devices

To run the simple integration test generated by patrol bootstrap:

$ patrol drive