تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

بدء المحاكي من سطر الأوامر

تتضمن حزمة تطوير البرامج (SDK) لنظام التشغيل Android محاكي جهاز Android، وهو جهاز افتراضي. يعمل على جهاز الكمبيوتر. يتيح لك محاكي Android تطوير التطبيقات واختبارها تطبيقات Android بدون استخدام جهاز فعلي.

تصف هذه الصفحة ميزات سطر الأوامر التي يمكنك استخدامها مع محاكي Android للحصول على معلومات عن استخدام واجهة مستخدم Android Emulator، يُرجى الانتقال إلى تشغيل التطبيقات على محاكي Android

بدء المحاكي

يمكنك استخدام الأمر emulator لتشغيل المحاكي كبديل تشغيل مشروعك أو تشغيلها من خلال "مدير AVD"

إليك بناء جملة سطر الأوامر الأساسي لبدء جهاز افتراضي من طلب Terminal:

emulator -avd avd_name [ {-option [value]} … ]

أو

emulator @avd_name [ {-option [value]} … ]

على سبيل المثال، إذا شغّلت المحاكي من داخل "استوديو Android" على جهاز Mac، فإن المحاكي سيكون سطر الأوامر مشابهًا لما يلي:

/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout

يُرجى ملاحظة أنّ الوسائط -qt-hide-window -grpc-use-token -idle-grpc-timeout تُستخدم فقط لتشغيل نافذة المحاكي في "استوديو Android". إذا أردت تشغيل المحاكي في نافذته الخاصة، يجب عدم استخدام هذه المعلمات الإضافية.

يمكنك تحديد خيارات بدء التشغيل عند بدء تشغيل المحاكي، ولكن ليس بعد بدئه.

للحصول على قائمة بأسماء AVD، أدخِل الأمر التالي:

emulator -list-avds

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

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

لإيقاف محاكي Android، أغلِق نافذة المحاكي.

تثبيت تطبيق

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

لاستخدام adb لتثبيت تطبيقك وتشغيله واختباره، اتبع هذه الخطوات العامة:

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

لإلغاء تثبيت تطبيق، افعل ذلك كما تفعل على جهاز Android.

يحتفظ الجهاز الافتراضي بالتطبيق وبيانات حالته خلال عمليات إعادة التشغيل. في قسم قرص بيانات المستخدم (userdata-qemu.img). لمحو هذه البيانات أو ابدأ تشغيل المحاكي بالخيار -wipe-data أو امسح البيانات في مدير AVD. لمزيد من المعلومات عن بيانات المستخدمين التقسيم وسعة التخزين الأخرى، راجع القسم التالي.

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

التعرّف على الأدلة والملفات التلقائية

يستخدم المحاكي ملفات مرتبطة، منها نظام AVD وأدلة البيانات الأكثر أهمية. من المفيد فهم بنية دليل المحاكي والملفات عند تحديد خيارات سطر الأوامر، رغم أنك لا تفعل ذلك عادةً تحتاج إلى تعديل الأدلة أو الملفات الافتراضية.

يستخدم محاكي Android برنامج Windows Hypervisor Platform (QEMU).

دليل نظام AVD

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

نظاما التشغيل macOS وLinux - ~/Library/Android/sdk/system-images/android-apiLevel/variant/arch/
Windows - C:\Users\user\Library\Android\sdk\system-images\android-apiLevel\variant\arch\

المكان:

apiLevel هو مستوى رقمي لواجهة برمجة التطبيقات أو حرف وإصدارات المعاينة. على سبيل المثال، تشير السمة android-V إلى نظام التشغيل Android معاينة VanillaIceCream وعند طرحه، أصبح المستوى 35 من واجهة برمجة التطبيقات، android-35
variant هو اسم يقابل ميزات معيّنة عن طريق صورة النظام. على سبيل المثال، google_apis أو android-wear
arch هي البنية المستهدَفة لوحدة المعالجة المركزية (CPU). على سبيل المثال: x86

استخدِم الخيار -sysdir لتحديد دليل نظام مختلف لما يلي: ومتوسّط مدة المشاهدة

يقرأ المحاكي الملفات التالية من دليل النظام:

الجدول 1. ملفات دليل النظام التي يقرأها Android المحاكي

ملف	الوصف	خيار تحديد ملف مختلف
‫`kernel-qemu` أو `kernel-ranchu`	تشير هذه السمة إلى صورة النواة الثنائية لـ AVD. تستند `kernel-ranchu` إلى محاكي QEMU	`-kernel`
`ramdisk.img`	صورة قسم التشغيل هذه مجموعة فرعية من `system.img` بواسطة النواة (kernel) في البداية قبل تحميل صورة النظام. أُنشأها جون هنتر، الذي كان متخصصًا عادةً ما يحتوي على عدد قليل من البرامج الثنائية والنصوص البرمجية للتهيئة.	`-ramdisk`
`system.img`	تمثّل هذه السمة النسخة الأولية للقراءة فقط من صورة النظام. وعلى وجه التحديد، قسم يحتوي على مكتبات النظام والبيانات المقابلة لمستوى واجهة برمجة التطبيقات والمتغير.	`-system`
`userdata.img`	هو الإصدار الأولي لقسم البيانات، والذي يظهر `data/` في نظام المحاكاة ويحتوي على جميع البيانات القابلة للكتابة متوسّط مدة المشاهدة ويستخدم المحاكي هذا الملف عند إنشاء متوسّط مدة مشاهدة جديدة أو استخدام الخيار `‑wipe-data`. لمزيد من المعلومات، يُرجى الاطّلاع على وصف ملف `userdata-qemu.img` في القسم التالي.	`-initdata` `-init-data`

دليل بيانات AVD

دليل بيانات AVD، ويسمى أيضًا دليل المحتوى، خاص بـ مثيل AVD واحد ويحتوي على جميع البيانات القابلة للتعديل لـ AVD

الموقع الجغرافي التلقائي هو ما يلي، حيث name هو اسم متوسّط مدة المشاهدة:

نظاما التشغيل macOS وLinux - ~/.android/avd/name.avd/
Windows 10 والإصدارات الأحدث - C:\Users\user\.android\name.avd\

استخدِم الخيار -datadir لتحديد دليل بيانات AVD مختلف.

يسرد الجدول التالي أهم الملفات المضمَّنة في هذا الدليل:

الجدول 2. الملفات المهمة في دليل بيانات AVD

ملف الوصف خيار تحديد ملف مختلف

ملف	الوصف	خيار تحديد ملف مختلف
`userdata-qemu.img`	محتوى قسم البيانات، الذي يظهر كـ `data/` في نظام المحاكاة. عند إنشاء متوسّط مدة مشاهدة جديدة أو عند استخدام `-wipe-data` لإعادة ضبط متوسّط مدة المشاهدة على الإعدادات الأصلية التلقائية، ينسخ المحاكي ملف `userdata.img` في دليل النظام إلى إنشاء هذا الملف. يستخدم كل مثيل جهاز افتراضي صورة بيانات مستخدم قابلة للكتابة لتخزين بيانات البيانات المحددة للجلسة. على سبيل المثال، يستخدم الصورة لتخزين صورة وبيانات التطبيقات المثبتة والإعدادات وقواعد البيانات والملفات. كل مستخدم لديه دليل `ANDROID_SDK_HOME` مختلف يخزِّن أدلة البيانات متوسّط مدة المشاهدة التي أنشأها هذا المستخدم يحتوي كل متوسط مدة مشاهدة على `userdata-qemu.img` واحدة. الملف.	`-data`
`cache.img`	صورة قسم ذاكرة التخزين المؤقت، التي تظهر على شكل `cache/` في نظام المحاكاة. يكون هذا العمود فارغًا عند إنشاء "متوسّط مدة المشاهدة" لأول مرة أو استخدام الخيار `-wipe-data`. يخزن ملفات التنزيل المؤقتة بواسطة تطبيق إدارة التنزيل وأحيانًا النظام. على سبيل المثال، المتصفح يُستخدم لتخزين صفحات الويب والصور التي تم تنزيلها مؤقتًا أثناء تشغيل المحاكي الجري. عند إيقاف تشغيل الجهاز الافتراضي، يتم حذف الملف. يمكنك الاحتفاظ بالملف باستخدام الخيار `-cache`.	`-cache`
`sdcard.img`	(اختياري) صورة قسم لبطاقة SD تتيح لك محاكاة بطاقة SD بطاقة على جهاز افتراضي. يمكنك إنشاء ملف صورة لبطاقة SD في AVD المدير أو يستخدم `mksdcard` . الملف مخزن على كمبيوتر التطوير ويجب تحميله على لبدء التشغيل. عند تحديد AVD في "مدير AVD"، يمكنك اختيار لاستخدام ملف بطاقة SD مُدار تلقائيًا أو ملف أنشأته باستخدام أداة `mksdcard`. يمكنك عرض ملف `sdcard.img` المرتبطة بمتوسّط مدة المشاهدة في "مدير متوسّط مدة المشاهدة" الخيار `-sdcard` تلغي ملف بطاقة SD المحدد في AVD. يُرجى العلم أنّ خيار بطاقة SD هذا لن يعمل على أجهزة Mac المزوّدة بخدمة Apple Silicon. يمكنك تصفّح الملفات وإرسال الملفات إليها ونسخها وإزالتها من ملف SD تم محاكاته. بطاقة باستخدام واجهة مستخدم المحاكي أو `adb` أثناء تشغيل الجهاز الافتراضي. لا يمكنك إزالة بطاقة SD تمت محاكاتها. بطاقة من جهاز افتراضي قيد التشغيل. لنسخ الملفات إلى ملف بطاقة SD قبل تحميله، حمِّل الصورة كجهاز تكراري ثم نسخ الملفات. أو استخدم أداة مساعدة مثل `mtools`: لنسخ الملفات مباشرةً إلى الصورة. يتعامل المحاكي مع الملف كمجموعة من وحدات البايت، لذا فإن تنسيق بطاقة SD لا أمر مهم. لا يؤثر الخيار `-wipe-data` في هذا الملف. إذا كنت محو الملف وحذف الملف ثم إعادة إنشائه باستخدام أداة "مدير AVD" أو أداة `mksdcard` تغيير حجم الملف أيضًا حذف الملف وإنشاء ملف جديد.	`-sdcard`

userdata-qemu.img

محتوى قسم البيانات، الذي يظهر كـ data/ في نظام المحاكاة. عند إنشاء متوسّط مدة مشاهدة جديدة أو عند استخدام -wipe-data لإعادة ضبط متوسّط مدة المشاهدة على الإعدادات الأصلية التلقائية، ينسخ المحاكي ملف userdata.img في دليل النظام إلى إنشاء هذا الملف.

يستخدم كل مثيل جهاز افتراضي صورة بيانات مستخدم قابلة للكتابة لتخزين بيانات البيانات المحددة للجلسة. على سبيل المثال، يستخدم الصورة لتخزين صورة وبيانات التطبيقات المثبتة والإعدادات وقواعد البيانات والملفات. كل مستخدم لديه دليل ANDROID_SDK_HOME مختلف يخزِّن أدلة البيانات متوسّط مدة المشاهدة التي أنشأها هذا المستخدم يحتوي كل متوسط مدة مشاهدة على userdata-qemu.img واحدة. الملف.

-data

cache.img صورة قسم ذاكرة التخزين المؤقت، التي تظهر على شكل cache/ في نظام المحاكاة. يكون هذا العمود فارغًا عند إنشاء "متوسّط مدة المشاهدة" لأول مرة أو استخدام الخيار -wipe-data. يخزن ملفات التنزيل المؤقتة بواسطة تطبيق إدارة التنزيل وأحيانًا النظام. على سبيل المثال، المتصفح يُستخدم لتخزين صفحات الويب والصور التي تم تنزيلها مؤقتًا أثناء تشغيل المحاكي الجري. عند إيقاف تشغيل الجهاز الافتراضي، يتم حذف الملف. يمكنك الاحتفاظ بالملف باستخدام الخيار -cache. -cache

sdcard.img

(اختياري) صورة قسم لبطاقة SD تتيح لك محاكاة بطاقة SD بطاقة على جهاز افتراضي. يمكنك إنشاء ملف صورة لبطاقة SD في AVD المدير أو يستخدم mksdcard . الملف مخزن على كمبيوتر التطوير ويجب تحميله على لبدء التشغيل.

عند تحديد AVD في "مدير AVD"، يمكنك اختيار لاستخدام ملف بطاقة SD مُدار تلقائيًا أو ملف أنشأته باستخدام أداة mksdcard. يمكنك عرض ملف sdcard.img المرتبطة بمتوسّط مدة المشاهدة في "مدير متوسّط مدة المشاهدة" الخيار -sdcard تلغي ملف بطاقة SD المحدد في AVD. يُرجى العلم أنّ خيار بطاقة SD هذا لن يعمل على أجهزة Mac المزوّدة بخدمة Apple Silicon.

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

لنسخ الملفات إلى ملف بطاقة SD قبل تحميله، حمِّل الصورة كجهاز تكراري ثم نسخ الملفات. أو استخدم أداة مساعدة مثل mtools: لنسخ الملفات مباشرةً إلى الصورة.

يتعامل المحاكي مع الملف كمجموعة من وحدات البايت، لذا فإن تنسيق بطاقة SD لا أمر مهم.

لا يؤثر الخيار -wipe-data في هذا الملف. إذا كنت محو الملف وحذف الملف ثم إعادة إنشائه باستخدام أداة "مدير AVD" أو أداة mksdcard تغيير حجم الملف أيضًا حذف الملف وإنشاء ملف جديد.

-sdcard

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

يمكنك اكتشاف مكان الملفات بطريقتين:

يمكنك استخدام -verbose أو -debug init عند تشغيل المحاكي من سطر الأوامر. انظر إلى الناتج.

استخدِم الأمر -help-option في emulator لتنفيذ ما يلي: إدراج دليل افتراضي. مثلاً:

emulator -help-datadir

  Use '-datadir <dir>' to specify a directory where writable image files
  will be searched. On this system, the default directory is:

      /Users/me/.android

  See '-help-disk-images' for more information about disk image files.

خيارات بدء تشغيل سطر الأوامر

يسرد هذا القسم الخيارات التي يمكنك توفيرها في سطر الأوامر عند بدء تشغيل المحاكي.

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

الخيارات شائعة الاستخدام

يسرد الجدول التالي خيارات بدء تشغيل سطر الأوامر التي قد تستخدمها كثيرًا:

الجدول 3. خيارات سطر الأوامر شائعة الاستخدام

خيار سطر الأوامر	الوصف
التشغيل السريع
`-no-snapshot-load`	يجري تشغيلاً على البارد ويحفظ حالة المحاكي عند الخروج.
`-no-snapshot-save`	يجري تشغيل سريع إن أمكن، ولكن لا يحفظ حالة المحاكي عند الخروج.
`-no-snapshot`	يؤدي هذا الإجراء إلى إيقاف ميزة "التشغيل السريع" تمامًا وعدم تحميل حالة المحاكي أو حفظها.
معدّات الجهاز
`-camera-back mode` `-camera-front mode`	لضبط وضع المحاكاة لكاميرا مواجهة للخلف أو الأمامية. يؤدي هذا الإجراء إلى إلغاء أي إعداد للكاميرا في متوسّط مدة المشاهدة يمكن أن تكون `mode` أيًّا من القيم التالية: `emulated` - يحاكي المحاكي كاميرا في البرنامج. `webcamn` - يستخدم المحاكي كاميرا ويب متصلة كمبيوتر التطوير، المحدد حسب الرقم. للحصول على قائمة بكاميرات الويب، استخدم الخيار `-webcam-list`. مثلاً: `webcam0` `none`: لإيقاف الكاميرا في الجهاز الافتراضي مثلاً: emulator @Pixel8_API_34 -camera-back webcam0
`-webcam-list`	يسرد كاميرات الويب المتوفرة للمحاكاة على كمبيوتر التطوير. بالنسبة مثال: emulator @Pixel8_API_34 -webcam-list List of web cameras connected to the computer: Camera 'webcam0' is connected to device 'webcam0' on channel 0 using pixel format 'UYVY' في المثال، حرف `webcam0` الأول هو الاسم الذي تستخدمه في سطر الأوامر. `webcam0` الثاني هو الاسم الذي يستخدمه نظام التشغيل على حاسب التطوير. تشير رسالة الأشكال البيانية والاسم الثاني يختلف حسب نظام التشغيل. بدءًا من الإصدار 25.2.4 من أدوات حزمة تطوير البرامج (SDK)، يجب إدخال اسم "متوسّط مدة المشاهدة".
صور القرص والذاكرة
`-memory size`	تحدّد حجم ذاكرة الوصول العشوائي الفعلية، من 1536 إلى 8192 ميغابايت. مثلاً: emulator @Pixel8_API_34 -memory 2048 تلغي هذه القيمة إعدادات "متوسّط مدة المشاهدة".
`-sdcard filepath`	تحدِّد هذه السياسة اسم الملف ومساره إلى ملف صورة التقسيم على بطاقة SD. بالنسبة مثال: emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img إذا لم يتم العثور على الملف، فلا يزال المحاكي يعمل، ولكن بدون بطاقة SD. يعرض الأمر التحذير عدم وجود صورة في بطاقة SD. إذا لم تحدّد هذا الخيار، ستكون القيمة التلقائية `sdcard.img`. في دليل البيانات ما لم يحدِّد AVD شيئًا مختلفًا. للحصول على تفاصيل حول بطاقات SD التي تمت محاكاتها، راجِع دليل بيانات AVD.
`-wipe-data`	يحذف بيانات المستخدمين وينسخ البيانات من ملف البيانات الأولي. هذا الخيار محو بيانات الجهاز الافتراضي وإعادتها إلى الحالة نفسها التي كانت عليها تم تعريفه لأول مرة. تتم إزالة جميع التطبيقات والإعدادات المثبَّتة. مثلاً: emulator @Pixel8_API_34 -wipe-data يكون ملف بيانات المستخدمين تلقائيًا هو `userdata-qemu.img` والحرف الأول من القيمة `userdata.img`. يوجد كلا الملفين في دليل البيانات. لا يؤثر الخيار `-wipe-data` في `sdcard.img`. الملف. لمزيد من المعلومات حول بيانات المستخدم، راجع القسم التعرّف على الأدلة والملفات التلقائية.
تصحيح الأخطاء
`-debug tags`	تتيح هذه السياسة تفعيل عرض رسائل تصحيح الأخطاء لعلامة واحدة أو أكثر أو إيقافها. افصل بين العلامات المتعددة بمسافة أو فاصلة أو عمود. مثلاً: $ emulator @Pixel8_API_34 -debug init,metrics لإيقاف علامة، ضَع شَرطة (-) أمامها. على سبيل المثال، ما يلي يعرض جميع رسائل تصحيح الأخطاء، باستثناء الرسائل المتعلقة بمقابس الشبكة. والمقاييس: `-debug all,-socket,-metrics` للحصول على قائمة بالعلامات والأوصاف، يمكنك استخدام السمة `-help-debug-tags`. الخيار. مثلاً: emulator -help-debug-tags يمكنك تحديد علامات تصحيح الأخطاء التلقائية في `ANDROID_VERBOSE` متغير البيئة. حدِّد العلامات التي تريد استخدامها ضمن قائمة مفصولة بفواصل. إليك مثال يوضّح كيفية تحديد السمة `socket` علامات `gles`: ANDROID_VERBOSE=socket,gles ويعادل استخدام: `-debug-socket -debug-gles` أو `-debug socket,gles`
`-debug-tag` `-debug-no-tag`	تُفعِّل نوع معيَّن من رسائل تصحيح الأخطاء. استخدِم النموذج "`no`" من أجل: إيقاف نوع رسالة تصحيح الأخطاء مثلاً: emulator @Pixel8_API_34 -debug-all -debug-no-metrics للحصول على قائمة بالعلامات، استخدِم الأمر `emulator -help-debug-tags`.
`-logcat logtags`	تتيح هذه السياسة عرض رسائل Logcat لعلامة واحدة أو أكثر وعمليات الكتابة. إلى النافذة الطرفية. على سبيل المثال، الأمر التالي يمكّن رسالة الخطأ رسائل من جميع المكونات: emulator @Pixel8_API_34 -logcat :e يستخدم `logtags` الصيغة نفسها التي يستخدمها الأمر `adb logcat logtags`. يُرجى إدخال `adb logcat -help` للاطّلاع على مزيد من المعلومات. المعلومات. وهي عبارة عن قائمة بفلاتر السجل المفصولة بمسافة أو فاصلة بالتنسيق `componentName:logLevel` `componentName` عبارة عن علامة نجمية حرف بدل (``) أو اسم مكون، مثل `ActivityManager`، `SystemServer`، `InputManager`، أو `WindowManager`. `logLevel` هي إحدى القيم التالية: `v` - مطوَّل `d` - تصحيح الأخطاء `i` - غنية بالمعلومات `w` - مستوى سجل التحذير `e` - خطأ `s` - صامت يعرض المثال التالي رسائل مكون بروتوكول GSM في الصفحة مستوى السجل: emulator @Pixel8_API_34 -logcat '*:s GSM:i' إذا لم توفّر الخيار `-logcat` في سطر الأوامر، سيؤدي ذلك إلى ويبحث المحاكي عن `ANDROID_LOG_TAGS` متغير البيئة. إذا تم تحديد `ANDROID_LOG_TAGS` باستخدام سمة صالحة إنّ القيمة `logtags` ليست فارغة، لأنّ المحاكي يستخدم قيمتها. لتفعيل إخراج Logcat في الوحدة الطرفية تلقائيًا. يمكنك أيضًا إعادة توجيه هي نفسها أو رسائل السجل الأخرى إلى الوحدة الطرفية من خلال `adb`. لمزيد من المعلومات، معلومات حول Logcat و`adb`، راجِع Logcat أداة سطر الأوامر، عرض وكتابة السجلّات باستخدام Logcat و`Log` ومعرّف الإصدار: الطلبات.
`-show-kernel`	يعرض رسائل تصحيح أخطاء النواة في النافذة الطرفية. مثلاً: emulator @Pixel8_API_34 -show-kernel ومن بين استخدامات هذا الخيار التحقق من أن عملية التمهيد تعمل بشكل صحيح.
`-verbose`	يطبع رسائل إعداد المحاكي في النافذة الطرفية. بالنسبة مثال: emulator @Pixel8_API_34 -verbose وهي تعرض الملفات والإعدادات التي يتم تحديدها بالفعل عند بدء جهاز افتراضي محدّد في متوسّط مدة المشاهدة. يشبه هذا الخيار تحديد `-debug-init`
الشبكة
`-dns-server servers`	تستخدم خوادم نظام أسماء النطاقات المحدّدة. `servers` هو قائمة مفصولة بفاصلة تضم ما يصل إلى أربعة أسماء لخوادم نظام أسماء النطاقات أو عناوين IP. بالنسبة مثال: emulator @Pixel8_API_34 -dns-server 192.0.2.0, 192.0.2.255 يحاول المحاكي بشكل تلقائي اكتشاف خوادم نظام أسماء النطاقات التي تستخدمها ويضبطها أسماء مستعارة خاصة في شبكة جدار الحماية التي تتم محاكاتها للسماح لنظام Android للاتصال مباشرةً بالخوادم. استخدِم الخيار `-dns-server` لتحديد قائمة مختلفة بخوادم نظام أسماء النطاقات.
`-http-proxy proxy`	يجعل جميع اتصالات TCP من خلال خادم وكيل HTTP/HTTPS محددًا. إذا كان إلى الإنترنت عن طريق خادم وكيل، يمكنك استخدام هذا أو متغير البيئة `http_proxy` لإعداد على عملية إعادة التوجيه المناسبة. مثلاً: emulator @Pixel8_API_34 -http-proxy myserver:1981 يمكن أن يكون `proxy` أحد التالي: `http://server:port` `http://username:password@server:port` تشير رسالة الأشكال البيانية يمكن حذف البادئة `http://`. وفي حال عدم توفّر هذا الخيار، يبحث المحاكي عن عنوان URL الخاص بـ `http_proxy`. متغير البيئة ويستخدم تلقائيًا أي قيمة تتطابق مع تنسيق `proxy` لمزيد من المعلومات، راجع استخدام باستخدام خادم وكيل.
`-netdelay delay`	يتم ضبط محاكاة وقت استجابة الشبكة على أحد الخيارات التالية: قيم `delay` بالمللي ثانية: `gsm` - بروتوكول GSM/CSD (الحد الأدنى 150 وحد أقصى 550) `hscsd` - HSCSD (80 كحد أدنى، 400 كحد أقصى). `gprs` - شبكة GPRS (35 كحد أدنى، 200 كحد أقصى). `edge` - EDGE/EGPRS (80 كحد أدنى، 400 كحد أقصى). `umts`: النظام العالمي لاتصالات الجوال عن بعد (UMTS)/شبكة الجيل الثالث (35) (35 كحد أدنى، 200 كحد أقصى). `hsdpa` - HSDPA (الحد الأدنى 0، الحد الأقصى 0). `lte` - LTE (الحد الأدنى 0، الحد الأقصى 0) `evdo` - EVDO (الحد الأدنى 0، الحد الأقصى 0) `none` - ليس هناك وقت استجابة، وهو الخيار التلقائي (الحد الأدنى 0، الحد الأقصى 0). `num` - يحدد وقت الاستجابة بدقة. `min:max` - لتحديد الحد الأدنى للفرد و وأقصى وقت استجابة. مثلاً: emulator @Pixel8_API_34 -netdelay gsm ويتيح المحاكي التحكم في الشبكة بالإضافة إلى توفير وقت استجابة أعلى للاتصال. ويمكنك تحديده إما من خلال شكل المظهر أو باستخدام الخياران `‑netspeed` و`-netdelay`
`-netfast`	لإيقاف تقييد الشبكة. مثلاً: emulator @Pixel8_API_34 -netfast يشبه هذا الخيار تحديد `-netspeed full -netdelay none`. وهذه هي القيم التلقائية لهذه الخيارات.
`-netspeed speed`	تضبط هذه السياسة محاكاة سرعة الشبكة. يحدد الحد الأقصى للتحميل إلى الشبكة سرعات التنزيل بإحدى قيم `speed` التالية في كيلوبت في الثانية: `gsm` - بروتوكول GSM/CSD (أعلى: 14.4، أقل: 14.4) `hscsd` - HSCSD (أعلى: 14.4، أدنى: 57.6). `gprs` - شبكة GPRS (أعلى: 28.8، أدنى: 57.6). `edge` - EDGE/EGPRS (أعلى: 473.6، أسفل: 473.6) `umts` - النظام العالمي لاتصالات الجوّال عن بُعد (UMTS) /3G (أعلى: 384.0، أسفل: 384.0) `hsdpa` - HSDPA (أعلى: 5760.0، أدنى: 13,980.0). `lte` - LTE (أعلى: 58,000، انخفاض: 173,000) `evdo` - EVDO (ارتفاع: 75,000، انخفاض: 280,000) `full` - بدون حد أقصى، الإعداد التلقائي (أعلى: 0.0، أدنى: 0.0). `num`: تحدّد هذه السمة سرعة التحميل والتنزيل. `up:down` - لتحديد الشخص للأعلى وللأسفل والسرعة. مثلاً: emulator @Pixel8_API_34 -netspeed edge ويتيح المحاكي التحكم في الشبكة بالإضافة إلى توفير وقت استجابة أعلى للاتصال. ويمكنك تحديده إما من خلال شكل المظهر أو باستخدام الخياران `‑netspeed` و`-netdelay`
`-port port`	تحدِّد هذه السياسة رقم منفذ TCP المُستخدَم لوحدة التحكّم و`adb`. مثلاً: emulator @Pixel8_API_34 -port 5556 القيمة التلقائية هي 5554 لأول مثيل جهاز افتراضي يتم تشغيله على جهازك. يشغل الجهاز الافتراضي عادةً منفذين متجاورين: منفذ وحدة التحكّم ومنفذ `adb`. وحدة التحكم الخاصة بأول جهاز افتراضي يعمل على جهاز معين يستخدم المنفذين 5554 و`adb` الخاصين بوحدة التحكم 5555. التالي الحالات تستخدم أرقام المنافذ لزيادة عدد المنافذ بمقدار اثنين. على سبيل المثال، 5556/5557، 5558/5559 وهكذا. ويتراوح النطاق من 5554 إلى 5682، مما يسمح بـ 64 نتيجة متزامنة أجهزة افتراضية. غالبًا ما تكون عمليات تخصيص المنافذ مماثلة لتحديد `-ports port,{port + 1}`. يجب على `{port + 1}` أن يكون مجانيًا ومحفوظًا لمدة `adb`. إذا كان أي من منافذ وحدة التحكّم أو `adb` قيد الاستخدام بالفعل، فلن يبدأ المحاكي. الخيار `‑port` الإبلاغ عن المنافذ والرقم التسلسلي الذي يستخدمه الجهاز الافتراضي وإرسال تحذير في حال هناك أي مشاكل في القيم التي قدّمتها. في واجهة مستخدم المحاكي، يمكنك الاطّلاع على رقم منفذ وحدة التحكّم في عنوان النافذة وعرض منفذ `adb` عن طريق اختيار مساعدة > لمحة. تجدر الإشارة إلى أنّه إذا كانت قيمة `port` غير زوجية وكانت في النطاق من 5554 إلى 5584، سيبدأ الجهاز الافتراضي ولكنه لن يكون مرئيًا عندما استخدِم الأمر `adb devices`، إذا بدأ `adb server` بعد المحاكي. لهذا السبب، ننصح باستخدام رقم منفذ زوجي في وحدة التحكّم.
`-ports console-port,adb-port`	تحدِّد هذه السياسة منافذ TCP المستخدَمة في وحدة التحكّم و`adb`. مثلاً: emulator @Pixel8_API_34 -ports 5556,5559 يتراوح نطاق المنافذ الصالحة بين 5554 و5682، مما يسمح بـ 64 منافذ افتراضية متزامنة. الأجهزة. يحدد الخيار `-ports` نوع المنافذ والرقم التسلسلي. يستخدمه المحاكي ويحذّر إذا كانت هناك أي مشاكل في والقيم التي قدمتها. وننصح باستخدام الخيار `-port` بدلاً من ذلك، حيثما أمكن. تشير رسالة الأشكال البيانية يتوفر الخيار `-ports` لإعدادات الشبكة التي تتطلب إعدادات خاصة. لمزيد من المعلومات حول ضبط وحدة التحكّم ومنافذ `adb`، يُرجى الاطّلاع على الخيار `-port`
`-tcpdump filepath`	يلتقط حزم الشبكة ويخزّنها في ملف. مثلاً: emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap استخدم هذا الخيار لبدء التقاط جميع حزم الشبكة المرسلة عبر شبكة LAN افتراضية إيثرنت للمحاكي. بعد ذلك، يمكنك استخدام أداة مثل Wireshark لتحليل عدد الزيارات. لاحظ أن هذا الخيار يلتقط جميع حزم إيثرنت ولا يقتصر على بروتوكول التحكم بالنقل الاتصالات.
النظام
`-accel mode`	تضبط هذه السياسة تسريع الأجهزة الافتراضية الخاصة بالمحاكي. مثلاً: emulator @Pixel8_API_34 -accel auto تعمل ميزة المحاكاة المسرّعة مع صور النظام بتنسيقات x86 وx86_64 فقط. وفي نظام التشغيل Linux، يعتمد على KVM. يعتمد النظام في نظامي التشغيل Windows وMac على وحدة المعالجة المركزية من Intel وIntel HAXM السائق. ويتم تجاهل هذا الخيار إذا كنت لا تحاكي جهازًا يعمل بمعيارَي x86 أو x86_64. القيم الصالحة لـ `mode` هي: `auto` - يحدّد تلقائيًا ما إذا كان التسريع متاحًا أم لا وتستخدمها عند الإمكان (الإعداد التلقائي). `off` - لإيقاف التسريع تمامًا، والذي يكون مفيدًا في المقام الأول لتصحيح الأخطاء. `on`: لفرض التسريع. إذا لم يتم تثبيت KVM أو HAXM أو للاستخدام، فلن يبدأ المحاكي ويطبع رسالة خطأ. لمزيد من المعلومات، راجع إعداد تسريع الأجهزة لمحاكي Android
`-accel-check`	يتحقّق مما إذا كان برنامج Hypervisor (مراقب الأجهزة الظاهرية) المطلوب لتسريع الجهاز الافتراضي (VM) للمحاكي (HAXM أو KVM). مثلاً: emulator -accel-check لمزيد من المعلومات، يُرجى الاطِّلاع على التحقُّق من تثبيت برنامج Hypervisor (مراقب الأجهزة الظاهرية).
`-engine engine`	تحدِّد هذه السياسة محرّك المحاكي: `auto`: يختار أحد المحرّكات تلقائيًا (الإعداد التلقائي). `classic` - لاستخدام محرك QEMU 1 القديم (متوقف). `qemu2`: يستخدم محرّك QEMU 2 الأحدث. مثلاً: emulator @Pixel8_API_34 -engine auto يجب أن يختار الرصد التلقائي القيمة التي توفر أفضل أداء في حال لمحاكاة متوسّط مدة مشاهدة معيّنة استخدِم الخيار `-engine` لأغراض تصحيح الأخطاء والمقارنة فقط.
`-gpu mode`	يختار وضع محاكاة وحدة معالجة الرسومات. مثلاً: emulator @Pixel8_API_34 -gpu swiftshader_indirect لمزيد من المعلومات، يُرجى الاطّلاع على ضبط ميزة "تسريع الرسومات".
`-no-accel`	لإيقاف تسريع الجهاز الافتراضي (VM) المحاكي عند استخدام نظام التشغيل x86 أو x86_64 . وهي مفيدة لتصحيح الأخطاء فقط وتماثل استخدامها لتحديد `-accel off`. مثلاً: emulator @Pixel8_API_34 -no-accel لمزيد من المعلومات، راجع إعداد تسريع الأجهزة لمحاكي Android
`-nojni` `-no-jni`	لإيقاف عمليات فحص واجهة Java الأصلية (JNI) الموسّعة في Android Dalvik أو ART. مثلاً: emulator @Pixel8_API_34 -nojni عند بدء تشغيل جهاز افتراضي، يتم تلقائيًا تفعيل عمليات التحقّق الممتدة من JNI. بالنسبة مزيد من المعلومات، يُرجى مراجعة JNI النصائح.
`-selinux {disabled\|permissive}`	ضبط نظام التشغيل Linux المعزز للأمان (SELinux) إلى الوضع `disabled` أو `permissive` على جهاز يعمل بنظام التشغيل Linux . مثلاً: me-linux$ emulator @Pixel8_API_34 -selinux permissive تكون SELinux في وضع `enforcing` تلقائيًا، ما يعني أنّ سياسة الأمان هي الفرضية. يُحمِّل الوضع `permissive` سياسة SELinux، ولكن لا يحمِّلها. وتنفيذه. يسجِّل هذا الخيار انتهاكات السياسة فقط. إيقاف وضع `disabled` دعم النواة لنظام SELinux.
`-timezone timezone`	تضبط هذه السياسة المنطقة الزمنية للجهاز الافتراضي. `timezone` بدلاً من المنطقة الزمنية للمضيف. بالنسبة مثال: emulator @Pixel8_API_34 -timezone Europe/Paris ويستخدم المحاكي تلقائيًا المنطقة الزمنية لجهاز كمبيوتر التطوير. استخدام هذا الخيار لتحديد منطقة زمنية مختلفة أو إذا لم يكن الاكتشاف التلقائي يعمل بشكل صحيح. يجب إدخال القيمة `timezone` ضمن zoneinfo. وهو `area/location` أو `area/subarea/location` مثلاً: `America/Los_Angeles` `Europe/Paris` `America/Argentina/Buenos_Aires` يجب أن تكون المنطقة الزمنية المحدّدة في قاعدة بيانات Zoneinfo.
`-version`	يعرض رقم إصدار المحاكي. مثلاً: emulator @Pixel8_API_34 -version أو emulator -version
واجهة المستخدم
`-no-boot-anim`	لإيقاف الرسوم المتحركة لبدء التشغيل أثناء بدء تشغيل المحاكي للتشغيل بشكل أسرع. مثلاً: emulator @Pixel8_API_34 -no-boot-anim في أجهزة الكمبيوتر الأبطأ، يمكن أن يؤدي هذا الخيار إلى تسريع تسلسل التمهيد بشكل كبير.
`-screen mode`	تضبط هذه السياسة وضع المحاكاة للشاشة التي تعمل باللمس. مثلاً: emulator @Pixel8_API_34 -screen no-touch يمكن أن تكون `mode` أيًّا من القيم التالية: `touch`: يحاكي شاشة تعمل باللمس (الإعداد التلقائي). `multi-touch`: لمحاكاة شاشة تعمل باللمس المتعدّد. `no-touch` - يوقف الشاشة التي تعمل باللمس وشاشة اللمس المتعدد. عملية المحاكاة.

الخيارات المتقدمة

تتوفر خيارات بدء تشغيل سطر الأوامر في الجدول التالي، ولكنها غير شائعة الاستخدام. بواسطة مطور التطبيقات العادي.

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

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

الجدول 4. الخيارات المتقدمة لسطر الأوامر

الخيار المتقدم	وصف قصير
`-bootchart timeout`	لتفعيل التمهيد مع انتهاء المهلة بالثواني. بعض أنظمة Android تحتوي الصور على نظام إعداد مُعدَّل يدمج منشأة تمهيد بدء التشغيل. يمكنك تمرير فترة مهلة بدء التشغيل إلى النظام باستخدام هذا الخيار. إذا كان نظام init لم يتم تفعيل ميزة بدء التشغيل، فإن هذا الخيار لا يؤدي إلى أي شيء. هذا الخيار يكون مفيدًا في المقام الأول لمطوّري الأنظمة الأساسية، وليس لمطوّري التطبيقات الخارجيين مثلاً: emulator @Pixel8_API_34 -bootchart 120
`-cache filepath`	تحدِّد هذه السياسة ملف صورة قسم ذاكرة التخزين المؤقت. توفر اسم ملف وقيمة مطلقة مسار أو مسار مرتبط بدليل البيانات لإعداد ذاكرة تخزين مؤقت دائمة الملف. وإذا لم يكن الملف موجودًا، فسينشئه المحاكي كملف فارغ. مثلاً: emulator @Pixel8_API_34 -cache ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img إذا لم تستخدم هذا الخيار، فسيكون الملف الافتراضي هو ملف مؤقت يُسمى `cache.img` لمزيد من المعلومات، يُرجى الاطّلاع على بيانات متوسّط مدة المشاهدة. الدليل.
`-cache-size size`	لضبط حجم قسم ذاكرة التخزين المؤقت بالميغابايت. مثلاً: emulator @Pixel8_API_34 -cache-size 1000 إذا لم تحدد لنحدد هذا الخيار، تكون القيمة التلقائية 66 ميغابايت. عادةً، لا يحتاج معظم مطوّري التطبيقات إلى هذا الخيار، ما لم يحتاجوا إلى تنزيل ملفات كبيرة جدًا أكبر من الحجم التلقائي ذاكرة التخزين المؤقت. لمزيد من المعلومات عن ذاكرة التخزين المؤقت يُرجى الاطّلاع على دليل بيانات AVD.
`-data filepath`	تضبط هذه السياسة ملف الصورة في قسم بيانات المستخدمين. توفر اسم ملف مسار مطلق أو مسار مرتبط بدليل العمل لإعداد ملف بيانات مستخدم دائم. إذا لم يكن الملف موجودًا، فسينشئ المحاكي ملف صورة من ملف `userdata.img` التلقائي، وتخزّنها في اسم الملف الذي حددته، وتبقى بيانات المستخدم إليه عند إيقاف التشغيل. مثلاً: emulator @Pixel8_API_34 -data ~/.android/avd/Pixel8_API_34.avd/userdata-test.img إذا لم تستخدم هذا الخيار، سيكون الملف التلقائي هو ملف باسم "`userdata-qemu.img`". لمزيد من المعلومات حول ملف بيانات المستخدمين، راجِع بيانات متوسّط مدة المشاهدة. الدليل.
`-datadir dir`	تحدّد هذه السمة دليل بيانات باستخدام مسار مطلق. لمزيد من المعلومات راجِع دليل بيانات AVD. مثلاً: emulator @Pixel8_API_34 -datadir ~/.android/avd/Pixel8_API_34.avd/mytest
`-force-32bit`	يستخدم المحاكي إصدار 32 بت على أنظمة أساسية 64 بت. في بعض الأحيان، يكون هذا الخيار مفيدًا للاختبار أو تصحيح الأخطاء. على سبيل المثال، كانت هناك مشكلة حيث لا يعمل المحاكي أحيانًا على نظام التشغيل Windows إصدار 64 بت، لكن كان الإصدار 32 بت يعمل. هذا النمط مفيدًا لإجراء مقارنات لتصحيح المشكلة. إليك مثال: emulator @Pixel8_API_34 -force-32bit
`-help-disk-images`	الحصول على مساعدة بشأن صور القرص. يوفر هذا الخيار معلومات ذات صلة مطوري التطبيقات والنظام الأساسي على حد سواء. مثلاً: emulator -help-disk-images
`-help-char-devices`	يمكن الحصول على مساعدة بشأن مواصفات الأحرف `device`. حاسمة تتطلب بعض خيارات المحاكي معلمة `device`. مثلاً: emulator -help-char-devices
`-help-sdk-images`	يحصل على مساعدة حول صور الأقراص ذات الصلة بمطوّري التطبيقات. يجعل هذا الخيار معلومات حول مكان ملفات الصور لـ AVD تم إنشاؤه باستخدام وأدوات حزمة تطوير البرامج (SDK). مثلاً: emulator -help-sdk-images
`-help-build-images`	يحصل على مساعدة حول صور الأقراص ذات الصلة بمطوري النظام الأساسي. مثلاً: emulator -help-build-images
`-initdata filepath` `-init-data filepath`	تحدِّد هذه السياسة الإصدار الأولي من قسم البيانات. بعد المسح بيانات المستخدم، ينسخ المحاكي محتوى الملف المحدد إلى المستخدم (ملف `userdata-qemu.img` بشكل تلقائي) بدلاً من استخدام `userdata.img` الافتراضي كإصدار أولي. تحدد اسم ملف ومسار مطلق أو مسار مرتبط بدليل العمل. مثلاً: emulator @Pixel8_API_34 -initdata ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/userdata-test.img في حال عدم تحديد مسار، سيتم وضع الملف في دليل النظام. لمزيد من المعلومات، للحصول على معلومات، راجِع دليل نظام AVD.
`-kernel filepath`	يستخدم نواة محددة تمت محاكاتها. إذا لم تحدد مسارًا، سيستخدم المحاكي البحث في دليل النظام. يمكنك استخدام خيار `‑show‑kernel` لعرض رسائل تصحيح أخطاء النواة. مثلاً: emulator @Pixel8_API_34 -kernel ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/kernel-test.img -show-kernel إذا لم تحدّد هذا الخيار، ستكون القيمة التلقائية `kernel-ranchu`. لمزيد من المعلومات، للحصول على معلومات، راجِع دليل نظام AVD.
`-noaudio` `-no-audio`	لإيقاف دعم الصوت لهذا الجهاز الافتراضي. بعض أنظمة التشغيل Linux وWindows أجهزة الكمبيوتر بها برامج تشغيل صوت خاطئة تسبب أعراضًا مختلفة، مثل مما يمنع المحاكي من البدء. في هذه الحالة، استخدم هذا الخيار التغلب على المشكلة. ويمكنك بدلاً من ذلك استخدام `QEMU_AUDIO_DRV`. متغير البيئة لتغيير الواجهة الخلفية للصوت. مثلاً: emulator @Pixel8_API_34 -noaudio
`-nocache` `-no-cache`	ويتم تشغيل المحاكي بدون قسم لذاكرة التخزين المؤقت. إذا كنت لا تستخدم هذا يكون الملف التلقائي هو ملف مؤقت باسم `cache.img`. هذا النمط لمطوّري النظام الأساسي فقط. لمزيد من المعلومات، راجِع دليل بيانات AVD. مثلاً: emulator @Pixel8_API_34 -nocache
`-no-snapshot`	تحظر عمليات التحميل التلقائية والحفظ معًا، ما يتسبّب في ظهور المحاكي لتنفيذ تسلسل تشغيل كامل وفقدان حالته عند إغلاقه. يلغي الخيار `-snapshot`. مثلاً: emulator @Pixel8_API_34 -no-snapshot
`-no-snapshot-load`	تمنع هذه السياسة المحاكي من تحميل حالة AVD من مساحة تخزين اللقطات. يؤدي هذا الإجراء إلى إتمام تشغيل كامل. مثلاً: emulator @Pixel8_API_34 -no-snapshot-load
`-no-snapshot-save`	تمنع هذه السياسة المحاكي من حفظ حالة "متوسّط مدة المشاهدة" في مساحة تخزين اللقطات. خروج، مما يعني أنه سيتم فقد جميع التغييرات. مثلاً: emulator @Pixel8_API_34 -no-snapshot-save
`-no-snapshot-update-time`	لا تحاول تصحيح وقت ساعة "متوسّط مدة المشاهدة" فورًا عند استعادة اللقطة. يمكن أن يكون هذا الخيار مفيدًا أثناء الاختبار لأنه يتجنب قفزة زمنية مفاجئة. سيستمر إرسال التعديلات المتعلقة بالوقت إلى متوسّط مدة المشاهدة كل 15 ثانية تقريبًا. مثلاً: emulator @Pixel8_API_34 -no-snapshot-update-time
`-no-snapstorage`	بدء المحاكي بدون تحميل ملف لتخزين حالته أو تحميله لقطات، مما يفرض تشغيلاً كاملاً ويعطِّل وظيفة لقطة الحالة. هذا النمط يلغي هذا الخيار `-snapstorage` و`-snapshot` الخيارات. مثلاً: emulator @Pixel8_API_34 -no-snapstorage
`-no-window`	لإيقاف عرض النافذة الرسومية على المحاكي. هذا الخيار مفيد عند تشغيل المحاكي على خوادم لا تحتوي على شاشة عرض. يمكنك الوصول إلى المحاكي من خلال `adb` أو وحدة التحكّم مثلاً: emulator @Pixel8_API_34 -no-window
`-partition-size size`	تحدِّد هذه السياسة حجم قسم بيانات النظام بالميغابايت. مثلاً: emulator @Pixel8_API_34 -partition-size 1024
`-prop name=value`	تضبط هذه السياسة خاصية نظام Android في المحاكي عند بدء تشغيله. يجب أن يكون `name` اسم موقع إلكتروني مصنّفًا على أنّه `qemu_prop` من أصل 32 حرفًا، بدون أي مسافات، و`value` يجب أن تكون سلسلة من أكثر من 92 حرفًا. على سبيل المثال، راجع ملف `property_contexts`. يمكنك تحديد عدة خيارات `‑prop` على عنوان واحد. سطر الأوامر. يمكن أن يكون هذا الخيار مفيدًا لتصحيح الأخطاء. مثلاً: emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz
`-qemu args`	تمرير الوسيطات إلى برنامج محاكي QEMU عند استخدام هذا الخيار، تأكد من أنه آخر تم تحديد جميع الخيارات بعد أن يتم تفسيرها على أنها خاصة بـ QEMU الخيارات. هذا الخيار متقدم جدًا ويجب استخدامه فقط من قِبل المطورين الذين لديهم دراية كبيرة بميزة QEMU ومحاكاة Android.
`-qemu -h`	عرض مساعدة "`-qemu`" مثلاً: emulator -qemu -h
`-ramdisk filepath`	تُستخدَم لتحديد صورة تشغيل RAMdisk. تحدّد هذه السياسة اسم الملف ومسارًا مطلقًا. أو مسار مرتبط بدليل العمل. مثلاً: emulator @Pixel8_API_34 -ramdisk ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/ramdisk-test.img إذا لم تستخدم هذا الخيار، فسيتم هو ملف `ramdisk.img` في دليل النظام التلقائي. لمزيد من المعلومات، للحصول على معلومات، راجِع دليل نظام AVD.
`-report-console socket`	إبلاغ جهة خارجية بعيدة عن منفذ وحدة التحكّم قبل البدء عملية المحاكاة. يمكن أن يكون مفيدًا لنص اختبار تلقائي. على "`socket`" استخدام أحد هذه الإشعارات. التنسيقات: `tcp:port[,server][,max=seconds][,ipv6]` `unix:port[,server][,max=seconds][,ipv6]` لمزيد من المعلومات، استخدِم الخيار `-help-report-console` كما هو موضّح في المساعدة بشأن خيارات محددة.
`-shell`	تنشئ وحدة تحكم هيكل جذر في الوحدة الطرفية الحالية. ويختلف هذا الخيار عن `adb shell` بالطرق التالية: فهي تنشئ هيكل جذر يتيح لك تعديل أجزاء كثيرة من . وتعمل حتى إذا كانت "`adb daemon`" في نظام المحاكاة معطَّلة. اضغط على Control+C (أو Command-C على نظام التشغيل macOS) لإيقاف المحاكي بدلاً من المحاكي. مثلاً: emulator @Pixel8_API_34 -shell
`-snapshot name`	تُحدِّد هذه السياسة اسم لقطة ضمن ملف تخزين النبذة تلقائيًا على بدء العمليات وحفظها. بدلاً من تنفيذ تسلسل تمهيد كامل، استئناف تنفيذه من لقطة حالة سابقة، وهي بشكل أسرع بكثير. عند توفير هذا الخيار، لن يتمكن المحاكي من خلال تحميل اللقطة لهذا الاسم من صورة اللقطة وحفظها مرة أخرى تحت الاسم نفسه عند الخروج. إذا لم تستخدم هذا الخيار، فإن الإعداد الافتراضي هو تسلسل تمهيد كامل. إذا لم تكن اللقطة المحددة موجودة، ينفِّذ المحاكي تسلسل تشغيل كاملاً بدلاً من ذلك، حفظ البيانات. يمكنك الاطّلاع على الخيار `-snapstorage` للحصول على معلومات حول لتحديد ملف تخزين لقطة والملف الافتراضي. emulator @Pixel8_API_34 -snapshot snapshot2 تذكر أنه أثناء تحميل لقطة، يتم استبدال جميع محتويات النظام وبيانات المستخدم وصور بطاقة SD بالمحتوى الذي احتفظوا به عند إنشاء اللقطة. ما لم يتم الحفظ هذه المعلومات في لقطة مختلفة، ستُفقد أي تغييرات منذ ذلك الحين. يمكنك أيضًا إنشاء لقطة من وحدة التحكم المحاكية باستخدام الأمر `avd snapshot save name`. لمزيد من المعلومات، يُرجى مراجعة أرسِل أوامر وحدة تحكُّم المحاكي.
`-snapshot-list`	تعرِض قائمة باللقطات المتاحة. يطبع هذا الأمر جدولاً للقطات. التي يتم تخزينها في ملف تخزين اللقطات الذي تم بدء تشغيل المحاكي فيه مع ثم يخرج. إذا حدّدت السمة `-snapstorage file` فإن هذا الأمر يطبع كذلك جدول اللقطات المخزنة في ملف. مثلاً: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img يمكنك استخدام قيم عمود ID وTAG في الإخراج كوسيطات للخيار `-snapshot`.
`-snapstorage filepath`	تُحدِّد ملف مستودع يحتوي على جميع لقطات الحالة. الكل اللقطات التي تم إجراؤها أثناء التنفيذ يتم حفظها في هذا الملف. فقط ويمكن استعادة اللقطات في هذا الملف أثناء تشغيل المحاكي. مثلاً: emulator @Pixel8_API_34 -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img إذا لم تحدّد هذا الخيار، ستكون القيمة التلقائية هي `snapshots.img` في البيانات. الدليل. إذا لم يكن الملف المحدد موجودًا، فسيبدأ المحاكي، ولكن بدون توفير إمكانية حفظ أو تحميل لقطات الحالة.
`-sysdir dir`	تحدِّد هذه السياسة دليل نظام باستخدام مسار مطلق. لمزيد من المعلومات راجِع دليل نظام AVD. مثلاً: emulator @Pixel8_API_34 -sysdir ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/test
`-system filepath`	تحدِّد هذه السياسة ملف نظام مبدئيًا. توفر اسم الملف ومسارًا مطلقًا أو مسار مرتبط بدليل العمل. مثلاً: emulator @Pixel8_API_34 -system ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/system-test.img إذا لم تستخدم هذا الخيار، فسيتم هو ملف `system.img` في دليل النظام التلقائي. لمزيد من المعلومات، للحصول على معلومات، راجِع دليل نظام AVD.
`-use-system-libs`	على نظام التشغيل Linux، يتم استخدام نظام `libstdc++` بدلاً من الإصدار المجمّع. باستخدام نظام المحاكي. لا تستخدم هذا الخيار إلا في حالة عدم تشغيل المحاكي بشكل طبيعي، و لاحظ أنها لا تعمل دائمًا. وبدلاً من ذلك، يمكنك ضبط متغير البيئة `ANDROID_EMULATOR_USE_SYSTEM_LIBS` إلى 1. مثلاً: me-linux$ emulator @Pixel8_API_34 -use-system-libs
`-writable-system`	استخدِم هذا الخيار للحصول على صورة نظام قابلة للكتابة أثناء جلسة المحاكاة. لإجراء ذلك: ويمكنك تشغيل جهاز افتراضي باستخدام الخيار "`-writable-system`". أدخِل الأمر `adb remount` من الوحدة الطرفية للأوامر لإخباره. إعادة تثبيت `system/` في وضع القراءة/الكتابة. بشكل افتراضي، يتم تثبيته للقراءة فقط. يؤدي استخدام هذه العلامة إلى إنشاء نسخة مؤقتة من صورة النظام قد يصل حجمها إلى مئات الميغابايت، ولكن ستتم تدميرها عندما يغير المحاكي .

الخيارات التي تم إيقافها نهائيًا

تم إيقاف خيارات سطر الأوامر التالية:

-audio-in
-audio-out
-charmap
-code-profile
-cpu-delay
-dpi-device
-dynamic_skin
-enable-kvm
-gps
-image
-keyset
-help-keys
-help-keyset-file
-nand-limits
-noskin
-no-skin
-onion
-onion-alpha
-onion-rotation
-radio
-ranchu
-raw-keys
-scale
-shared-net-id
-shell-serial
-skin
-skindir
-trace
-useaudio

الحصول على مساعدة بشأن خيارات سطر الأوامر

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

عرض جميع خيارات المحاكي

لطباعة قائمة بجميع خيارات المحاكي، بما في ذلك وصف موجز، أدخل الأمر التالي:

emulator -help

الحصول على مساعدة تفصيلية بشأن خيار محدَّد

لطباعة المساعدة لخيار بدء تشغيل معين، أدخل الأمر التالي:

emulator -help-option

مثلاً:

emulator -help-netspeed

وهذه المساعدة أكثر تفصيلاً من الوصف المقدم من الخيار -help.

الحصول على مساعدة تفصيلية بشأن جميع الخيارات

للحصول على مساعدة مفصلة حول جميع خيارات المحاكي، أدخل الأمر التالي:

emulator -help-all

سرد متغيّرات بيئة المحاكي

للحصول على قائمة بمتغيرات بيئة المحاكي، أدخِل الأمر التالي:

emulator -help-environment

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

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

لطباعة قائمة بالعلامات لخيارات -debug، أدخِل الأمر التالي:

emulator -help-debug-tags

تتيح لك خيارات -debug تفعيل رسائل تصحيح الأخطاء من مكونات محددة للمحاكي، على النحو المحدد بواسطة العلامات.