自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

WifiHelper

public class WifiHelper
extends Object

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

用于在设备上操控 Wi-Fi 服务的辅助类。

摘要

字段
`public static final String`	`INSTRUMENTATION_PKG`

公共构造函数
`WifiHelper(ITestDevice device)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup)` 可跳过 Wi-Fi APK 设置的备用构造函数。
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` 用于指定是否使用新版 Wi-Fi 帮助程序 v2 的构造函数。

公共方法
`boolean`	`addOpenNetwork(String ssid)`
`boolean`	`addOpenNetwork(String ssid, boolean scanSsid)`
`boolean`	`addWpaPskNetwork(String ssid, String psk)`
`boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)`
`boolean`	`checkConnectivity(String urlToCheck)`
`void`	`cleanUp()`
`boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)`
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)`
`IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)`
`boolean`	`disableWifi()`
`boolean`	`disconnectFromNetwork()`
`boolean`	`enableWifi()`
`static File`	`extractWifiUtilApk()` 用于从类路径中提取 wifi util apk 的辅助方法
`String`	`getBSSID()`
`String`	`getIpAddress()`
`String`	`getSSID()`
	`getWifiInfo()`
`boolean`	`hasValidIp()`
`boolean`	`isWifiEnabled()`
`boolean`	`removeAllNetworks()`
`boolean`	`startMonitor(long interval, String urlToCheck)`
	`stopMonitor()`
`boolean`	`waitForIp(long timeout)`
`boolean`	`waitForWifiDisabled(long timeout)`
`boolean`	`waitForWifiDisabled()`
`boolean`	`waitForWifiEnabled(long timeout)`
`boolean`	`waitForWifiEnabled()`
`boolean`	`waitForWifiState(WifiState... expectedStates)`

字段

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

公共构造函数

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)

可跳过 Wi-Fi APK 设置的备用构造函数。

参数
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`

抛出
`DeviceNotAvailableException`

WifiHelper

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

用于指定是否使用新的 Wi-Fi 帮助程序 v2 的构造函数。v2 操作无需安装 Wi-Fi 实用程序 apk。

参数
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`
`useV2`	`boolean`

抛出
`DeviceNotAvailableException`

公共方法

addOpenNetwork

public boolean addOpenNetwork (String ssid)

参数
`ssid`	`String`

返回
`boolean`

抛出
`DeviceNotAvailableException`

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

参数
`ssid`	`String`
`scanSsid`	`boolean`

返回
`boolean`

抛出
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

参数
`ssid`	`String`
`psk`	`String`

返回
`boolean`

抛出
`DeviceNotAvailableException`

addWpaPskNetwork

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

参数
`ssid`	`String`
`psk`	`String`
`scanSsid`	`boolean`

返回
`boolean`

抛出
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

参数
`urlToCheck`	`String`

返回
`boolean`

抛出
`DeviceNotAvailableException`

cleanUp

public void cleanUp ()

抛出
`DeviceNotAvailableException`

connectToNetwork

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

参数
`ssid`	`String`
`psk`	`String`
`urlToCheck`	`String`

返回
`boolean`

抛出
`DeviceNotAvailableException`

connectToNetwork

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

参数
`ssid`	`String`
`psk`	`String`
`urlToCheck`	`String`
`scanSsid`	`boolean`
`defaultType`	`String`

返回
`IWifiHelper.WifiConnectionResult`

抛出
`DeviceNotAvailableException`

connectToNetwork

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

参数
`ssid`	`String`
`psk`	`String`
`urlToCheck`	`String`
`scanSsid`	`boolean`

返回
`IWifiHelper.WifiConnectionResult`

抛出
`DeviceNotAvailableException`

disableWifi

public boolean disableWifi ()

返回
`boolean`

抛出
`DeviceNotAvailableException`

disconnectFromNetwork

public boolean disconnectFromNetwork ()

返回
`boolean`

抛出
`DeviceNotAvailableException`

enableWifi

public boolean enableWifi ()

返回
`boolean`

抛出
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

用于从类路径中提取 wifi util apk 的辅助方法

返回
`File`

getBSSID

public String getBSSID ()

返回
`String`

抛出
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

返回
`String`

抛出
`DeviceNotAvailableException`

getSSID

public String getSSID ()

返回
`String`

抛出
`DeviceNotAvailableException`

getWifiInfo

public  getWifiInfo ()

返回

抛出
`DeviceNotAvailableException`

hasValidIp

public boolean hasValidIp ()

返回
`boolean`

抛出
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

返回
`boolean`

抛出
`DeviceNotAvailableException`

removeAllNetworks

public boolean removeAllNetworks ()

返回
`boolean`

抛出
`DeviceNotAvailableException`

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

参数
`interval`	`long`
`urlToCheck`	`String`

返回
`boolean`

抛出
`DeviceNotAvailableException`

stopMonitor

public  stopMonitor ()

返回

抛出
`DeviceNotAvailableException`

waitForIp

public boolean waitForIp (long timeout)

参数
`timeout`	`long`

返回
`boolean`

抛出
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

参数
`timeout`	`long`

返回
`boolean`

抛出
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled ()

返回
`boolean`

抛出
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

参数
`timeout`	`long`

返回
`boolean`

抛出
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled ()

返回
`boolean`

抛出
`DeviceNotAvailableException`

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

参数
`expectedStates`	`WifiState`

返回
`boolean`

抛出
`DeviceNotAvailableException`