Home | History | Annotate | only in /cts/tools/tradefed-host
Up to higher level directory
NameDateSize
.classpath15-Nov-2011672
.project15-Nov-2011376
Android.mk15-Nov-20111.1K
etc/15-Nov-2011
README15-Nov-20112.8K
res/15-Nov-2011
src/15-Nov-2011
tests/15-Nov-2011

README

      1 CTS Trade Federation
      2 ---------------------
      3 
      4 CTS Trade Federation, cts-tradefed for short, is an early look of the next
      5 generation test harness for CTS.
      6 
      7 cts-tradefed is built on top of the Android Trade Federation test harness.
      8 
      9 It works in a similar manner to the existing CTS harness, but supports some
     10 advanced features such as:
     11 
     12   - modular, flexible extensible design. cts-tradefed can be extended to
     13 support running CTS in a continuous test environment.
     14   - supports sharding a CTS test run across multiple devices in parallel
     15   - automatically continue a CTS test run on another device if connection
     16 is lost
     17 
     18 However, note the cts-tradefed is currently experimental, and should not
     19 be used to generate official CTS compatibility reports. Please see
     20 'Known issues' section for more details.
     21 
     22 Configuring cts-tradefed
     23 ------------------------
     24 
     25 1. Ensure 'adb' is in your current PATH. adb can be found in the
     26 Android SDK available from http://developer.android.com
     27 
     28 Example:
     29   PATH=$PATH:/home/myuser/android-sdk-linux_x86/platform-tools
     30 
     31 2. Follow the 'Setting up your device' steps documented in the
     32 CTS User Manual. The CTS User Manual can be downloaded at
     33 http://source.android.com/compatibility/downloads.html
     34 
     35 3. Connect the device to the host machine.
     36 
     37 4. Ensure device is visible via 'adb devices'
     38 
     39 Using cts-tradefed
     40 -------------------
     41 
     42 To run a test plan on a single device:
     43 
     44 1. Make sure you have at least one device connected
     45 2. Launch the cts-tradefed console by running the 'cts-tradefed' script at
     46 android-cts/tools/cts-tradefed
     47 3. Type:
     48 'run command --plan CTS cts' to run the default CTS plan
     49 
     50 Some other useful commands are
     51 
     52 To run a test package:
     53 'run command --package <packagename> cts'
     54 
     55 To run a test class:
     56 'run command --class <full test class name> cts'
     57 
     58 To shard a plan test run on multiple devices
     59 'run command --plan CTS --shards <number of shards> cts
     60 note: all connected devices must be running the same build
     61 
     62 For more options:
     63 'run command --help cts'
     64 
     65 Known issues and missing features
     66 ----------------------------------
     67 - missing support for listing packages and plans (coming soon)
     68 - missing support for reporting incomplete tests
     69 - missing support for resuming previous test runs
     70 - logging to be improved
     71 
     72 CTS Tradefed Development
     73 ------------------------
     74 See http://source.android.com for instructions on obtaining the Android
     75 platform source code and setting up a build environment.
     76 
     77 The source for the CTS extensions for tradefed can be found at
     78 <android source root>/cts/tools/tradefed-host
     79 
     80 The source for the tradefed framework itself can be found at
     81 <android source root>/tools/tradefederation
     82 
     83 Perform these steps to build and run cts-tradefed from the development
     84 environment:
     85 cd <path to android source root>
     86 make cts
     87 cts-tradefed
     88 
     89 More documentation and details on using and extending trade federation will
     90 be forthcoming in the near future.
     91 
     92