إنشاء الأجهزة الافتراضية وإدارتها

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

جهاز Android الظاهري (AVD) هو إعداد يحدِّد سمات هاتف Android أو جهاز Android اللوحي أو Wear OS أو Android TV أو جهاز Automotive OS الذي تريد محاكاته في محاكي Android. أداة "إدارة الأجهزة" هي أداة يمكنك تشغيلها من Android Studio تساعدك في إنشاء أجهزة افتراضية Android وإدارةها.

لفتح مدير الأجهزة الجديد، نفِّذ أحد الإجراءات التالية:

• من شاشة الترحيب في Android Studio، اختَر المزيد من الإجراءات > مدير الأجهزة الافتراضية.

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

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

إذا كنت تريد استخدام الأجهزة الافتراضية لإجراء اختبارات مزوّدة بأدوات قياس الأداء المبرمَجة بطريقة قابلة للتطوير ومُدارة ذاتيًا، ننصحك باستخدام الأجهزة المُدارة من Gradle.

لمحة عن متوسّط مدّة المشاهدة

يحتوي جهاز افتراضي Android على ملف تعريف للأجهزة وصورة نظام ومساحة تخزين وخلفية وخصائص أخرى.

ننصحك بإنشاء جهاز افتراضي Android لكل صورة نظام يمكن لتطبيقك استخدامها استنادًا إلى إعداد <uses-sdk> في البيان.

الملف الشخصي للجهاز

يحدِّد ملفّ تعريف الأجهزة خصائص الجهاز كما هو مُشَحن من المصنع. يأتي "مدير الأجهزة" مُحمَّلاً مسبقًا بملفّات تعريف معيّنة للأجهزة، مثل أجهزة Pixel، ويمكنك تحديد ملفّات تعريف الأجهزة أو تخصيصها حسب الحاجة.

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

إنّ الأجهزة التي تحمل هذا الشعار ونوع الجهاز "هاتف" متوافقة أيضًا مع مجموعة أدوات اختبار التوافق (CTS) وقد تستخدم صور نظام تتضمّن تطبيق "متجر Play".

صور النظام

تتضمّن صورة النظام المُصنَّفة باستخدام Google APIs إمكانية الوصول إلى خدمات Google Play.

تعرض علامة التبويب مُقترَحة صور النظام المقترَحة. وتشمل علامات التبويب الأخرى قائمة أكثر اكتمالاً. تصف اللوحة اليمنى صورة النظام المحدّدة.

إذا ظهر لك رمز تنزيل بجانب صورة نظام، يعني ذلك أنّ هذه الصورة ليست مثبَّتة حاليًا على جهاز التطوير. انقر على الرمز لتنزيل صورة النظام. يجب أن يكون جهازك متصلاً بالإنترنت لتنزيل صور النظام.

إنّ مستوى واجهة برمجة التطبيقات للجهاز المستهدَف مهم، لأنّ تطبيقك لا يعمل على صورة نظام يكون فيها مستوى واجهة برمجة التطبيقات أقل من المستوى المطلوب لتطبيقك، كما هو محدّد في السمة minSdk في ملف بيان التطبيق. لمزيد من المعلومات عن العلاقة بين مستوى واجهة برمجة تطبيقات النظام و minSdk، اطّلِع على مقالة إصدار تطبيقك.

إذا كان تطبيقك يعلن عن عنصر <uses-library> في ملف البيان، يحتاج التطبيق إلى صورة نظام تتضمّن هذه المكتبة الخارجية. لتشغيل تطبيقك على جهاز محاكاة، أنشئ جهاز محاكاة Android (AVD) يتضمّن المكتبة المطلوبة. ولإجراء ذلك، قد تحتاج إلى استخدام مكوّن إضافي لمنصّة AVD ، على سبيل المثال، تحتوي إضافة Google APIs على مكتبة "خرائط Google" .

لضمان أمان التطبيقات وتقديم تجربة متسقة على الأجهزة الفعلية، يتم توقيع صور النظام التي تتضمّن "متجر Google Play" باستخدام مفتاح إصدار ، ما يعني أنّه لا يمكنك الحصول على امتيازات مرتفعة (إذن الوصول إلى الجذر) باستخدام هذه الصور.

إذا كنت بحاجة إلى أذونات مميّزة (إذن الوصول إلى الجذر) للمساعدة في تحديد المشاكل وحلّها في التطبيقات، يمكنك استخدام صور نظام Android Open Source Project (AOSP) التي لا تتضمّن تطبيقات أو خدمات Google. يمكنك بعد ذلك استخدام الأمرَين adb root وadb unroot للتبديل بين الأذونات العادية والمرفوعة:

  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  % adb root
  restarting adbd as root
  % adb shell
  emu64a:/ #
  emu64a:/ # exit
  % adb unroot
  restarting adbd as non root
  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  %
  

مساحة التخزين

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

البشرة

يحدِّد مظهر المحاكي مظهر الجهاز. يقدّم "مدير الأجهزة" بعض أشكال الشاشة المحدّدة مسبقًا. يمكنك أيضًا تحديد الخلفيات الخاصة بك أو استخدام خلفيات تقدّمها جهات خارجية.

ميزات AVD والتطبيقات

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

إنشاء جهاز افتراضي للتطوير

لإنشاء جهاز افتراضي للألعاب جديد:

1. افتح "مدير الأجهزة".
2. انقر على إنشاء جهاز.

   تظهر نافذة اختيار الجهاز.

   

   يُرجى العِلم أنّ بعض ملفات تعريف الأجهزة فقط تتضمّن متجر Google Play. تتوافق هذه الملفات الشخصية بالكامل مع مجموعة أدوات اختبار التوافق (CTS) وقد تستخدم صور نظام تتضمّن تطبيق "متجر Play".

3. اختَر ملفّ تعريف أجهزة، ثمّ انقر على التالي.

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

   تظهر نافذة صورة النظام.

   
4. اختَر صورة النظام لمستوى معيّن لواجهة برمجة التطبيقات، ثم انقر على التالي.

تظهر نافذة التحقّق من الإعدادات.


5. غيِّر خصائص AVD حسب الحاجة، ثم انقر على إنهاء.

   انقر على عرض الإعدادات المتقدّمة لعرض المزيد من الإعدادات، مثل درجة الحرارة.

يظهر جهاز AVD الجديد في علامة التبويب الأجهزة الافتراضية ضمن "مدير الأجهزة" و قائمة الجهاز المستهدَف.

لإنشاء جهاز افتراضي للاندرويد بدءًا من نسخة:

1. من علامة التبويب الأجهزة الافتراضية في مدير الأجهزة، انقر على القائمة واختَر تكرار.

   تظهر نافذة التحقّق من الإعدادات.

2. انقر على الخطوة السابقة إذا كنت بحاجة إلى إجراء تغييرات على نافذتَي صورة النظام أو اختيار الجهاز.
3. أدخِل أي تغييرات تحتاجها، ثم انقر على إنهاء.

   يظهر جهاز AVD في علامة التبويب الأجهزة الافتراضية ضمن "مدير الأجهزة".

إنشاء ملف شخصي للأجهزة

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

يمكنك تحديد ملف شخصي جديد للأجهزة من البداية أو نسخ ملف شخصي للأجهزة كنقطة بداية. لا يمكن تعديل الملفات الشخصية للأجهزة المحمّلة مسبقًا.

لإنشاء ملفّ شخصي جديد للأجهزة من البداية:

1. في نافذة اختيار الجهاز ، انقر على ملف تعريف جهاز جديد.

2. في نافذة ضبط الملف الشخصي للأجهزة، غيِّر سمات الملف الشخصي للأجهزة حسب الحاجة.

   
3. انقر على إنهاء.

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

لإنشاء ملفّ شخصي للأجهزة باستخدام نسخة كنقطة بداية:

1. في نافذة اختيار الجهاز ، اختَر ملف تعريف الجهاز وانقر على نسخ الجهاز أو انقر بزر الماوس الأيمن على ملف تعريف الجهاز واختَر نسخ.

2. في نافذة ضبط الملف الشخصي للأجهزة، غيِّر سمات الملف الشخصي للأجهزة حسب الحاجة.
3. انقر على إنهاء.

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

تعديل عروض الأسعار الديناميكية للفيديو الحالية

يمكنك تنفيذ العمليات التالية على جهاز افتراضي Android من علامة التبويب الأجهزة الافتراضية في "مدير الأجهزة":

• لتعديل جهاز افتراضي، انقر على تعديل هذا الجهاز الافتراضي وأدخِل التغييرات.
• لحذف جهاز افتراضي للألعاب، انقر على القائمة واختَر حذف.
• لعرض ملفَي AVD INI وIMG المرتبطَين على القرص، انقر على القائمة وحدِّد عرض على القرص.
• للاطّلاع على تفاصيل ضبط AVD التي يمكنك تضمينها في تقارير الأخطاء المرسَلة إلى فريق Android Studio، انقر على القائمة واختَر عرض التفاصيل.

تعديل الملفات الشخصية الحالية للأجهزة

لا يمكنك تعديل ملفات أجهزة الأجهزة المحمَّلة مسبقًا أو حذفها، ولكن يمكنك تنفيذ العمليات التالية على ملفات أجهزة الأجهزة الأخرى من نافذة اختيار الجهاز:

• لتعديل ملف شخصي للأجهزة، اختَره وانقر على تعديل الجهاز. يمكنك أيضًا النقر بزر الماوس الأيمن على ملف شخصي للأجهزة واختيار تعديل. بعد ذلك، أدخِل التغييرات التي تريدها.
• لحذف ملف تعريف أجهزة، انقر عليه بزر الماوس الأيمن واختَر حذف.

تشغيل محاكي وإيقافه ومحو البيانات

من علامة التبويب الأجهزة الافتراضية، يمكنك تنفيذ العمليات التالية على المحاكي:

• لتشغيل محاكي يستخدم جهاز افتراضي Android، انقر على بدء .
• لإيقاف محاكي قيد التشغيل، انقر على رمز القائمة واختَر إيقاف.
• لمحو بيانات المحاكي، انقر على القائمة واختَر محو البيانات.

استيراد ملفات تعريف الأجهزة وتصديرها

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

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

خصائص AVD

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

تلغي خصائص ضبط AVD خصائص الملف الشخصي للأجهزة، و تلغي خصائص المحاكي التي تحدّدها أثناء تشغيل المحاكي كلاً منهما.

الجدول 1: سمات ضبط AVD

خصائص الملف الشخصي للأجهزة

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

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

تكون بعض المواقع غير مفعّلة لبعض أنواع الأجهزة. على سبيل المثال، لا تتوفّر السمة "مستدير" إلا على أجهزة Wear OS.

الجدول 2: ملف الضبط خصائص الملف الشخصي للجهاز

إنشاء مظهر محاكي

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

يحتوي كل مظهر محاكي على ما يلي:

• ملف hardware.ini
• ملفات التنسيق للاتجاهات المتوافقة والإعدادات المادية
• ملفات الصور لعناصر العرض، مثل الخلفية والمفاتيح والأزرار

لإنشاء خلفية مخصّصة واستخدامها:

1. أنشئ دليلاً يمكنك فيه حفظ ملفات إعدادات المظهر.
2. حدِّد المظهر المرئي للقشرة في ملف نصي باسم layout. يحدِّد هذا الملف العديد من خصائص المظهر، مثل حجم مواد عرض الصور للأزرار المحدّدة. مثلاً:

   parts {
       device {
           display {
               width   320
               height  480
               x       0
               y       0
           }
       }
   
       portrait {
           background {
               image background_port.png
           }
   
           buttons {
               power {
                   image  button_vertical.png
                   x 1229
                   y 616
               }
           }
       }
       ...
   }
   

3. أضِف ملفات صور نقطية لصور الجهاز إلى الدليل نفسه.
4. حدِّد إعدادات إضافية للأجهزة المتعلّقة بالأجهزة في ملف INI لإعدادات الجهاز، مثل hw.keyboard و hw.lcd.density.
5. أرشِف الملفات في مجلد المظهر واختَر ملف الأرشيف كمظهر مخصّص.

للحصول على معلومات أكثر تفصيلاً حول إنشاء مظاهر المحاكي، اطّلِع على مواصفات ملف مظهر المحاكي لنظام التشغيل Android في رمز المصدر الخاص بالأدوات.