Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.
Vendor Test Suite and infrastructure for Android 10 and lower
Stay organized with collections
Save and categorize content based on your preferences.
The Android Vendor Test Suite (VTS) provides extensive new functionality for
Android testing and promotes a test-driven development process. To help the
Android development community interact with test data, Android includes the
following testing resources:
- Video Tutorials.
Describes the videos on running and developing VTS and CTS-on-GSI on Android
9 and Android 8.1.
- Systems Testing with VTS.
Describes how to use VTS to test an Android native system implementation, set
up a testing environment, then test a patch using a VTS plan.
- Test Framework. Provides details on using the VTS test
framework. Includes:
- Device shell commands.
Instructions on how to use device shell commands to execute target-side test
binaries, to get/set properties, environment variables, and system
information, and to start/stop the Android framework.
- Test templates.
Details on configuring and using test templates for test modules that are
not host-side Python subclass of VTS runner's BaseTest.
- Service name aware HAL
testing. Details on Android 9 support for
obtaining the service name of a given HAL instance based on the device on
VTS is running.
- HAL testability check.
Details on Android 9 support for a runtime method
that uses the device configuration to identify which VTS tests should be
skipped for that device target.
- Multi-device
testing. Instructions for configuring tests that require interaction
between multiple Android devices.
- VTS testing with debug ramdisk. Instructions on
how to use a debug ramdisk to enable running VTS with a generic system image (GSI).
- VTS Dashboard. Web-based user interface for viewing VTS
results. Includes details on:
- Setup. Instructions for setting up and
configuring the VTS Dashboard.
- Database. A scalable
back-end to support the continuous integration dashboard.
- User Interface. A cohesive user
interface that uses material design to effectively display information about
test results, profiling, and coverage.
- Lab infrastructure. Describes the architecture of an
automated testing
infrastructure for running VTS, CTS, or other tests on partner devices
running the AOSP Generic System Image (GSI).
Requires a Host Controller.
- binder and hwbinder
performance tests. Tools for measuring throughput and latency.
For additional details, refer to the
Android
VTS Products video produced by Google Developers, and the
Treble:
Fast Software Updates by Creating an Equilibrium in an Active Software
Ecosystem of Globally Distributed Stakeholders paper, which is free
for ACM members and non-members can purchase or read the abstract.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-08-29 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[],[],null,["# Vendor Test Suite and infrastructure for Android 10 and lower\n\nThe Android Vendor Test Suite (VTS) provides extensive new functionality for\nAndroid testing and promotes a test-driven development process. To help the\nAndroid development community interact with test data, Android includes the\nfollowing testing resources:\n\n- [Video Tutorials.](/docs/core/tests/vts/vts-video) Describes the videos on running and developing VTS and CTS-on-GSI on Android 9 and Android 8.1.\n- [Systems Testing with VTS.](/docs/core/tests/vts/systems) Describes how to use VTS to test an Android native system implementation, set up a testing environment, then test a patch using a VTS plan.\n- **Test Framework.** Provides details on using the VTS test framework. Includes:\n - [Device shell commands](/docs/core/tests/vts/shell-commands). Instructions on how to use device shell commands to execute target-side test binaries, to get/set properties, environment variables, and system information, and to start/stop the Android framework.\n - [Test templates](/docs/core/tests/vts/test-templates). Details on configuring and using test templates for test modules that are not host-side Python subclass of VTS runner's BaseTest.\n - [Service name aware HAL\n testing](/docs/core/tests/vts/sna-hal-testing). Details on Android 9 support for obtaining the service name of a given HAL instance based on the device on VTS is running.\n - [HAL testability check](/docs/core/tests/vts/hal-testability). Details on Android 9 support for a runtime method that uses the device configuration to identify which VTS tests should be skipped for that device target.\n - [Multi-device\n testing](/docs/core/tests/vts/multi-device-testing). Instructions for configuring tests that require interaction between multiple Android devices.\n - [VTS testing with debug ramdisk](/docs/core/tests/vts/vts-on-gsi). Instructions on how to use a debug ramdisk to enable running VTS with a generic system image (GSI).\n- **VTS Dashboard.** Web-based user interface for viewing VTS results. Includes details on:\n - [Setup](/docs/core/tests/vts/setup). Instructions for setting up and configuring the VTS Dashboard.\n - [Database](/docs/core/tests/vts/database). A scalable back-end to support the continuous integration dashboard.\n - [User Interface](/docs/core/tests/vts/ui). A cohesive user interface that uses material design to effectively display information about test results, profiling, and coverage.\n- **Lab infrastructure.** Describes the architecture of an [automated testing\n infrastructure](/docs/core/tests/vts/automated-test-infra) for running VTS, CTS, or other tests on partner devices running the AOSP [Generic System Image (GSI)](/docs/setup/create/gsi). Requires a [Host Controller](/docs/core/tests/vts/host-controller).\n- [binder and hwbinder\n performance tests](/docs/core/tests/vts/performance). Tools for measuring throughput and latency.\n\n\nFor additional details, refer to the\n[Android\nVTS Products video](https://www.youtube.com/watch?v=7BX7oSHc7nk&list=PLWz5rJ2EKKc9JOMtoWWMJHFHgvXDoThva) produced by Google Developers, and the\n[Treble:\nFast Software Updates by Creating an Equilibrium in an Active Software\nEcosystem of Globally Distributed Stakeholders](https://dl.acm.org/doi/10.1145/3358237) paper, which is free\nfor ACM members and non-members can purchase or read the abstract."]]
