自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
SwitchUserTargetPreparer
public
class
SwitchUserTargetPreparer
extends BaseTargetPreparer
在 setUp 中切換至指定使用者類型的 ITargetPreparer。根據預設，系統會保留目前使用者，且不會執行切換作業。
嘗試切換回執行前目前使用者，藉此還原裝置使用者狀態。
摘要
公用建構函式
SwitchUserTargetPreparer
public SwitchUserTargetPreparer ()
公用方法
public void setUp (TestInformation testInformation)
| 參數 |
|---|
testInformation |
TestInformation |
public void tearDown (TestInformation testInformation,
Throwable e)
| 參數 |
|---|
testInformation |
TestInformation |
e |
Throwable |
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間：2025-07-27 (世界標準時間)。
[[["容易理解","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-07-27 (世界標準時間)。"],[],[],null,["# SwitchUserTargetPreparer\n========================\n\n\n`\npublic\n\n\nclass\nSwitchUserTargetPreparer\n`\n\n\n`\n\n\n`\n\n`\n\nextends `[BaseTargetPreparer](../../../../../../reference/tradefed/com/android/tradefed/targetprep/BaseTargetPreparer.html)`\n\n\n`\n\n`\n\n\n`\n\n|---|---|----------------------------------------------------------|\n| java.lang.Object |||\n| ↳ | [com.android.tradefed.targetprep.BaseTargetPreparer](../../../../../../reference/tradefed/com/android/tradefed/targetprep/BaseTargetPreparer.html) ||\n| | ↳ | com.android.tradefed.targetprep.SwitchUserTargetPreparer |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nA [ITargetPreparer](../../../../../../reference/tradefed/com/android/tradefed/targetprep/ITargetPreparer.html) that switches to the specified user kind in setUp. By default it\nremains in the current user, and no switching is performed.\n\nTries to restore device user state by switching back to the pre-execution current user.\n\nSummary\n-------\n\n| ### Public constructors ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ` `[SwitchUserTargetPreparer](../../../../../../reference/tradefed/com/android/tradefed/targetprep/SwitchUserTargetPreparer.html#SwitchUserTargetPreparer())`() ` |\n\n| ### Public methods ||\n|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` void` | ` `[setUp](../../../../../../reference/tradefed/com/android/tradefed/targetprep/SwitchUserTargetPreparer.html#setUp(com.android.tradefed.invoker.TestInformation))`(`[TestInformation](../../../../../../reference/tradefed/com/android/tradefed/invoker/TestInformation.html)` testInformation) ` |\n| ` void` | ` `[tearDown](../../../../../../reference/tradefed/com/android/tradefed/targetprep/SwitchUserTargetPreparer.html#tearDown(com.android.tradefed.invoker.TestInformation,%20java.lang.Throwable))`(`[TestInformation](../../../../../../reference/tradefed/com/android/tradefed/invoker/TestInformation.html)` testInformation, Throwable e) ` |\n\nPublic constructors\n-------------------\n\n### SwitchUserTargetPreparer\n\n```\npublic SwitchUserTargetPreparer ()\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nPublic methods\n--------------\n\n### setUp\n\n```\npublic void setUp (TestInformation testInformation)\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Parameters ||\n|-------------------|--------------------------|\n| `testInformation` | `TestInformation` \u003cbr /\u003e |\n\n| Throws ||\n|----------------------------------------------------------------------------------------------------------------------------------|---|\n| [DeviceNotAvailableException](../../../../../../reference/tradefed/com/android/tradefed/device/DeviceNotAvailableException.html) | |\n| [TargetSetupError](../../../../../../reference/tradefed/com/android/tradefed/targetprep/TargetSetupError.html) | |\n\n### tearDown\n\n```\npublic void tearDown (TestInformation testInformation, \n Throwable e)\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Parameters ||\n|-------------------|--------------------------|\n| `testInformation` | `TestInformation` \u003cbr /\u003e |\n| `e` | `Throwable` \u003cbr /\u003e |\n\n| Throws ||\n|----------------------------------------------------------------------------------------------------------------------------------|---|\n| [DeviceNotAvailableException](../../../../../../reference/tradefed/com/android/tradefed/device/DeviceNotAvailableException.html) | |"]]
