مدير الحساب

avdmanager هي أداة سطر الأوامر تتيح لك إنشاء أجهزة Android افتراضية (AVD) وإدارتها من سطر الأوامر. يتيح لك AVD تحديد خصائص هاتف Android أو ساعة Wear OS أو جهاز Android TV الذي تريد محاكاته في محاكي Android.

إذا كنت تستخدم "استوديو Android"، لن تحتاج إلى استخدام هذه الأداة ويمكنك بدلاً من ذلك إنشاء وإدارة AVD من بيئة التطوير المتكاملة.

يتم تضمين أداة avdmanager في حزمة أدوات سطر الأوامر لـ Android SDK على android_sdk/cmdline-tools/version/bin/avdmanager.

بناء الجملة

لاستخدام avdmanager، استخدِم البنية التالية:

avdmanager [global options] command [command options]

الخيارات العامة

الجدول 1. قائمة الخيارات العامة لـ avdmanager.

خيار عام الوصف
-s | ‏--silent الوضع الصامت: تتم طباعة الأخطاء فقط.
-h | ‏--help مساعدة بشأن الاستخدام
-v | ‏--verbose وضع مطوَّل: تتم طباعة الأخطاء والتحذيرات والرسائل الإعلامية.
--clear cache محو ذاكرة التخزين المؤقت لبيان مستودع مدير حزمة تطوير البرامج (SDK)

الأوامر وخيارات الأوامر

الجدول 2. هذه قائمة بالأوامر والخيارات لـ avdmanager.

الأوامر والخيارات الوصف
create avd -n name -k "sdk_id" [-c {path|size}] [-f] [-p path]

إنشاء AVD جديد يجب توفير name لنظام AVD وتحديد رقم تعريف حزمة SDK لاستخدامها في AVD باستخدام sdk_id بين علامتَي اقتباس. على سبيل المثال، يؤدي الأمر التالي إلى إنشاء AVD باسم test باستخدام صورة النظام x86 للمستوى 25 من واجهة برمجة التطبيقات:

avdmanager create avd -n test -k "system-images;android-25;google_apis;x86"
يوضّح ما يلي استخدامات الخيارات الأخرى:
  • -c {path|size}: المسار إلى صورة بطاقة SD لـ "متوسط مدة المشاهدة" هذا أو حجم صورة بطاقة SD جديدة لإنشاء "متوسط مدة المشاهدة" هذا بالكيلوبايت أو ميغابايت، يشار إليه بالرمز K أو M. على سبيل المثال، -c path/to/sdcard/ أو -c 1000M.
  • -f: فرض إنشاء "متوسّط مدة المشاهدة" يمكنك استخدام هذا الخيار إذا كنت بحاجة إلى استبدال "متوسّط مدة تشغيل" حالي بـ "متوسّط مدة تشغيل" جديد باستخدام الاسم نفسه.
  • -p path: المسار إلى الموقع الذي سيتم فيه إنشاء الدليل لملفات AVD هذا إذا لم تحدّد مسارًا، يتم إنشاء "متوسّط مدة المشاهدة" في ~/.android/avd/.
delete avd -n name حذف "متوسّط مدة المشاهدة" يجب تحديد AVD باستخدام name.
move avd -n name [-p path] [-r new-name] نقل AVD أو إعادة تسميته يجب تحديد AVD باستخدام name. في ما يلي شرح لاستخدامات الخيارات الأخرى:
  • -p path: المسار المطلق للموقع الذي سيتم إنشاء الدليل فيه حيث سيتم نقل ملفات AVD هذا. في حال عدم تضمين هذه الوسيطة، لن يتم نقل AVD. ويمكنك اختيار عدم تضمين هذه الوسيطة إذا أردت إعادة تسمية AVD بشكل صحيح.
  • -r new-name: ستتم إعادة تسمية الاسم الجديد لنظام AVD.
list [target|device|avd] [-c] أدرج جميع الأهداف أو تعريفات الأجهزة أو متوسط مدة المشاهدة المتاحة. إذا لم تحدّد target أو device أو avd، ستدرج السمة avdmanager العناصر الثلاث جميعها. يمكنك تضمين الوسيطة -c لتلقّي نتيجة مكثفة مناسبة للنصوص البرمجية. لا تتوفر الوسيطة -c عند إدراج الخيارات الثلاثة جميعها معًا.