2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 android-latest-release를 사용하세요. 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 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)` Wi-Fi APK 설정을 건너뛸 수 있는 대체 생성자입니다.
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` 새 Wi-Fi 도우미 v2를 사용할지 여부를 지정하는 생성자입니다.

공개 메서드
`boolean`	`addOpenNetwork(String ssid)` ssid로 식별되는 개방형 보안 네트워크를 추가합니다.
`boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` ssid로 식별되는 개방형 보안 네트워크를 추가합니다.
`boolean`	`addWpaPskNetwork(String ssid, String psk)` ssid로 식별되는 WPA-PSK 보안 네트워크를 추가합니다.
`boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` ssid로 식별되는 WPA-PSK 보안 네트워크를 추가합니다.
`boolean`	`checkConnectivity(String urlToCheck)` 지정된 URL에 HTTP 요청을 전송하여 연결을 확인합니다.
`void`	`cleanUp()` 리소스와 wifi 도우미 패키지 설치를 정리합니다.
`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()` 클래스 경로에서 Wi-Fi 유틸리티 APK를 추출하는 도우미 메서드
`String`	`getBSSID()` 현재 액세스 포인트의 기본 서비스 세트 식별자 (BSSID)를 가져옵니다.
`String`	`getIpAddress()` Wi-Fi 인터페이스와 연결된 IP 주소를 가져옵니다.
`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()`이 true가 될 때까지 기다립니다.
`boolean`	`waitForWifiEnabled()` 기본 제한 시간으로 `isWifiEnabled()`이 true가 될 때까지 기다립니다.
`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)

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로 식별되는 개방형 보안 네트워크를 추가합니다.

Wi-Fi 네트워크에 연결하려면 먼저 wpa_supplicant 구성에서 네트워크 프로필을 만들어야 합니다. 이렇게 하면 wpa_cli를 호출하여 ssid로 식별되는 공개 보안 네트워크를 추가합니다.

매개변수
`ssid`	`String`: 추가할 네트워크의 ssid입니다.

반환
`boolean`	네트워크가 추가되면 `true`, 그렇지 않으면 `false`

생성 값
`DeviceNotAvailableException`

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

ssid로 식별되는 개방형 보안 네트워크를 추가합니다.

매개변수
`ssid`	`String`: 추가할 네트워크의 ssid입니다.
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 검색할지 여부입니다.

반환
`boolean`	네트워크가 추가되면 `true`, 그렇지 않으면 `false`

생성 값
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

ssid로 식별되는 WPA-PSK 보안 네트워크를 추가합니다.

매개변수
`ssid`	`String`: 추가할 네트워크의 ssid입니다.
`psk`	`String`: 사용할 WPA-PSK 암호

반환
`boolean`	네트워크가 추가되면 `true`, 그렇지 않으면 `false`

생성 값
`DeviceNotAvailableException`

addWpaPskNetwork

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

ssid로 식별되는 WPA-PSK 보안 네트워크를 추가합니다.

매개변수
`ssid`	`String`: 추가할 네트워크의 ssid입니다.
`psk`	`String`: 사용할 WPA-PSK 암호
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 검색할지 여부입니다.

반환
`boolean`	네트워크가 추가되면 `true`, 그렇지 않으면 `false`

생성 값
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

지정된 URL에 HTTP 요청을 전송하여 연결을 확인합니다.

매개변수
`urlToCheck`	`String`: HTTP 요청 확인을 위한 대상 URL

반환
`boolean`	기기가 연결 확인을 통과하는 경우 `true`

생성 값
`DeviceNotAvailableException`

cleanUp

public void cleanUp ()

리소스와 wifi 도우미 패키지 설치를 정리합니다. 이는 도우미가 제거되면 기기의 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`: HTTP 요청 확인을 위한 대상 URL

반환
`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`: HTTP 요청 확인을 위한 대상 URL
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 스캔할지 여부
`defaultType`	`String`: SSID의 네트워크 유형이 결정되지 않은 경우 대체할 기본 네트워크 유형

반환
`IWifiHelper.WifiConnectionResult`	Wi-Fi 연결 결과를 나타내는 WifiConnectionResult

생성 값
`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`: HTTP 요청 확인을 위한 대상 URL
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 스캔할지 여부

반환
`IWifiHelper.WifiConnectionResult`	Wi-Fi 연결 결과를 나타내는 WifiConnectionResult

생성 값
`DeviceNotAvailableException`

disableWifi

public boolean disableWifi ()

기기에서 Wi-Fi 상태를 사용 중지합니다.

반환
`boolean`	Wi-Fi가 사용 중지된 경우 `true`

생성 값
`DeviceNotAvailableException`

disconnectFromNetwork

public boolean disconnectFromNetwork ()

현재 Wi-Fi 네트워크에서 연결을 해제하고 Wi-Fi를 사용 중지합니다.

반환
`boolean`	작업이 성공한 경우 `true`

생성 값
`DeviceNotAvailableException`

enableWifi

public boolean enableWifi ()

기기에서 Wi-Fi 상태를 사용 설정합니다.

반환
`boolean`	Wi-Fi가 사용 설정된 경우 `true`

생성 값
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

클래스 경로에서 Wi-Fi 유틸리티 APK를 추출하는 도우미 메서드

반환
`File`

생성 값
`IOException`

getBSSID

public String getBSSID ()

현재 액세스 포인트의 기본 서비스 세트 식별자 (BSSID)를 가져옵니다.

반환
`String`

생성 값
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Wi-Fi 인터페이스와 연결된 IP 주소를 가져옵니다. IP 주소를 가져오는 데 실패한 경우 null를 반환합니다.

반환
`String`

생성 값
`DeviceNotAvailableException`

getSSID

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`	시간이 초과되기 전에 IP 주소가 할당되면 `true`, 그렇지 않으면 `false`

생성 값
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

isWifiEnabled()이 false가 될 때까지 기다립니다.

매개변수
`timeout`	`long`: 대기 시간(밀리초)

반환
`boolean`	제한 시간 전에 Wi-Fi가 사용 중지된 경우 `true`, 그렇지 않은 경우 `false`입니다.

생성 값
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled ()

기본 제한 시간으로 isWifiEnabled()가 false가 될 때까지 기다립니다.

반환
`boolean`	제한 시간 전에 Wi-Fi가 사용 중지된 경우 `true`, 그렇지 않은 경우 `false`입니다.

생성 값
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

isWifiEnabled()이 true가 될 때까지 기다립니다.

매개변수
`timeout`	`long`: 대기 시간(밀리초)

반환
`boolean`	시간 초과 전에 Wi-Fi가 사용 설정된 경우 `true`, 그렇지 않은 경우 `false`입니다.

생성 값
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled ()

기본 제한 시간으로 isWifiEnabled()이 true가 될 때까지 기다립니다.

반환
`boolean`	시간 초과 전에 Wi-Fi가 사용 설정된 경우 `true`, 그렇지 않은 경우 `false`입니다.

생성 값
`DeviceNotAvailableException`

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

예상되는 Wi-Fi 상태 중 하나가 발생할 때까지 기다립니다.

매개변수
`expectedStates`	`WifiState`: 예상되는 하나 이상의 Wi-Fi 상태

반환
`boolean`	`true` 예상 상태 중 하나가 발생한 경우 `false` 시간 제한에 도달하기 전에 상태가 발생하지 않은 경우

생성 값
`DeviceNotAvailableException`