WifiHelper

public class WifiHelper
extends Object implements IWifiHelper

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

Klasa pomocnicza do manipulowania usługami Wi-Fi na urządzeniu.

Podsumowanie

Stałe

String INSTRUMENTATION_PKG

Konstruktory publiczne

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

Alternatywny konstruktor, który może pominąć konfigurację pakietu APK Wi-Fi.

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

Konstruktor określający, czy używać nowego narzędzia Wi-Fi w wersji 2.

Metody publiczne

boolean addOpenNetwork(String ssid)

Dodaje otwartą sieć zabezpieczeń zidentyfikowaną przez identyfikator SSID.

boolean addOpenNetwork(String ssid, boolean scanSsid)

Dodaje otwartą sieć zabezpieczeń zidentyfikowaną przez identyfikator SSID.

boolean addWpaPskNetwork(String ssid, String psk)

Dodaje sieć zabezpieczoną WPA-PSK z identyfikatorem ssid.

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

Dodaje sieć zabezpieczoną WPA-PSK z identyfikatorem ssid.

boolean checkConnectivity(String urlToCheck)

Sprawdza połączenie, wysyłając żądanie HTTP na podany adres URL.

void cleanUp()

Zwolnij miejsce zajmowane przez zasoby i zainstalowany pakiet modułu pomocniczego Wi-Fi.

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

Łączy się z siecią Wi-Fi i sprawdza połączenie.

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

Łączy się z siecią Wi-Fi i sprawdza połączenie.

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

Łączy się z siecią Wi-Fi i sprawdza połączenie.

boolean disableWifi()

Wyłącza stan Wi-Fi na urządzeniu.

boolean disconnectFromNetwork()

Odłącz się od bieżącej sieci Wi-Fi i wyłącz Wi-Fi.

boolean enableWifi()

Włącza stan Wi-Fi na urządzeniu.

static File extractWifiUtilApk()

Metoda pomocnicza do wyodrębniania pliku APK narzędzia Wi-Fi ze ścieżki klasy

String getBSSID()

Pobiera identyfikator BSSID bieżącego punktu dostępu.

String getIpAddress()

Pobiera adres IP powiązany z interfejsem Wi-Fi.

String getSSID()

Pobiera identyfikator zestawu usług aktualnie połączonej sieci.

Map<String, String> getWifiInfo()

Pobiera informacje o bieżącym połączeniu Wi-Fi.

boolean hasValidIp()

boolean isWifiEnabled()

Sprawdź, czy Wi-Fi jest obecnie włączone.

boolean removeAllNetworks()

Usuwa wszystkie znane sieci.

boolean startMonitor(long interval, String urlToCheck)

Rozpoczyna monitorowanie połączeń sieciowych.

List<Long> stopMonitor()

Zatrzymuje monitorowanie połączenia sieciowego.

boolean waitForIp(long timeout)

Poczekaj, aż do karty sieciowej Wi-Fi zostanie przypisany adres IP.

boolean waitForWifiDisabled(long timeout)

Zaczekaj, aż isWifiEnabled() będzie mieć wartość false.

boolean waitForWifiDisabled()

Poczekaj, aż isWifiEnabled() przyjmie wartość false, z domyślnym czasem oczekiwania.

boolean waitForWifiEnabled(long timeout)

Zaczekaj, aż isWifiEnabled() będzie mieć wartość „prawda”.

boolean waitForWifiEnabled()

Poczekaj, aż isWifiEnabled() przyjmie wartość „true” (prawda), z domyślnym czasem oczekiwania.

boolean waitForWifiState(WifiState... expectedStates)

Czeka na wystąpienie jednego z oczekiwanych stanów Wi-Fi.

Stałe

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

Wartość stała: "com.android.tradefed.utils.wifi"

Konstruktory publiczne

WifiHelper

public WifiHelper (ITestDevice device)

Parametry
device ITestDevice

Zgłasza
DeviceNotAvailableException

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

Parametry
device ITestDevice

wifiUtilApkPath String

Zgłasza
DeviceNotAvailableException

WifiHelper

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

Alternatywny konstruktor, który może pominąć konfigurację pakietu APK Wi-Fi.

Parametry
device ITestDevice

wifiUtilApkPath String

doSetup boolean

Zgłasza
DeviceNotAvailableException

WifiHelper

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

Konstruktor określający, czy ma być używana nowa wersja 2 narzędzia do obsługi Wi-Fi. Operacje w wersji 2 nie wymagają instalowania pliku APK narzędzia do obsługi Wi-Fi.

Parametry
device ITestDevice

wifiUtilApkPath String

doSetup boolean

useV2 boolean

Zgłasza
DeviceNotAvailableException

Metody publiczne

addOpenNetwork

public boolean addOpenNetwork (String ssid)

Dodaje otwartą sieć zabezpieczeń zidentyfikowaną przez identyfikator SSID.

Aby połączyć się z dowolną siecią Wi-Fi, musisz najpierw utworzyć profil sieci w konfiguracji wpa_supplicant. Spowoduje to wywołanie wpa_cli w celu dodania otwartej sieci zabezpieczonej zidentyfikowanej przez ssid.

Parametry
ssid String: identyfikator SSID sieci do dodania.
Zwraca
boolean true, jeśli sieć została dodana, w przeciwnym razie false.
Zgłasza
DeviceNotAvailableException

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Dodaje otwartą sieć zabezpieczeń zidentyfikowaną przez identyfikator SSID.

Aby połączyć się z dowolną siecią Wi-Fi, musisz najpierw utworzyć profil sieci w konfiguracji wpa_supplicant. Spowoduje to wywołanie wpa_cli w celu dodania otwartej sieci zabezpieczonej zidentyfikowanej przez ssid.

Parametry
ssid String: identyfikator SSID sieci do dodania.
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
Zwraca
boolean true, jeśli sieć została dodana, w przeciwnym razie false.
Zgłasza
DeviceNotAvailableException

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

Dodaje sieć zabezpieczoną WPA-PSK z identyfikatorem ssid.

Parametry
ssid String: identyfikator SSID sieci do dodania.
psk String: hasło WPA-PSK do użycia;
Zwraca
boolean true, jeśli sieć została dodana, w przeciwnym razie false.
Zgłasza
DeviceNotAvailableException

addWpaPskNetwork

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

Dodaje sieć zabezpieczoną WPA-PSK z identyfikatorem ssid.

Parametry
ssid String: identyfikator SSID sieci do dodania.
psk String: hasło WPA-PSK do użycia;
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
Zwraca
boolean true, jeśli sieć została dodana, w przeciwnym razie false.
Zgłasza
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

Sprawdza połączenie, wysyłając żądanie HTTP na podany adres URL.

Parametry
urlToCheck String: docelowy adres URL do sprawdzenia żądania HTTP.
Zwraca
boolean true czy urządzenie przeszło test połączenia.
Zgłasza
DeviceNotAvailableException

cleanUp

public void cleanUp ()

Zwolnij miejsce zajmowane przez zasoby i zainstalowany pakiet modułu pomocniczego Wi-Fi. Tę funkcję należy wywoływać tylko wtedy, gdy Wi-Fi nie jest już potrzebne do wywołania, ponieważ urządzenie utraci połączenie Wi-Fi po odinstalowaniu pomocnika.

Zgłasza
DeviceNotAvailableException

connectToNetwork

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

Łączy się z siecią Wi-Fi i sprawdza połączenie.

Parametry
ssid String: identyfikator SSID sieci, z którą chcesz się połączyć
psk String: hasło WPA-PSK do użycia. Może mieć wartość null.
urlToCheck String: docelowy adres URL do sprawdzenia żądania HTTP.
Zwraca
boolean true czy urządzenie przeszło test połączenia.
Zgłasza
DeviceNotAvailableException

connectToNetwork

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

Łączy się z siecią Wi-Fi i sprawdza połączenie.

Parametry
ssid String: identyfikator SSID sieci, z którą chcesz się połączyć
psk String: hasło WPA-PSK do użycia. Może mieć wartość null.
urlToCheck String: docelowy adres URL do sprawdzenia żądania HTTP.
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
defaultType String: Domyślny typ sieci, do którego można wrócić, jeśli typ sieci SSID nie jest określony
Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult reprezentujący wynik połączenia Wi-Fi
Zgłasza
DeviceNotAvailableException

connectToNetwork

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

Łączy się z siecią Wi-Fi i sprawdza połączenie.

Parametry
ssid String: identyfikator SSID sieci, z którą chcesz się połączyć
psk String: hasło WPA-PSK do użycia. Może mieć wartość null.
urlToCheck String: docelowy adres URL do sprawdzenia żądania HTTP.
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult reprezentujący wynik połączenia Wi-Fi
Zgłasza
DeviceNotAvailableException

disableWifi

public boolean disableWifi ()

Wyłącza stan Wi-Fi na urządzeniu.

Zwraca
boolean true, jeśli Wi-Fi zostało wyłączone
Zgłasza
DeviceNotAvailableException

disconnectFromNetwork

public boolean disconnectFromNetwork ()

Odłącz się od bieżącej sieci Wi-Fi i wyłącz Wi-Fi.

Zwraca
boolean true, jeśli operacja się powiodła.
Zgłasza
DeviceNotAvailableException

enableWifi

public boolean enableWifi ()

Włącza stan Wi-Fi na urządzeniu.

Zwraca
boolean true, jeśli Wi-Fi zostało włączone
Zgłasza
DeviceNotAvailableException

extractWifiUtilApk

public static File extractWifiUtilApk ()

Metoda pomocnicza do wyodrębniania pliku APK narzędzia Wi-Fi ze ścieżki klasy

Zwraca
File

Zgłasza
IOException

getBSSID

public String getBSSID ()

Pobiera identyfikator BSSID bieżącego punktu dostępu.

Zwraca
String

Zgłasza
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

Pobiera adres IP powiązany z interfejsem Wi-Fi. Zwraca null, jeśli nie udało się pobrać adresu IP.

Zwraca
String

Zgłasza
DeviceNotAvailableException

getSSID

public String getSSID ()

Pobiera identyfikator zestawu usług aktualnie połączonej sieci.

Zwraca
String

Zgłasza
DeviceNotAvailableException

getWifiInfo

public Map<String, String> getWifiInfo ()

Pobiera informacje o bieżącym połączeniu Wi-Fi.

Obejmuje to SSID, BSSID, adres IP, szybkość łącza i RSSI.

Zwraca
Map<String, String> mapę zawierającą informacje o połączeniu Wi-Fi;
Zgłasza
DeviceNotAvailableException

hasValidIp

public boolean hasValidIp ()

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

isWifiEnabled

public boolean isWifiEnabled ()

Sprawdź, czy Wi-Fi jest obecnie włączone.

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

removeAllNetworks

public boolean removeAllNetworks ()

Usuwa wszystkie znane sieci.

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

Rozpoczyna monitorowanie połączeń sieciowych.

Parametry
interval long: interwał między sprawdzaniem połączenia.
urlToCheck String: adres URL, z którym chcesz sprawdzić połączenie.
Zwraca
boolean true, jeśli operacja się powiodła.
Zgłasza
DeviceNotAvailableException

stopMonitor

public List<Long> stopMonitor ()

Zatrzymuje monitorowanie połączenia sieciowego.

Zwraca też historię opóźnień od ostatniego wywołania IWifiHelper.startMonitor(long,String).

Zwraca
List<Long> historię opóźnień,
Zgłasza
DeviceNotAvailableException

waitForIp

public boolean waitForIp (long timeout)

Poczekaj, aż do karty Wi-Fi zostanie przypisany adres IP.

Parametry
timeout long: jak długo czekać
Zwraca
boolean true jeśli adres IP zostanie przypisany przed upływem limitu czasu, false w przeciwnym razie
Zgłasza
DeviceNotAvailableException

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

Zaczekaj, aż isWifiEnabled() będzie mieć wartość false.

Parametry
timeout long: czas oczekiwania w milisekundach
Zwraca
boolean true – jeśli Wi-Fi zostało wyłączone przed upływem limitu czasu, false – w przeciwnym razie.
Zgłasza
DeviceNotAvailableException

waitForWifiDisabled

public boolean waitForWifiDisabled ()

Poczekaj, aż isWifiEnabled() przyjmie wartość false, z domyślnym czasem oczekiwania.

Zwraca
boolean true – jeśli Wi-Fi zostało wyłączone przed upływem limitu czasu, false – w przeciwnym razie.
Zgłasza
DeviceNotAvailableException

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

Zaczekaj, aż isWifiEnabled() będzie mieć wartość „prawda”.

Parametry
timeout long: czas oczekiwania w milisekundach
Zwraca
boolean true, jeśli Wi-Fi zostało włączone przed upływem limitu czasu, w przeciwnym razie – false.
Zgłasza
DeviceNotAvailableException

waitForWifiEnabled

public boolean waitForWifiEnabled ()

Poczekaj, aż isWifiEnabled() przyjmie wartość „true” (prawda), z domyślnym czasem oczekiwania.

Zwraca
boolean true, jeśli Wi-Fi zostało włączone przed upływem limitu czasu, w przeciwnym razie – false.
Zgłasza
DeviceNotAvailableException

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

Czeka na wystąpienie jednego z oczekiwanych stanów Wi-Fi.

Parametry
expectedStates WifiState: jeden lub więcej oczekiwanych stanów Wi-Fi.
Zwraca
boolean true, jeśli wystąpił jeden z oczekiwanych stanów. false jeśli żaden ze stanów nie wystąpił przed upływem czasu oczekiwania
Zgłasza
DeviceNotAvailableException