1 CTS Instant Trade Federation 2 --------------------- 3 4 CTS Instant Trade Federation, cts-instant-tradefed for short, is built 5 on top of the Android Trade Federation test harness. 6 7 It works in a similar manner to the normal CTS harness, but is targeted 8 to test Instant App compatiblity. 9 10 Configuring cts-instant-tradefed 11 ------------------------ 12 13 1. Ensure 'adb' is in your current PATH. adb can be found in the 14 Android SDK available from http://developer.android.com 15 16 Example: 17 PATH=$PATH:/home/myuser/android-sdk-linux_x86/platform-tools 18 19 2. Follow the 'Setting up your device' steps documented in the 20 CTS User Manual. The CTS User Manual can be downloaded at 21 http://source.android.com/compatibility/downloads.html 22 23 3. Connect the device to the host machine. 24 25 4. Ensure device is visible via 'adb devices' 26 27 Using cts-instant-tradefed 28 ------------------- 29 30 To run a test plan on a single device: 31 32 1. Make sure you have at least one device connected 33 2. Launch the cts-instant-tradefed console by running the 'cts-instant-tradefed'. If you've 34 downloaded and extracted the CTS zip, the script can be found at 35 android-cts_instant/tools/cts-instant-tradefed 36 Or else if you are working from the Android source tree and have run make cts, 37 the script can be found at 38 out/host/linux-x86/cts/android-cts_instant/tools/cts-instant-tradefed 39 3. Type: 40 'run cts-instant' to run the default CTS plan 41 42 Some other useful commands are 43 44 To run a test module: 45 'run cts-instant --module <module_name>' 46 47 To run a specific test: 48 'run cts-instant --module <module_name> --test <test_name>' 49 50 To shard a plan test run on multiple devices 51 'run cts-instant --shard-count <number of shards> 52 note: all connected devices must be running the same build 53 54 For more options: 55 'run cts-instant --help' 56 57 CTS Tradefed Development 58 ------------------------ 59 See http://source.android.com for instructions on obtaining the Android 60 platform source code and setting up a build environment. 61 62 The source for the CTS extensions for tradefed can be found at 63 <android source root>/cts/tools/tradefed-host 64 65 The source for the tradefed framework can be found on the 'tradefed' branch. 66 67 Perform these steps to build and run cts-instant-tradefed from the development 68 environment: 69 cd <path to android source root> 70 make cts_instant 71 cts-instant-tradefed 72 73 More documentation and details on using and extending trade federation will 74 be forthcoming in the near future. 75 76