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.

WifiHelper

public class WifiHelper
extends Object implements IWifiHelper

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

Classe auxiliar para manipular serviços de Wi-Fi no dispositivo.

Resumo

Constantes
`String`	`INSTRUMENTATION_PKG`

Construtores públicos
`WifiHelper(ITestDevice device)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup)` Construtor alternativo que pode pular a configuração do APK do Wi-Fi.
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` Construtor para especificar se é necessário usar o novo auxiliar de Wi-Fi v2.

Métodos públicos
`boolean`	`addOpenNetwork(String ssid)` Adiciona a rede de segurança aberta identificada pelo SSID.
`boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Adiciona a rede de segurança aberta identificada pelo SSID.
`boolean`	`addWpaPskNetwork(String ssid, String psk)` Adiciona a rede de segurança WPA-PSK identificada por ssid.
`boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Adiciona a rede de segurança WPA-PSK identificada por ssid.
`boolean`	`checkConnectivity(String urlToCheck)` Verifica a conectividade enviando uma solicitação HTTP para o URL especificado.
`void`	`cleanUp()` Limpe os recursos e a instalação do pacote do assistente de Wi-Fi.
`boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` Conecta-se a uma rede Wi-Fi e verifica a conectividade.
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` Conecta-se a uma rede Wi-Fi e verifica a conectividade.
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` Conecta-se a uma rede Wi-Fi e verifica a conectividade.
`boolean`	`disableWifi()` Desativa o estado do Wi-Fi no dispositivo.
`boolean`	`disconnectFromNetwork()` Desconecte-se da rede Wi-Fi atual e desative o Wi-Fi.
`boolean`	`enableWifi()` Ativa o estado do Wi-Fi no dispositivo.
`static File`	`extractWifiUtilApk()` Método auxiliar para extrair o APK de utilitário do Wi-Fi do classpath.
`String`	`getBSSID()` Recebe o identificador do conjunto de serviços básicos (BSSID) do ponto de acesso atual.
`String`	`getIpAddress()` Recebe o endereço IP associado à interface Wi-Fi.
`String`	`getSSID()` Recebe o identificador do conjunto de serviços da rede conectada no momento.
`Map<String, String>`	`getWifiInfo()` Recebe as informações atuais de conexão Wi-Fi.
`boolean`	`hasValidIp()`
`boolean`	`isWifiEnabled()` Verifique se o Wi-Fi está ativado.
`boolean`	`removeAllNetworks()` Remove todas as redes conhecidas.
`boolean`	`startMonitor(long interval, String urlToCheck)` Inicia o monitoramento da conectividade de rede.
`List<Long>`	`stopMonitor()` Interrompe o monitoramento da conectividade de rede.
`boolean`	`waitForIp(long timeout)` Aguarde até que um endereço IP seja atribuído ao adaptador Wi-Fi.
`boolean`	`waitForWifiDisabled(long timeout)` Aguarde até que `isWifiEnabled()` seja "false".
`boolean`	`waitForWifiDisabled()` Aguarde até que `isWifiEnabled()` seja falso com um tempo limite padrão.
`boolean`	`waitForWifiEnabled(long timeout)` Aguarde até que `isWifiEnabled()` seja verdadeiro.
`boolean`	`waitForWifiEnabled()` Aguarde até que `isWifiEnabled()` seja verdadeiro com um tempo limite padrão.
`boolean`	`waitForWifiState(WifiState... expectedStates)` Aguarde até que um dos estados de Wi-Fi esperados ocorra.

Constantes

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

Valor da constante: "com.android.tradefed.utils.wifi"

Construtores públicos

WifiHelper

public WifiHelper (ITestDevice device)

Parâmetros
`device`	`ITestDevice`

Gera
`DeviceNotAvailableException`

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

Parâmetros
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`

Gera
`DeviceNotAvailableException`

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath, 
                boolean doSetup)

Construtor alternativo que pode pular a configuração do APK do Wi-Fi.

Parâmetros
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`

Gera
`DeviceNotAvailableException`

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath, 
                boolean doSetup, 
                boolean useV2)

Construtor para especificar se é necessário usar o novo auxiliar de Wi-Fi v2. As operações da v2 não precisam instalar o APK do utilitário de Wi-Fi.

Parâmetros
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`
`useV2`	`boolean`

Gera
`DeviceNotAvailableException`

Métodos públicos

addOpenNetwork

public boolean addOpenNetwork (String ssid)

Adiciona a rede de segurança aberta identificada pelo SSID.

Para se conectar a qualquer rede Wi-Fi, primeiro é preciso criar um perfil de rede na configuração do wpa_supplicant. Isso vai chamar o wpa_cli para adicionar a rede de segurança aberta identificada por ssid.

Parâmetros
`ssid`	`String`: o SSID da rede a ser adicionada.

Retorna
`boolean`	`true` se a rede foi adicionada com sucesso. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Adiciona a rede de segurança aberta identificada pelo SSID.

Parâmetros
`ssid`	`String`: o SSID da rede a ser adicionada.
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto desta rede.

Retorna
`boolean`	`true` se a rede foi adicionada com sucesso. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

Adiciona a rede de segurança WPA-PSK identificada por ssid.

Parâmetros
`ssid`	`String`: o SSID da rede a ser adicionada.
`psk`	`String`: a senha WPA-PSK a ser usada

Retorna
`boolean`	`true` se a rede foi adicionada com sucesso. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk, 
                boolean scanSsid)

Adiciona a rede de segurança WPA-PSK identificada por ssid.

Parâmetros
`ssid`	`String`: o SSID da rede a ser adicionada.
`psk`	`String`: a senha WPA-PSK a ser usada
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto desta rede.

Retorna
`boolean`	`true` se a rede foi adicionada com sucesso. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

Verifica a conectividade enviando uma solicitação HTTP para o URL especificado.

Parâmetros
`urlToCheck`	`String`: um URL de destino para uma verificação de solicitação HTTP.

Retorna
`boolean`	`true` se o dispositivo passar na verificação de conectividade.

Gera
`DeviceNotAvailableException`

cleanUp

public void cleanUp ()

Limpe os recursos e a instalação do pacote do assistente de Wi-Fi. Isso só deve ser chamado quando o Wi-Fi não for mais necessário para a invocação, já que o dispositivo perderia a conexão Wi-Fi quando o auxiliar for desinstalado.

Gera
`DeviceNotAvailableException`

connectToNetwork

public boolean connectToNetwork (String ssid, 
                String psk, 
                String urlToCheck)

Conecta-se a uma rede Wi-Fi e verifica a conectividade.

Parâmetros
`ssid`	`String`: o SSID da rede a ser conectada
`psk`	`String`: a senha WPA-PSK a ser usada. Pode ser nulo.
`urlToCheck`	`String`: um URL de destino para uma verificação de solicitação HTTP.

Retorna
`boolean`	`true` se o dispositivo passar na verificação de conectividade.

Gera
`DeviceNotAvailableException`

connectToNetwork

public IWifiHelper.WifiConnectionResult connectToNetwork (String ssid, 
                String psk, 
                String urlToCheck, 
                boolean scanSsid, 
                String defaultType)

Conecta-se a uma rede Wi-Fi e verifica a conectividade.

Parâmetros
`ssid`	`String`: o SSID da rede a ser conectada
`psk`	`String`: a senha WPA-PSK a ser usada. Pode ser nulo.
`urlToCheck`	`String`: um URL de destino para uma verificação de solicitação HTTP.
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto desta rede.
`defaultType`	`String`: tipo de rede padrão para usar se o tipo de rede do SSID não for determinado.

Retorna
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult que representa o resultado da conexão Wi-Fi.

Gera
`DeviceNotAvailableException`

connectToNetwork

public IWifiHelper.WifiConnectionResult connectToNetwork (String ssid, 
                String psk, 
                String urlToCheck, 
                boolean scanSsid)

Conecta-se a uma rede Wi-Fi e verifica a conectividade.

Parâmetros
`ssid`	`String`: o SSID da rede a ser conectada
`psk`	`String`: a senha WPA-PSK a ser usada. Pode ser nulo.
`urlToCheck`	`String`: um URL de destino para uma verificação de solicitação HTTP.
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto desta rede.

Retorna
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult que representa o resultado da conexão Wi-Fi.

Gera
`DeviceNotAvailableException`

disableWifi

public boolean disableWifi ()

Desativa o estado do Wi-Fi no dispositivo.

Retorna
`boolean`	`true` se o Wi-Fi foi desativado

Gera
`DeviceNotAvailableException`

disconnectFromNetwork

public boolean disconnectFromNetwork ()

Desconecte-se da rede Wi-Fi atual e desative o Wi-Fi.

Retorna
`boolean`	`true` se a operação for bem-sucedida.

Gera
`DeviceNotAvailableException`

enableWifi

public boolean enableWifi ()

Ativa o estado do Wi-Fi no dispositivo.

Retorna
`boolean`	`true` se o Wi-Fi foi ativado com sucesso

Gera
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

Método auxiliar para extrair o APK de utilitário do Wi-Fi do classpath.

Retorna
`File`

Gera
`IOException`

getBSSID

public String getBSSID ()

Recebe o identificador do conjunto de serviços básicos (BSSID) do ponto de acesso atual.

Retorna
`String`

Gera
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Recebe o endereço IP associado à interface Wi-Fi. Retorna null se houver uma falha ao recuperar o endereço IP.

Retorna
`String`

Gera
`DeviceNotAvailableException`

getSSID

public String getSSID ()

Recebe o identificador do conjunto de serviços da rede conectada no momento.

Retorna
`String`

Gera
`DeviceNotAvailableException`

getWifiInfo

public Map<String, String> getWifiInfo ()

Recebe as informações atuais de conexão Wi-Fi.

Isso inclui SSID, BSSID, endereço IP, velocidade do link e RSSI.

Retorna
`Map<String, String>`	um mapa com informações de conexão Wi-Fi.

Gera
`DeviceNotAvailableException`

hasValidIp

public boolean hasValidIp ()

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Verifique se o Wi-Fi está ativado.

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

removeAllNetworks

public boolean removeAllNetworks ()

Remove todas as redes conhecidas.

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

Inicia o monitoramento da conectividade de rede.

Parâmetros
`interval`	`long`: intervalo entre as verificações de conectividade.
`urlToCheck`	`String`: um URL para verificar a conectividade.

Retorna
`boolean`	`true` se a operação for bem-sucedida.

Gera
`DeviceNotAvailableException`

stopMonitor

public List<Long> stopMonitor ()

Interrompe o monitoramento da conectividade de rede.

Isso também retorna o histórico de latência desde a última chamada IWifiHelper.startMonitor(long,String).

Retorna
`List<Long>`	o histórico de latência.

Gera
`DeviceNotAvailableException`

waitForIp

public boolean waitForIp (long timeout)

Aguarde até que um endereço IP seja atribuído ao adaptador Wi-Fi.

Parâmetros
`timeout`	`long`: quanto tempo esperar

Retorna
`boolean`	`true` se um endereço IP for atribuído antes do tempo limite, `false` caso contrário.

Gera
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

Aguarde até que isWifiEnabled() seja "false".

Parâmetros
`timeout`	`long`: tempo em ms para aguardar

Retorna
`boolean`	`true` se o Wi-Fi foi desativado antes do tempo limite, `false` caso contrário.

Gera
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled ()

Aguarde até que isWifiEnabled() seja falso com um tempo limite padrão.

Retorna
`boolean`	`true` se o Wi-Fi foi desativado antes do tempo limite, `false` caso contrário.

Gera
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

Aguarde até que isWifiEnabled() seja verdadeiro.

Parâmetros
`timeout`	`long`: tempo em ms para aguardar

Retorna
`boolean`	`true` se o Wi-Fi foi ativado antes do tempo limite. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled ()

Aguarde até que isWifiEnabled() seja verdadeiro com um tempo limite padrão.

Retorna
`boolean`	`true` se o Wi-Fi foi ativado antes do tempo limite. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

Aguarde até que um dos estados de Wi-Fi esperados ocorra.

Parâmetros
`expectedStates`	`WifiState`: um ou mais estados de Wi-Fi esperados

Retorna
`boolean`	`true` se um dos estados esperados ocorreu. `false` se nenhum dos estados ocorreu antes do tempo limite ser atingido

Gera
`DeviceNotAvailableException`