A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad 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 helper per la manipolazione dei servizi Wi-Fi sul dispositivo.

Riepilogo

Costanti
`String`	`INSTRUMENTATION_PKG`

Costruttori pubblici
`WifiHelper(ITestDevice device)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup)` Costruttore alternativo che può saltare la configurazione dell'APK Wi-Fi.
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` Costruttore per specificare se utilizzare il nuovo helper Wi-Fi v2.

Metodi pubblici
`boolean`	`addOpenNetwork(String ssid)` Aggiunge la rete di sicurezza aperta identificata da ssid.
`boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Aggiunge la rete di sicurezza aperta identificata da ssid.
`boolean`	`addWpaPskNetwork(String ssid, String psk)` Aggiunge la rete di sicurezza WPA-PSK identificata da ssid.
`boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Aggiunge la rete di sicurezza WPA-PSK identificata da ssid.
`boolean`	`checkConnectivity(String urlToCheck)` Controlla la connettività inviando una richiesta HTTP all'URL specificato.
`void`	`cleanUp()` Libera spazio dalle risorse e dall'installazione del pacchetto helper Wi-Fi.
`boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` Si connette a una rete Wi-Fi e verifica la connettività.
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` Si connette a una rete Wi-Fi e verifica la connettività.
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` Si connette a una rete Wi-Fi e verifica la connettività.
`boolean`	`disableWifi()` Disattiva lo stato del Wi-Fi sul dispositivo.
`boolean`	`disconnectFromNetwork()` Disconnettiti dalla rete Wi-Fi corrente e disattiva il Wi-Fi.
`boolean`	`enableWifi()` Attiva lo stato del Wi-Fi sul dispositivo.
`static File`	`extractWifiUtilApk()` Metodo helper per estrarre l'APK dell'utilità Wi-Fi dal classpath
`String`	`getBSSID()` Recupera il Basic Service Set Identifier (BSSID) del punto di accesso attuale.
`String`	`getIpAddress()` Ottiene l'indirizzo IP associato all'interfaccia Wi-Fi.
`String`	`getSSID()` Recupera il Service Set Identifier della rete attualmente connessa.
`Map<String, String>`	`getWifiInfo()` Recupera le informazioni sulla connessione Wi-Fi attuale.
`boolean`	`hasValidIp()`
`boolean`	`isWifiEnabled()` Controlla se il Wi-Fi è attualmente attivo.
`boolean`	`removeAllNetworks()` Rimuove tutte le reti conosciute.
`boolean`	`startMonitor(long interval, String urlToCheck)` Avvia il monitoraggio della connettività di rete.
`List<Long>`	`stopMonitor()` Interrompe il monitoraggio della connettività di rete.
`boolean`	`waitForIp(long timeout)` Attendi che venga assegnato un indirizzo IP alla scheda Wi-Fi.
`boolean`	`waitForWifiDisabled(long timeout)` Attendi che `isWifiEnabled()` sia false.
`boolean`	`waitForWifiDisabled()` Attendi che `isWifiEnabled()` sia false con un timeout predefinito.
`boolean`	`waitForWifiEnabled(long timeout)` Attendi che `isWifiEnabled()` sia true.
`boolean`	`waitForWifiEnabled()` Attendi che `isWifiEnabled()` sia true con un timeout predefinito.
`boolean`	`waitForWifiState(WifiState... expectedStates)` Attende che si verifichi uno degli stati Wi-Fi previsti.

Costanti

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

Valore costante: "com.android.tradefed.utils.wifi"

Costruttori pubblici

WifiHelper

public WifiHelper (ITestDevice device)

Parametri
`device`	`ITestDevice`

Genera
`DeviceNotAvailableException`

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

Parametri
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`

Genera
`DeviceNotAvailableException`

WifiHelper

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

Costruttore alternativo che può saltare la configurazione dell'APK Wi-Fi.

Parametri
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`

Genera
`DeviceNotAvailableException`

WifiHelper

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

Costruttore per specificare se utilizzare il nuovo helper Wi-Fi v2. Le operazioni v2 non richiedono l'installazione dell'APK dell'utilità Wi-Fi.

Parametri
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`
`useV2`	`boolean`

Genera
`DeviceNotAvailableException`

Metodi pubblici

addOpenNetwork

public boolean addOpenNetwork (String ssid)

Aggiunge la rete di sicurezza aperta identificata da ssid.

Per connettersi a qualsiasi rete Wi-Fi, è necessario prima creare un profilo di rete nella configurazione di wpa_supplicant. Verrà chiamato wpa_cli per aggiungere la rete con sicurezza aperta identificata da ssid.

Parametri
`ssid`	`String`: l'SSID della rete da aggiungere.

Resi
`boolean`	`true` se la rete è stata aggiunta, `false` in caso contrario.

Genera
`DeviceNotAvailableException`

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Aggiunge la rete di sicurezza aperta identificata da ssid.

Parametri
`ssid`	`String`: l'SSID della rete da aggiungere.
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete.

Resi
`boolean`	`true` se la rete è stata aggiunta, `false` in caso contrario.

Genera
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

Aggiunge la rete di sicurezza WPA-PSK identificata da ssid.

Parametri
`ssid`	`String`: l'SSID della rete da aggiungere.
`psk`	`String`: la passphrase WPA-PSK da utilizzare

Resi
`boolean`	`true` se la rete è stata aggiunta, `false` in caso contrario.

Genera
`DeviceNotAvailableException`

addWpaPskNetwork

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

Aggiunge la rete di sicurezza WPA-PSK identificata da ssid.

Parametri
`ssid`	`String`: l'SSID della rete da aggiungere.
`psk`	`String`: la passphrase WPA-PSK da utilizzare
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete.

Resi
`boolean`	`true` se la rete è stata aggiunta, `false` in caso contrario.

Genera
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

Controlla la connettività inviando una richiesta HTTP all'URL specificato.

Parametri
`urlToCheck`	`String`: un URL di destinazione per un controllo della richiesta HTTP

Resi
`boolean`	`true` se il dispositivo supera il controllo della connettività.

Genera
`DeviceNotAvailableException`

cleanUp

public void cleanUp ()

Libera spazio dalle risorse e dall'installazione del pacchetto helper Wi-Fi. Questo metodo deve essere chiamato solo quando il Wi-Fi non è più necessario per la chiamata, poiché il dispositivo perderebbe la connessione Wi-Fi quando l'helper viene disinstallato.

Genera
`DeviceNotAvailableException`

connectToNetwork

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

Si connette a una rete Wi-Fi e verifica la connettività.

Parametri
`ssid`	`String`: l'SSID della rete a cui connettersi
`psk`	`String`: la passphrase WPA-PSK da utilizzare. Questo campo può essere nullo.
`urlToCheck`	`String`: un URL di destinazione per un controllo della richiesta HTTP

Resi
`boolean`	`true` se il dispositivo supera il controllo della connettività.

Genera
`DeviceNotAvailableException`

connectToNetwork

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

Si connette a una rete Wi-Fi e verifica la connettività.

Parametri
`ssid`	`String`: l'SSID della rete a cui connettersi
`psk`	`String`: la passphrase WPA-PSK da utilizzare. Questo campo può essere nullo.
`urlToCheck`	`String`: un URL di destinazione per un controllo della richiesta HTTP
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete
`defaultType`	`String`: Tipo di rete predefinito a cui eseguire il fallback se il tipo di rete dell'SSID non è determinato

Resi
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult che rappresenta il risultato della connessione Wi-Fi

Genera
`DeviceNotAvailableException`

connectToNetwork

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

Si connette a una rete Wi-Fi e verifica la connettività.

Parametri
`ssid`	`String`: l'SSID della rete a cui connettersi
`psk`	`String`: la passphrase WPA-PSK da utilizzare. Questo campo può essere nullo.
`urlToCheck`	`String`: un URL di destinazione per un controllo della richiesta HTTP
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete

Resi
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult che rappresenta il risultato della connessione Wi-Fi

Genera
`DeviceNotAvailableException`

disableWifi

public boolean disableWifi ()

Disattiva lo stato del Wi-Fi sul dispositivo.

Resi
`boolean`	`true` se il Wi-Fi è stato disattivato

Genera
`DeviceNotAvailableException`

disconnectFromNetwork

public boolean disconnectFromNetwork ()

Disconnettiti dalla rete Wi-Fi corrente e disattiva il Wi-Fi.

Resi
`boolean`	`true` se l'operazione è riuscita.

Genera
`DeviceNotAvailableException`

enableWifi

public boolean enableWifi ()

Attiva lo stato del Wi-Fi sul dispositivo.

Resi
`boolean`	`true` se il Wi-Fi è stato attivato correttamente

Genera
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

Metodo helper per estrarre l'APK dell'utilità Wi-Fi dal classpath

Resi
`File`

Genera
`IOException`

getBSSID

public String getBSSID ()

Recupera il Basic Service Set Identifier (BSSID) del punto di accesso attuale.

Resi
`String`

Genera
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Ottiene l'indirizzo IP associato all'interfaccia Wi-Fi. Restituisce null se si è verificato un errore durante il recupero dell'indirizzo IP.

Resi
`String`

Genera
`DeviceNotAvailableException`

getSSID

public String getSSID ()

Recupera il Service Set Identifier della rete attualmente connessa.

Resi
`String`

Genera
`DeviceNotAvailableException`

getWifiInfo

public Map<String, String> getWifiInfo ()

Recupera le informazioni sulla connessione Wi-Fi attuale.

Sono inclusi SSID, BSSID, indirizzo IP, velocità del collegamento e RSSI.

Resi
`Map<String, String>`	una mappa contenente informazioni sulla connessione Wi-Fi.

Genera
`DeviceNotAvailableException`

hasValidIp

public boolean hasValidIp ()

Resi
`boolean`

Genera
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Controlla se il Wi-Fi è attualmente attivo.

Resi
`boolean`

Genera
`DeviceNotAvailableException`

removeAllNetworks

public boolean removeAllNetworks ()

Rimuove tutte le reti conosciute.

Resi
`boolean`

Genera
`DeviceNotAvailableException`

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

Avvia il monitoraggio della connettività di rete.

Parametri
`interval`	`long`: intervallo tra i controlli di connettività.
`urlToCheck`	`String`: un URL per verificare la connettività.

Resi
`boolean`	`true` se l'operazione è riuscita.

Genera
`DeviceNotAvailableException`

stopMonitor

public List<Long> stopMonitor ()

Interrompe il monitoraggio della connettività di rete.

Restituisce anche la cronologia della latenza dall'ultima chiamata IWifiHelper.startMonitor(long,String).

Resi
`List<Long>`	la cronologia della latenza.

Genera
`DeviceNotAvailableException`

waitForIp

public boolean waitForIp (long timeout)

Attendi che venga assegnato un indirizzo IP alla scheda Wi-Fi.

Parametri
`timeout`	`long`: tempo di attesa

Resi
`boolean`	`true` se viene assegnato un indirizzo IP prima del timeout, `false` altrimenti

Genera
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

Attendi che isWifiEnabled() sia false.

Parametri
`timeout`	`long`: tempo di attesa in ms

Resi
`boolean`	`true` se il Wi-Fi è stato disattivato prima del timeout, `false` altrimenti.

Genera
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled ()

Attendi che isWifiEnabled() sia false con un timeout predefinito.

Resi
`boolean`	`true` se il Wi-Fi è stato disattivato prima del timeout, `false` altrimenti.

Genera
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

Attendi che isWifiEnabled() sia true.

Parametri
`timeout`	`long`: tempo di attesa in ms

Resi
`boolean`	`true` se il Wi-Fi è stato attivato prima del timeout, `false` in caso contrario.

Genera
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled ()

Attendi che isWifiEnabled() sia true con un timeout predefinito.

Resi
`boolean`	`true` se il Wi-Fi è stato attivato prima del timeout, `false` in caso contrario.

Genera
`DeviceNotAvailableException`

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

Attende che si verifichi uno degli stati Wi-Fi previsti.

Parametri
`expectedStates`	`WifiState`: uno o più stati del Wi-Fi da prevedere

Resi
`boolean`	`true` se si è verificato uno degli stati previsti. `false` se nessuno degli stati si è verificato prima del raggiungimento del timeout

Genera
`DeviceNotAvailableException`