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.
Dry run a configuration
Stay organized with collections
Save and categorize content based on your preferences.
It can be convenient to dry-run a Trade Federation (TF) configuration to
ensure that TF is properly configured.
There are two different mechanisms in TF for this.
General configuration
The dry-run command checks that a configuration is parsed correctly and is
runnable. The command does not run TF so this validation is limited to the
TF configuration syntax.
Configuration for test suites
For the test suite configurations, such as CTS, the --collect-tests-only
command is available. It runs everything except the test cases, which are
enumerated. However, it does run all the other setup steps, like installing
APKs.
This is a convenient option to ensure that a configuration runs as expected
without actually running the tests.
Support for collect-tests-only
The support for the collect-tests-only is exposed via
ITestCollector.
A test runner that implements this interface enumerates its test cases
instead of running them.
InstrumentationTest
is an example implementation of that interface.
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-06-12 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-06-12 UTC."],[],[],null,["# Dry run a configuration\n\nIt can be convenient to `dry-run` a Trade Federation (TF) configuration to\nensure that TF is properly configured.\n\nThere are two different mechanisms in TF for this.\n\nGeneral configuration\n---------------------\n\nThe `dry-run` command checks that a configuration is parsed correctly and is\nrunnable. The command does not run TF so this validation is limited to the\nTF configuration syntax.\n\nConfiguration for test suites\n-----------------------------\n\nFor the test suite configurations, such as CTS, the `--collect-tests-only`\ncommand is available. It runs everything except the test cases, which are\nenumerated. However, it does run all the other setup steps, like installing\nAPKs.\n\nThis is a convenient option to ensure that a configuration runs as expected\nwithout actually running the tests.\n\n### Support for collect-tests-only\n\nThe support for the collect-tests-only is exposed via\n[ITestCollector](/reference/tradefed/com/android/tradefed/testtype/ITestCollector).\n\nA test runner that implements this interface enumerates its test cases\ninstead of running them.\n\n[InstrumentationTest](/reference/tradefed/com/android/tradefed/testtype/InstrumentationTest)\nis an example implementation of that interface."]]
