ایجاد و مدیریت دستگاه های مجازی

دستگاه مجازی Android (AVD) پیکربندی است که ویژگی‌های یک تلفن Android، تبلت، Wear OS، Android TV یا دستگاه سیستم عامل Automotive را که می‌خواهید در شبیه‌ساز Android شبیه‌سازی کنید، تعریف می‌کند. Device Manager ابزاری است که می‌توانید از Android Studio راه‌اندازی کنید و به شما در ایجاد و مدیریت AVD کمک می‌کند.

برای باز کردن Device Manager جدید، یکی از موارد زیر را انجام دهید:

• از صفحه خوش‌آمدگویی Android Studio، گزینه‌های More Actions > Virtual Device Manager را انتخاب کنید.

• پس از باز کردن یک پروژه، View > Tool Windows > Device Manager را از نوار منوی اصلی انتخاب کنید، سپس روی + کلیک کنید و سپس روی Create Virtual Device کلیک کنید.

پس از ایجاد دستگاه های خود، می توانید لیستی از تمام دستگاه ها را در پنل مدیریت دستگاه مشاهده کنید.

اگر می‌خواهید از دستگاه‌های مجازی برای اجرای آزمایش‌های خودکار خودکار خود به‌صورت مقیاس‌پذیر و خود مدیریتی استفاده کنید، از دستگاه‌های مدیریت‌شده Gradle استفاده کنید.

درباره AVD ها

یک AVD حاوی مشخصات سخت افزاری، تصویر سیستم، فضای ذخیره سازی، پوسته و سایر خصوصیات است.

توصیه می‌کنیم یک AVD برای هر تصویر سیستمی ایجاد کنید که برنامه شما به طور بالقوه می‌تواند بر اساس تنظیم <uses-sdk> در مانیفست خود پشتیبانی کند.

مشخصات سخت افزاری

مشخصات سخت افزاری مشخص کننده ویژگی های دستگاهی است که از کارخانه ارسال می شود. Device Manager با نمایه‌های سخت‌افزاری خاصی مانند دستگاه‌های Pixel از قبل بارگذاری شده است و می‌توانید پروفایل‌های سخت‌افزار را در صورت نیاز تعریف یا سفارشی کنید.

تعریف دستگاه با نشان‌واره Google Play در ستون Play Store شامل برنامه فروشگاه Google Play و دسترسی به خدمات Google Play، از جمله یک برگه Google Play در گفتگوی Extended Controls است که دکمه‌ای مناسب برای به‌روزرسانی خدمات Google Play در دستگاه

دستگاه‌های دارای این نشان‌واره و نوع دستگاه «تلفن» نیز با CTS سازگار هستند و ممکن است از تصاویر سیستمی استفاده کنند که شامل برنامه Play Store می‌شود.

تصاویر سیستم

یک تصویر سیستم با برچسب Google API شامل دسترسی به خدمات Google Play است.

تب Recommended تصاویر سیستم توصیه شده را فهرست می کند. برگه های دیگر شامل لیست کامل تری هستند. صفحه سمت راست تصویر سیستم انتخاب شده را توصیف می کند.

اگر نماد دانلود را در کنار تصویر سیستم مشاهده کردید، آن تصویر در حال حاضر بر روی دستگاه توسعه شما نصب نشده است. برای دانلود تصویر سیستم روی نماد کلیک کنید. برای دانلود تصاویر سیستم باید به اینترنت متصل باشید.

سطح API دستگاه مورد نظر مهم است، زیرا برنامه شما روی یک تصویر سیستمی با سطح API کمتر از سطح مورد نیاز برنامه شما، همانطور که در ویژگی minSdk در فایل مانیفست برنامه مشخص شده است، اجرا نمی شود. برای اطلاعات بیشتر در مورد رابطه بین سطح API سیستم و minSdk ، به نسخه برنامه خود مراجعه کنید.

اگر برنامه شما عنصر <uses-library> را در فایل مانیفست اعلام کند، برنامه به یک تصویر سیستمی نیاز دارد که شامل آن کتابخانه خارجی باشد. برای اجرای برنامه خود بر روی یک شبیه ساز، یک AVD ایجاد کنید که شامل کتابخانه مورد نیاز است. برای انجام این کار، ممکن است لازم باشد از یک جزء افزودنی برای پلتفرم AVD استفاده کنید. برای مثال، افزونه Google APIs حاوی کتابخانه Google Maps است.

برای اطمینان از امنیت برنامه و تجربه یکنواخت با دستگاه‌های فیزیکی، تصاویر سیستم با فروشگاه Google Play همراه با یک کلید انتشار امضا می‌شوند، به این معنی که با این تصاویر نمی‌توانید امتیازات (ریشه) بالاتری دریافت کنید.

اگر برای کمک به عیب‌یابی برنامه‌ها به امتیازات بالا (root) نیاز دارید، می‌توانید از تصاویر سیستم پروژه منبع باز Android (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 شبیه سازی شده را ذخیره می کند. در صورت نیاز، می‌توانید از Device Manager برای پاک کردن داده‌های کاربر استفاده کنید تا دستگاه همان داده‌هایی را داشته باشد که گویی جدید است.

پوست

یک پوسته شبیه ساز ظاهر یک دستگاه را مشخص می کند. Device Manager برخی از پوسته های از پیش تعریف شده را ارائه می دهد. همچنین می‌توانید پوسته‌های ارائه شده توسط اشخاص ثالث را خودتان تعریف کنید یا از آنها استفاده کنید.

ویژگی های AVD و برنامه

مطمئن شوید که تعریف AVD شما شامل ویژگی‌های دستگاهی است که برنامه شما به آنها وابسته است. برای لیست ویژگی هایی که می توانید در AVD های خود تعریف کنید، به بخش های مربوط به مشخصات مشخصات سخت افزاری و ویژگی های AVD مراجعه کنید.

یک AVD ایجاد کنید

برای ایجاد یک AVD جدید:

1. Device Manager را باز کنید.
2. روی ایجاد دستگاه کلیک کنید.

   پنجره Select Hardware ظاهر می شود.

   

   توجه داشته باشید که فقط برخی از نمایه های سخت افزاری شامل Play Store هستند. این نمایه‌ها کاملاً با CTS سازگار هستند و ممکن است از تصاویر سیستمی استفاده کنند که شامل برنامه Play Store است.

3. یک نمایه سخت افزاری انتخاب کنید، سپس روی Next کلیک کنید.

   اگر نمایه سخت افزاری مورد نظر خود را نمی بینید، می توانید یک نمایه سخت افزاری ایجاد یا وارد کنید ، همانطور که در بخش های دیگر این صفحه توضیح داده شده است.

   پنجره System Image ظاهر می شود.

   
4. تصویر سیستم را برای یک سطح API خاص انتخاب کنید و سپس روی Next کلیک کنید.

پنجره Verify Configuration ظاهر می شود.


5. خواص AVD را در صورت نیاز تغییر دهید و سپس روی Finish کلیک کنید.

   برای نمایش تنظیمات بیشتر، مانند پوسته، روی Show Advanced Settings کلیک کنید.

AVD جدید در تب مجازی Device Manager و منوی دستگاه مورد نظر ظاهر می شود.

برای ایجاد یک AVD که با یک کپی شروع می شود:

1. از تب Virtual Device Manager، روی Menu کلیک کنید و Duplicate را انتخاب کنید.

   پنجره Verify Configuration ظاهر می شود.

2. اگر نیاز به ایجاد تغییرات در تصویر سیستم یا انتخاب پنجره های سخت افزاری دارید، روی گزینه قبلی کلیک کنید.
3. هر تغییری را که نیاز دارید انجام دهید و سپس روی Finish کلیک کنید.

   AVD در تب مجازی Device Manager ظاهر می شود.

یک نمایه سخت افزاری ایجاد کنید

Device Manager پروفایل های سخت افزاری از پیش تعریف شده ای را برای دستگاه های معمولی فراهم می کند تا بتوانید به راحتی آنها را به تعاریف AVD خود اضافه کنید. اگر نیاز به تعریف دستگاه دیگری دارید، می توانید یک نمایه سخت افزاری جدید ایجاد کنید.

می توانید از ابتدا یک نمایه سخت افزاری جدید تعریف کنید یا یک نمایه سخت افزاری را به عنوان نقطه شروع کپی کنید. نمایه های سخت افزاری از پیش بارگذاری شده قابل ویرایش نیستند.

برای ایجاد یک نمایه سخت افزاری جدید از ابتدا:

1. در پنجره Select Hardware ، روی New Hardware Profile کلیک کنید.

2. در پنجره Configure Hardware Profile ، مشخصات مشخصات سخت افزار را در صورت نیاز تغییر دهید.

   
3. روی Finish کلیک کنید.

   نمایه سخت افزار جدید شما در پنجره Select Hardware ظاهر می شود. می‌توانید یک AVD که از نمایه سخت‌افزاری استفاده می‌کند، با کلیک بر روی Next یا روی Cancel کلیک کنید تا به تب مجازی یا منوی دستگاه مورد نظر بازگردید.

برای ایجاد نمایه سخت افزاری با استفاده از یک کپی به عنوان نقطه شروع:

1. در پنجره Select Hardware ، یک نمایه سخت افزاری را انتخاب کنید و روی Clone Device کلیک کنید یا روی یک نمایه سخت افزاری کلیک راست کرده و Clone را انتخاب کنید.

2. در پنجره Configure Hardware Profile ، مشخصات مشخصات سخت افزار را در صورت نیاز تغییر دهید.
3. روی Finish کلیک کنید.

نمایه سخت افزار جدید شما در پنجره Select Hardware ظاهر می شود. می‌توانید یک AVD که از نمایه سخت‌افزاری استفاده می‌کند، با کلیک بر روی Next یا روی Cancel کلیک کنید تا به تب مجازی یا منوی دستگاه مورد نظر بازگردید.

AVD های موجود را ویرایش کنید

از تب مجازی Device Manager می توانید عملیات زیر را روی AVD انجام دهید:

• برای ویرایش یک AVD، روی Edit this AVD کلیک کنید و تغییرات خود را انجام دهید
• برای حذف یک AVD، روی Menu کلیک کنید و حذف را انتخاب کنید.
• برای نمایش فایل‌های AVD INI و IMG مرتبط روی دیسک، روی Menu کلیک کنید و Show on Disk را انتخاب کنید.
• برای مشاهده جزئیات پیکربندی AVD که می‌توانید در گزارش‌های باگ به تیم Android Studio اضافه کنید، روی Menu کلیک کنید و View Details را انتخاب کنید.

پروفایل های سخت افزاری موجود را ویرایش کنید

شما نمی توانید پروفایل های سخت افزاری از پیش بارگذاری شده را ویرایش یا حذف کنید، اما می توانید از پنجره Select Hardware، عملیات زیر را بر روی سایر پروفایل های سخت افزاری انجام دهید:

• برای ویرایش یک نمایه سخت افزاری، آن را انتخاب کرده و روی Edit Device کلیک کنید. همچنین می توانید روی نمایه سخت افزاری کلیک راست کرده و Edit را انتخاب کنید. در مرحله بعد، تغییرات خود را انجام دهید.
• برای حذف نمایه سخت افزاری، روی آن کلیک راست کرده و Delete را انتخاب کنید.

یک شبیه ساز را اجرا و متوقف کنید و داده ها را پاک کنید

از تب Virtual می توانید عملیات زیر را روی یک شبیه ساز انجام دهید:

• برای اجرای شبیه‌سازی که از AVD استفاده می‌کند، روی Launch کلیک کنید .
• برای متوقف کردن یک شبیه ساز در حال اجرا، روی منو کلیک کنید و Stop را انتخاب کنید.
• برای پاک کردن داده‌های شبیه‌ساز، روی منو کلیک کنید و Wipe Data را انتخاب کنید.

واردات و صادرات پروفایل های سخت افزاری

از پنجره Select Hardware ، می‌توانید پروفایل‌های سخت‌افزار را به صورت زیر وارد و صادر کنید:

• برای وارد کردن یک نمایه سخت افزاری، روی Import Hardware Profiles کلیک کنید و فایل XML را در رایانه خود که حاوی تعریف است انتخاب کنید.
• برای صادر کردن یک نمایه سخت افزاری، روی آن کلیک راست کرده و Export را انتخاب کنید. مکانی را که می خواهید فایل XML حاوی تعریف را در آن ذخیره کنید، مشخص کنید.

ویژگی های AVD

پیکربندی AVD تعامل بین کامپیوتر توسعه‌دهنده و شبیه‌ساز و همچنین ویژگی‌هایی را که می‌خواهید در نمایه سخت‌افزار لغو کنید، مشخص می‌کند. می توانید ویژگی های زیر را برای تنظیمات AVD در پنجره Verify Configuration مشخص کنید. ویژگی‌های دارای برچسب (پیشرفته) تنها در صورتی نمایش داده می‌شوند که روی Show Advanced Settings کلیک کنید.

ویژگی‌های پیکربندی AVD ویژگی‌های نمایه سخت‌افزار را نادیده می‌گیرند، و ویژگی‌های شبیه‌ساز که هنگام اجرای شبیه‌ساز تنظیم می‌کنید، هر دو را نادیده می‌گیرند.

جدول 1. ویژگی های پیکربندی AVD

مشخصات مشخصات سخت افزاری

در پنجره Configure Hardware Profile می توانید ویژگی های زیر را برای پروفایل های سخت افزاری مشخص کنید. ویژگی‌های پیکربندی AVD ویژگی‌های نمایه سخت‌افزار را نادیده می‌گیرند، و ویژگی‌های شبیه‌ساز که هنگام اجرای شبیه‌ساز تنظیم می‌کنید، هر دو را نادیده می‌گیرند.

نمایه های سخت افزاری از پیش تعریف شده همراه با Device Manager قابل ویرایش نیستند. با این حال، می توانید پروفایل ها را کپی کنید و کپی ها را ویرایش کنید.

برخی از ویژگی ها برای برخی از انواع دستگاه غیرفعال هستند. به عنوان مثال، ویژگی "Round" فقط در دستگاه های Wear OS موجود است.

جدول 2. ویژگی های پیکربندی مشخصات سخت افزاری

یک پوسته شبیه ساز ایجاد کنید

پوسته شبیه ساز اندروید مجموعه ای از فایل هاست که عناصر بصری و کنترلی نمایشگر شبیه ساز را تعریف می کند. اگر تعاریف پوست موجود در تنظیمات 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. فایل ها را در پوشه پوسته بایگانی کنید و فایل آرشیو را به عنوان پوسته سفارشی انتخاب کنید.

برای اطلاعات دقیق تر درباره ایجاد پوسته های شبیه ساز، مشخصات فایل پوسته شبیه ساز اندروید را در کد منبع ابزار ببینید.