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

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

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

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

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

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

إذا كنت تريد استخدام الأجهزة الافتراضية لتشغيل اختباراتك المزوّدة بأدوات قياس الأداء المبرمَجة بطريقة قابلة للتطوير ومُدارة ذاتيًا، ننصحك باستخدام الأجهزة المُدارة من 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، على سبيل المثال، تحتوي الإضافة 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. انقر على إنشاء جهاز.

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

   

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

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

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

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

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

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


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

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

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

لإنشاء متوسّط مدة المشاهدة باستخدام نسخة، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

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

2. في نافذة إعداد الملف الشخصي للأجهزة، غيِّر خصائص الملف الشخصي للأجهزة حسب الحاجة.

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

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

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

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

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

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

تعديل تصاميم الإعلانات المتجاوبة على شبكة البحث الحالية

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

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

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

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

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

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

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

• لتشغيل محاكي يستخدم جهاز افتراضي 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 في رمز مصدر الأدوات.