自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度将源代码发布到 AOSP。对于构建 AOSP 和向 AOSP 贡献代码，我们建议使用 android-latest-release 而不是 aosp-main。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

WifiHelper

public class WifiHelper
extends Object

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)` 可跳过 wifi 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 实用程序 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

常量值： "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)

可跳过 Wi-Fi APK 设置的替代构造函数。

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

抛出
`DeviceNotAvailableException`

WifiHelper

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

构造函数，用于指定是否使用新的 WiFi 辅助程序 v2。v2 操作不需要安装 WiFi 实用程序 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 实用程序 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`