1MTS Trade Federation
2---------------------
3
4Mainline Test Suite Trade Federation, mts-tradefed for short, is built on
5top of the Android Trade Federation test harness to test mainline modules.
6
7Configuring mts-tradefed
8------------------------
9
10Ensure 'adb' is in your current PATH. adb can be found in the
11Android SDK available from http://developer.android.com
12
13Example:
14  PATH=$PATH:/home/myuser/android-sdk-linux_x86/platform-tools
15
16And ensure device is visible via 'adb devices'
17
18Using mts-tradefed
19-------------------
20
21To run a test plan on a single device:
22
231. Make sure you have at least one device connected
242. Launch the mts-tradefed console by running the 'mts-tradefed'. If you
25are working from the Android source tree and have run 'm mts',
26the script can be found at
27  out/host/linux-x86/ats/android-mts/tools/mts-tradefed
283. Type:
29'run mts' to run the default MTS plan
30
31Some other useful commands are
32
33To run a test module:
34'run mts --module <module_name>'
35
36To run a specific test:
37'run mts --test <test_name>'
38
39To shard a plan test run on multiple devices
40'run mts --shards <number of shards>
41note: all connected devices must be running the same build
42
43For more options:
44'run mts --help'
45
46MTS Tradefed Development
47------------------------
48See http://source.android.com for instructions on obtaining the Android
49platform source code and setting up a build environment.
50
51The source for the tradefed framework can be found on the 'tradefed' branch.
52
53Perform these steps to build and run mts-tradefed from the development
54environment:
55cd <path to android source root>
56m mts
57mts-tradefed
58
59More documentation and details on using and extending trade federation will
60be forthcoming in the near future.
61
62