A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en el AOSP.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

WifiHelper

public class WifiHelper
extends Object implements IWifiHelper

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

Clase de ayuda para manipular los servicios de Wi-Fi en el dispositivo.

Resumen

Constantes
`String`	`INSTRUMENTATION_PKG`

Constructores públicos
`WifiHelper(ITestDevice device)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup)` Es un constructor alternativo que puede omitir la configuración del APK de Wi-Fi.
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` Es el constructor para especificar si se debe usar la nueva versión 2 del asistente de Wi-Fi.

Métodos públicos
`boolean`	`addOpenNetwork(String ssid)` Agrega la red de seguridad abierta identificada por ssid.
`boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Agrega la red de seguridad abierta identificada por ssid.
`boolean`	`addWpaPskNetwork(String ssid, String psk)` Agrega la red de seguridad WPA-PSK identificada por ssid.
`boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Agrega la red de seguridad WPA-PSK identificada por ssid.
`boolean`	`checkConnectivity(String urlToCheck)` Verifica la conectividad enviando una solicitud HTTP a la URL proporcionada.
`void`	`cleanUp()` Limpia los recursos y la instalación empaquetada del asistente de Wi-Fi.
`boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` Se conecta a una red Wi-Fi y verifica la conectividad.
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` Se conecta a una red Wi-Fi y verifica la conectividad.
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` Se conecta a una red Wi-Fi y verifica la conectividad.
`boolean`	`disableWifi()` Inhabilita el estado de Wi-Fi en el dispositivo.
`boolean`	`disconnectFromNetwork()` Desconéctate de la red Wi-Fi actual y deshabilita la conexión Wi-Fi.
`boolean`	`enableWifi()` Habilita el estado de Wi-Fi en el dispositivo.
`static File`	`extractWifiUtilApk()` Método auxiliar para extraer el APK de la utilidad de Wi-Fi de la ruta de clase
`String`	`getBSSID()` Obtiene el identificador de conjunto de servicios básicos (BSSID) del punto de acceso actual.
`String`	`getIpAddress()` Obtiene la dirección IP asociada con la interfaz Wi-Fi.
`String`	`getSSID()` Obtiene el identificador del conjunto de servicios de la red conectada actualmente.
`Map<String, String>`	`getWifiInfo()` Obtiene la información de conexión Wi-Fi actual.
`boolean`	`hasValidIp()`
`boolean`	`isWifiEnabled()` Comprueba si el Wi-Fi está habilitado actualmente.
`boolean`	`removeAllNetworks()` Quita todas las redes conocidas.
`boolean`	`startMonitor(long interval, String urlToCheck)` Inicia la supervisión de la conectividad de red.
`List<Long>`	`stopMonitor()` Detiene la supervisión de la conectividad de red.
`boolean`	`waitForIp(long timeout)` Espera hasta que se asigne una dirección IP al adaptador de Wi-Fi.
`boolean`	`waitForWifiDisabled(long timeout)` Espera a que `isWifiEnabled()` sea falso.
`boolean`	`waitForWifiDisabled()` Espera a que `isWifiEnabled()` sea falso con un tiempo de espera predeterminado.
`boolean`	`waitForWifiEnabled(long timeout)` Espera a que `isWifiEnabled()` sea verdadero.
`boolean`	`waitForWifiEnabled()` Espera a que `isWifiEnabled()` sea verdadero con un tiempo de espera predeterminado.
`boolean`	`waitForWifiState(WifiState... expectedStates)` Espera hasta que se produzca uno de los estados de Wi-Fi esperados.

Constantes

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

Valor de la constante: "com.android.tradefed.utils.wifi"

Constructores públicos

WifiHelper

public WifiHelper (ITestDevice device)

Parámetros
`device`	`ITestDevice`

Arroja
`DeviceNotAvailableException`

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

Parámetros
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`

Arroja
`DeviceNotAvailableException`

WifiHelper

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

Es un constructor alternativo que puede omitir la configuración del APK de Wi-Fi.

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

Arroja
`DeviceNotAvailableException`

WifiHelper

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

Es el constructor para especificar si se debe usar el nuevo asistente de Wi-Fi v2. Las operaciones de la versión 2 no necesitan instalar el APK de la utilidad de Wi-Fi.

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

Arroja
`DeviceNotAvailableException`

Métodos públicos

addOpenNetwork

public boolean addOpenNetwork (String ssid)

Agrega la red de seguridad abierta identificada por ssid.

Para conectarse a cualquier red Wi-Fi, primero se debe crear un perfil de red en la configuración de wpa_supplicant. Esto llamará a wpa_cli para agregar la red de seguridad abierta identificada por ssid.

Parámetros
`ssid`	`String`: Es el SSID de la red que se agregará.

Muestra
`boolean`	`true` si la red se agregó correctamente; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Agrega la red de seguridad abierta identificada por ssid.

Parámetros
`ssid`	`String`: Es el SSID de la red que se agregará.
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.

Muestra
`boolean`	`true` si la red se agregó correctamente; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

Agrega la red de seguridad WPA-PSK identificada por ssid.

Parámetros
`ssid`	`String`: Es el SSID de la red que se agregará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará.

Muestra
`boolean`	`true` si la red se agregó correctamente; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

addWpaPskNetwork

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

Agrega la red de seguridad WPA-PSK identificada por ssid.

Parámetros
`ssid`	`String`: Es el SSID de la red que se agregará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará.
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.

Muestra
`boolean`	`true` si la red se agregó correctamente; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

Verifica la conectividad enviando una solicitud HTTP a la URL proporcionada.

Parámetros
`urlToCheck`	`String`: Es una URL de destino para una verificación de solicitud HTTP.

Muestra
`boolean`	`true` si el dispositivo pasa la verificación de conectividad

Arroja
`DeviceNotAvailableException`

cleanUp

public void cleanUp ()

Limpia los recursos y la instalación empaquetada del asistente de Wi-Fi. Solo se debe llamar a este método cuando ya no se necesita Wi-Fi para la invocación, ya que el dispositivo perdería la conexión Wi-Fi cuando se desinstale el asistente.

Arroja
`DeviceNotAvailableException`

connectToNetwork

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

Se conecta a una red Wi-Fi y verifica la conectividad.

Parámetros
`ssid`	`String`: Es el SSID de la red a la que se conectará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará. Puede ser nulo.
`urlToCheck`	`String`: Es una URL de destino para una verificación de solicitud HTTP.

Muestra
`boolean`	`true` si el dispositivo pasa la verificación de conectividad

Arroja
`DeviceNotAvailableException`

connectToNetwork

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

Se conecta a una red Wi-Fi y verifica la conectividad.

Parámetros
`ssid`	`String`: Es el SSID de la red a la que se conectará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará. Puede ser nulo.
`urlToCheck`	`String`: Es una URL de destino para una verificación de solicitud HTTP.
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.
`defaultType`	`String`: Es el tipo de red predeterminado al que se recurre si no se determina el tipo de red del SSID.

Muestra
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult que representa el resultado de la conexión Wi-Fi

Arroja
`DeviceNotAvailableException`

connectToNetwork

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

Se conecta a una red Wi-Fi y verifica la conectividad.

Parámetros
`ssid`	`String`: Es el SSID de la red a la que se conectará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará. Puede ser nulo.
`urlToCheck`	`String`: Es una URL de destino para una verificación de solicitud HTTP.
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.

Muestra
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult que representa el resultado de la conexión Wi-Fi

Arroja
`DeviceNotAvailableException`

disableWifi

public boolean disableWifi ()

Inhabilita el estado de Wi-Fi en el dispositivo.

Muestra
`boolean`	`true` si se inhabilitó el Wi-Fi correctamente

Arroja
`DeviceNotAvailableException`

disconnectFromNetwork

public boolean disconnectFromNetwork ()

Desconéctate de la red Wi-Fi actual y deshabilita la conexión Wi-Fi.

Muestra
`boolean`	`true` si la operación se realizó correctamente.

Arroja
`DeviceNotAvailableException`

enableWifi

public boolean enableWifi ()

Habilita el estado de Wi-Fi en el dispositivo.

Muestra
`boolean`	`true` si la conexión Wi-Fi se habilitó correctamente

Arroja
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

Método auxiliar para extraer el APK de la utilidad de Wi-Fi de la ruta de clase

Muestra
`File`

Arroja
`IOException`

getBSSID

public String getBSSID ()

Obtiene el identificador de conjunto de servicios básicos (BSSID) del punto de acceso actual.

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Obtiene la dirección IP asociada con la interfaz Wi-Fi. Devuelve null si no se pudo recuperar la dirección IP.

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getSSID

public String getSSID ()

Obtiene el identificador del conjunto de servicios de la red conectada actualmente.

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getWifiInfo

public Map<String, String> getWifiInfo ()

Obtiene la información de conexión Wi-Fi actual.

Esto incluye el SSID, el BSSID, la dirección IP, la velocidad de vínculo y el RSSI.

Muestra
`Map<String, String>`	Un mapa que contiene información de conexión Wi-Fi.

Arroja
`DeviceNotAvailableException`

hasValidIp

public boolean hasValidIp ()

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Comprueba si el Wi-Fi está habilitado actualmente.

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

removeAllNetworks

public boolean removeAllNetworks ()

Quita todas las redes conocidas.

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

Inicia la supervisión de la conectividad de red.

Parámetros
`interval`	`long`: Intervalo entre las verificaciones de conectividad.
`urlToCheck`	`String`: Es una URL para verificar la conectividad.

Muestra
`boolean`	`true` si la operación se realizó correctamente.

Arroja
`DeviceNotAvailableException`

stopMonitor

public List<Long> stopMonitor ()

Detiene la supervisión de la conectividad de red.

También devuelve el historial de latencia desde la última llamada a IWifiHelper.startMonitor(long,String).

Muestra
`List<Long>`	el historial de latencia.

Arroja
`DeviceNotAvailableException`

waitForIp

public boolean waitForIp (long timeout)

Espera hasta que se asigne una dirección IP al adaptador de Wi-Fi.

Parámetros
`timeout`	`long`: Cuánto tiempo esperar

Muestra
`boolean`	`true` si se asigna una dirección IP antes del tiempo de espera; de lo contrario, `false`

Arroja
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

Espera a que isWifiEnabled() sea falso.

Parámetros
`timeout`	`long`: Tiempo en ms para esperar

Muestra
`boolean`	`true` si se inhabilitó el Wi-Fi antes del tiempo de espera; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled ()

Espera a que isWifiEnabled() sea falso con un tiempo de espera predeterminado.

Muestra
`boolean`	`true` si se inhabilitó el Wi-Fi antes del tiempo de espera; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

Espera a que isWifiEnabled() sea verdadero.

Parámetros
`timeout`	`long`: Tiempo en ms para esperar

Muestra
`boolean`	`true` si el Wi-Fi estaba habilitado antes del tiempo de espera; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled ()

Espera a que isWifiEnabled() sea verdadero con un tiempo de espera predeterminado.

Muestra
`boolean`	`true` si el Wi-Fi estaba habilitado antes del tiempo de espera; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

Espera hasta que se produzca uno de los estados de Wi-Fi esperados.

Parámetros
`expectedStates`	`WifiState`: Uno o más estados de Wi-Fi esperados

Muestra
`boolean`	`true` si se produjo uno de los estados esperados. `false` si ninguno de los estados ocurrió antes de que se alcanzara el tiempo de espera

Arroja
`DeviceNotAvailableException`