ميزات متقدّمة لمحاكي الشبكة

يتضمّن "محاكي Android" محاكي شبكة يتيح لك تطوير تطبيقات Android واختبارها بدون استخدام أجهزة راديو فعلية.

توضّح هذه الصفحة خيارات سطر الأوامر للتحكّم في ميزات محاكي الشبكة.

عند بدء محاكي من سطر الأوامر، استخدِم العلامة -netsim-args في علامات المحاكي لتمرير وسيطات إلى محاكي الشبكة.

emulator -netsim-args="arg1 [arg2 ...]"

على سبيل المثال، لتفعيل ميزة تسجيل بيانات الحزمة، والتسجيل، وتحديد منفذ HCI معيّن، يمكنك استخدام ما يلي:

emulator -netsim-args="--pcap --logtostderr --verbose --hci-port 12345"

إعدادات Netsim

تتحكّم هذه العلامات في السلوك العام لبرنامج netsim الخفي وإعداده.

  • ‫-l, --logtostderr: تحدّد هذه السمة ما إذا كان سيتم إرسال رسائل السجلّ إلى stderr بدلاً من ملفات السجلّ. مفيدة لعرض السجلّات مباشرةً في ناتج المحاكي.
  • -v, --verbose: تفعيل الوضع المفصّل يطبع هذا الوضع سجلات أكثر تفصيلاً، وهو مفيد لتصحيح الأخطاء المعقّدة.
  • --hci-port <HCI_PORT>: اضبط منفذ HCI مخصّصًا. وهي مفيدة لتشغيل محاكيات متعددة أو الاتصال بمنفذ HCI معيّن.

تحديد الدليل الخاص بعناصر البناء

لتحديد دليل لعناصر محاكي الشبكة، اضبط متغيّر البيئة $ANDROID_TMP على النحو التالي:

export ANDROID_TMP=/path/to/your/directory

يحفظ محاكي الشبكة العناصر في الدليل التالي: $ANDROID_TMP/android/netsimd/. إذا تم ضبط متغير البيئة $USER، سيحفظ محاكي الشبكة العناصر في $ANDROID_TMP/android{-$USER}/netsimd/.

تسجيل حِزم الشبكة

لتفعيل ميزة "التقاط الحِزم"، استخدِم الوسيطة --pcap مع المحاكي.

emulator -netsim-args="--pcap"

تفيد هذه الميزة في تصحيح أخطاء الشبكة وتحليل عدد الزيارات. يحفظ محاكي الشبكة ملف التقاط حِزم البيانات (pcap) لكل شريحة راديو. يمكنك فتح هذه الملفات باستخدام أدوات مثل Wireshark. يحفظ محاكي الشبكة ملفات التقاط الحِزم في الدليل الفرعي pcap ضمن دليل عناصر netsimd.

ضبط نقطة وصول Wi-Fi (معرّف مجموعة الخدمات الأساسي (SSID) والتشفير المخصّصان)

لضبط نقطة وصول Wi-Fi، استخدِم الوسيطة --wifi مع المحاكي. مثلاً:

emulator -netsim-args="--wifi <SSID> <PASSWORD>"
  • SSID: اسم الشبكة
  • PASSWORD: كلمة مرور الشبكة اختيارية ويجب أن تتألف من 8 أحرف أو أكثر، وعند ضبطها، سيتم تشفير نقطة الوصول باستخدام WPA2 (CCMP).

ضبط قوة الإشارة المستلمة (RSSI)

يتيح محاكي الشبكة ضبط قيم RSSI معيّنة لراديو معيّن باستخدام العلامة --rssi.

emulator -netsim-args="--rssi <PHY_KIND:RSSI_VALUE>"
  • PHY_KIND: نوع راديو البلوتوث (مثل ble أو bt_classic). تتيح هذه المَعلمة استخدام الأسماء المستعارة غير الحساسة لحالة الأحرف.
  • ‫RSSI_VALUE: قيمة RSSI، وهي عدد صحيح (i8).

على سبيل المثال، يضبط الأمر التالي مستوى إشارة RSSI لزيارات BLE على ‎-65 dBm:

emulator -netsim-args="--rssi=ble:-65"

يمكنك تحديد هذه العلامة عدة مرات لأجهزة راديو مختلفة (مثلاً، --rssi=bt_classic:-65 --rssi=ble:-72).