自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 Cloud Translation API 翻譯而成。

指定準備者

系統會在測試層級中定義的測試前，呼叫目標準備工具。這樣一來，您就能設定任何裝置，讓測試順利執行。

基礎介面

基礎介面為 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 模組的方式。