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.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

SettingsUtil

public class SettingsUtil
extends Object

java.lang.Object
↳	com.google.android.tradefed.device.SettingsUtil

Uma classe utilitária que pode mudar as configurações de um dispositivo.

Essa classe está temporariamente em vendor/google porque depende de um mecanismo não pronto para código aberto para mudar configurações seguras. Quando um método de código aberto seguro para mudar configurações seguras estiver disponível, essa classe será migrada para o projeto principal do Tradefed.

Resumo

Construtores públicos
`SettingsUtil(ITestDevice device)` Construtor padrão para SettingsUtil. Permite configurar as configurações do lado do dispositivo.
`SettingsUtil(ITestDevice device, File settingApk)` Construtor que permite substituir o APK padrão usado para configurar as configurações do dispositivo.

Métodos públicos
`void`	`changeGlobalSetting(String name, String value)` Mudar uma configuração global no dispositivo
`void`	`changeGooglePartnerSetting(String name, String value)` Mudar uma configuração de parceiro do Google no dispositivo
`void`	`changeSecureSetting(String name, String value)` Mudar uma configuração de segurança no dispositivo
`void`	`changeSetting(String name, String value)` Mudar uma configuração no dispositivo
`void`	`installSettingCmdApk()` Instale o APK do comando de configuração no dispositivo.
`void`	`overrideGServices(String name, String value)` Substitui um valor de gservices no dispositivo.
`void`	`uninstallSettingCmd()` Desinstale o APK do comando de configuração do dispositivo.

Construtores públicos

SettingsUtil

public SettingsUtil (ITestDevice device)

Construtor padrão para SettingsUtil. Permite configurar as configurações do lado do dispositivo. Um APK padrão é usado para configurar as configurações do dispositivo e é escolhido com base na assinatura de build dele.

Parâmetros
`device`	`ITestDevice`: dispositivo em teste

Gera
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

SettingsUtil

public SettingsUtil (ITestDevice device, 
                File settingApk)

Construtor que permite substituir o APK padrão usado para configurar as configurações do dispositivo.

Parâmetros
`device`	`ITestDevice`: dispositivo em teste
`settingApk`	`File`: objeto de arquivo que se refere ao caminho em que o SettingCmd.apk está armazenado. Se for nulo, vai usar o APK padrão, escolhido com base na assinatura de build do dispositivo.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

Métodos públicos

changeGlobalSetting

public void changeGlobalSetting (String name, 
                String value)

Mudar uma configuração global no dispositivo

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

changeGooglePartnerSetting

public void changeGooglePartnerSetting (String name, 
                String value)

Mudar uma configuração de parceiro do Google no dispositivo

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

changeSecureSetting

public void changeSecureSetting (String name, 
                String value)

Mudar uma configuração de segurança no dispositivo

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

changeSetting

public void changeSetting (String name, 
                String value)

Mudar uma configuração no dispositivo

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

installSettingCmdApk

public void installSettingCmdApk ()

Instale o APK do comando de configuração no dispositivo. Precisa ser executado antes de qualquer chamada de configuração de mudança.

Gera
`DeviceNotAvailableException`
`TargetSetupError`

overrideGServices

public void overrideGServices (String name, 
                String value)

Substitui um valor de gservices no dispositivo.

Essa operação é assíncrona. Não há garantia de que o valor gservices será definido quando esse método retornar.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

uninstallSettingCmd

public void uninstallSettingCmd ()

Desinstale o APK do comando de configuração do dispositivo.

Gera
`DeviceNotAvailableException`