اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

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

ميزة "الاتصال السهل بشبكة Wi-Fi"

يتيح Android 10 بروتوكول Wi-Fi Easy Connect، المعروف أيضًا باسم بروتوكول إدارة الجهاز (DPP). طرح تحالف Wi-Fi Alliance (WFA) بروتوكول Wi-Fi Easy Connect كبديل لنظام Wi-Fi Protected Setup (WPS). تم إيقاف نظام WPS في Android 9.

يوفّر بروتوكول Wi-Fi Easy Connect طريقة آمنة لإجراء ما يلي:

إضافة أجهزة Wi-Fi (بما في ذلك الأجهزة التي لا تتضمّن شاشة) إلى شبكة بدون إدخال كلمة مرور
الانضمام إلى شبكات Wi-Fi بدون معرفة كلمة المرور أو إدخالها

يتم ضبط عملية الإعداد والمصادقة باستخدام معرّف موارد موحّد (URI)، يتم الحصول عليه عن طريق مسح رمز استجابة سريعة ضوئيًا (باستخدام كاميرا)، أو يتم ضبطه خارج النطاق، مثلاً باستخدام البلوتوث المنخفض الطاقة (BLE) أو الاتصال القريب المدى (NFC).

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

يتيح Android 10 بروتوكول Wi-Fi Easy Connect في وضع المُنشئ فقط (لا يتوفّر وضع المستجيب). تتوفّر أوضاع التشغيل التالية:

الوضع "مُنشئ-مُعدّ": إرسال بيانات اعتماد الشبكة إلى جهاز جديد عن طريق مسح رمز الاستجابة السريعة ضوئيًا
الوضع "مُنشئ-مُسجِّل": الانضمام إلى شبكة عن طريق مسح رمز الاستجابة السريعة للشبكة ضوئيًا

يتيح Android 10 بروتوكول المفتاح المشترك مسبقًا (PSK) لـ WPA2 وبروتوكول المصادقة المتزامنة للأجهزة المتساوية (SAE) لـ WPA3.

لا يتوفّر بروتوكول Wi-Fi Easy Connect إلا في وضع العميل (لا يتوفّر وضع SoftAP).

التنفيذ

لإتاحة بروتوكول Wi-Fi Easy Connect، عليك تنفيذ واجهة برنامج الطالب المتوفّرة في مشروع مفتوح المصدر لنظام Android (AOSP). استنادًا إلى الواجهة التي تم تنفيذها، يكون ذلك في:

hardware/interfaces/wifi/supplicant/1.2/ أو إصدار أحدث لـ HIDL
hardware/interfaces/wifi/supplicant/aidl/ لـ AIDL

في ما يلي المتطلبات اللازمة لإتاحة بروتوكول DPP:

تصحيحات لنواة Linux لإتاحة بروتوكول DPP:
- cfg80211
- nl80211
wpa_supplicant مع إتاحة بروتوكول DPP
برنامج تشغيل Wi-Fi مع إتاحة بروتوكول DPP
برنامج ثابت لـ Wi-Fi مع إتاحة بروتوكول DPP

تتوفّر واجهات برمجة التطبيقات العامة في Android 10 لتستخدمها التطبيقات:

WifiManager#isEasyConnectSupported: طلب من إطار العمل تحديد ما إذا كان الجهاز يتيح بروتوكول Wi-Fi Easy Connect
Activity#startActivityForResult(ACTION_PROCESS_WIFI_EASY_CONNECT_URI): السماح للتطبيقات بدمج بروتوكول Wi-Fi Easy Connect في عملية الإعداد أو التثبيت

تفعيل بروتوكول Wi-Fi Easy Connect

لتفعيل بروتوكول Wi-Fi Easy Connect في إطار عمل Android، عليك تضمين خيار التجميع CONFIG_DPP في ملف الإعدادwpa_supplicant، وهو android.config:

# Easy Connect (Device Provisioning Protocol - DPP)
CONFIG_DPP=y

التحقق من صحة البيانات

لاختبار عملية التنفيذ، عليك إجراء الاختبارات التالية.

اختبارات الوحدة

أجرِ اختبار DppManagerTest للتحقّق من سلوك علامات الإمكانات لبروتوكول DPP.

atest DppManagerTest

اختبارات VTS

إذا تم تنفيذ واجهة HIDL، أجرِ VtsHalWifiSupplicantV1_2TargetTest لاختبار سلوك برنامج الطالب HAL الإصدار 1.2.

إذا تم تنفيذ واجهة AIDL، أجرِ VtsHalWifiSupplicantStaIfaceTargetTest لاختبار سلوك برنامج الطالب HAL.