為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將於 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，建議使用 android-latest-release，而非 aosp-main。android-latest-release 資訊清單分支版本一律會參照推送至 AOSP 的最新版本。詳情請參閱「Android 開放原始碼計畫變更」一文。

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)` Alternative constructor that can skip the setup of the 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()` Helper method to extract the wifi util apk from the classpath
`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)

建構函式，用於指定是否使用新的 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 ()

從類別路徑擷取 Wi-Fi 實用工具 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`