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