You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
82 lines
2.4 KiB
82 lines
2.4 KiB
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 <number of shards>
|
|
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
|
|
<android source root>/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 <path to android source root>
|
|
make vts
|
|
vts-tradefed
|
|
|
|
More documentation and details on using and extending trade federation will
|
|
be forthcoming in the near future.
|
|
|