إرسال أوامر وحدة التحكّم في المحاكي

يوفر كل جهاز افتراضي قيد التشغيل وحدة تحكّم تتيح لك طلب البيانات والتحكّم في بيئة الجهاز المحاكى. على سبيل المثال، يمكنك استخدام وحدة التحكّم لإدارة إعادة توجيه المنفذ وخصائص الشبكة وأحداث الاتصال الهاتفي أثناء تشغيل تطبيقك على المحاكي.

تتطلّب الأوامر التالية أن يكون لديك محاكي قيد التشغيل. لمزيد من المعلومات حول تشغيل المحاكي، يُرجى الاطّلاع على تشغيل التطبيقات على Android Emulator وبدء المحاكي من سطر الأوامر.

بدء جلسة وحدة تحكّم وإيقافها

للوصول إلى وحدة التحكّم وإدخال الأوامر من نافذة وحدة طرفية، استخدِم telnet للاتصال بمنفذ وحدة التحكّم وقدِّم رمز المصادقة المميز. في كل مرة تعرض فيها وحدة التحكّم OK، تكون جاهزة لتلقّي الأوامر. لا يوجد طلب نموذجي.

للاتصال بوحدة تحكّم جهاز افتراضي قيد التشغيل، اتّبِع الخطوات التالية:

1. افتح نافذة المحطة الطرفية وأدخِل الأمر التالي:

   telnet localhost console-port
   

   يعرض عنوان نافذة المحاكي رقم منفذ وحدة التحكّم عند التشغيل في نافذة منفصلة، ولكن لا يعرضه عند التشغيل في نافذة الأدوات. على سبيل المثال، يمكن أن يكون عنوان النافذة لمحاكي يستخدم منفذ وحدة التحكّم 5554 هو Pixel8_API_34:5554. بالإضافة إلى ذلك، يعرض الأمر adb devices قائمة بالأجهزة الافتراضية قيد التشغيل وأرقام منافذ وحدة التحكّم الخاصة بها. لمزيد من المعلومات، يُرجى الاطّلاع على طلب البحث عن الأجهزة.

   ملاحظة: يستمع المحاكي إلى عمليات الاتصال على المنافذ من 5554 إلى 5585، ويقبل عمليات الاتصال من المضيف المحلي فقط.

2. بعد أن تعرض وحدة التحكّم حسنًا، أدخِل الأمر auth auth_token.

   قبل أن تتمكّن من إدخال أوامر وحدة التحكّم، يجب المصادقة على وحدة تحكّم المحاكي. يجب أن يتطابق auth_token مع محتوى الملف .emulator_console_auth_token في دليل منزلك.

   إذا لم يكن هذا الملف متوفّرًا، ينشئ الأمر telnet localhost console-port الملف الذي يحتوي على رمز مميّز للمصادقة تم إنشاؤه عشوائيًا. لإيقاف المصادقة، احذف الرمز المميّز من الملف .emulator_console_auth_token أو أنشئ ملفًا فارغًا إذا لم يكن الملف متوفّرًا.

3. بعد الاتصال بوحدة التحكّم، أدخِل أوامر وحدة التحكّم.

   أدخِل help أو help command أو help-verbose للاطّلاع على قائمة بأوامر وحدة التحكّم والتعرّف على أوامر معيّنة.

4. للخروج من جلسة وحدة التحكّم، أدخِل quit أو exit.

في ما يلي مثال على جلسة:

$ telnet localhost 5554
Trying ::1...
telnet: connect to address ::1: Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Android Console: Authentication required
Android Console: type 'auth <auth_token>' to authenticate
Android Console: you can find your <auth_token> in
'/Users/me/.emulator_console_auth_token'
OK
auth 123456789ABCdefZ
Android Console: type 'help' for a list of commands
OK
help-verbose
Android console command help:
    help|h|?         Prints a list of commands
    help-verbose     Prints a list of commands with descriptions
    ping             Checks if the emulator is alive
    automation       Manages emulator automation
    event            Simulates hardware events
    geo              Geo-location commands
    gsm              GSM related commands
    cdma             CDMA related commands
    crash            Crashes the emulator instance
    crash-on-exit    Simulates crash on exit for the emulator instance
    kill             Terminates the emulator instance
    restart          Restarts the emulator instance
    network          Manages network settings  (ethernet and cellular only)
    power            Power related commands
    quit|exit        Quits control session
    redir            Manages port redirections
    sms              SMS related commands
    avd              Controls virtual device execution
    qemu             QEMU-specific commands
    sensor           Manages emulator sensors
    physics          Manages physical model
    finger           Manages emulator finger print
    debug            Controls the emulator debug output tags
    rotate           Rotates the screen clockwise by 90 degrees
    screenrecord     Records the emulator's display
    fold             Folds the device
    unfold           Unfolds the device
    multidisplay     Configures the multi-display
    nodraw           turn on/off NoDraw mode. (experimental)
    resize-display   resize the display resolution to the preset size
    virtualscene-image  customize virtualscene image for virtulscene camera
    proxy            manage network proxy server settings
    phonenumber      set phone number for the device

try 'help <command>' for command-specific help
OK
exit
Connection closed by foreign host.

أوامر التنفيذ التلقائي

إذا لم تكن بحاجة إلى إبقاء الجلسة مفتوحة، استخدِم الاختصار adb emu، الذي ينفّذ الأمر ويعيد التحكّم فورًا إلى الصدفة التي تم استدعاؤه منها:

adb emu command commandParameter

يؤدي استدعاء adb emu إلى الاتصال بالمحاكي المتاح. إذا كنت تشغّل عدة محاكيات في الوقت نفسه، عليك إدخال الرقم التسلسلي للمحاكي الذي تستهدفه:

adb -s emulator-serial emu command commandParameter

مرجع أوامر المحاكي

توضّح القائمتان التاليتان أوامر وحدة تحكّم المحاكي مع مَعلماتها وقيمها:

طلبات عامة

• avd {stop| start| status| name} يستعلم عن الجهاز الافتراضي ويتحكّم فيه ويديره، وذلك على النحو التالي:

  • stop: لإيقاف تنفيذ الجهاز.
  • start: يبدأ تنفيذ الجهاز.
  • الحالة: طلب البحث عن حالة الجهاز الافتراضي، والتي يمكن أن تكون قيد التشغيل أو متوقفة.
  • name: طلب بحث عن اسم الجهاز الافتراضي.

• avd snapshot {list| save name| load name| delete name} يتم حفظ حالة الجهاز واستعادتها في اللقطات على النحو التالي:

  • list: تعرض هذه السمة جميع اللقطات المحفوظة.
  • save name: لحفظ اللقطة باسم.
  • load name: لتحميل اللقطة المسماة.
  • استبدِل delete name باسم اللقطة المحفوظة لحذفها.

  يحفظ المثال التالي لقطة بالاسم firstactivitysnapshot:

  avd snapshot save firstactivitysnapshot
  

• fold: يطوي الجهاز لعرض إعدادات الشاشة الأصغر، إذا كان الجهاز قابلاً للطي ومفتوحًا حاليًا.

• فتح: يفتح الجهاز لعرض إعدادات الشاشة الأكبر، إذا كان الجهاز قابلاً للطي وكان مطويًا حاليًا.

• kill: لإنهاء الجهاز الافتراضي.

• ping: يتحقّق مما إذا كان الجهاز الافتراضي قيد التشغيل.

• تدوير: لتدوير الفيديو بزاوية 45 درجة عكس عقارب الساعة

تعطُّل المحاكي

• crash: يؤدي إلى تعطُّل المحاكي أثناء تنفيذ التطبيق.

• crash-on-exit: يؤدي إلى تعطُّل المحاكي عند خروج التطبيق.

علامات تصحيح الأخطاء

• علامات تصحيح الأخطاء ...: تتيح هذه العلامة تفعيل رسائل تصحيح الأخطاء أو إيقافها من أجزاء محدّدة من المحاكي. يجب أن تكون مَعلمة العلامات قيمة من قائمة علامات تصحيح الأخطاء التي تظهر عند تنفيذ emulator -help-debug-tags. لمزيد من المعلومات حول الخيار -help-debug-tags، راجِع جدول الخيارات الشائعة الاستخدام. يسمح المثال التالي باستخدام علامة الراديو:

  debug radio
  

إعادة توجيه المنفذ

• redir list: تعرض عمليات إعادة توجيه المنفذ الحالية.

• redir add protocol:host-port:guest-port تضيف هذه السمة عملية إعادة توجيه منفذ جديد، على النحو التالي:

  • البروتوكول: يجب أن يكون tcp أو udp.
  • host-port: رقم المنفذ المطلوب فتحه على المضيف.
  • guest-port: رقم المنفذ الذي سيتم توجيه البيانات إليه على المحاكي.

• redir del protocol:host-port يحذف هذا الأمر عملية إعادة توجيه المنفذ.

  • البروتوكول: يجب أن يكون tcp أو udp.
  • host-port: رقم المنفذ المطلوب فتحه على المضيف.

الموقع الجغرافي

يضبط هذا الخيار الموقع الجغرافي الذي يتم إرساله إلى التطبيقات التي تعمل داخل المحاكي من خلال إرسال إشارة GPS إلى المحاكي.

يمكنك إصدار أحد أوامر الموقع الجغرافي التالية فور تشغيل جهاز افتراضي. يضبط المحاكي الموقع الجغرافي الذي تدخله من خلال إنشاء موفّر موقع جغرافي وهمي. يستجيب موفِّر الموقع الجغرافي هذا لخدمات الاستماع إلى الموقع الجغرافي التي تضبطها التطبيقات، كما يقدّم الموقع الجغرافي إلى LocationManager. يمكن لأي تطبيق الاستعلام من "خدمة تحديد الموقع الجغرافي" للحصول على الموقع الجغرافي الحالي الذي تم تحديده باستخدام نظام تحديد المواقع العالمي (GPS) للجهاز المحاكي من خلال استدعاء LocationManager.getLastKnownLocation("gps").

• ‫geo fix longitude latitude [altitude] [satellites] [velocity]: يرسل هذا الأمر إصلاحًا بسيطًا لنظام تحديد المواقع العالمي (GPS) إلى المحاكي. حدِّد خط الطول وخط العرض بالدرجات العشرية. استخدِم رقمًا من 1 إلى 12 لتحديد عدد الأقمار الصناعية التي سيتم استخدامها لتحديد الموقع الجغرافي، وحدِّد الارتفاع بالأمتار والسرعة بالعُقد.

• جملة geo nmea: تُرسِل جملة NMEA 0183 إلى الجهاز المحاكى كما لو تم إرسالها من مودم GPS محاكى. ابدأ الجملة بالرمز ‎$GP. لا تتوفّر حاليًا سوى الجملتين '$GPGGA' و '$GPRCM'. المثال التالي هو جملة GPGGA (بيانات تحديد المواقع العالمية) التي تحصل على الوقت والموقع الجغرافي وبيانات التحديد لجهاز استقبال GPS:

  geo nmea $GPGGA,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x,xx,x.x,x.x,M,x.x,M,x.x,xxxx
  

أحداث الأجهزة الوهمية

يتيح لك نظام الأحداث الفرعي للأجهزة في محاكي وحدة التحكّم محاكاة أي تفاعل مادي مع الجهاز تقريبًا. ويشمل ذلك الأزرار المادية واللمس/الإيماءات على الشاشة وأقراص التدوير وإدخالات ذراع التحكّم ومفاتيح التبديل في الأجهزة.

• أنواع الأحداث: تعرض هذه السمة جميع أنواع الأحداث الوهمية. بالنسبة إلى الأحداث التي تتضمّن رموزًا، يتم إدراج عدد الرموز بين قوسين على اليسار. مثال على الإخراج:

  event types
  event <type> can be an integer or one of the following aliases:
      EV_SYN
      EV_KEY    (405 code aliases)
      EV_REL    (2 code aliases)
      EV_ABS    (27 code aliases)
      EV_MSC
      EV_SW     (4 code aliases)
      EV_LED
      EV_SND
      EV_REP
      EV_FF
      EV_PWR
      EV_FF_STATUS
      EV_MAX
  OK
  

• event send types [types ...]: يرسل نوعًا واحدًا أو أكثر من أنواع الأحداث الوهمية.

• نوع رموز الأحداث: تعرض هذه السمة رموز الأحداث لنوع الحدث الزائف المحدّد.

• event send type[:code]:[value] [...]: لإرسال حدث واحد أو أكثر من الأحداث الوهمية مع رموز وقيم رموز اختيارية.

EV_KEY — مراجع رموز المفاتيح

يُستخدَم نوع الحدث EV_KEY لمحاكاة الضغط على الأزرار وتحريرها. تقسّم الجداول التالية القائمة الكبيرة لرموز المفاتيح المتوافقة إلى فئات منطقية. بالنسبة إلى كل رمز مفتاح، يؤدي إرسال القيمة 1 إلى محاكاة الضغط على المفتاح، بينما يؤدي إرسال القيمة 0 إلى محاكاة رفع الإصبع عن المفتاح. تمثّل القيمة 2 تكرار المفتاح.

الجدول الفرعي أ: مفاتيح نظام Android

الجدول الفرعي B: عناصر التحكّم في الوسائط والتشغيل

الجدول الفرعي C: لوحات المفاتيح العامة ولوحات المفاتيح المخصّصة للتنقّل

الجدول الفرعي D: الأبجدية الرقمية ورموز لوحة المفاتيح

• أحرف الأبجدية القياسية: من KEY_A إلى KEY_Z (26 رمزًا)
• مفاتيح لوحة المفاتيح الرقمية: من KEY_1 إلى KEY_0 (10 رموز).

الجدول الفرعي E: مفاتيح التعديل والوظائف

• مفاتيح الوظائف العادية: من KEY_F1 إلى KEY_F24 (24 رمزًا)

الجدول الفرعي F: لوحات التحكّم وعصا التحكّم

الجدول الفرعي G: إدخالات الماوس واللمس وقلم الشاشة

الجدول الفرعي H: اختصارات التطبيقات

EV_ABS — أحداث الحركة المطلقة

يُعدّ نوع الحدث EV_ABS مهمًا لمحاكاة اللمسات الدقيقة وإيماءات السحب والإفلات وإجراءات الضغط المتعدد بأصابع متعددة وتعديلات عصا التحكّم. تتطابق الإحداثيات المطلقة أدناه مع دقة الشاشة الأساسية.

يتم توجيه التفاعل باللمس على أجهزة Android من خلال بروتوكولات اللمس المتعدد (MT). تستخدم المحاكيات الحديثة كلاً من البروتوكول A (بدون حالة، ويتم فيه إرسال حِزم جهات الاتصال مفصولة بعلامات المزامنة) والبروتوكول B (مع حالة، ويتم فيه تعيين جهات الاتصال إلى خانات تتبُّع مخصّصة). يتيح البروتوكول B تتبُّعًا فعّالاً لعمليات لمس متزامنة متعددة للإيماءات، مثل التكبير والتصغير.

EV_REL وEV_SW — مفاتيح الحركة والأجهزة

تتولّى فئة الأحداث EV_REL إدارة التغييرات في المؤشر النسبي أو الإحداثيات، ويتم استخدامها في المقام الأول لمحاكاة حركات الماوس الخارجية أو عجلات التمرير. تتولّى فئة الحدث EV_SW إدارة مفاتيح التحكّم في الأجهزة المادية، مثل ما إذا كان الهاتف القابل للطي أو الجهاز اللوحي مطويًا، أو ما إذا تم إدخال جهاز صوتي خارجي.

بنية إرسال الأوامر

لإرسال هذه الرموز، يجب تنسيق أمر وحدة التحكّم باستخدام الأنواع والرموز والقيم مفصولة بنقطتين رأسيتين. يمكنك وضع تغييرات متعدّدة في الإحداثيات في قائمة انتظار ضمن سلسلة واحدة. من المهم إضافة علامة مزامنة نهائية (EV_SYN:0:0) دائمًا للإشارة إلى أنّ إطار عمل المحاكي يجب أن يجمع هذه المدخلات ويعالجها معًا.

أمثلة على نصوص الأحداث والإيماءات

بما أنّ Telnet تتيح إرسال مَعلمات متعدّدة الأجزاء، يمكنك محاكاة تسلسلات إيماءات جسدية واقعية. في ما يلي بنى نصوص برمجية أولية للأحداث بهدف أتمتة الإيماءات من وحدة تحكّم المضيف.

محاكاة نقرة على الشاشة

لتنفيذ نقرة شاشة نظيفة عند إحداثيات مستهدَفة، عليك تعيين معرّف تتبُّع، وتحديد إحداثيات X وY على الشاشة، ومحاكاة لمس جهة الاتصال، والمزامنة، ثم التحرير.

# Press down at coordinate (400, 800) and sync
event send EV_ABS:ABS_MT_TRACKING_ID:1
OK
event send EV_ABS:ABS_MT_POSITION_X:400
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Lift finger up and sync
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK

محاكاة التمرير السريع (العمودي)

لتنفيذ إيماءة التمرير السريع للتنقّل، اضغط مع الاستمرار على نقطة الاتصال عند الإحداثي الأولي، وأرسِل إطارات إحداثيات الحركة الوسيطة، ثم حرِّر نقطة الاتصال في النهاية.

# Finger touch down at start coordinate (500, 1600)
event send EV_ABS:ABS_MT_TRACKING_ID:2
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1600
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Move coordinates upward dynamically
event send EV_ABS:ABS_MT_POSITION_Y:1200
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:400
OK
event send EV_SYN:0:0
OK
# Finger release at coordinate (500, 400)
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK

محاكاة إيماءة التكبير أو التصغير بإصبعين

لتفعيل التكبير بإصبعَين، استخدِم خانتَي MT نشطتَين (0 و1) لتتبُّع إحداثيَّي لمس متزامنين يتحرّكان بعيدًا عن بعضهما البعض وتنسيقهما.

# Finger 1 down at (500, 1000) using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:10
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Finger 2 down at (600, 1000) using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:11
OK
event send EV_ABS:ABS_MT_POSITION_X:600
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_SYN:0:0
OK
# Fingers slide apart from each other
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_POSITION_X:300
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_POSITION_X:800
OK
event send EV_SYN:0:0
OK
# Lift Finger 1 using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_SYN:0:0
OK
# Lift Finger 2 using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK

محاكاة تبديل اتصال سمّاعات الرأس

محاكاة عمليات إدخال أو إزالة مقبس سماعة الرأس لاختبار مفاتيح توجيه الصوت تمثّل القيمة 1 عملية إدخال مقبس، وتمثّل القيمة 0 عملية إزالة سماعة الرأس.

# Simulate headphones plugged in
event send EV_SW:SW_HEADPHONE_INSERT:1 EV_SYN:0:0
OK
# Simulate headphones unplugged
event send EV_SW:SW_HEADPHONE_INSERT:0 EV_SYN:0:0
OK

التعرّف على رموز أحداث وحدة التحكّم من جهاز حقيقي

للاطّلاع على تسلسل بنية الأحداث الدقيق لأي إجراء مخصّص أو إيماءة زر، يمكنك الاتصال عبر adb shell وتشغيل أداة getevent التشخيصية. أثناء تفاعلك مع واجهة المستخدم الرسومية للمحاكي، تعرض وحدة التحكّم رموز الأحداث وأنواعها ومواضعها بدقة.

# Run getevent to monitor input events dynamically
adb shell getevent -lt
/dev/input/event12: EV_KEY       KEY_POWER            DOWN
/dev/input/event12: EV_SYN       SYN_REPORT           00000000
/dev/input/event12: EV_KEY       KEY_POWER            UP
/dev/input/event12: EV_SYN       SYN_REPORT           00000000

• رسالة نصية خاصة بالحدث: ترسل سلسلة من الأحرف تحاكي ضغطات المفاتيح. يجب أن تكون الرسالة سلسلة UTF-8. يتم عكس عملية الربط بين مشاركات Unicode ولوحة مفاتيح الجهاز الحالية، ويتم تجاهل الأحرف غير المتاحة بدون إشعار.

عناصر التحكّم في حالة التشغيل

• شاشة الطاقة: تعرض حالة البطارية والشاحن.

• power ac {on| off}: لضبط حالة الشحن عبر التيار المتردد على "مفعّل" أو "غير مفعّل".

• حالة الطاقة {unknown| charging| discharging| not-charging| full}: لتغيير حالة البطارية كما هو محدّد.

• power present {true| false}: يضبط حالة توفّر البطارية.

• power health {unknown| good| overheat| dead| overvoltage| failure}: لضبط حالة صحة البطارية.

• power capacity percent: تضبط هذه السمة حالة سعة البطارية المتبقية كنسبة مئوية من 0 إلى 100.

حالة اتصال الشبكة (إيثرنت وشبكة الجوّال فقط)

• حالة الشبكة: تتحقّق من حالة الشبكة وخصائص التأخير والسرعة الحالية.

• network delay latency تغيير وقت استجابة الشبكة المحاكى

  يتيح لك المحاكي محاكاة مستويات مختلفة من وقت استجابة الشبكة حتى تتمكّن من اختبار تطبيقك في بيئة أكثر ملاءمة لظروف التشغيل الفعلية. يمكنك ضبط مستوى أو نطاق وقت الاستجابة عند بدء تشغيل المحاكي، أو يمكنك استخدام وحدة التحكّم لتغيير وقت الاستجابة أثناء تشغيل التطبيق في المحاكي.

  يكون تنسيق وقت استجابة الشبكة أحد التنسيقات التالية (الأرقام بالمللي ثانية):

  تنسيق وقت استجابة الشبكة:

• ‫gprs: شبكة GPRS التي تستخدم نطاق وقت استجابة يبلغ 150 كحدّ أدنى و550 كحدّ أقصى.

• EDGE: EDGE/EGPRS، التي تستخدم نطاق تأخير يبلغ 80 كحد أدنى و400 كحد أقصى.

• ‫umts: النظام العالمي لاتصالات الجوال عن بعد (UMTS) أو شبكة الجيل الثالث، ويستخدم نطاق وقت استجابة يبلغ 35 كحد أدنى و200 كحد أقصى.

• none: ما مِن وقت استجابة.

• استبدِل num بمقدار وقت الاستجابة المطلوب بالمللي ثانية.

• ‫min:max: يحاكي نطاق وقت الاستجابة المحدّد.

  لضبط وقت الاستجابة عند بدء تشغيل المحاكي، استخدِم خيار المحاكي -netdelay مع قيمة وقت استجابة متوافقة. أمثلة:

  emulator -netdelay gprs
  emulator -netdelay 40,100
  

  لإجراء تغييرات على تأخير الشبكة أثناء تشغيل المحاكي، اتّصِل بوحدة التحكّم واستخدِم الأمر network delay:

  network delay gprs
  network delay 40 100
  

• network speed speed يتيح لك المحاكي محاكاة معدّلات نقل البيانات المختلفة على الشبكة. يمكنك ضبط معدّل نقل أو نطاق عند بدء تشغيل المحاكي، أو يمكنك استخدام وحدة التحكّم لتغيير المعدّل أثناء تشغيل التطبيق في المحاكي.

  يكون تنسيق سرعة الشبكة أحد التنسيقات التالية (الأرقام بالكيلوبت/ثانية):

  تنسيق سرعة الشبكة:

• ‫gsm: GSM/CSD، الذي يستخدم سرعة 14.4 ميغابايت في الثانية للتحميل و14.4 ميغابايت في الثانية للتنزيل

• ‫hscsd: HSCSD، التي تستخدم سرعة 14.4 في التحميل و43.2 في التنزيل

• ‫gprs: شبكة GPRS التي تستخدم سرعة 40.0 ميغابايت في الثانية للتحميل و80.0 ميغابايت في الثانية للتنزيل

• EDGE: EDGE/EGPRS، التي تستخدم سرعة 118.4 في التحميل و236.8 في التنزيل

• ‫umts: النظام العالمي لاتصالات الجوال عن بعد (UMTS)/الجيل الثالث، الذي يستخدم سرعة 128.0 في التحميل و1920 في التنزيل

• hsdpa: HSDPA، الذي يستخدم سرعة 348.0 للأعلى و14,400.0 للأسفل.

• ‫lte: شبكة LTE، التي تستخدم سرعة 58,000 في التحميل و173,000 في التنزيل

• ‫evdo: EVDO، التي تستخدم سرعة 75,000 في التحميل و280,000 في التنزيل

• كاملة: سرعة غير محدودة، ولكنها تعتمد على سرعة اتصال جهاز الكمبيوتر بالإنترنت.

• num: يضبط معدّلًا دقيقًا بالكيلوبت في الثانية يُستخدم لكل من التحميل والتنزيل.

• up:down: يضبط معدّلات دقيقة بالكيلوبت/ثانية للتحميل والتنزيل بشكل منفصل.

  لضبط سرعة الشبكة عند بدء تشغيل المحاكي، استخدِم خيار -netspeed في المحاكي. أمثلة:

  emulator -netspeed gsm @Pixel_API_26
  emulator -netspeed 14.4,80 @Pixel_API_26
  

  لإجراء تغييرات على سرعة الشبكة أثناء تشغيل المحاكي، اتّصِل بوحدة التحكّم واستخدِم الأمر network speed:

  network speed 14.4 80
  

• network capture {start| stop} file يرسل حِزمًا إلى ملف. توضّح القائمة التالية المَعلمات وقيم المَعلمات:

  ملاحظة: بدءًا من الإصدار 36.5 من "محاكي Android" والإصدارات الأحدث، يتم تلقائيًا التعامل مع عدد الزيارات المرتبطة باتصال Wi-Fi من خلال netsim. لا يسجّل أمر وحدة التحكّم الخاص بتسجيل بيانات الشبكة سوى بيانات شبكة الجيل الثاني/شبكة WAN القديمة التي يتم توجيهها من خلال حزمة QEMU slirp. لالتقاط حِزم Wi-Fi أو Bluetooth أو حِزم الشبكة المتقدّمة في أحدث إصدارات المحاكي، راجِع التقاط حركة بيانات الشبكة في دليل "الشبكة المتقدّمة للمحاكي".

• start file: لبدء تسجيل حِزم الشبكة لأسباب أمنية، يجب أن يكون الملف اسم ملف مجردًا (بدون فواصل مسار مثل / وبدون ..). سيتم حفظ ملف التقاط الحزمة ضمن دليل المحتوى الخاص بجهاز Android الافتراضي في المجلد console_out/ (على سبيل المثال، ~/.android/avd/avd_name.avd/console_out/file).

• stop file: لإيقاف إرسال الحِزم إلى الملف المحدّد.

محاكاة الاتصال الهاتفي

يتضمّن محاكي Android أجهزة مودم محاكاة خاصة بشبكات GSM وCDMA تتيح لك محاكاة وظائف الاتصال الهاتفي في المحاكي. على سبيل المثال، يمكنك باستخدام GSM محاكاة المكالمات الهاتفية الواردة وإنشاء اتصالات البيانات وإنهائها. باستخدام CDMA، يمكنك تقديم مصدر اشتراك وقائمة التجوال المفضّلة. يتعامل نظام Android مع المكالمات المحاكاة تمامًا كما يتعامل مع المكالمات الفعلية. لا يتيح المحاكي تشغيل الصوت أثناء المكالمات.

• gsm {call| accept| cancel| busy} phonenumber في ما يلي مَعلمات gsm:

  • call: يحاكي مكالمة هاتفية واردة من رقم الهاتف.
  • accept: يقبل مكالمة واردة من رقم هاتف ويغيّر حالة المكالمة إلى نشطة. يمكنك تغيير حالة مكالمة إلى نشطة فقط عندما تكون حالتها الحالية في انتظار أو معلّقة.
  • cancel: لإنهاء مكالمة هاتفية واردة أو صادرة إلى رقم هاتف.
  • busy: لإغلاق مكالمة صادرة إلى رقم هاتف وتغيير حالة المكالمة إلى "مشغول". لا يمكنك تغيير حالة المكالمة إلى مشغول إلا إذا كانت حالتها الحالية هي انتظار.

• gsm {data| voice} state يغيّر أمر حالة البيانات حالة اتصال بيانات GPRS، ويغيّر أمر حالة الصوت حالة اتصال صوت GPRS، وذلك على النحو التالي:

  • غير مسجَّلة: ما مِن شبكة متاحة.
  • الشبكة الرئيسية: على الشبكة المحلية، بدون تجوال
  • التجوال: على شبكة التجوال
  • جارٍ البحث: جارٍ البحث عن شبكات.
  • مرفوض: مكالمات الطوارئ فقط
  • إيقاف: كما هو الحال مع "غير مسجّل".
  • on: كما هو الحال في المنزل.

• gsm hold: لتغيير حالة المكالمة إلى "في الانتظار" يمكنك تغيير حالة مكالمة إلى "في انتظار الرد" فقط عندما تكون حالتها الحالية نشطة أو في انتظار الرد.

• قائمة GSM: تعرض جميع المكالمات الواردة والصادرة وحالاتها.

• حالة GSM: تعرض حالة GSM الحالية للصوت/البيانات. القيم هي تلك الموضّحة للأوامر الصوتية وأوامر البيانات.

• gsm signal {rssi| ber} يؤدي هذا الخيار إلى تغيير قوة الإشارة المسجّلة (rssi) ومعدّل الخطأ في البت (ber) خلال الـ 15 ثانية التالية من التحديث. توضّح القائمة التالية المَعلمات وقيمها:

  • ‫rssi: يتراوح النطاق بين 0 و31 و99 للقيمة غير المعروفة.
  • ber: يتراوح النطاق بين 0 و7 و99 للقيمة غير المعروفة.

• gsm signal-profile num: لضبط ملف قوة الإشارة، حيث يمثل num رقمًا من 0 إلى 4.

• cdma ssource source تضبط هذه السمة مصدر الاشتراك الحالي في شبكة CDMA، حيث يكون المصدر عبارة عن قائمة سماح مستندة إلى الشبكة تتضمّن المشتركين في شبكة CDMA وقيمهم، وذلك على النحو التالي:

  • nv: لقراءة الاشتراك من ذاكرة الوصول العشوائي غير المتطايرة
  • ‫ruim: لقراءة الاشتراك من وحدة تعريف هوية المستخدم القابلة للإزالة (RUIM).

• cdma prl_version version: تعرض هذه السمة إصدار قائمة التجوال المفضّلة (PRL) الحالية. رقم الإصدار مخصّص لقاعدة بيانات PRL التي تتضمّن معلومات تُستخدم أثناء عملية اختيار النظام واكتسابه.

إدارة أدوات الاستشعار على المحاكي

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

• حالة أداة الاستشعار: تعرض قائمة بجميع أدوات الاستشعار وحالتها.

• sensor get sensor-name: للحصول على إعدادات sensor-name يحصل المثال التالي على قيمة مستشعر التسارع:

  sensor get acceleration
  acceleration = 2.23517e-07:9.77631:0.812348
  

  تشير قيم التسارع المفصولة بنقطتَين رأسيتَين(:) إلى إحداثيات x وy وz لأجهزة الاستشعار الافتراضية.

• sensor set sensor-name value-x:value-y:value-z: لضبط قيم sensor-name. يضبط المثال التالي مستشعر التسارع على قيم x وy وz مفصولة بنقطتين رأسيتين.

  sensor set acceleration 2.23517e-07:9.77631:0.812348
  

محاكاة الرسائل القصيرة

• sms send sender-phone-number textmessage تنشئ هذه الطريقة رسالة SMS واردة محاكية. توضّح القائمة التالية المَعلمات وقيمها:

  • sender-phone-number: يحتوي على سلسلة رقمية عشوائية.
  • textmessage: رسالة SMS.

  يرسل المثال التالي الرسالة "مرحبًا" إلى رقم الهاتف 4085555555:

  sms send 4085555555 hi there
  

تعيد وحدة التحكّم توجيه رسالة SMS إلى إطار عمل Android، الذي يمرّرها إلى تطبيق على المحاكي يتعامل مع الرسائل القصيرة، مثل تطبيق "الرسائل". وإذا أدخلت 10 أرقام، ينسّقها التطبيق كرقم هاتف. يتم عرض السلاسل الرقمية الأطول أو الأقصر بالطريقة التي أرسلتها بها.

محاكاة بصمة الإصبع

• finger touch fingerprint-id: يحاكي إصبعًا يلمس المستشعر.

• finger remove: يحاكي إزالة الإصبع.

للحصول على تعليمات حول كيفية استخدام هذه الأوامر، راجِع القسم التالي حول محاكاة بصمة الإصبع والتحقّق من صحتها.

تسجيل الشاشة

يتيح أمر تسجيل الشاشة إمكانية تسجيل ملفات فيديو عالية الجودة للشاشة الفعلية للمحاكي مباشرةً من نظام التشغيل المضيف. ويُعدّ ذلك مفيدًا جدًا لمسارات الدمج المستمر وإعداد تقارير الأخطاء تلقائيًا.

• screenrecord {start| stop} file يبدأ عملية تسجيل الشاشة أو يوقفها.
  • بدء الملف: لبدء تسجيل الفيديو يجب أن ينتهي ملف الإخراج بالامتداد الإلزامي .webm. يتم حفظ الفيديو الذي تم التقاطه مباشرةً ضمن دليل إخراج وحدة التحكّم في محاكي Android للأجهزة الافتراضية (AVD): ~/.android/avd/avd_name.avd/console_out/file.
  • stop file: لإيقاف عملية تسجيل الشاشة النشطة.

التشغيل الآلي والماكرو

يتيح النظام الفرعي للتشغيل الآلي للمطوّرين تسجيل عمليات نقل حالة الماكرو على الجهاز الافتراضي قيد التشغيل وإعادة تشغيلها لتنفيذ مسارات الاختبار الآلي.

• automation {record| stop-record| play| stop-play} تُستخدَم لإدارة عمليات تسجيل وحدات الماكرو المبرمَجة.
  • record: لبدء تسجيل التغييرات والمدخلات في حالة الجهاز
  • ‫stop-record: لإيقاف جلسة تسجيل الماكرو الحالية.
  • تشغيل: لبدء تشغيل تسلسل وحدات ماكرو مسجَّل
  • stop-play: لإيقاف تسلسل تشغيل الماكرو النشط.

الفيزياء (6 درجات من الحرية)

تتحكّم أوامر الفيزياء في تسجيل الوضعيات المكانية الصحيحة لعينات من نماذج الحركة الفيزيائية ذات ست درجات حرية (6DoF)، والتي تُستخدَم لمحاكاة ميزة تتبُّع الحركة المتقدّمة.

• physics {record-gt| stop} تُستخدَم لإدارة التسجيلات التي تتضمّن نموذج الوضعية الجسدية.
  • ‫record-gt: تبدأ في تسجيل بيانات حركة 6 درجات من الحرية (6DoF) الخاصة بالبيانات المرجعية.
  • stop: لإيقاف عملية تسجيل البيانات الأساسية الحالية

عناصر التحكّم المتقدّمة بالجهاز

يجمع هذا القسم نقاط نهاية أوامر وحدة التحكّم المتخصّصة للغاية لإعدادات المحاكاة المتقدّمة، بما في ذلك خوادم وكيل الشبكة وإعدادات العرض المتعدد وعمليات إلغاء العرض وتصحيح الأخطاء المباشر في برنامج Hypervisor.

• multidisplay {add| del} تضيف هذه السمة شاشات افتراضية ثانوية أو تحذفها لاختبار إعدادات متعددة الشاشات. ملاحظة: لا تتوافق الشاشات الثانوية مع ملفات التعريف القابلة للطي، مثل Pixel Fold أو المحاكي القابل لتغيير الحجم.

• proxy {set| clear} يضبط إعادة توجيه الخادم الوكيل للشبكة آليًا من وحدة التحكّم.

  • set host port: تضبط هذه السمة إعدادات الخادم الوكيل المستهدف.
  • clear: لإعادة ضبط إعدادات الخادم الوكيل على الإعدادات التلقائية ملاحظة: تتعذّر عمليات ضبط الوكيل في بيئات التنفيذ بلا واجهة مستخدم رسومية.

• virtualscene-image {wall| table} image_path تخصيص الجدران الخلفية أو الجداول الأفقية المعروضة في خلاصة كاميرا المشهد الافتراضي باستخدام ملف صورة مخصّص للمستخدم

• resize-display scale تعديل درجة دقة الشاشة ديناميكيًا بين المقاييس المضبوطة مسبقًا ملاحظة: لا تتوافق تعديلات درجة الدقة مع عمليات الضبط بدون شاشة.

• nodraw {on| off} يؤدي إلى إيقاف عرض واجهة المستخدم الرسومية على شاشة الجهاز المضيف لتقليل استخدام ذاكرة النظام وتخفيف الحمل على وحدة معالجة الرسومات أثناء عمليات التشغيل الآلي المكثّفة في الخلفية بدون واجهة مستخدم.

• grpc port تضبط هذه السمة إعدادات التحكّم المتقدّمة في الأجهزة آليًا من خلال نقاط نهاية مخصّصة لمنفذ gRPC.

• qemu monitor توفّر هذه السمة إمكانية الوصول المباشر إلى وحدة التحكّم التفاعلية الخاصة بمشرف الجهاز الظاهري الأساسي. لا يمكن إدخال هذا الأمر إلا عبر جلسات نشطة لوحدة تحكّم Telnet.

• icebox track pid تتيح هذه السمة أخذ لقطات تلقائية للنظام عندما يواجه تطبيق محدّد استثناءً أو يتعطّل.

• phonenumber number يضبط هذا الحقل رقم الهاتف المحلي الافتراضي لجهاز الاختبار.

واجهة gRPC البرمجية

تتوافق إصدارات المحاكي الحديثة مع واجهة gRPC برمجية فعّالة إلى جانب وحدة تحكّم Telnet القديمة. على الرغم من أنّ وحدة تحكّم Telnet مناسبة للجلسات التفاعلية السريعة أو النصوص البرمجية البسيطة، تم تصميم واجهة gRPC للتحكّم الآلي عالي الأداء والآمن والقوي في بيئات التكامل المستمر (CI) والبيئات غير الرسومية. من خلال توفير نقاط نهاية مباشرة للخدمة، تزيل gRPC الحاجة إلى تحليل تدفقات النصوص أو إدارة عمليات المصافحة لجلسات الوحدة الطرفية أو عرض منافذ localhost غير مشفّرة.

للمساعدة في الاختيار بين وحدة تحكّم Telnet القديمة وواجهة gRPC الحديثة القابلة للبرمجة، راجِع المقارنة التالية بين الأداء والأمان وإمكانات الميزات:

إطلاق gRPC واستدعاؤه

لاستخدام نقاط نهاية gRPC، شغِّل "محاكي Android" من سطر الأوامر وأضِف العلامة -grpc، مع تحديد منفذ إعادة التوجيه المستهدف.

# Start the emulator with the gRPC service enabled on port 8556
emulator -grpc localhost:8556 @Pixel_Fold

بعد تشغيل المحاكي مع تفعيل خدمة gRPC، يمكنك إجراء استدعاءات RPC برمجية. لإجراء الاختبار باستخدام سطر الأوامر، استخدِم الأداة grpcurl للتواصل مع خدمات المحاكي. يتم تنسيق جميع الطلبات بتنسيق JSON وإرسالها عبر نص عادي.

# Query the status of the virtual device using grpcurl
grpcurl -plaintext -d '{}' localhost:8556 \
  android.emulation.control.EmulatorController/getStatus

# Simulate an incoming phone call
grpcurl -plaintext -d '{"operation": "InitCall", "number": "1234567890"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendPhone

# Simulate typing text into the guest OS
grpcurl -plaintext -d '{"text": "Hello"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendKey

ربط وحدة تحكّم Telnet بخدمة gRPC

يوضّح جدول المراجع التالي كيفية ربط أوامر وحدة تحكّم Telnet القديمة بخدمات gRPC وطرقها المقابلة، مع الإشارة إلى كيفية تنفيذ التفاعلات الشائعة مع الأجهزة الافتراضية آليًا:

أوامر آلية فريدة خاصة بـ gRPC

توفّر واجهة gRPC العديد من الإمكانات المتطورة التي يستحيل تنفيذها عبر اتصالات وحدة تحكّم Telnet القديمة. وتشمل هذه الميزات بث logcat المباشر، أو تسجيل الصوت أو إدخاله في اتجاهين، أو تعديل واجهة المستخدم الرسومية للمضيف، أو الوصول المباشر إلى shell.

محاكاة بصمة الإصبع والتحقّق من صحتها

استخدِم أمر الإصبع لمحاكاة عملية المصادقة ببصمة الإصبع والتحقّق من صحتها في تطبيقك. يجب أن يتوفّر لديك الإصدار 24.3 أو إصدار أحدث من "أدوات حزمة تطوير البرامج (SDK)" والإصدار 6.0 (مستوى واجهة برمجة التطبيقات 23) أو إصدار أحدث من نظام التشغيل Android.

لمحاكاة عملية مصادقة بصمة الإصبع والتحقّق من صحتها، اتّبِع الخطوات التالية:

1. إذا لم يكن لديك معرّف بصمة إصبع، سجِّل بصمة إصبع جديدة في المحاكي من خلال النقر على الإعدادات > الأمان > بصمة الإصبع واتّباع تعليمات التسجيل.

2. اضبط إعدادات تطبيقك لقبول المصادقة ببصمة الإصبع. بعد إجراء عملية الإعداد هذه، يعرض جهازك شاشة مصادقة بصمة الإصبع.

3. أثناء عرض تطبيقك لشاشة مصادقة بصمة الإصبع، انتقِل إلى وحدة التحكّم وأدخِل الأمر finger touch ورقم تعريف بصمة الإصبع الذي أنشأته. يحاكي هذا الإجراء لمسة إصبع.

4. بعد ذلك، أدخِل الأمر finger remove لمحاكاة إزالة الإصبع. يجب أن يستجيب تطبيقك كما لو أنّ المستخدم وضع إصبعه على أداة استشعار بصمات الأصابع ثم أزاله.