Systems Testing With VTS

The Vendor Test Suite (VTS) automates HAL and OS kernel testing. To use VTS to test an Android native system implementation, set up a testing environment then test a patch using a VTS plan.

Establishing a test environment

To set up a testing environment:

  1. Install Python development kit:
    sudo apt-get install python-dev
    
  2. Install Protocol Buffer tools (for Python):
    sudo apt-get install python-protobuf
    sudo apt-get install protobuf-compiler
    
  3. Install Python virtual environment-related tools:
    sudo apt-get install python-virtualenv
    sudo apt-get install python-pip
    

Testing a patch

To test a patch:

  1. Build a VTS host-side package:
    . build/envsetup.sh
    lunch aosp_arm64-userdebug
    make vts -j
    
  2. Run the default VTS tests:
    vts-tradefed
    tf> run vts     // where vts is the test plan name
    

VTS plans

Available VTS test plans include:

Command Description
> run vts For default VTS tests
> run vts-hal For default VTS HAL (hardware abstraction layer) tests
> run vts-kernel For default VTS kernel tests

To view a list of all plans, refer to /test/vts/tools/vts-tradefed/res/config.md.

Support

You can view a user manual at /test/vts/doc. For questions on VTS, please join android-vts@googlegroups.com.