החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-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`

‫constructors ציבוריים
`WifiHelper(ITestDevice device)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup)` ‫Constructor חלופי שיכול לדלג על ההגדרה של קובץ ה-APK של ה-Wi-Fi.
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` הבונה (constructor) שקובע אם להשתמש בכלי החדש לעזרה ב-Wi-Fi, גרסה 2.

‫methods ציבוריים
`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.
`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 של כלי ה-Wi-Fi מנתיב המחלקות
`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()` יהיה true.
`boolean`	`waitForWifiEnabled()` המתנה עד שהערך של `isWifiEnabled()` יהיה TRUE עם זמן קצוב לתפוגה שמוגדר כברירת מחדל.
`boolean`	`waitForWifiState(WifiState... expectedStates)` הפונקציה ממתינה עד שאחד ממצבי ה-Wi-Fi הצפויים מתרחש.

ערכים קבועים

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

ערך קבוע: "com.android.tradefed.utils.wifi"

‫constructors ציבוריים

WifiHelper

public WifiHelper (ITestDevice device)

פרמטרים
`device`	`ITestDevice`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

פרמטרים
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

WifiHelper

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

‫Constructor חלופי שיכול לדלג על ההגדרה של קובץ ה-APK של ה-Wi-Fi.

פרמטרים
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

WifiHelper

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

הפעולה Constructor מציינת אם להשתמש בגרסה החדשה של כלי העזר ל-Wi-Fi, גרסה 2. בפעולות של גרסה 2 אין צורך להתקין את קובץ ה-APK של כלי ה-Wi-Fi.

פרמטרים
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`
`useV2`	`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

‫methods ציבוריים

addOpenNetwork

public boolean addOpenNetwork (String ssid)

מוסיף את רשת האבטחה הפתוחה שזוהתה על ידי ssid.

כדי להתחבר לרשת Wi-Fi, צריך קודם ליצור פרופיל רשת בהגדרות של wpa_supplicant. הפעולה הזו תפעיל את wpa_cli כדי להוסיף את רשת האבטחה הפתוחה שזוהתה על ידי ssid.

פרמטרים
`ssid`	‫`String`: ה-SSID של הרשת שרוצים להוסיף.

החזרות
`boolean`	‫`true` אם הרשת נוספה בהצלחה, אחרת `false`.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

מוסיף את רשת האבטחה הפתוחה שזוהתה על ידי ssid.

פרמטרים
`ssid`	‫`String`: ה-SSID של הרשת שרוצים להוסיף.
`scanSsid`	‫`boolean`: האם לסרוק SSID מוסתר ברשת הזו.

החזרות
`boolean`	‫`true` אם הרשת נוספה בהצלחה, אחרת `false`.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

מוסיף את רשת האבטחה WPA-PSK שזוהתה על ידי ssid.

פרמטרים
`ssid`	‫`String`: ה-SSID של הרשת שרוצים להוסיף.
`psk`	‫`String`: סיסמת WPA-PSK לשימוש

החזרות
`boolean`	‫`true` אם הרשת נוספה בהצלחה, אחרת `false`.

הקפצת הודעות שגיאה (throw)
`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`.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

בודק את הקישוריות על ידי שליחת בקשת HTTP לכתובת ה-URL שצוינה.

פרמטרים
`urlToCheck`	‫`String`: כתובת יעד לבדיקת בקשת HTTP

החזרות
`boolean`	`true` אם המכשיר עובר את בדיקת החיבור.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

cleanUp

public void cleanUp ()

מנקים את המשאבים ואת ההתקנה של חבילת כלי העזר ל-Wi-Fi. הפונקציה הזו צריכה להיקרא רק כשאין יותר צורך ב-Wi-Fi להפעלה, כי המכשיר יאבד את חיבור ה-Wi-Fi כשהעוזר יוסר.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

connectToNetwork

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

מתחבר לרשת Wi-Fi ובודק את החיבור.

פרמטרים
`ssid`	‫`String`: ה-SSID של הרשת שאליה רוצים להתחבר
`psk`	‫`String`: סיסמת WPA-PSK לשימוש. הערך בשדה הזה יכול להיות null.
`urlToCheck`	‫`String`: כתובת יעד לבדיקת בקשת HTTP

החזרות
`boolean`	`true` אם המכשיר עובר את בדיקת החיבור.

הקפצת הודעות שגיאה (throw)
`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
`scanSsid`	‫`boolean`: האם לסרוק SSID מוסתר ברשת הזו
`defaultType`	‫`String`: סוג הרשת שמוגדר כברירת מחדל שאליה המערכת תחזור אם לא ייקבע סוג הרשת של ה-SSID

החזרות
`IWifiHelper.WifiConnectionResult`	‫WifiConnectionResult שמייצג את תוצאת החיבור ל-Wi-Fi

הקפצת הודעות שגיאה (throw)
`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
`scanSsid`	‫`boolean`: האם לסרוק SSID מוסתר ברשת הזו

החזרות
`IWifiHelper.WifiConnectionResult`	‫WifiConnectionResult שמייצג את תוצאת החיבור ל-Wi-Fi

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

disableWifi

public boolean disableWifi ()

ההגדרה משביתה את מצב ה-Wi-Fi במכשיר.

החזרות
`boolean`	‫`true` אם ה-Wi-Fi הושבת בהצלחה

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

disconnectFromNetwork

public boolean disconnectFromNetwork ()

מתנתקים מרשת ה-Wi-Fi הנוכחית ומשביתים את ה-Wi-Fi.

החזרות
`boolean`	‫`true` אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

enableWifi

public boolean enableWifi ()

ההגדרה מאפשרת את מצב ה-Wi-Fi במכשיר.

החזרות
`boolean`	‫`true` אם ה-Wi-Fi הופעל בהצלחה

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

שיטת עזר לחילוץ קובץ ה-APK של כלי ה-Wi-Fi מנתיב המחלקות

החזרות
`File`

הקפצת הודעות שגיאה (throw)
`IOException`

getBSSID

public String getBSSID ()

מקבל את המזהה של מערך השירות הבסיסי (BSSID) של נקודת הגישה הנוכחית.

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

הפונקציה מחזירה את כתובת ה-IP שמשויכת לממשק ה-Wi-Fi. הפונקציה מחזירה את הערך null אם אחזור כתובת ה-IP נכשל.

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getSSID

public String getSSID ()

מקבל את המזהה של מערך השירות של הרשת שמחוברת כרגע.

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getWifiInfo

public Map<String, String> getWifiInfo ()

קבלת פרטי החיבור הנוכחי ל-Wi-Fi.

המידע הזה כולל את ה-SSID,‏ BSSID, כתובת ה-IP, מהירות הקישור ו-RSSI.

החזרות
`Map<String, String>`	מפה שמכילה פרטי חיבור Wi-Fi.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

hasValidIp

public boolean hasValidIp ()

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

בודקים אם ה-Wi-Fi מופעל.

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

removeAllNetworks

public boolean removeAllNetworks ()

הסרת כל הרשתות הידועות.

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

מפעיל את המעקב אחרי החיבור לרשת.

פרמטרים
`interval`	‫`long`: האינטרוול בין בדיקות הקישוריות.
`urlToCheck`	‫`String`: כתובת URL לבדיקת הקישוריות.

החזרות
`boolean`	‫`true` אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

stopMonitor

public List<Long> stopMonitor ()

מפסיק את המעקב אחרי החיבור לרשת.

הפונקציה מחזירה גם את היסטוריית זמן האחזור מאז השיחה האחרונה IWifiHelper.startMonitor(long,String).

החזרות
`List<Long>`	היסטוריית זמני האחזור.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForIp

public boolean waitForIp (long timeout)

מחכים עד שכתובת IP מוקצית למתאם ה-Wi-Fi.

פרמטרים
`timeout`	‫`long`: כמה זמן לחכות

החזרות
`boolean`	‫`true` אם כתובת ה-IP מוקצית לפני פסק הזמן, `false` אחרת

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

מחכים עד שהערך של isWifiEnabled() יהיה false.

פרמטרים
`timeout`	‫`long`: זמן ההמתנה במילישניות

החזרות
`boolean`	‫`true` אם ה-Wi-Fi הושבת לפני שהזמן הקצוב לתפוגה הסתיים, `false` אחרת.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled ()

המתנה עד שהערך של isWifiEnabled() יהיה False עם פסק זמן שמוגדר כברירת מחדל.

החזרות
`boolean`	‫`true` אם ה-Wi-Fi הושבת לפני שהזמן הקצוב לתפוגה הסתיים, `false` אחרת.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

מחכים עד ש-isWifiEnabled() יהיה true.

פרמטרים
`timeout`	‫`long`: זמן ההמתנה במילישניות

החזרות
`boolean`	‫`true` אם ה-Wi-Fi הופעל לפני שהזמן הקצוב לתפוגה הסתיים, `false` אחרת.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled ()

המתנה עד שהערך של isWifiEnabled() יהיה TRUE עם זמן קצוב לתפוגה שמוגדר כברירת מחדל.

החזרות
`boolean`	‫`true` אם ה-Wi-Fi הופעל לפני שהזמן הקצוב לתפוגה הסתיים, `false` אחרת.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

הפונקציה ממתינה עד שאחד ממצבי ה-Wi-Fi הצפויים מתרחש.

פרמטרים
`expectedStates`	‫`WifiState`: מצב Wi-Fi אחד או יותר שצפויים

החזרות
`boolean`	‫`true` אם אחד מהמצבים הצפויים התרחש. `false` if none of the states occurred before timeout is reached

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`