مدير الحساب

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

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

تتضمّن حزمة "أدوات سطر الأوامر" في Android SDK أداة avdmanager في المسار 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 Manager

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

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

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

إنشاء "جهاز Android افتراضي" جديد يجب تقديم name لـ "جهاز Android الافتراضي" وتحديد رقم تعريف حزمة SDK التي سيتم استخدامها للجهاز باستخدام sdk_id بين علامتَي اقتباس. على سبيل المثال، ينشئ الأمر التالي "جهاز Android افتراضي" باسم 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: فرض إنشاء "الجهاز الافتراضي" استخدِم هذا الخيار إذا كنت بحاجة إلى استبدال "جهاز Android افتراضي" حالي بآخر جديد يحمل الاسم نفسه.
  • -p path: مسار الموقع الذي يتم فيه إنشاء دليل ملفات "الجهاز الافتراضي" إذا لم تحدّد مسارًا، يتم إنشاء "الجهاز الافتراضي" في ~/.android/avd/.
delete avd -n name حذف "جهاز Android افتراضي" يجب تحديد "الجهاز الافتراضي" باستخدام name.
move avd -n name [-p path] [-r new-name] نقل "جهاز Android افتراضي" أو إعادة تسميته يجب تحديد "الجهاز الافتراضي" باستخدام name. يصف ما يلي استخدامات الخيارات الأخرى:
  • -p path: المسار المطلق للموقع الذي سيتم فيه إنشاء الدليل الذي سيتم نقل ملفات "الجهاز الافتراضي" إليه إذا لم يتم تضمين هذا الوسيط، لن يتم نقل "الجهاز الافتراضي". يمكنك اختيار عدم تضمين هذا الوسيط إذا كنت تريد إعادة تسمية "الجهاز الافتراضي" في مكانه.
  • -r new-name: الاسم الجديد لـ "الجهاز الافتراضي" الذي تتم إعادة تسميته
list [target|device|avd] [-c] عرض جميع الأهداف المتاحة أو تعريفات الأجهزة أو "أجهزة Android الافتراضية" إذا لم تحدّد target أو device أو avd، يعرض avdmanager الخيارات الثلاثة كلها. أدرِج الوسيط -c لتلقّي ناتج مضغوط مناسب للبرامج النصية. لا يتوفّر الوسيط -c عند عرض الخيارات الثلاثة كلها معًا.