VTS Trade Federation

VTS Trade Federation, vts-tradefed for short, is the next generation test harness for VTS.

vts-tradefed is built on top of the Android Trade Federation test harness.

It works in a similar manner to the prior VTS harness, but with much simplicity.

• tests all run through Trade Federation without python wrapper, thus no virtualenv is needed.
• supports sharding a VTS test run across multiple devices in parallel
• supports Trade Federation suite features including auto-retry.

Configuring vts-tradefed

1. Ensure 'adb' is in your current PATH. adb can be found in the Android SDK available from http://developer.android.com

Example: PATH=$PATH:/home/myuser/android-sdk-linux_x86/platform-tools

2. Follow the 'Setting up your device' steps documented in the VTS User Manual.

TODO: add link for documentation.

3. Connect the device to the host machine.

4. Ensure device is visible via 'adb devices'

Using vts-tradefed

To run a test plan on a single device:

1. Make sure you have at least one device connected
2. Launch the vts-tradefed console by running the 'vts-tradefed'. If you've downloaded and extracted the VTS zip, the script can be found at android-vts/tools/vts-tradefed Or else if you are working from the Android source tree and have run make vts, the script can be found at out/host/linux-x86/vts/android-vts/tools/vts-tradefed
3. Type: 'run vts' to run the default VTS plan

Some other useful commands are

To run a test module: 'run vts --module <module_name>'

To run a specific test: 'run vts --module <module_name> --test <test_name>'

To shard a plan test run on multiple devices 'run vts --shard-count note: all connected devices must be running the same build

For more options: 'run vts --help'

VTS Tradefed Development

See http://source.android.com for instructions on obtaining the Android platform source code and setting up a build environment.

The source for the VTS extensions for tradefed can be found at /test/vts/tools/vts-tradefed

The source for the tradefed framework can be found on the 'tradefed' branch.

Perform these steps to build and run vts-tradefed from the development environment: cd make vts vts-tradefed

More documentation and details on using and extending trade federation will be forthcoming in the near future.