Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

UserSwitcher

public final class UserSwitcher
extends Object

java.lang.Object
↳	com.android.tradefed.device.UserSwitcher

Objeto auxiliar usado para alternar para um usuário de um determinado type e depois voltar para o usuário anterior.

Observação : ele deve ser usado apenas uma vez, geralmente por implementações de ERROR(/com.android.tradefed.targetprep.ISwitchUserTargetPreparer) (que chamariam ERROR(switchUser(ITestDevice,UserType)/#switchUser(com.android.tradefed.device.ITestDevice,com.android.tradefed.device.UserInfo.UserType) switchUser(ITestDevice,UserType)) em setUp() e switchBack() em tearDown(). Ele pode ser usado várias vezes, e nesse caso, switchBack() sempre mudaria para o ERROR(user switched to/#switchUser(com.android.tradefed.device.ITestDevice,com.android.tradefed.device.UserInfo.UserType) user switched to) mais recente.

Resumo

Construtores públicos
`UserSwitcher(ITestDevice device, UserInfo.UserType userType)` Construtor padrão.
`UserSwitcher(ITestDevice device, UserInfo.UserType userType, UserSwitcher.UserTypeMode userTypeMode)` Construtor completo.

Métodos públicos
`boolean`	`switchBack()` Volta para o usuário atual antes da chamada `ERROR(switchUser(ITestDevice,UserType)/#switchUser(com.android.tradefed.device.ITestDevice,com.android.tradefed.device.UserInfo.UserType) switchUser(ITestDevice,UserType))`.
`int`	`switchUser()` Muda para um usuário do conjunto `type` no construtor, se necessário.

Construtores públicos

UserSwitcher

public UserSwitcher (ITestDevice device, 
                UserInfo.UserType userType)

Construtor padrão.

Ele define o modo de tipo de usuário como UserTypeMode.LEGACY.

Parâmetros
`device`	`ITestDevice`
`userType`	`UserInfo.UserType`: tipo de usuário para alternar.

UserSwitcher

public UserSwitcher (ITestDevice device, 
                UserInfo.UserType userType, 
                UserSwitcher.UserTypeMode userTypeMode)

Construtor completo.

Parâmetros
`device`	`ITestDevice`
`userType`	`UserInfo.UserType`: tipo de usuário para alternar.
`userTypeMode`	`UserSwitcher.UserTypeMode`: define o comportamento do preparador com base em algumas propriedades do tipo de usuário.

Métodos públicos

switchBack

public boolean switchBack ()

Volta para o usuário atual antes da chamada ERROR(switchUser(ITestDevice,UserType)/#switchUser(com.android.tradefed.device.ITestDevice,com.android.tradefed.device.UserInfo.UserType) switchUser(ITestDevice,UserType)).

Retorna
`boolean`	se a troca foi bem-sucedida

Gera
`IllegalStateException`	se esse método for chamado antes de `ERROR(switchUser(ITestDevice,UserType)/#switchUser(com.android.tradefed.device.ITestDevice,com.android.tradefed.device.UserInfo.UserType) switchUser(ITestDevice,UserType))`
`DeviceNotAvailableException`

switchUser

public int switchUser ()

Muda para um usuário do conjunto type no construtor, se necessário.

Retorna
`int`	ID do usuário atual após a troca

Gera
`TargetSetupError`	se não for possível encontrar um usuário do tipo especificado, se a operação de troca de usuário falhar ou se esse método já tiver sido chamado.
`DeviceNotAvailableException`