WifiHelper

public class WifiHelper
extends Object implements IWifiHelper

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

Вспомогательный класс для управления службами Wi-Fi на устройстве.

Краткое содержание

Константы

String INSTRUMENTATION_PKG

Государственные строители

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

Альтернативный конструктор, позволяющий пропустить настройку APK-файла Wi-Fi.

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

Конструктор, указывающий, следует ли использовать новый вспомогательный модуль Wi-Fi версии 2.

Общедоступные методы

boolean addOpenNetwork (String ssid)

Добавляет открытую сеть безопасности, идентифицируемую по SSID.

boolean addOpenNetwork (String ssid, boolean scanSsid)

Добавляет открытую сеть безопасности, идентифицируемую по SSID.

boolean addWpaPskNetwork (String ssid, String psk)

Добавляет сеть безопасности WPA-PSK, идентифицируемую по SSID.

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

Добавляет сеть безопасности WPA-PSK, идентифицируемую по SSID.

boolean checkConnectivity (String urlToCheck)

Проверяет подключение, отправляя HTTP-запрос на указанный URL.

void cleanUp ()

Очистите ресурсы и выполните установку пакета Wi-Fi Helper.

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

Подключается к сети Wi-Fi и проверяет наличие подключения.

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

Подключается к сети Wi-Fi и проверяет наличие подключения.

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

Подключается к сети Wi-Fi и проверяет наличие подключения.

boolean disableWifi ()

Отключает состояние Wi-Fi на устройстве.

boolean disconnectFromNetwork ()

Отключитесь от текущей сети Wi-Fi и выключите Wi-Fi.

boolean enableWifi ()

Включает состояние Wi-Fi на устройстве.

static File extractWifiUtilApk ()

Вспомогательный метод для извлечения APK-файла утилиты wifi из classpath.

String getBSSID ()

Получает базовый идентификатор набора служб (BSSID) текущей точки доступа.

String getIpAddress ()

Получает IP-адрес, связанный с Wi-Fi-интерфейсом.

String getSSID ()

Получает идентификатор набора служб текущей подключенной сети.

Map<String, String> getWifiInfo ()

Получает информацию о текущем подключении к сети Wi-Fi.

boolean hasValidIp ()

boolean isWifiEnabled ()

Проверьте, включен ли в данный момент Wi-Fi.

boolean removeAllNetworks ()

Удаляет все известные сети.

boolean startMonitor (long interval, String urlToCheck)

Запускает мониторинг сетевого подключения.

List<Long> stopMonitor ()

Отключает мониторинг сетевого подключения.

boolean waitForIp (long timeout)

Дождитесь присвоения IP-адреса Wi-Fi-адаптеру.

boolean waitForWifiDisabled (long timeout)

Дождитесь, пока isWifiEnabled() станет равным false.

boolean waitForWifiDisabled ()

Дождитесь, пока isWifiEnabled() станет равным false, с заданным по умолчанию таймаутом.

boolean waitForWifiEnabled (long timeout)

Дождитесь, пока isWifiEnabled() станет истинным.

boolean waitForWifiEnabled ()

Дождитесь, пока isWifiEnabled() станет истинным, с заданным по умолчанию таймаутом.

boolean waitForWifiState ( WifiState... expectedStates)

Ожидает наступления одного из ожидаемых состояний Wi-Fi.

Константы

INSTRUMENTATION_PKG 

public static final String INSTRUMENTATION_PKG

Постоянное значение: "com.android.tradefed.utils.wifi"

Государственные строители

WifiHelper 

public WifiHelper (ITestDevice device)

Параметры
device ITestDevice

Броски
DeviceNotAvailableException

WifiHelper 

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

Параметры
device ITestDevice

wifiUtilApkPath String

Броски
DeviceNotAvailableException

WifiHelper 

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

Альтернативный конструктор, позволяющий пропустить настройку APK-файла Wi-Fi.

Параметры
device ITestDevice

wifiUtilApkPath String

doSetup boolean

Броски
DeviceNotAvailableException

WifiHelper 

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

Конструктор, указывающий, следует ли использовать новую вспомогательную функцию wifi v2. Для работы с v2 не требуется устанавливать APK-файл утилиты wifi.

Параметры
device ITestDevice

wifiUtilApkPath String

doSetup boolean

useV2 boolean

Броски
DeviceNotAvailableException

Общедоступные методы

addOpenNetwork 

public boolean addOpenNetwork (String ssid)

Добавляет открытую сеть безопасности, идентифицируемую по SSID.

Для подключения к любой сети Wi-Fi необходимо сначала создать сетевой профиль в конфигурации wpa_supplicant. Это вызовет wpa_cli для добавления открытой сети безопасности, идентифицированной по SSID.

Параметры
ssid String : SSID сети, которую нужно добавить.

Возвраты
boolean true , если сеть была успешно добавлена, false в противном случае.

Броски
DeviceNotAvailableException

addOpenNetwork 

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Добавляет открытую сеть безопасности, идентифицируемую по SSID.

Для подключения к любой сети Wi-Fi необходимо сначала создать сетевой профиль в конфигурации wpa_supplicant. Это вызовет wpa_cli для добавления открытой сети безопасности, идентифицированной по SSID.

Параметры
ssid String : SSID сети, которую нужно добавить.

scanSsid boolean : следует ли сканировать скрытые SSID для этой сети.

Возвраты
boolean true , если сеть была успешно добавлена, false в противном случае.

Броски
DeviceNotAvailableException

addWpaPskNetwork 

public boolean addWpaPskNetwork (String ssid, 
                String psk)

Добавляет сеть безопасности WPA-PSK, идентифицируемую по SSID.

Параметры
ssid String : SSID сети, которую нужно добавить.

psk String : парольная фраза WPA-PSK для использования.

Возвраты
boolean true , если сеть была успешно добавлена, false в противном случае.

Броски
DeviceNotAvailableException

addWpaPskNetwork 

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

Добавляет сеть безопасности WPA-PSK, идентифицируемую по SSID.

Параметры
ssid String : SSID сети, которую нужно добавить.

psk String : парольная фраза WPA-PSK для использования.

scanSsid boolean : следует ли сканировать скрытые SSID для этой сети.

Возвраты
boolean true , если сеть была успешно добавлена, false в противном случае.

Броски
DeviceNotAvailableException

проверка подключения 

public boolean checkConnectivity (String urlToCheck)

Проверяет подключение, отправляя HTTP-запрос на указанный URL.

Параметры
urlToCheck String : целевой URL-адрес для проверки HTTP-запроса.

Возвраты
boolean true , если устройство прошло проверку на подключение.

Броски
DeviceNotAvailableException

очистка 

public void cleanUp ()

Очистите ресурсы и установите пакет вспомогательной программы для Wi-Fi. Этот вызов следует производить только тогда, когда Wi-Fi больше не нужен, поскольку устройство потеряет Wi-Fi-соединение при удалении вспомогательной программы.

Броски
DeviceNotAvailableException

connectToNetwork 

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

Подключается к сети Wi-Fi и проверяет наличие подключения.

Параметры
ssid String : SSID сети для подключения

psk String : парольная фраза WPA-PSK для использования. Может быть пустым значением (null).

urlToCheck String : целевой URL-адрес для проверки HTTP-запроса.

Возвраты
boolean true , если устройство прошло проверку на подключение.

Броски
DeviceNotAvailableException

connectToNetwork 

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

Подключается к сети Wi-Fi и проверяет наличие подключения.

Параметры
ssid String : SSID сети для подключения

psk String : парольная фраза WPA-PSK для использования. Может быть пустым значением (null).

urlToCheck String : целевой URL-адрес для проверки HTTP-запроса.

scanSsid boolean : следует ли сканировать скрытые SSID для этой сети.

defaultType String : Тип сети по умолчанию, к которому будет применяться резервный тип, если тип сети SSID не определен.

Возвраты
IWifiHelper.WifiConnectionResult WifiConnectionResult — результат подключения к Wi-Fi.

Броски
DeviceNotAvailableException

connectToNetwork 

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

Подключается к сети Wi-Fi и проверяет наличие подключения.

Параметры
ssid String : SSID сети для подключения

psk String : парольная фраза WPA-PSK для использования. Может быть пустым значением (null).

urlToCheck String : целевой URL-адрес для проверки HTTP-запроса.

scanSsid boolean : следует ли сканировать скрытые SSID для этой сети.

Возвраты
IWifiHelper.WifiConnectionResult WifiConnectionResult — результат подключения к Wi-Fi.

Броски
DeviceNotAvailableException

disableWifi 

public boolean disableWifi ()

Отключает состояние Wi-Fi на устройстве.

Возвраты
boolean true если Wi-Fi был успешно отключен

Броски
DeviceNotAvailableException

disconnectFromNetwork 

public boolean disconnectFromNetwork ()

Отключитесь от текущей сети Wi-Fi и выключите Wi-Fi.

Возвраты
boolean true если операция прошла успешно.

Броски
DeviceNotAvailableException

enableWifi 

public boolean enableWifi ()

Включает состояние Wi-Fi на устройстве.

Возвраты
boolean true если Wi-Fi был успешно включен.

Броски
DeviceNotAvailableException

extractWifiUtilApk 

public static File extractWifiUtilApk ()

Вспомогательный метод для извлечения APK-файла утилиты wifi из classpath.

Возвраты
File

Броски
IOException

получитьBSSID 

public String getBSSID ()

Получает базовый идентификатор набора служб (BSSID) текущей точки доступа.

Возвраты
String

Броски
DeviceNotAvailableException

получить IP-адрес 

public String getIpAddress ()

Получает IP-адрес, связанный с Wi-Fi-интерфейсом. Возвращает null если при получении IP-адреса произошла ошибка.

Возвраты
String

Броски
DeviceNotAvailableException

получитьSSID 

public String getSSID ()

Получает идентификатор набора служб текущей подключенной сети.

Возвраты
String

Броски
DeviceNotAvailableException

getWifiInfo 

public Map<String, String> getWifiInfo ()

Получает информацию о текущем подключении к сети Wi-Fi.

Сюда входят SSID, BSSID, IP-адрес, скорость соединения и RSSI.

Возвраты
Map<String, String> Карта, содержащая информацию о подключении к Wi-Fi.

Броски
DeviceNotAvailableException

hasValidIp 

public boolean hasValidIp ()

Возвраты
boolean

Броски
DeviceNotAvailableException

isWifiEnabled 

public boolean isWifiEnabled ()

Проверьте, включен ли в данный момент Wi-Fi.

Возвраты
boolean

Броски
DeviceNotAvailableException

removeAllNetworks 

public boolean removeAllNetworks ()

Удаляет все известные сети.

Возвраты
boolean

Броски
DeviceNotAvailableException

startMonitor 

public boolean startMonitor (long interval, 
                String urlToCheck)

Запускает мониторинг сетевого подключения.

Параметры
interval long : интервал между проверками подключения.

urlToCheck String : URL-адрес для проверки подключения.

Возвраты
boolean true если операция прошла успешно.

Броски
DeviceNotAvailableException

stopMonitor 

public List<Long> stopMonitor ()

Отключает мониторинг сетевого подключения.

Эта функция также возвращает историю задержек с момента последнего вызова IWifiHelper.startMonitor(long,String) .

Возвраты
List<Long> история задержек.

Броски
DeviceNotAvailableException

waitForIp 

public boolean waitForIp (long timeout)

Дождитесь присвоения IP-адреса Wi-Fi-адаптеру.

Параметры
timeout long : как долго ждать

Возвраты
boolean true , если IP-адрес назначен до истечения таймаута, false в противном случае.

Броски
DeviceNotAvailableException

waitForWifiDisabled 

public boolean waitForWifiDisabled (long timeout)

Дождитесь, пока isWifiEnabled() станет равным false.

Параметры
timeout long : время ожидания в миллисекундах

Возвраты
boolean true , если Wi-Fi был отключен до истечения таймаута, false в противном случае.

Броски
DeviceNotAvailableException

waitForWifiDisabled 

public boolean waitForWifiDisabled ()

Дождитесь, пока isWifiEnabled() станет равным false, с заданным по умолчанию таймаутом.

Возвраты
boolean true , если Wi-Fi был отключен до истечения таймаута, false в противном случае.

Броски
DeviceNotAvailableException

waitForWifiEnabled 

public boolean waitForWifiEnabled (long timeout)

Дождитесь, пока isWifiEnabled() станет истинным.

Параметры
timeout long : время ожидания в миллисекундах

Возвраты
boolean true , если Wi-Fi был включен до истечения таймаута, false в противном случае.

Броски
DeviceNotAvailableException

waitForWifiEnabled 

public boolean waitForWifiEnabled ()

Дождитесь, пока isWifiEnabled() станет истинным, с заданным по умолчанию таймаутом.

Возвраты
boolean true , если Wi-Fi был включен до истечения таймаута, false в противном случае.

Броски
DeviceNotAvailableException

waitForWifiState 

public boolean waitForWifiState (WifiState... expectedStates)

Ожидает наступления одного из ожидаемых состояний Wi-Fi.

Параметры
expectedStates WifiState : одно или несколько состояний Wi-Fi, которые следует ожидать.

Возвраты
boolean true , если произошло одно из ожидаемых состояний. false , если ни одно из состояний не произошло до истечения времени ожидания.

Броски
DeviceNotAvailableException