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)

دالة إنشاء بديلة يمكنها تخطّي عملية إعداد حزمة APK لشبكة Wi-Fi.

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

الدالة الإنشائية لتحديد ما إذا كان سيتم استخدام الإصدار 2 من أداة مساعدة Wi-Fi الجديدة.

الإجراءات العامة

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 الخاصة بأداة Wifi من مسار الفئة

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() خطأ.

boolean waitForWifiDisabled()

انتظِر إلى أن تصبح قيمة isWifiEnabled() "خطأ" مع مهلة تلقائية.

boolean waitForWifiEnabled(long timeout)

انتظِر إلى أن تصبح قيمة isWifiEnabled() صحيحة.

boolean waitForWifiEnabled()

انتظِر إلى أن تصبح قيمة isWifiEnabled() صحيحة مع مهلة تلقائية.

boolean waitForWifiState(WifiState... expectedStates)

تنتظر هذه السمة إلى أن تحدث إحدى حالات شبكة Wi-Fi المتوقّعة.

الثوابت

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

Constant Value: "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)

دالة إنشاء بديلة يمكنها تخطّي عملية إعداد حزمة APK لشبكة Wi-Fi.

المعلَمات
device ITestDevice

wifiUtilApkPath String

doSetup boolean

عمليات الطرح
DeviceNotAvailableException

WifiHelper

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

الدالة الإنشائية لتحديد ما إذا كان سيتم استخدام الإصدار 2 من أداة مساعدة Wi-Fi الجديدة. لا تتطلّب عمليات الإصدار 2 تثبيت حِزمة APK الخاصة بأداة Wi-Fi.

المعلَمات
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.

للاتصال بأي شبكة Wi-Fi، يجب أولاً إنشاء ملف تعريف للشبكة في إعدادات wpa_supplicant. سيؤدي ذلك إلى استدعاء wpa_cli لإضافة شبكة أمان مفتوحة تم تحديدها بواسطة ssid.

المعلَمات
ssid String: معرّف SSID للشبكة المطلوب إضافتها
scanSsid ‫boolean: ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة.
المرتجعات
boolean ‫true إذا تمت إضافة الشبكة بنجاح، وfalse في الحالات الأخرى
عمليات الطرح
DeviceNotAvailableException

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

تضيف هذه السمة شبكة أمان WPA-PSK التي تم تحديدها بواسطة ssid.

المعلَمات
ssid String: معرّف SSID للشبكة المطلوب إضافتها
psk String: عبارة مرور WPA-PSK المطلوب استخدامها
المرتجعات
boolean ‫true إذا تمت إضافة الشبكة بنجاح، وfalse في الحالات الأخرى
عمليات الطرح
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 في الحالات الأخرى
عمليات الطرح
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

يتحقّق من إمكانية الاتصال من خلال إرسال طلب HTTP إلى عنوان URL المحدّد.

المعلَمات
urlToCheck String: عنوان URL مقصود لإجراء فحص طلب HTTP
المرتجعات
boolean true إذا اجتاز الجهاز اختبار الاتصال.
عمليات الطرح
DeviceNotAvailableException

cleanUp

public void cleanUp ()

تنظيف الموارد وعملية تثبيت حزمة أداة المساعدة في شبكة Wi-Fi يجب عدم استدعاء هذه الدالة إلا عندما لا تكون شبكة Wi-Fi مطلوبة بعد الآن لتنفيذ الطلب، لأنّ الجهاز سيفقد الاتصال بشبكة Wi-Fi عند إلغاء تثبيت التطبيق المساعد.

عمليات الطرح
DeviceNotAvailableException

connectToNetwork

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

الاتصال بشبكة Wi-Fi والتحقّق من الاتصال

المعلَمات
ssid ‫String: معرّف SSID للشبكة المطلوب الاتصال بها
psk String: عبارة مرور WPA-PSK التي سيتم استخدامها يمكن أن تكون هذه القيمة فارغة.
urlToCheck String: عنوان URL مقصود لإجراء فحص طلب HTTP
المرتجعات
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 التي سيتم استخدامها يمكن أن تكون هذه القيمة فارغة.
urlToCheck String: عنوان URL مقصود لإجراء فحص طلب HTTP
scanSsid ‫boolean: ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة
defaultType String: نوع الشبكة التلقائي الذي سيتم الرجوع إليه في حال عدم تحديد نوع شبكة SSID
المرتجعات
IWifiHelper.WifiConnectionResult ‫WifiConnectionResult الذي يمثّل نتيجة اتصال Wi-Fi
عمليات الطرح
DeviceNotAvailableException

connectToNetwork

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

الاتصال بشبكة Wi-Fi والتحقّق من الاتصال

المعلَمات
ssid ‫String: معرّف SSID للشبكة المطلوب الاتصال بها
psk String: عبارة مرور WPA-PSK التي سيتم استخدامها يمكن أن تكون هذه القيمة فارغة.
urlToCheck String: عنوان URL مقصود لإجراء فحص طلب HTTP
scanSsid ‫boolean: ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة
المرتجعات
IWifiHelper.WifiConnectionResult ‫WifiConnectionResult الذي يمثّل نتيجة اتصال Wi-Fi
عمليات الطرح
DeviceNotAvailableException

disableWifi

public boolean disableWifi ()

يؤدي ذلك إلى إيقاف حالة شبكة Wi-Fi على الجهاز.

المرتجعات
boolean ‫true إذا تم إيقاف شبكة Wi-Fi بنجاح
عمليات الطرح
DeviceNotAvailableException

disconnectFromNetwork

public boolean disconnectFromNetwork ()

قطع الاتصال بشبكة Wi-Fi الحالية وإيقاف Wi-Fi

المرتجعات
boolean ‫true إذا نجحت العملية
عمليات الطرح
DeviceNotAvailableException

enableWifi

public boolean enableWifi ()

يتم تفعيل حالة شبكة Wi-Fi على الجهاز.

المرتجعات
boolean ‫true إذا تم تفعيل شبكة Wi-Fi بنجاح
عمليات الطرح
DeviceNotAvailableException

extractWifiUtilApk

public static File extractWifiUtilApk ()

طريقة مساعدة لاستخراج حزمة APK الخاصة بأداة Wifi من مسار الفئة

المرتجعات
File

عمليات الطرح
IOException

getBSSID

public String getBSSID ()

تعرض هذه السمة معرّف مجموعة الخدمات الأساسية (BSSID) لنقطة الوصول الحالية.

المرتجعات
String

عمليات الطرح
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

تعرض هذه السمة عنوان IP المرتبط بواجهة Wi-Fi. تعرِض null إذا حدث خطأ أثناء استرداد عنوان IP.

المرتجعات
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 true إذا تم تخصيص عنوان IP قبل انتهاء المهلة، false بخلاف ذلك
عمليات الطرح
DeviceNotAvailableException

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

انتظِر إلى أن تصبح قيمة isWifiEnabled() خطأ.

المعلَمات
timeout ‫long: الوقت بالمللي ثانية للانتظار
المرتجعات
boolean ‫true إذا تم إيقاف شبكة Wi-Fi قبل انتهاء المهلة، false في الحالات الأخرى.
عمليات الطرح
DeviceNotAvailableException

waitForWifiDisabled

public boolean waitForWifiDisabled ()

انتظِر إلى أن تصبح قيمة isWifiEnabled() خطأ مع مهلة تلقائية.

المرتجعات
boolean ‫true إذا تم إيقاف شبكة Wi-Fi قبل انتهاء المهلة، false في الحالات الأخرى.
عمليات الطرح
DeviceNotAvailableException

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

انتظِر إلى أن تصبح قيمة isWifiEnabled() صحيحة.

المعلَمات
timeout ‫long: الوقت بالمللي ثانية للانتظار
المرتجعات
boolean true إذا كان Wi-Fi مفعّلاً قبل انتهاء المهلة، false في الحالات الأخرى
عمليات الطرح
DeviceNotAvailableException

waitForWifiEnabled

public boolean waitForWifiEnabled ()

انتظِر إلى أن تصبح قيمة isWifiEnabled() صحيحة مع مهلة تلقائية.

المرتجعات
boolean true إذا كان Wi-Fi مفعّلاً قبل انتهاء المهلة، false في الحالات الأخرى
عمليات الطرح
DeviceNotAvailableException

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

تنتظر هذه السمة إلى أن تحدث إحدى حالات شبكة Wi-Fi المتوقّعة.

المعلَمات
expectedStates ‫WifiState: حالة واحدة أو أكثر من حالات شبكة Wi-Fi التي يجب توقّعها
المرتجعات
boolean true إذا حدثت إحدى الحالات المتوقّعة. ‫false إذا لم تحدث أي من الحالات قبل انتهاء المهلة
عمليات الطرح
DeviceNotAvailableException