為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將於 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，建議使用 android-latest-release，而非 aosp-main。android-latest-release 資訊清單分支版本一律會參照推送至 AOSP 的最新版本。詳情請參閱「Android 開放原始碼計畫變更」一文。
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
導入測試控管工具模式
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
Android 10 新增的「測試機模式」功能，可供第三方應用程式開發人員自動化管理裝置或裝置群組。這項功能提供一種方法，可抹除 Android 裝置上的所有使用者資料、保留 ADB 金鑰，並略過所有首次設定畫面。這樣一來，使用者就能在啟動後立即執行 UI 測試，不必手動操作。
自訂
您可以檢查 ActivityManager.isRunningInUserTestHarness()，判斷裝置是否處於測試控管工具模式。盡量減少自訂項目；
僅限於跳過會中斷 UI 測試或需要手動互動的設定畫面 (在鍵盤或設定精靈上)。
實作
PersistentDataBlockManagerInternal 的預設實作位於 PersistentDataBlockService 中。測試控管工具模式已在 TestHarnessModeService 中實作。
測試機模式的預設實作方式與原廠重設保護機制使用相同的儲存機制，可將 adb 金鑰暫時儲存在持續性分割區。如果測試裝置已實作具備恢復原廠設定保護機制的持續性分割區，支援這項功能幾乎不需要任何作業。
如果 OEM 沒有設定持續性分割區，就必須先實作 PersistentDataBlockManagerInternal，才能執行 TestHarnessModeService。
查看測試控管工具模式的狀態
啟用測試控管工具模式後，ActivityManager.isRunningInUserTestHarness() 會傳回 true。
執行測試控管工具模式
啟用測試機架模式會清除裝置上的所有資料，並設定裝置以進行測試。也就是說，裝置中所有可能干擾測試的部分 (例如自動同步帳戶、套件驗證和自動更新) 預設都會停用，但使用者可以重新啟用。
執行 adb 指令，啟用測試控管工具模式：
adb shell cmd testharness enable
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間：2025-12-03 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-12-03 (世界標準時間)。"],[],[]]
