實作測試控管工具模式

測試輔助程式模式是 Android 10 中新增的功能,適用於希望自動化裝置或裝置機隊的第三方應用程式開發人員。這項功能提供一種方法,可清除 Android 裝置上的所有使用者資料、保留 ADB 金鑰,並略過所有首次設定畫面。這樣一來,使用者就能在啟動後立即執行 UI 測試,無需任何手動互動。

自訂

您可以檢查 ActivityManager.isRunningInUserTestHarness(),判斷裝置是否處於測試控管工具模式。請盡量自訂自訂內容;請限制略過某些設定畫面 (在鍵盤或設定精靈上),否則可能會幹擾 UI 測試或需要手動操作。

實作

PersistentDataBlockManagerInternal 的預設實作項目位於 PersistentDataBlockService 中。測試控管工具模式已在 TestHarnessModeService 中實作。

測試輔助工具模式的預設實作項目會使用與工廠重設保護機制相同的儲存機制,將 ADB 金鑰暫時儲存在永久分割區中。如果測試裝置已實作含有恢復原廠設定保護機制的持續性分割區,則無須或幾乎不需要採取任何行動即可支援這項功能。

如果 OEM 未設定永久性分割區,就必須先實作 PersistentDataBlockManagerInternal,再執行 TestHarnessModeService

檢查測試控管工具模式的狀態

啟用測試控管工具模式時,ActivityManager.isRunningInUserTestHarness() 會傳回 true

執行測試控管工具模式

啟用測試控管工具模式後,系統會清除裝置上的所有資料,並設定裝置以便進行測試。也就是說,裝置中所有可能干擾測試的部分 (例如自動同步帳戶、套件驗證和自動更新) 都會預設為停用,但使用者可以重新啟用。

執行 adb 指令以啟用測試控管工具模式:

adb shell cmd testharness enable