A sylph is a mythological invisible being of the air. Wikipedia
Sylph is a command line utility for running Flutter integration and end-to-end tests on pools of real iOS and Android devices in the cloud. Sylph runs on a developer mac or in a CI environment.
pub global activate sylph
or, if not using the default config file:
sylph -c <path to config file>
All configuration information is passed to Sylph using a configuration file. The default config file is called
project_name: flutter tests default_job_timeout: 5 # minutes tmp_dir: /tmp/sylph device_pools: - pool_name: android pool 1 pool_type: android devices: - name: Samsung Galaxy S9 (Unlocked) model: SM-G960U1 os: 8.0.0 - pool_name: ios pool 1 pool_type: ios devices: - name: Apple iPhone X model: A1865 os: 12.0 test_suites: - test_suite: example tests 1 main: test_driver/main1.dart testspec: test_driver/test_spec.yaml tests: - test_driver/main1_test1.dart - test_driver/main1_test2.dart device_pools: - android pool 1 # - ios pool 1 job_timeout: 5 # minutes - test_suite: example tests 2 main: test_driver/main2.dart testspec: test_driver/test_spec.yaml tests: - test_driver/main2_test1.dart - test_driver/main2_test2.dart device_pools: - android pool 1 # - ios pool 1 job_timeout: 5 # minutes
To see Sylph in action, a live demo of the example app is available.
The log of the live run is here:
The resulting artifacts are here:
(includes a video of test running on device)
When contributing to this repository, please feel free to discuss via issue or pull request.
Your feedback is used to guide where development effort is focused. So feel free to create as many issues and pull requests as you want. You should expect a timely and considered response.
A new Flutter project.
This project is a starting point for a Flutter application.
A few resources to get you started if this is your first Flutter project:
For help getting started with Flutter, view our online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.
You can install the package from the command line:
$ pub global activate sylph
The package has the following executables:
Add this to your package's pubspec.yaml file:
dependencies: sylph: ^0.2.0
You can install packages from the command line:
$ pub get
$ flutter pub get
Alternatively, your editor might support
pub get or
flutter pub get.
Check the docs for your editor to learn more.
Now in your Dart code, you can use:
|0.2.0||Jun 22, 2019|
|0.1.1||Mar 17, 2019|
|0.1.0||Mar 17, 2019|
Describes how popular the package is relative to other packages. [more]
Code health derived from static analysis. [more]
Reflects how tidy and up-to-date the package is. [more]
Weighted score of the above. [more]
We analyzed this package on Jun 25, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:
Detected platforms: Flutter, other
|Dart SDK||>=2.0.0 <3.0.0|