自 2025 年 3 月 27 日起,我们建议您使用 android-latest-release
而非 aosp-main
构建 AOSP 并为其做出贡献。如需了解详情,请参阅 AOSP 的变更。
通过套件运行测试
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
1. 设置套件
通过套件运行的测试不同于直接通过 Tradefed 测试运行程序运行的标准测试。
有关定义和说明,请参阅设置套件。
2. 将选项和过滤条件传递到套件和模块
您可以使用各种命令行和参数将选项和过滤条件传递到套件级别或模块级别。
如需了解相关说明,请参阅将选项和过滤条件传递到套件和模块。
3. 系统状态检查工具
系统状态检查工具是在各个模块之间运行的组件,它可以检查和清理模块可能忘记清理的某些状态,例如模块忘了关掉锁屏。
有关实现和用法,请参阅系统状态检查工具。
4. AndroidTest.xml 结构
每个 AndroidTest.xml
文件代表一个测试模块。本部分介绍 AndroidTest.xml
配置文件的结构、它们与常规 Tradefed 配置的区别,以及允许的内容和不允许的内容。
有关允许的标记和配置示例,请参阅 AndroidTest.xml 结构。
5. 调优分片配置
本部分介绍如何调优模块配置的分片方面,并说明与每种方法相关的优势:
有关详情,请参阅调优 AndroidTest.xml 模块。
6. 控制器
模块控制器是可以在 AndroidTest.xml
中指定的特殊对象,用于更改模块行为的某一方面。例如,如果不满足某些条件,您可以完全跳过该模块。
有关实现和日志记录,请参阅模块控制器。
7. 重试
套件重试允许您重新运行对失败测试的上一次调用,以排除可能导致第一次失败的不稳定性和隔离性差的问题。
有关示例和用法,请参阅套件重试。
8. 多设备套件
较新版本现在支持多设备套件和模块,使测试可以在测试流程中的多个设备之间进行协调。
如需了解详情,请参阅多设备套件。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-03-26。
[null,null,["最后更新时间 (UTC):2025-03-26。"],[],[],null,["# Test through a suite\n\n1. Set up suite\n---------------\n\nTests running through a suite differs from a standard test running directly\nthrough Tradefed test runner.\n\nSee [Set up Suite](/docs/core/tests/tradefed/testing/through-suite/setup) for definitions and instructions.\n\n2. Pass options and filters to suite and modules\n------------------------------------------------\n\nVarious command lines and arguments can be used to pass options and filters to\nthe suite-level or the module-levels.\n\nSee [Pass options and filters to the suite and the modules](/docs/core/tests/tradefed/testing/through-suite/option-passing)\nfor instructions.\n\n3. System Status Checker\n------------------------\n\nSystem Status Checker is a component running between each module that can check\nand clean up some states that the module might have forgotten to clean, for\nexample a module leaving a keyguard on.\n\nSee [System status checker](/docs/core/tests/tradefed/testing/through-suite/system-status-checker) for implementation and\nuse.\n\n4. AndroidTest.xml structure\n----------------------------\n\nEach `AndroidTest.xml` file represents one test module. This section describes\nthe structure of an `AndroidTest.xml` configuration file, how they differ from\nregular Tradefed configuration, and what is allowed and not allowed.\n\nSee [AndroidTest.xml structure](/docs/core/tests/tradefed/testing/through-suite/android-test-structure) for allowed tags and\nan example configuration.\n\n5. Tune sharding configuration\n------------------------------\n\nThis section explains how to tune sharding aspects of your module configuration\nand describes the benefits associated with each of them:\n\n- Declare your module shardable or not\n- Tune the possible number of shards for your module\n\nSee [Tune AndroidTest.xml modules](/docs/core/tests/tradefed/testing/through-suite/android-test-tuning) for details.\n\n6. Controller\n-------------\n\nModule controllers are special objects that can be specified in\n`AndroidTest.xml` to alter some aspect of the module's behavior. For example,\nyou may completely skip the module if some conditions are not met.\n\nSee [Module controllers](/docs/core/tests/tradefed/testing/through-suite/module-controller) for implementation and logging.\n\n7. Retry\n--------\n\nSuite Retry allows you to re-run a previous invocation of failed tests in order\nto rule out flakiness or poor isolation that may have caused the first failure.\n\nSee [Suite Retry](/docs/core/tests/tradefed/testing/through-suite/suite-retry) for examples and use.\n\n8. Multi devices suites\n-----------------------\n\nNewer releases now support multi-devices suites and modules which allow for a\ntest to coordinate between multiple devices in its test flow.\n\nSee [Multi-devices suites](/docs/core/tests/tradefed/testing/through-suite/multi-devices-suites) for more details."]]