À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer dans AOSP, utilisez android-latest-release. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à 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 d'assistance pour manipuler les services Wi-Fi sur l'appareil.

Résumé

Constantes
`String`	`INSTRUMENTATION_PKG`

Constructeurs publics
`WifiHelper(ITestDevice device)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup)` Constructeur alternatif qui peut ignorer la configuration de l'APK Wi-Fi.
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` Constructeur permettant de spécifier s'il faut utiliser le nouvel utilitaire Wi-Fi V2.

Méthodes publiques
`boolean`	`addOpenNetwork(String ssid)` Ajoute le réseau de sécurité ouvert identifié par ssid.
`boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Ajoute le réseau de sécurité ouvert identifié par ssid.
`boolean`	`addWpaPskNetwork(String ssid, String psk)` Ajoute le réseau sécurisé WPA-PSK identifié par le ssid.
`boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Ajoute le réseau sécurisé WPA-PSK identifié par le ssid.
`boolean`	`checkConnectivity(String urlToCheck)` Vérifie la connectivité en envoyant une requête HTTP à l'URL indiquée.
`void`	`cleanUp()` Nettoyez les ressources et l'installation du package de l'assistant Wi-Fi.
`boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` Se connecter à un réseau Wi-Fi et vérifier la connectivité
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` Se connecter à un réseau Wi-Fi et vérifier la connectivité
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` Se connecter à un réseau Wi-Fi et vérifier la connectivité
`boolean`	`disableWifi()` Désactive l'état du Wi-Fi sur l'appareil.
`boolean`	`disconnectFromNetwork()` Déconnecte-toi du réseau Wi-Fi actuel et désactive le Wi-Fi.
`boolean`	`enableWifi()` Active l'état du Wi-Fi sur l'appareil.
`static File`	`extractWifiUtilApk()` Méthode d'assistance pour extraire l'APK de l'utilitaire Wi-Fi du classpath
`String`	`getBSSID()` Récupère l'identifiant de l'ensemble de services de base (BSSID) du point d'accès actuel.
`String`	`getIpAddress()` Obtient l'adresse IP associée à l'interface Wi-Fi.
`String`	`getSSID()` Récupère l'identifiant du jeu de services du réseau actuellement connecté.
`Map<String, String>`	`getWifiInfo()` Obtient les informations actuelles sur la connexion Wi-Fi.
`boolean`	`hasValidIp()`
`boolean`	`isWifiEnabled()` Vérifiez si le Wi-Fi est actuellement activé.
`boolean`	`removeAllNetworks()` Supprime tous les réseaux connus.
`boolean`	`startMonitor(long interval, String urlToCheck)` Démarre la surveillance de la connectivité réseau.
`List<Long>`	`stopMonitor()` Arrête la surveillance de la connectivité réseau.
`boolean`	`waitForIp(long timeout)` Attendez qu'une adresse IP soit attribuée à l'adaptateur Wi-Fi.
`boolean`	`waitForWifiDisabled(long timeout)` Attendez que `isWifiEnabled()` soit défini sur "false".
`boolean`	`waitForWifiDisabled()` Attendez que `isWifiEnabled()` soit défini sur "false" avec un délai avant expiration par défaut.
`boolean`	`waitForWifiEnabled(long timeout)` Attendez que `isWifiEnabled()` soit défini sur "true".
`boolean`	`waitForWifiEnabled()` Attendez que `isWifiEnabled()` soit défini sur "true" avec un délai d'attente par défaut.
`boolean`	`waitForWifiState(WifiState... expectedStates)` Attend qu'un des états Wi-Fi attendus se produise.

Constantes

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

Valeur de constante : "com.android.tradefed.utils.wifi"

Constructeurs publics

WifiHelper

public WifiHelper (ITestDevice device)

Paramètres
`device`	`ITestDevice`

Génère
`DeviceNotAvailableException`

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

Paramètres
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`

Génère
`DeviceNotAvailableException`

WifiHelper

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

Constructeur alternatif qui peut ignorer la configuration de l'APK Wi-Fi.

Paramètres
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`

Génère
`DeviceNotAvailableException`

WifiHelper

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

Constructeur permettant de spécifier s'il faut utiliser le nouvel utilitaire Wi-Fi v2. Les opérations v2 n'ont pas besoin d'installer l'APK de l'utilitaire Wi-Fi.

Paramètres
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`
`useV2`	`boolean`

Génère
`DeviceNotAvailableException`

Méthodes publiques

addOpenNetwork

public boolean addOpenNetwork (String ssid)

Ajoute le réseau de sécurité ouvert identifié par ssid.

Pour se connecter à un réseau Wi-Fi, un profil réseau doit d'abord être créé dans la configuration wpa_supplicant. Cela appellera wpa_cli pour ajouter le réseau de sécurité ouvert identifié par ssid.

Paramètres
`ssid`	`String` : SSID du réseau à ajouter.

Renvoie
`boolean`	`true` si le réseau a été ajouté, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Ajoute le réseau de sécurité ouvert identifié par ssid.

Paramètres
`ssid`	`String` : SSID du réseau à ajouter.
`scanSsid`	`boolean` : indique s'il faut rechercher le SSID masqué de ce réseau.

Renvoie
`boolean`	`true` si le réseau a été ajouté, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

Ajoute le réseau sécurisé WPA-PSK identifié par le ssid.

Paramètres
`ssid`	`String` : SSID du réseau à ajouter.
`psk`	`String` : phrase secrète WPA-PSK à utiliser

Renvoie
`boolean`	`true` si le réseau a été ajouté, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

addWpaPskNetwork

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

Ajoute le réseau sécurisé WPA-PSK identifié par le ssid.

Paramètres
`ssid`	`String` : SSID du réseau à ajouter.
`psk`	`String` : phrase secrète WPA-PSK à utiliser
`scanSsid`	`boolean` : indique s'il faut rechercher le SSID masqué de ce réseau.

Renvoie
`boolean`	`true` si le réseau a été ajouté, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

Vérifie la connectivité en envoyant une requête HTTP à l'URL indiquée.

Paramètres
`urlToCheck`	`String` : URL de destination pour une vérification de requête HTTP

Renvoie
`boolean`	`true` si l'appareil réussit le test de connectivité.

Génère
`DeviceNotAvailableException`

cleanUp

public void cleanUp ()

Nettoyez les ressources et l'installation du package de l'assistant Wi-Fi. Cette méthode ne doit être appelée que lorsque le Wi-Fi n'est plus nécessaire pour l'invocation, car l'appareil perdrait la connexion Wi-Fi lorsque l'assistant est désinstallé.

Génère
`DeviceNotAvailableException`

connectToNetwork

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

Se connecter à un réseau Wi-Fi et vérifier la connectivité

Paramètres
`ssid`	`String` : SSID du réseau auquel se connecter
`psk`	`String` : phrase secrète WPA-PSK à utiliser. Cette valeur peut être nulle.
`urlToCheck`	`String` : URL de destination pour une vérification de requête HTTP

Renvoie
`boolean`	`true` si l'appareil réussit le test de connectivité.

Génère
`DeviceNotAvailableException`

connectToNetwork

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

Se connecter à un réseau Wi-Fi et vérifier la connectivité

Paramètres
`ssid`	`String` : SSID du réseau auquel se connecter
`psk`	`String` : phrase secrète WPA-PSK à utiliser. Cette valeur peut être nulle.
`urlToCheck`	`String` : URL de destination pour une vérification de requête HTTP
`scanSsid`	`boolean` : indique si le SSID masqué doit être recherché pour ce réseau.
`defaultType`	`String` : type de réseau par défaut auquel revenir si le type de réseau du SSID n'est pas déterminé.

Renvoie
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult représentant le résultat de la connexion Wi-Fi

Génère
`DeviceNotAvailableException`

connectToNetwork

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

Se connecter à un réseau Wi-Fi et vérifier la connectivité

Paramètres
`ssid`	`String` : SSID du réseau auquel se connecter
`psk`	`String` : phrase secrète WPA-PSK à utiliser. Cette valeur peut être nulle.
`urlToCheck`	`String` : URL de destination pour une vérification de requête HTTP
`scanSsid`	`boolean` : indique si le SSID masqué doit être recherché pour ce réseau.

Renvoie
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult représentant le résultat de la connexion Wi-Fi

Génère
`DeviceNotAvailableException`

disableWifi

public boolean disableWifi ()

Désactive l'état du Wi-Fi sur l'appareil.

Renvoie
`boolean`	`true` si le Wi-Fi a été désactivé

Génère
`DeviceNotAvailableException`

disconnectFromNetwork

public boolean disconnectFromNetwork ()

Déconnecte-toi du réseau Wi-Fi actuel et désactive le Wi-Fi.

Renvoie
`boolean`	`true` si l'opération a réussi.

Génère
`DeviceNotAvailableException`

enableWifi

public boolean enableWifi ()

Active l'état du Wi-Fi sur l'appareil.

Renvoie
`boolean`	`true` si le Wi-Fi a été activé

Génère
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

Méthode d'assistance pour extraire l'APK de l'utilitaire Wi-Fi du classpath

Renvoie
`File`

Génère
`IOException`

getBSSID

public String getBSSID ()

Récupère l'identifiant de l'ensemble de services de base (BSSID) du point d'accès actuel.

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Obtient l'adresse IP associée à l'interface Wi-Fi. Renvoie null en cas d'échec de la récupération de l'adresse IP.

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getSSID

public String getSSID ()

Récupère l'identifiant du jeu de services du réseau actuellement connecté.

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getWifiInfo

public Map<String, String> getWifiInfo ()

Obtient les informations actuelles sur la connexion Wi-Fi.

Cela inclut le SSID, le BSSID, l'adresse IP, la vitesse de connexion et le RSSI.

Renvoie
`Map<String, String>`	une carte contenant des informations sur la connexion Wi-Fi.

Génère
`DeviceNotAvailableException`

hasValidIp

public boolean hasValidIp ()

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Vérifiez si le Wi-Fi est actuellement activé.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

removeAllNetworks

public boolean removeAllNetworks ()

Supprime tous les réseaux connus.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

Démarre la surveillance de la connectivité réseau.

Paramètres
`interval`	`long` : intervalle entre les vérifications de la connectivité.
`urlToCheck`	`String` : URL permettant de vérifier la connectivité.

Renvoie
`boolean`	`true` si l'opération a réussi.

Génère
`DeviceNotAvailableException`

stopMonitor

public List<Long> stopMonitor ()

Arrête la surveillance de la connectivité réseau.

Cela renvoie également l'historique de latence depuis le dernier appel IWifiHelper.startMonitor(long,String).

Renvoie
`List<Long>`	l'historique de latence.

Génère
`DeviceNotAvailableException`

waitForIp

public boolean waitForIp (long timeout)

Attendez qu'une adresse IP soit attribuée à l'adaptateur Wi-Fi.

Paramètres
`timeout`	`long` : durée d'attente

Renvoie
`boolean`	`true` si une adresse IP est attribuée avant le délai d'expiration, `false` sinon.

Génère
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

Attendez que isWifiEnabled() soit défini sur "false".

Paramètres
`timeout`	`long` : temps d'attente en ms

Renvoie
`boolean`	`true` si le Wi-Fi a été désactivé avant le délai d'inactivité, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled ()

Attendez que isWifiEnabled() soit défini sur "false" avec un délai avant expiration par défaut.

Renvoie
`boolean`	`true` si le Wi-Fi a été désactivé avant le délai d'inactivité, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

Attendez que isWifiEnabled() soit défini sur "true".

Paramètres
`timeout`	`long` : temps d'attente en ms

Renvoie
`boolean`	`true` si le Wi-Fi était activé avant le délai d'inactivité, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled ()

Attendez que isWifiEnabled() soit défini sur "true" avec un délai d'attente par défaut.

Renvoie
`boolean`	`true` si le Wi-Fi était activé avant le délai d'inactivité, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

Attend qu'un des états Wi-Fi attendus se produise.

Paramètres
`expectedStates`	`WifiState` : un ou plusieurs états Wi-Fi attendus

Renvoie
`boolean`	`true` si l'un des états attendus s'est produit. `false` si aucun des états ne s'est produit avant l'expiration du délai

Génère
`DeviceNotAvailableException`