sylph 0.2.0

A utility for running Flutter integration tests on pools of real devices in cloud. Works with AWS Device Farms.

A sylph is a mythological invisible being of the air. Wikipedia

Sylph

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.

Installation

pub global activate sylph

Usage

sylph

or, if not using the default config file:

sylph -c <path to config file>

Configuration

All configuration information is passed to Sylph using a configuration file. The default config file is called sylph.yaml:

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

Live demo

To see Sylph in action, a live demo of the example app is available.

The log of the live run is here:
https://travis-ci.com/mmcc007/sylph

The resulting artifacts are here:
https://github.com/mmcc007/sylph/releases
(includes a video of test running on device)

Contributing

When contributing to this repository, please feel free to discuss via issue or pull request.

Issues and pull requests are welcome.

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.