自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

目标准备器

目标准备器在定义它们的测试级别中的测试之前调用。这样，您就可以设置任何设备，以使测试顺畅地运行。

基础接口

基接口是 ITargetPreparer，用于实现要执行的 setUp 方法。建议您实现我们的基本抽象类 BaseTargetPreparer，它提供了内置的停用功能来轻松停用准备器。

setUp 的自然扩展是 tearDown，由其他接口 ITargetCleaner 提供。这提供了 tearDown 接口，可用于清理测试执行后 setUp 中完成的任何任务。

BaseTargetPreparer 类也会扩展 ITargetCleaner。

我们建议每个准备器限定于一项主要功能，例如安装 APK 或运行命令。这样，就可以更容易地重复使用准备器。

此外，请在添加新的准备器之前检查可用准备器的列表，以避免重复工作。准备器位于 tools/tradefederation/core/src/com/android/tradefed/targetprep/。

对象标记为 target_preparer，例如：

<target_preparer class="com.android.tradefed.targetprep.InstallApkSetup">
    <option name="install-arg" value="-d"/>
</target_preparer>

如需了解相关背景信息，另请参阅设置套件。

如果是在顶级设置中指定的准备器，则准备器会仅针对每个设备运行一次。例如 cts-common.xml，它是 Android 兼容性测试套件 (CTS) 测试的顶级设置。

如果是在模块级设置中指定的准备器，则准备器将始终在该模块之前运行。例如 backup/AndroidTest.xml，它定义 Tradefed 如何运行 backup CTS 模块。