Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an 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

Hilfsklasse zum Bearbeiten von WLAN-Diensten auf dem Gerät.

Zusammenfassung

Konstanten
`String`	`INSTRUMENTATION_PKG`

Öffentliche Konstruktoren
`WifiHelper(ITestDevice device)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup)` Alternativer Konstruktor, mit dem die Einrichtung der WLAN-APK übersprungen werden kann.
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` Konstruktor, um anzugeben, ob der neue WLAN-Helfer v2 verwendet werden soll.

Öffentliche Methoden
`boolean`	`addOpenNetwork(String ssid)` Fügt das offene Sicherheitsnetzwerk hinzu, das durch „ssid“ identifiziert wird.
`boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Fügt das offene Sicherheitsnetzwerk hinzu, das durch „ssid“ identifiziert wird.
`boolean`	`addWpaPskNetwork(String ssid, String psk)` Fügt das durch „ssid“ identifizierte WPA-PSK-Sicherheitsnetzwerk hinzu.
`boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Fügt das durch „ssid“ identifizierte WPA-PSK-Sicherheitsnetzwerk hinzu.
`boolean`	`checkConnectivity(String urlToCheck)` Prüft die Verbindung, indem eine HTTP-Anfrage an die angegebene URL gesendet wird.
`void`	`cleanUp()` Bereinigen Sie die Ressourcen und die Installation des WLAN-Helfer-Pakets.
`boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.
`boolean`	`disableWifi()` Deaktiviert den WLAN-Status auf dem Gerät.
`boolean`	`disconnectFromNetwork()` Trennen Sie die Verbindung zum aktuellen WLAN und deaktivieren Sie WLAN.
`boolean`	`enableWifi()` Aktiviert den WLAN-Status auf dem Gerät.
`static File`	`extractWifiUtilApk()` Hilfsmethode zum Extrahieren der WLAN-Utility-APK aus dem Klassenpfad
`String`	`getBSSID()` Ruft die BSSID (Basic Service Set Identifier) des aktuellen Zugangspunkts ab.
`String`	`getIpAddress()` Ruft die IP-Adresse ab, die mit der WLAN-Schnittstelle verknüpft ist.
`String`	`getSSID()` Ruft den Service Set Identifier des aktuell verbundenen Netzwerks ab.
`Map<String, String>`	`getWifiInfo()` Ruft die aktuellen WLAN-Verbindungsinformationen ab.
`boolean`	`hasValidIp()`
`boolean`	`isWifiEnabled()` Prüfe, ob WLAN derzeit aktiviert ist.
`boolean`	`removeAllNetworks()` Entfernt alle bekannten Netzwerke.
`boolean`	`startMonitor(long interval, String urlToCheck)` Startet die Überwachung der Netzwerkverbindung.
`List<Long>`	`stopMonitor()` Beendet die Überwachung der Netzwerkverbindung.
`boolean`	`waitForIp(long timeout)` Warten Sie, bis dem WLAN-Adapter eine IP-Adresse zugewiesen wurde.
`boolean`	`waitForWifiDisabled(long timeout)` Warten Sie, bis `isWifiEnabled()` „false“ ist.
`boolean`	`waitForWifiDisabled()` Warten Sie, bis `isWifiEnabled()` mit einem Standard-Timeout „false“ ist.
`boolean`	`waitForWifiEnabled(long timeout)` Warten Sie, bis `isWifiEnabled()` „true“ ist.
`boolean`	`waitForWifiEnabled()` Wartet mit einem Standard-Timeout, bis `isWifiEnabled()` „true“ ist.
`boolean`	`waitForWifiState(WifiState... expectedStates)` Wartet, bis einer der erwarteten WLAN-Status eintritt.

Konstanten

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

Konstanter Wert: "com.android.tradefed.utils.wifi"

Öffentliche Konstruktoren

WifiHelper

public WifiHelper (ITestDevice device)

Parameter
`device`	`ITestDevice`

Löst aus
`DeviceNotAvailableException`

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

Parameter
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`

Löst aus
`DeviceNotAvailableException`

WifiHelper

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

Alternativer Konstruktor, mit dem die Einrichtung der WLAN-APK übersprungen werden kann.

Parameter
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`

Löst aus
`DeviceNotAvailableException`

WifiHelper

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

Konstruktor, um anzugeben, ob der neue WLAN-Helfer v2 verwendet werden soll. Für v2-Vorgänge muss die WLAN-APK nicht installiert werden.

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

Löst aus
`DeviceNotAvailableException`

Öffentliche Methoden

addOpenNetwork

public boolean addOpenNetwork (String ssid)

Fügt das offene Sicherheitsnetzwerk hinzu, das durch „ssid“ identifiziert wird.

Um eine Verbindung zu einem WLAN herzustellen, muss zuerst ein Netzwerkprofil in der wpa_supplicant-Konfiguration erstellt werden. Dadurch wird „wpa_cli“ aufgerufen, um das offene Sicherheitsnetzwerk hinzuzufügen, das durch „ssid“ identifiziert wird.

Parameter
`ssid`	`String`: Die SSID des hinzuzufügenden Netzwerks.

Gibt Folgendes zurück:
`boolean`	`true`, wenn das Netzwerk hinzugefügt wurde, andernfalls `false`.

Löst aus
`DeviceNotAvailableException`

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Fügt das offene Sicherheitsnetzwerk hinzu, das durch „ssid“ identifiziert wird.

Parameter
`ssid`	`String`: Die SSID des hinzuzufügenden Netzwerks.
`scanSsid`	`boolean`: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.

Gibt Folgendes zurück:
`boolean`	`true`, wenn das Netzwerk hinzugefügt wurde, andernfalls `false`.

Löst aus
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

Fügt das durch „ssid“ identifizierte WPA-PSK-Sicherheitsnetzwerk hinzu.

Parameter
`ssid`	`String`: Die SSID des hinzuzufügenden Netzwerks.
`psk`	`String`: die zu verwendende WPA-PSK-Passphrase

Gibt Folgendes zurück:
`boolean`	`true`, wenn das Netzwerk hinzugefügt wurde, andernfalls `false`.

Löst aus
`DeviceNotAvailableException`

addWpaPskNetwork

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

Fügt das durch „ssid“ identifizierte WPA-PSK-Sicherheitsnetzwerk hinzu.

Parameter
`ssid`	`String`: Die SSID des hinzuzufügenden Netzwerks.
`psk`	`String`: die zu verwendende WPA-PSK-Passphrase
`scanSsid`	`boolean`: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.

Gibt Folgendes zurück:
`boolean`	`true`, wenn das Netzwerk hinzugefügt wurde, andernfalls `false`.

Löst aus
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

Prüft die Verbindung, indem eine HTTP-Anfrage an die angegebene URL gesendet wird.

Parameter
`urlToCheck`	`String`: Eine Ziel-URL für eine HTTP-Anfrageprüfung

Gibt Folgendes zurück:
`boolean`	`true`, wenn das Gerät den Konnektivitätstest besteht.

Löst aus
`DeviceNotAvailableException`

cleanUp

public void cleanUp ()

Bereinigen Sie die Ressourcen und die Installation des WLAN-Helfer-Pakets. Diese Methode sollte nur aufgerufen werden, wenn WLAN für den Aufruf nicht mehr benötigt wird, da das Gerät die WLAN-Verbindung verliert, wenn der Helfer deinstalliert wird.

Löst aus
`DeviceNotAvailableException`

connectToNetwork

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

Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.

Parameter
`ssid`	`String`: Die SSID des Netzwerks, mit dem eine Verbindung hergestellt werden soll.
`psk`	`String`: die zu verwendende WPA-PSK-Passphrase. Kann null sein.
`urlToCheck`	`String`: Eine Ziel-URL für eine HTTP-Anfrageprüfung

Gibt Folgendes zurück:
`boolean`	`true`, wenn das Gerät den Konnektivitätstest besteht.

Löst aus
`DeviceNotAvailableException`

connectToNetwork

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

Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.

Parameter
`ssid`	`String`: Die SSID des Netzwerks, mit dem eine Verbindung hergestellt werden soll.
`psk`	`String`: die zu verwendende WPA-PSK-Passphrase. Kann null sein.
`urlToCheck`	`String`: Eine Ziel-URL für eine HTTP-Anfrageprüfung
`scanSsid`	`boolean`: Gibt an, ob für dieses Netzwerk nach einer verborgenen SSID gesucht werden soll.
`defaultType`	`String`: Standardnetzwerktyp, auf den zurückgegriffen werden soll, wenn der Netzwerktyp der SSID nicht ermittelt werden kann

Gibt Folgendes zurück:
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult, das das WLAN-Verbindungsergebnis darstellt

Löst aus
`DeviceNotAvailableException`

connectToNetwork

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

Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.

Parameter
`ssid`	`String`: Die SSID des Netzwerks, mit dem eine Verbindung hergestellt werden soll.
`psk`	`String`: die zu verwendende WPA-PSK-Passphrase. Kann null sein.
`urlToCheck`	`String`: Eine Ziel-URL für eine HTTP-Anfrageprüfung
`scanSsid`	`boolean`: Gibt an, ob für dieses Netzwerk nach einer verborgenen SSID gesucht werden soll.

Gibt Folgendes zurück:
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult, das das WLAN-Verbindungsergebnis darstellt

Löst aus
`DeviceNotAvailableException`

disableWifi

public boolean disableWifi ()

Deaktiviert den WLAN-Status auf dem Gerät.

Gibt Folgendes zurück:
`boolean`	`true`, wenn WLAN deaktiviert wurde

Löst aus
`DeviceNotAvailableException`

disconnectFromNetwork

public boolean disconnectFromNetwork ()

Trennen Sie die Verbindung zum aktuellen WLAN und deaktivieren Sie WLAN.

Gibt Folgendes zurück:
`boolean`	`true`, wenn der Vorgang erfolgreich war.

Löst aus
`DeviceNotAvailableException`

enableWifi

public boolean enableWifi ()

Aktiviert den WLAN-Status auf dem Gerät.

Gibt Folgendes zurück:
`boolean`	`true`, wenn WLAN aktiviert wurde

Löst aus
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

Hilfsmethode zum Extrahieren der WLAN-Utility-APK aus dem Klassenpfad

Gibt Folgendes zurück:
`File`

Löst aus
`IOException`

getBSSID

public String getBSSID ()

Ruft die BSSID (Basic Service Set Identifier) des aktuellen Zugangspunkts ab.

Gibt Folgendes zurück:
`String`

Löst aus
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Ruft die IP-Adresse ab, die mit der WLAN-Schnittstelle verknüpft ist. Gibt null zurück, wenn beim Abrufen der IP-Adresse ein Fehler aufgetreten ist.

Gibt Folgendes zurück:
`String`

Löst aus
`DeviceNotAvailableException`

getSSID

public String getSSID ()

Ruft den Service Set Identifier des aktuell verbundenen Netzwerks ab.

Gibt Folgendes zurück:
`String`

Löst aus
`DeviceNotAvailableException`

getWifiInfo

public Map<String, String> getWifiInfo ()

Ruft die aktuellen WLAN-Verbindungsinformationen ab.

Dazu gehören SSID, BSSID, IP-Adresse, Verbindungsgeschwindigkeit und RSSI.

Gibt Folgendes zurück:
`Map<String, String>`	Eine Karte mit Informationen zur WLAN-Verbindung.

Löst aus
`DeviceNotAvailableException`

hasValidIp

public boolean hasValidIp ()

Gibt Folgendes zurück:
`boolean`

Löst aus
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Prüfe, ob WLAN derzeit aktiviert ist.

Gibt Folgendes zurück:
`boolean`

Löst aus
`DeviceNotAvailableException`

removeAllNetworks

public boolean removeAllNetworks ()

Entfernt alle bekannten Netzwerke.

Gibt Folgendes zurück:
`boolean`

Löst aus
`DeviceNotAvailableException`

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

Startet die Überwachung der Netzwerkverbindung.

Parameter
`interval`	`long`: Intervall zwischen Konnektivitätsprüfungen.
`urlToCheck`	`String`: Eine URL, mit der die Verbindung geprüft werden soll.

Gibt Folgendes zurück:
`boolean`	`true`, wenn der Vorgang erfolgreich war.

Löst aus
`DeviceNotAvailableException`

stopMonitor

public List<Long> stopMonitor ()

Beendet die Überwachung der Netzwerkverbindung.

Außerdem wird der Latenzverlauf seit dem letzten IWifiHelper.startMonitor(long,String)-Aufruf zurückgegeben.

Gibt Folgendes zurück:
`List<Long>`	den Latenzverlauf.

Löst aus
`DeviceNotAvailableException`

waitForIp

public boolean waitForIp (long timeout)

Warten Sie, bis dem WLAN-Adapter eine IP-Adresse zugewiesen wurde.

Parameter
`timeout`	`long`: Wartezeit

Gibt Folgendes zurück:
`boolean`	`true`, wenn eine IP-Adresse vor dem Zeitlimit zugewiesen wird, andernfalls `false`

Löst aus
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

Warten Sie, bis isWifiEnabled() „false“ ist.

Parameter
`timeout`	`long`: Zeit in Millisekunden, die gewartet werden soll

Gibt Folgendes zurück:
`boolean`	`true`, wenn WLAN vor dem Zeitlimit deaktiviert wurde, andernfalls `false`.

Löst aus
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled ()

Warten Sie, bis isWifiEnabled() mit einem Standard-Timeout „false“ ist.

Gibt Folgendes zurück:
`boolean`	`true`, wenn WLAN vor dem Zeitlimit deaktiviert wurde, andernfalls `false`.

Löst aus
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

Warten Sie, bis isWifiEnabled() „true“ ist.

Parameter
`timeout`	`long`: Zeit in Millisekunden, die gewartet werden soll

Gibt Folgendes zurück:
`boolean`	`true`, wenn WLAN vor dem Zeitlimit aktiviert wurde, andernfalls `false`.

Löst aus
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled ()

Wartet mit einem Standard-Timeout, bis isWifiEnabled() „true“ ist.

Gibt Folgendes zurück:
`boolean`	`true`, wenn WLAN vor dem Zeitlimit aktiviert wurde, andernfalls `false`.

Löst aus
`DeviceNotAvailableException`

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

Wartet, bis einer der erwarteten WLAN-Status eintritt.

Parameter
`expectedStates`	`WifiState`: ein oder mehrere zu erwartende WLAN-Status

Gibt Folgendes zurück:
`boolean`	`true`, wenn einer der erwarteten Zustände eingetreten ist. `false`, wenn keiner der Zustände vor dem Erreichen des Zeitlimits eingetreten ist

Löst aus
`DeviceNotAvailableException`