تتضمن حزمة تطوير البرامج (SDK) لنظام التشغيل Android محاكيًا لجهاز Android، وهو جهاز افتراضي يعمل على جهاز الكمبيوتر. يتيح لك محاكي Android تطوير تطبيقات Android واختبارها بدون استخدام جهاز فعلي.
تصف هذه الصفحة ميزات سطر الأوامر التي يمكنك استخدامها مع Android Emulator. للحصول على معلومات عن استخدام واجهة مستخدم محاكي Android، يمكنك الاطّلاع على تشغيل التطبيقات على محاكي Android.
بدء المحاكي
استخدِم الأمر emulator
لتشغيل المحاكي بدلاً من
تشغيل مشروعك أو
تشغيله من خلال "مدير AVD".
إليك بناء الجملة الأساسي لسطر الأوامر لبدء جهاز افتراضي من موجه طرفي:
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 التي يستخدمها المحاكي لمحاكاة نظام التشغيل. يحتوي هذا الدليل على ملفات للقراءة فقط خاصة بالنظام الأساسي ومشتركة بين جميع AVD من النوع نفسه، بما في ذلك مستوى واجهة برمجة التطبيقات وبنية وحدة المعالجة المركزية (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
لتحديد دليل نظام مختلف
لـ AVD.
يقرأ المحاكي الملفات التالية من دليل النظام:
الملف | الوصف | خيار تحديد ملف مختلف |
---|---|---|
kernel-qemu أو kernel-ranchu
|
تشير هذه السمة إلى صورة النواة الثنائية لـ AVD. يستند kernel-ranchu إلى
محاكي QEMU.
|
-kernel
|
ramdisk.img
|
صورة قسم التشغيل هذه مجموعة فرعية من system.img يتم تحميلها
بواسطة النواة مبدئيًا قبل تثبيت صورة النظام. وعادة ما يحتوي على عدد قليل من البرامج الثنائية والنصوص البرمجية للتهيئة.
|
-ramdisk
|
system.img
|
تمثّل هذه السمة النسخة الأولية للقراءة فقط من صورة النظام. وعلى وجه التحديد، القسم الذي يحتوي على مكتبات النظام وبياناته المقابلة لمستوى واجهة برمجة التطبيقات والسعر المتغير. | -system
|
userdata.img
|
تعرض هذه السمة الإصدار الأولي من قسم البيانات الذي يظهر على شكل
data/ في النظام الذي تمت محاكاته ويحتوي على جميع البيانات القابلة للكتابة
لمتوسّط مدة المشاهدة. ويستخدم المحاكي هذا الملف عند إنشاء متوسّط مدة مشاهدة (AVD) جديد أو استخدام الخيار
‑wipe-data . لمزيد من المعلومات، اطّلِع على
وصف ملف userdata-qemu.img في القسم التالي.
|
-initdata
-init-data
|
دليل بيانات AVD
إنّ دليل بيانات متوسّط مدة المشاهدة، والذي يُعرف أيضًا باسم دليل المحتوى، مخصَّص لمثيل واحد من متوسّط مدة المشاهدة والذي يتضمّن جميع البيانات القابلة للتعديل.
والموقع التلقائي هو ما يلي، حيث يكون name
هو اسم متوسّط مدة المشاهدة:
- نظاما التشغيل macOS وLinux -
~/.android/avd/name.avd/
- Windows 10 والإصدارات الأحدث -
C:\Users\user\.android\name.avd\
استخدِم الخيار -datadir
لتحديد دليل بيانات AVD مختلف.
يسرد الجدول التالي أهم الملفات المضمَّنة في هذا الدليل:
الملف | الوصف | خيار تحديد ملف مختلف |
---|---|---|
userdata-qemu.img
|
محتوى قسم البيانات، الذي يظهر كـ
يستخدم كل مثيل جهاز افتراضي صورة بيانات مستخدم قابلة للكتابة لتخزين البيانات الخاصة بالمستخدم والجلسة. على سبيل المثال، يستخدم الصورة لتخزين بيانات التطبيق والإعدادات وقواعد البيانات والملفات
المثبتة لدى مستخدم فريد. يمتلك كل مستخدم
دليل |
-data
|
cache.img
|
تمثّل هذه السمة صورة قسم ذاكرة التخزين المؤقت التي تظهر على شكل cache/ في
نظام المحاكاة. يكون هذا العمود فارغًا عند إنشاء "متوسّط مدة المشاهدة" لأول مرة أو استخدام
الخيار "-wipe-data ". وهو يخزن ملفات التنزيل المؤقتة وتتم تعبئته
بواسطة مدير التنزيل وأحيانًا النظام. على سبيل المثال، يستخدمه المتصفح لتخزين صفحات الويب والصور التي تم تنزيلها في ذاكرة التخزين المؤقت أثناء تشغيل المحاكي. عند إيقاف تشغيل الجهاز الافتراضي، يتم حذف الملف. ويمكنك مواصلة تشغيل الملف باستخدام الخيار -cache .
|
-cache
|
sdcard.img
|
(اختياري) صورة قسم لبطاقة SD تتيح لك محاكاة بطاقة SD على جهاز افتراضي. يمكنك إنشاء ملف صورة لبطاقة SD في مدير AVD أو باستخدام الأداة
عند تحديد AVD في "مدير AVD"، يمكنك اختيار
استخدام ملف بطاقة SD مُدار تلقائيًا أو ملف أنشأته باستخدام
أداة
يمكنك تصفُّح الملفات وإرسالها إليها ونسخها وإزالتها من بطاقة SD التي تمت محاكاتها، وذلك باستخدام واجهة مستخدِم المحاكي أو الأداة
لنسخ الملفات إلى ملف بطاقة SD قبل تحميله، حمِّل ملف
الصورة كجهاز تكراري ثم انسخ الملفات. أو استخدِم أداة مساعدة، مثل الحزمة ويتعامل المحاكي مع الملف كمجموعة من وحدات البايت، لذا فإن تنسيق بطاقة SD ليس مهمًا.
لا يؤثر الخيار |
-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.
الخيارات شائعة الاستخدام
يسرد الجدول التالي خيارات بدء تشغيل سطر الأوامر التي قد تستخدمها كثيرًا:
خيار سطر الأوامر | الوصف |
---|---|
التشغيل السريع | |
-no-snapshot-load
|
يجري تشغيلاً على البارد ويحفظ حالة المحاكي عند الخروج. |
-no-snapshot-save
|
يجري تشغيل سريع إن أمكن، ولكن لا يحفظ حالة المحاكي عند الخروج. |
-no-snapshot
|
يؤدي هذا الإجراء إلى إيقاف ميزة "التشغيل السريع" تمامًا وعدم تحميل حالة المحاكي أو حفظها. |
معدّات الجهاز | |
-camera-back mode -camera-front mode
|
لضبط وضع المحاكاة لكاميرا مواجهة للخلف أو الأمامية. يؤدي ذلك إلى إلغاء أي إعداد للكاميرا
في AVD.
يمكن أن تكون
مثلاً: 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' في المثال، حرف بدءًا من الإصدار 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.
في حال عدم تحديد هذا الخيار، يكون الإعداد التلقائي هو |
-wipe-data
|
يحذف بيانات المستخدمين وينسخ البيانات من ملف البيانات الأولي. يمحو هذا الخيار بيانات الجهاز الافتراضي ويعيدها إلى الحالة نفسها التي كانت عليها عند تحديدها لأول مرة. تتم إزالة جميع التطبيقات والإعدادات المثبَّتة. على سبيل المثال:
emulator @Pixel8_API_34 -wipe-data
يكون ملف بيانات المستخدمين تلقائيًا |
تصحيح الأخطاء | |
-debug tags
|
تتيح هذه السياسة تفعيل عرض رسائل تصحيح الأخطاء لعلامة واحدة أو أكثر أو إيقافها.
افصل بين العلامات المتعددة بمسافة أو فاصلة أو عمود. على سبيل المثال:
$ emulator @Pixel8_API_34 -debug init,metrics لإيقاف علامة، ضَع شَرطة (-) أمامها. على سبيل المثال، يعرض الخيار التالي جميع رسائل تصحيح الأخطاء، باستثناء الرسائل ذات الصلة بمقابس الشبكة والمقاييس:
للحصول على قائمة بالعلامات والأوصاف، استخدِم الخيار
emulator -help-debug-tags
يمكنك تحديد علامات تصحيح الأخطاء التلقائية في متغيّر بيئة
ANDROID_VERBOSE=socket,gles ويعادل استخدام:
أو
|
-debug-tag -debug-no-tag
|
تُفعِّل نوع معيَّن من رسائل تصحيح الأخطاء. استخدِم النموذج no لإيقاف نوع رسالة تصحيح الأخطاء. على سبيل المثال:
emulator @Pixel8_API_34 -debug-all -debug-no-metrics
للحصول على قائمة بالعلامات، استخدِم الأمر |
-logcat logtags
|
تفعِّل هذه السياسة عرض رسائل Logcat لعلامة واحدة أو أكثر وتكتبها في النافذة الطرفية. على سبيل المثال، يؤدي الأمر التالي إلى تفعيل رسائل الخطأ من جميع المكوّنات:
emulator @Pixel8_API_34 -logcat *:e
يستخدم
يعرض المثال التالي رسائل مكوّن GSM على مستوى السجلّ المعلوماتي:
emulator @Pixel8_API_34 -logcat '*:s GSM:i'
إذا لم توفّر الخيار لمزيد من
المعلومات حول Logcat و |
-show-kernel
|
يعرض رسائل تصحيح أخطاء النواة في النافذة الطرفية. على سبيل المثال:
emulator @Pixel8_API_34 -show-kernel ومن بين استخدامات هذا الخيار التحقق من أن عملية التمهيد تعمل بشكل صحيح. |
-verbose
|
يطبع رسائل إعداد المحاكي في النافذة الطرفية. على سبيل
المثال:
emulator @Pixel8_API_34 -verbose
وتعرِض الملفات والإعدادات التي يتم اختيارها فعليًا عند بدء
جهاز افتراضي محدّد في متوسّط مدة المشاهدة. يشبه هذا الخيار تحديد |
الشبكة | |
-dns-server servers
|
تستخدم خوادم نظام أسماء النطاقات المحدّدة. servers هي قائمة مفصولة بفواصل تضمّ ما يصل إلى أربعة أسماء لخوادم نظام أسماء النطاقات أو عناوين IP. مثلاً:
emulator @Pixel8_API_34 -dns-server 192.0.2.0,
يحاول المحاكي تلقائيًا اكتشاف خوادم نظام أسماء النطاقات التي تستخدمها وينشئ
أسماء مستعارة خاصة في شبكة جدار الحماية التي تمت محاكاتها للسماح لنظام Android
بالاتصال مباشرةً بالخوادم. استخدِم الخيار |
-http-proxy proxy
|
يجعل جميع اتصالات TCP من خلال خادم وكيل HTTP/HTTPS محددًا. إذا كان المحاكي بحاجة إلى الإنترنت من خلال خادم وكيل، يمكنك استخدام هذا الخيار أو متغيّر البيئة http_proxy لإعداد عملية إعادة التوجيه المناسبة. على سبيل المثال:
emulator @Pixel8_API_34 -http-proxy myserver:1981
يمكن أن تكون السمة
ويمكن حذف البادئة
وفي حال عدم توفير هذا الخيار، يبحث المحاكي عن متغيّر البيئة |
-netdelay delay
|
تضبط هذه السياسة محاكاة وقت استجابة الشبكة على إحدى قيم
مثلاً: emulator @Pixel8_API_34 -netdelay gsm
ويتيح المحاكي التحكم في الشبكة بالإضافة إلى توفير وقت استجابة أعلى للاتصال.
ويمكنك تحديده إما من خلال إعدادات المظهر أو باستخدام الخيارَين
|
-netfast
|
لإيقاف تقييد الشبكة. على سبيل المثال:
emulator @Pixel8_API_34 -netfast
يشبه هذا الخيار تحديد |
-netspeed speed
|
تضبط هذه السياسة محاكاة سرعة الشبكة. يحدِّد هذا الإعداد الحد الأقصى لسرعات التحميل والتنزيل على الشبكة باستخدام إحدى قيم
مثلاً: emulator @Pixel8_API_34 -netspeed edge
ويتيح المحاكي التحكم في الشبكة بالإضافة إلى توفير وقت استجابة أعلى للاتصال.
ويمكنك تحديده إما من خلال إعدادات المظهر أو باستخدام الخيارَين
|
-port port
|
تحدِّد هذه السياسة رقم منفذ TCP المُستخدَم لوحدة التحكّم وadb . على سبيل المثال:
emulator @Pixel8_API_34 -port 5556
القيمة التلقائية هي 5554 لأول مثيل جهاز افتراضي يتم تشغيله على جهازك. يشغل الجهاز الافتراضي عادةً منفذَين متجاورَين: منفذ وحدة تحكّم ومنفذ
غالبًا ما تكون عمليات تخصيص المنافذ مماثلة لتحديد يوضّح الخيار
تجدر الإشارة إلى أنّه إذا كانت القيمة |
-ports
|
تحدِّد هذه السياسة منافذ TCP المستخدَمة في وحدة التحكّم وadb . على سبيل المثال:
emulator @Pixel8_API_34 -ports 5556,5559
يتراوح نطاق المنافذ الصالحة من 5554 إلى 5682، ما يسمح بـ 64 جهازًا افتراضيًا متزامنًا. يُبلِغ الخيار
وننصح باستخدام الخيار
لمزيد من المعلومات حول ضبط منافذ |
-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، فتستند إلى وحدة المعالجة المركزية (CPU) من Intel وبرامج تشغيل Intel HAXM. ويتم تجاهل هذا الخيار إذا كنت لا تحاكي جهازًا يعمل بمعيارَي x86 أو x86_64.
القيم الصالحة لـ
ولمزيد من المعلومات، يمكنك الاطّلاع على إعداد تسريع الأجهزة لمحاكي Android. |
-accel-check
|
يتحقّق مما إذا كان قد تم تثبيت برنامج Hypervisor (مراقب الأجهزة الظاهرية) المطلوب لتسريع الأجهزة الافتراضية (HAXM أو KVM). على سبيل المثال:
emulator -accel-check لمزيد من المعلومات، يُرجى الاطِّلاع على التحقُّق من تثبيت برنامج Hypervisor (مراقب الأجهزة الظاهرية). |
-engine engine
|
تحدِّد هذه السياسة محرّك المحاكي:
على سبيل المثال:
emulator @Pixel8_API_34 -engine auto
يجب أن تختار ميزة الرصد التلقائي القيمة التي تقدّم أفضل أداء عند
محاكاة متوسّط مدة مشاهدة معيّنة. استخدِم الخيار |
-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. لمزيد من المعلومات، يمكنك الاطّلاع على نصائح مبادرة أخبار Google (JNI). |
-selinux {disabled|permissive}
|
تضبط وحدة الأمان في نظام التشغيل Linux (SELinux) المحسَّن للأمان على الوضع disabled أو permissive على نظام التشغيل Linux. على سبيل المثال:
me-linux$ emulator @Pixel8_API_34 -selinux permissive
تكون SELinux في وضع |
-timezone timezone
|
تضبط هذه السياسة المنطقة الزمنية للجهاز الافتراضي على emulator @Pixel8_API_34 -timezone Europe/Paris
ويستخدم المحاكي تلقائيًا المنطقة الزمنية لجهاز كمبيوتر التطوير. ويمكنك استخدام
هذا الخيار لتحديد منطقة زمنية مختلفة أو إذا كان الاكتشاف التلقائي
لا يعمل بشكل صحيح. يجب أن تكون القيمة
يجب أن تكون المنطقة الزمنية المحدّدة في قاعدة بيانات 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
يمكن أن تكون
|
الخيارات المتقدّمة
تتوفر خيارات بدء تشغيل سطر الأوامر في الجدول التالي ولكنها لا يشيع استخدامها من قِبل مطوّر التطبيق العادي.
في الأوصاف، يكون دليل العمل هو الدليل الحالي في الوحدة الطرفية التي تُدخِل فيها الأوامر. للحصول على معلومات حول دليل نظام AVD ودليل البيانات والملفات المخزنة فيها، يمكنك مراجعة قسم الأدلة والملفات الافتراضية.
يتناسب بعض هذه الخيارات مع مطوّري التطبيقات الخارجيين، ويستخدم بعضها بشكل أساسي مطوّري برامج النظام الأساسي. مطورو التطبيقات ينشئون تطبيقات Android ويشغِّلونها على AVD محددة. يعمل مطوّرو الأنظمة الأساسية على نظام Android ويشغّلونه داخل المحاكي بدون متوسّط مدة المشاهدة التي تم إنشاؤه مسبقًا.
الخيار المتقدم | وصف قصير |
---|---|
-bootchart timeout
|
لتفعيل التمهيد مع انتهاء المهلة بالثواني. تحتوي بعض صور نظام Android على نظام بدء معدّل يدمج مرفق مخطط تمهيد. يمكنك تمرير فترة مهلة التمهيد إلى النظام باستخدام هذا الخيار. إذا لم يتم تنشيط نظام التشغيل في نظام التهيئة، فإن هذا الخيار لا يفعل أي شيء. هذا الخيار مفيد في المقام الأول لمطوّري النظام الأساسي، وليس لمطوّري التطبيقات الخارجيين. على سبيل المثال: emulator @Pixel8_API_34 -bootchart 120 |
-cache filepath
|
تحدِّد هذه السياسة ملف صورة قسم ذاكرة التخزين المؤقت. توفّر هذه السياسة اسم ملف ومسارًا مطلقًا أو مسارًا متعلقًا بدليل البيانات لإعداد ملف ذاكرة تخزين مؤقت دائم. وإذا لم يكن الملف موجودًا، فسينشئه المحاكي كملف فارغ. على سبيل المثال: emulator @Pixel8_API_34 -cache ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img إذا لم تستخدم هذا الخيار، سيكون الملف التلقائي هو ملف مؤقت باسم
|
-cache-size size
|
لضبط حجم قسم ذاكرة التخزين المؤقت بالميغابايت. على سبيل المثال: emulator @Pixel8_API_34 -cache-size 1000 وإذا لم تحدّد هذا الخيار، ستكون القيمة التلقائية 66 ميغابايت. في العادة، لا يحتاج معظم مطوّري التطبيقات إلى هذا الخيار، إلا إذا كانوا بحاجة إلى تنزيل ملفات كبيرة جدًا يزيد حجمها عن ذاكرة التخزين المؤقت التلقائية. لمزيد من المعلومات حول ملف ذاكرة التخزين المؤقت، راجِع دليل بيانات AVD. |
-data filepath
|
تضبط هذه السياسة ملف الصورة في قسم بيانات المستخدمين. توفّر اسم ملف ومسارًا مطلقًا أو مسارًا متعلقًا بدليل العمل لإعداد ملف بيانات مستخدِم دائم. إذا لم يكن الملف متوفّرًا، ينشئ المحاكي صورة من ملف على سبيل المثال: emulator @Pixel8_API_34 -data ~/.android/avd/Pixel8_API_34.avd/userdata-test.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
|
يمكن الحصول على مساعدة بشأن مواصفات الأحرف 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
|
تحدِّد هذه السياسة الإصدار الأولي من قسم البيانات. بعد حجب بيانات المستخدمين، ينسخ المحاكي محتوى الملف المحدّد إلى بيانات المستخدمين (ملف على سبيل المثال: 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 إذا لم تحدّد هذا الخيار، ستكون القيمة التلقائية |
-noaudio
-no-audio
|
لإيقاف دعم الصوت لهذا الجهاز الافتراضي. تتضمن بعض أجهزة الكمبيوتر التي تعمل بنظامي التشغيل Linux وWindows برامج تشغيل صوت خاطئة تسبب أعراضًا مختلفة، مثل منع المحاكي من البدء. في هذه الحالة، استخدم هذا الخيار
للتغلب على المشكلة. يمكنك بدلاً من ذلك استخدام متغيّر البيئة على سبيل المثال: emulator @Pixel8_API_34 -noaudio |
-nocache
-no-cache
|
ويتم تشغيل المحاكي بدون قسم لذاكرة التخزين المؤقت. إذا لم تستخدم هذا الخيار، سيكون الملف التلقائي هو ملف مؤقت باسم على سبيل المثال: emulator @Pixel8_API_34 -nocache |
-no-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
|
لبدء المحاكي بدون تحميل ملف لتخزين لقطات حالة أو تحميلها، ما يؤدي إلى فرض التشغيل الكامل وإيقاف وظيفة لقطة الحالة. ويؤدي هذا
الخيار إلى إلغاء الخيارَين على سبيل المثال: emulator @Pixel8_API_34 -no-snapstorage |
-no-window
|
لإيقاف عرض النافذة الرسومية على المحاكي. يكون هذا الخيار مفيدًا عند تشغيل المحاكي على خوادم لا تحتوي على شاشة عرض. ويمكنك الوصول إلى المحاكي من خلال
" emulator @Pixel8_API_34 -no-window |
-partition-size size
|
تحدِّد هذه السياسة حجم قسم بيانات النظام بالميغابايت. على سبيل المثال: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name=value
|
تضبط هذه السياسة خاصية نظام Android في المحاكي عند بدء تشغيله.
يجب أن يكون emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args
|
تمرير الوسيطات إلى برنامج محاكي QEMU عند استخدام هذا الخيار، تأكَّد من أنّه الخيار الأخير الذي تم تحديده، لأنّ جميع الخيارات بعده يتم تفسيرها على أنّها خيارات خاصة بـ QEMU. هذا الخيار متقدّم تمامًا ويجب استخدامه فقط من قِبل المطوّرين الذين لديهم دراية كبيرة بتطبيق QEMU ومحاكاة Android. |
-qemu -h
|
عرض مساعدة " 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 إذا لم تستخدم هذا الخيار، سيكون الملف التلقائي هو |
-report-console socket
|
تقوم بالإبلاغ عن منفذ وحدة التحكم إلى جهة خارجية بعيدة قبل بدء المحاكاة. يمكن أن يكون مفيدًا لنص اختبار تلقائي.
على
لمزيد من المعلومات، استخدِم الخيار |
-shell
|
تنشئ وحدة تحكم هيكل جذر في الوحدة الطرفية الحالية. يختلف هذا الخيار عن الأمر
على سبيل المثال: emulator @Pixel8_API_34 -shell |
-snapshot name
|
تحدِّد هذه السياسة اسم اللقطة ضمن ملف تخزين اللقطات لعمليات البدء والحفظ تلقائيًا. وبدلاً من تنفيذ تسلسل تشغيل كامل، يمكن للمحاكي استئناف التنفيذ من لقطة حالة سابقة، ويكون ذلك عادةً أسرع بكثير. عند توفير هذا الخيار، يحمّل المحاكي لقطة لهذا الاسم من صورة اللقطة ويحفظها مرة أخرى بالاسم نفسه عند الخروج. في حال عدم استخدام هذا الخيار، سيكون الإعداد التلقائي هو تسلسل تمهيد كامل. في حال عدم توفّر اللقطة المحدّدة، يُنفِّذ المحاكي تسلسل تشغيل كامل بدلاً من ذلك وينفّذ عملية حفظ. يمكنك الاطّلاع على الخيار emulator @Pixel8_API_34 -snapshot snapshot2 تذكَّر أنّه أثناء تحميل لقطة، يتم استبدال جميع محتوى النظام وبيانات المستخدم وصور بطاقة SD بالمحتوى الذي تحتفظ به عند إنشاء اللقطة. سيتم فقدان أي تغييرات أجريتها منذ ذلك الحين ما لم تحفظ هذه المعلومات في نبذة مختلفة. ويمكنك أيضًا إنشاء نبذة من وحدة التحكّم في المحاكي باستخدام الأمر
|
-snapshot-list
|
تعرِض قائمة باللقطات المتاحة. يطبع هذا الأمر جدول لقطات تم تخزينها في ملف تخزين اللقطات الذي تم بدء المحاكي به، ثم يخرج. إذا حدّدت على سبيل المثال: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img يمكنك استخدام قيم عمودَي ID وTAG في الإخراج
كوسيطات للخيار |
-snapstorage filepath
|
تُحدِّد ملف مستودع يحتوي على جميع لقطات الحالة. يتم في هذا الملف حفظ جميع اللقطات التي تم إجراؤها أثناء التنفيذ. ويمكن استعادة اللقطات في هذا الملف فقط أثناء تشغيل المحاكي. على سبيل المثال: emulator @Pixel8_API_34 -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.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 إذا لم تستخدم هذا الخيار، سيكون الملف التلقائي هو |
-use-system-libs
|
على نظام التشغيل Linux، يتم استخدام نظام على سبيل المثال: me-linux$ emulator @Pixel8_API_34 -use-system-libs |
-writable-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
تفعيل رسائل تصحيح الأخطاء أو إيقافها من مكوّنات محدّدة في المحاكي، على النحو الذي تحدّده العلامات.