دستگاه مجازی 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 جدید:
- Device Manager را باز کنید.
- روی ایجاد دستگاه کلیک کنید.
پنجره Select Hardware ظاهر می شود.
توجه داشته باشید که فقط برخی از نمایه های سخت افزاری شامل Play Store هستند. این نمایهها کاملاً با CTS سازگار هستند و ممکن است از تصاویر سیستمی استفاده کنند که شامل برنامه Play Store است.
- یک نمایه سخت افزاری انتخاب کنید، سپس روی Next کلیک کنید.
اگر نمایه سخت افزاری مورد نظر خود را نمی بینید، می توانید یک نمایه سخت افزاری ایجاد یا وارد کنید ، همانطور که در بخش های دیگر این صفحه توضیح داده شده است.
پنجره System Image ظاهر می شود.
- تصویر سیستم را برای یک سطح API خاص انتخاب کنید و سپس روی Next کلیک کنید.
- خواص AVD را در صورت نیاز تغییر دهید و سپس روی Finish کلیک کنید.
برای نمایش تنظیمات بیشتر، مانند پوسته، روی Show Advanced Settings کلیک کنید.
پنجره Verify Configuration ظاهر می شود.
AVD جدید در تب مجازی Device Manager و منوی دستگاه مورد نظر ظاهر می شود.
برای ایجاد یک AVD که با یک کپی شروع می شود:
- از تب Virtual Device Manager، روی Menu کلیک کنید و Duplicate را انتخاب کنید.
پنجره Verify Configuration ظاهر می شود.
- اگر نیاز به ایجاد تغییرات در تصویر سیستم یا انتخاب پنجره های سخت افزاری دارید، روی گزینه قبلی کلیک کنید.
- هر تغییری را که نیاز دارید انجام دهید و سپس روی Finish کلیک کنید.
AVD در تب مجازی Device Manager ظاهر می شود.
یک نمایه سخت افزاری ایجاد کنید
Device Manager پروفایل های سخت افزاری از پیش تعریف شده ای را برای دستگاه های معمولی فراهم می کند تا بتوانید به راحتی آنها را به تعاریف AVD خود اضافه کنید. اگر نیاز به تعریف دستگاه دیگری دارید، می توانید یک نمایه سخت افزاری جدید ایجاد کنید.
می توانید از ابتدا یک نمایه سخت افزاری جدید تعریف کنید یا یک نمایه سخت افزاری را به عنوان نقطه شروع کپی کنید. نمایه های سخت افزاری از پیش بارگذاری شده قابل ویرایش نیستند.
برای ایجاد یک نمایه سخت افزاری جدید از ابتدا:
- در پنجره Select Hardware ، روی New Hardware Profile کلیک کنید.
در پنجره Configure Hardware Profile ، مشخصات مشخصات سخت افزار را در صورت نیاز تغییر دهید.
- روی Finish کلیک کنید.
نمایه سخت افزار جدید شما در پنجره Select Hardware ظاهر می شود. میتوانید یک AVD که از نمایه سختافزاری استفاده میکند، با کلیک بر روی Next یا روی Cancel کلیک کنید تا به تب مجازی یا منوی دستگاه مورد نظر بازگردید.
برای ایجاد نمایه سخت افزاری با استفاده از یک کپی به عنوان نقطه شروع:
- در پنجره Select Hardware ، یک نمایه سخت افزاری را انتخاب کنید و روی Clone Device کلیک کنید یا روی یک نمایه سخت افزاری کلیک راست کرده و Clone را انتخاب کنید.
- در پنجره Configure Hardware Profile ، مشخصات مشخصات سخت افزار را در صورت نیاز تغییر دهید.
- روی 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 ویژگیهای نمایه سختافزار را نادیده میگیرند، و ویژگیهای شبیهساز که هنگام اجرای شبیهساز تنظیم میکنید، هر دو را نادیده میگیرند.
دارایی AVD | توضیحات |
---|---|
نام AVD | یک نام برای AVD وارد کنید. نام می تواند شامل حروف بزرگ یا کوچک، اعداد، نقطه، زیرخط، پرانتز، خط تیره و فاصله باشد. نام فایلی که پیکربندی AVD را ذخیره می کند از نام AVD گرفته شده است. |
AVD ID (پیشرفته) | شناسه AVD را مشاهده کنید. شناسه AVD از نام AVD گرفته شده است. می توانید از ID برای مراجعه به AVD از خط فرمان استفاده کنید. |
مشخصات سخت افزاری | برای انتخاب نمایه سخت افزاری متفاوت از پنجره Select Hardware روی Change کلیک کنید. |
تصویر سیستم | برای انتخاب یک تصویر سیستم متفاوت از پنجره System Image روی تغییر کلیک کنید. برای دانلود یک تصویر جدید به یک اتصال اینترنتی فعال نیاز است. |
گرایش راه اندازی | یک گزینه برای جهت گیری شبیه ساز اولیه انتخاب کنید:
یک گزینه فقط در صورتی فعال می شود که در نمایه سخت افزاری پشتیبانی شود. هنگامی که AVD را در شبیه ساز اجرا می کنید، اگر هر دو حالت عمودی و افقی در نمایه سخت افزاری پشتیبانی می شوند، می توانید جهت را تغییر دهید. |
دوربین (پیشرفته) | یک گزینه برای هر دوربین فعال انتخاب کنید. تنظیمات Emulated و VirtualScene یک تصویر تولید شده توسط نرم افزار تولید می کنند، در حالی که تنظیمات وب کم از وب کم رایانه توسعه شما برای گرفتن عکس استفاده می کند. گزینه های دوربین فقط در صورتی در دسترس هستند که دوربینی در نمایه سخت افزاری پشتیبانی شود. آنها برای Wear OS، Android TV یا Google TV در دسترس نیستند. |
شبکه: سرعت (پیشرفته) | یک پروتکل شبکه را برای تعیین سرعت انتقال داده انتخاب کنید:
|
شبکه: تأخیر (پیشرفته) | یک پروتکل شبکه را انتخاب کنید تا تعیین کنید پروتکل چقدر زمان می برد تا یک بسته داده را از یک نقطه به نقطه دیگر منتقل کند. |
عملکرد شبیه سازی شده: گرافیک | نحوه نمایش گرافیک ها در شبیه ساز را انتخاب کنید:
|
عملکرد شبیه سازی شده: گزینه بوت (پیشرفته) |
نحوه بوت شدن AVD را انتخاب کنید: |
عملکرد شبیه سازی شده: CPU چند هسته ای (پیشرفته) | تعداد هستههای پردازنده رایانه خود را که میخواهید برای شبیهساز استفاده کنید، انتخاب کنید. استفاده از هسته های پردازنده بیشتر باعث افزایش سرعت شبیه ساز می شود. |
حافظه و حافظه: رم (پیشرفته) | مقدار RAM دستگاه را که توسط سازنده سخت افزار تنظیم شده است، لغو کنید. افزایش اندازه از منابع بیشتری در رایانه شما استفاده می کند اما از عملیات شبیه ساز سریعتر پشتیبانی می کند. اندازه RAM را وارد کرده و واحدها را انتخاب کنید، یکی از B (بایت)، کیلوبایت (کیلو بایت)، مگابایت (مگابایت)، گیگابایت (گیگا بایت)، یا TB (ترابایت). |
حافظه و حافظه: VM Heap (پیشرفته) | اندازه پشته VM تنظیم شده توسط سازنده سخت افزار را لغو کنید. اندازه پشته را وارد کنید و واحدها را انتخاب کنید، یکی از B (بایت)، کیلوبایت (کیلو بایت)، مگابایت (مگابایت)، گیگابایت (گیگا بایت)، یا TB (ترابایت). |
حافظه و حافظه: حافظه داخلی (پیشرفته) | مقدار فضای حافظه غیرقابل جابجایی موجود در دستگاه را که توسط سازنده سخت افزار تنظیم شده است، لغو کنید. اندازه ای را وارد کنید و واحدها را انتخاب کنید، یکی از B (بایت)، کیلوبایت (کیلو بایت)، مگابایت (مگابایت)، گیگابایت (گیگا بایت)، یا TB (ترابایت). |
حافظه و حافظه: کارت SD (پیشرفته) | مقدار فضای حافظه قابل جابجایی موجود برای ذخیره داده ها در دستگاه را مشخص کنید. برای استفاده از کارت SD مجازی مدیریت شده توسط Android Studio، Studio-managed را انتخاب کنید، یک اندازه وارد کنید و واحدها را انتخاب کنید، یکی از B (بایت)، کیلوبایت (کیلو بایت)، مگابایت (مگابایت)، گیگابایت (گیگا بایت)، یا TB ( ترابایت). حداقل 100 مگابایت برای استفاده از دوربین توصیه می شود. برای مدیریت فضای یک فایل، External file را انتخاب کرده و روی ... کلیک کنید تا فایل و محل آن مشخص شود. برای اطلاعات بیشتر، دایرکتوری داده |
Device Frame: Device Frame را فعال کنید | برای فعال کردن یک قاب در اطراف پنجره شبیه ساز که ظاهر یک دستگاه واقعی را تقلید می کند، انتخاب کنید. |
تعریف سفارشی پوست (پیشرفته) | پوسته ای را انتخاب کنید که کنترل می کند دستگاه هنگام نمایش در شبیه ساز چگونه به نظر می رسد. مشخص کردن اندازه صفحه نمایش خیلی بزرگ برای پوست می تواند به این معنی باشد که صفحه نمایش قطع شده است، بنابراین نمی توانید کل صفحه را ببینید. برای اطلاعات بیشتر به بخش ایجاد پوسته شبیه ساز مراجعه کنید. |
صفحه کلید: فعال کردن ورودی صفحه کلید (پیشرفته) | این گزینه را برای استفاده از صفحه کلید سخت افزاری خود برای تعامل با شبیه ساز انتخاب کنید. این گزینه برای Wear OS و Android TV غیرفعال است. |
مشخصات مشخصات سخت افزاری
در پنجره Configure Hardware Profile می توانید ویژگی های زیر را برای پروفایل های سخت افزاری مشخص کنید. ویژگیهای پیکربندی AVD ویژگیهای نمایه سختافزار را نادیده میگیرند، و ویژگیهای شبیهساز که هنگام اجرای شبیهساز تنظیم میکنید، هر دو را نادیده میگیرند.
نمایه های سخت افزاری از پیش تعریف شده همراه با Device Manager قابل ویرایش نیستند. با این حال، می توانید پروفایل ها را کپی کنید و کپی ها را ویرایش کنید.
برخی از ویژگی ها برای برخی از انواع دستگاه غیرفعال هستند. به عنوان مثال، ویژگی "Round" فقط در دستگاه های Wear OS موجود است.
ویژگی مشخصات سخت افزاری | توضیحات |
---|---|
نام دستگاه | یک نام برای نمایه سخت افزار وارد کنید. نام می تواند شامل حروف بزرگ یا کوچک، اعداد، نقطه، زیرخط، پرانتز و فاصله باشد. نام فایلی که مشخصات سخت افزار را ذخیره می کند از نام نمایه سخت افزار گرفته شده است. |
نوع دستگاه | یکی از موارد زیر را انتخاب کنید:
|
صفحه نمایش: اندازه صفحه نمایش | اندازه فیزیکی صفحه نمایش را بر حسب اینچ که بر روی قطر اندازه گیری می شود، مشخص کنید. اگر اندازه بزرگتر از صفحه نمایش رایانه شما باشد، در زمان راه اندازی از اندازه آن کاسته می شود. |
صفحه نمایش: وضوح صفحه نمایش | عرض و ارتفاع را بر حسب پیکسل وارد کنید تا تعداد کل پیکسل ها در صفحه شبیه سازی شده مشخص شود. |
صفحه نمایش: گرد | اگر دستگاه دارای صفحه نمایش گرد است، مانند برخی از دستگاه های Wear OS، این گزینه را انتخاب کنید. |
حافظه: RAM | اندازه رم دستگاه را وارد کرده و واحدها را انتخاب کنید، یکی از B (بایت)، کیلوبایت (کیلو بایت)، مگابایت (مگابایت)، گیگابایت (گیگا بایت)، یا TB (ترابایت). |
ورودی: دارای دکمه های سخت افزاری (بازگشت/خانه/منو) | اگر دستگاه شما دارای دکمه های ناوبری سخت افزاری است، این گزینه را انتخاب کنید. اگر این دکمهها فقط در نرمافزار پیادهسازی شدهاند، آن را از حالت انتخاب خارج کنید. اگر این گزینه را انتخاب کنید، دکمه ها روی صفحه ظاهر نمی شوند. در هر صورت، می توانید از پنل کناری شبیه ساز برای شبیه سازی فشار دادن دکمه ها استفاده کنید. |
ورودی: دارای صفحه کلید سخت افزاری | اگر دستگاه شما دارای صفحه کلید سخت افزاری است، این گزینه را انتخاب کنید. اگر نشد آن را لغو انتخاب کنید. اگر این گزینه را انتخاب کنید، صفحه کلیدی روی صفحه ظاهر نمی شود. در هر صورت، می توانید از صفحه کلید رایانه خود برای ارسال کلید به شبیه ساز استفاده کنید. |
ورودی: سبک ناوبری | یکی از موارد زیر را انتخاب کنید:
این گزینه ها برای کنترل های سخت افزاری روی خود دستگاه هستند. با این حال، رویدادهای ارسال شده به دستگاه توسط یک کنترلر خارجی یکسان است. |
حالت های دستگاه پشتیبانی شده | یک یا هر دو گزینه را انتخاب کنید:
شما باید حداقل یک گزینه را انتخاب کنید. اگر هر دو گزینه را انتخاب کنید، می توانید بین جهت گیری ها در شبیه ساز جابجا شوید. |
دوربین ها | برای فعال کردن دوربین، یک یا هر دو گزینه را انتخاب کنید:
اگر دوربین فعال است، میتوانید بر اساس گزینههایی که در پیکربندی AVD انتخاب میکنید، از وبکم دستگاه توسعهدهنده یا عکسی که توسط شبیهساز ارائه شده است، برای شبیهسازی گرفتن عکس استفاده کنید. |
حسگرها: شتاب سنج | اگر دستگاه دارای سخت افزاری است که به تعیین جهت آن کمک می کند، این گزینه را انتخاب کنید. |
سنسور: ژیروسکوپ | اگر دستگاه دارای سخت افزاری است که چرخش یا پیچش را تشخیص می دهد، این گزینه را انتخاب کنید. در ترکیب با یک شتابسنج، یک ژیروسکوپ میتواند تشخیص جهتگیری نرمتر را ارائه دهد و از یک سیستم جهتیابی شش محوره پشتیبانی کند. |
سنسورها: GPS | اگر دستگاه دارای سخت افزاری است که از سیستم ناوبری ماهواره ای مبتنی بر سیستم موقعیت یاب جهانی (GPS) پشتیبانی می کند، این گزینه را انتخاب کنید. |
سنسورها: حسگر مجاورت | اگر دستگاه دارای سخت افزاری است که تشخیص می دهد دستگاه در حین تماس تلفنی نزدیک به چهره کاربر است تا ورودی از صفحه نمایش را غیرفعال کند، این گزینه را انتخاب کنید. |
پوسته پیش فرض | پوسته ای را انتخاب کنید که کنترل می کند دستگاه هنگام نمایش در شبیه ساز چگونه به نظر می رسد. تعیین اندازه صفحهای که برای رزولوشن خیلی بزرگ است میتواند به این معنی باشد که صفحه نمایش قطع شده است، بنابراین نمیتوانید کل صفحه را ببینید. برای اطلاعات بیشتر به بخش زیر در مورد ایجاد پوسته شبیه ساز مراجعه کنید. |
یک پوسته شبیه ساز ایجاد کنید
پوسته شبیه ساز اندروید مجموعه ای از فایل هاست که عناصر بصری و کنترلی نمایشگر شبیه ساز را تعریف می کند. اگر تعاریف پوست موجود در تنظیمات AVD با نیازهای شما مطابقت ندارد، می توانید تعریف پوست سفارشی خود را ایجاد کرده و سپس آن را در AVD خود اعمال کنید.
هر پوسته شبیه ساز شامل:
- یک فایل
hardware.ini
- فایل های طرح بندی برای جهت گیری های پشتیبانی شده و پیکربندی های فیزیکی
- فایل های تصویری برای عناصر نمایش مانند پس زمینه، کلیدها و دکمه ها
برای ایجاد و استفاده از پوسته سفارشی:
- یک دایرکتوری ایجاد کنید که در آن بتوانید فایل های پیکربندی پوست خود را ذخیره کنید.
- ظاهر بصری پوست را در یک فایل متنی به نام
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 } } } ... }
- فایل های بیت مپ تصاویر دستگاه را به همان فهرست اضافه کنید.
- پیکربندیهای دستگاه مخصوص سختافزار اضافی را در یک فایل INI برای تنظیمات دستگاه، مانند
hw.keyboard
وhw.lcd.density
مشخص کنید. - فایل ها را در پوشه پوسته بایگانی کنید و فایل آرشیو را به عنوان پوسته سفارشی انتخاب کنید.
برای اطلاعات دقیق تر درباره ایجاد پوسته های شبیه ساز، مشخصات فایل پوسته شبیه ساز اندروید را در کد منبع ابزار ببینید.
،دستگاه مجازی 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 جدید:
- Device Manager را باز کنید.
- روی ایجاد دستگاه کلیک کنید.
پنجره Select Hardware ظاهر می شود.
توجه داشته باشید که فقط برخی از نمایه های سخت افزاری شامل Play Store هستند. این نمایهها کاملاً با CTS سازگار هستند و ممکن است از تصاویر سیستمی استفاده کنند که شامل برنامه Play Store است.
- یک نمایه سخت افزاری انتخاب کنید، سپس روی Next کلیک کنید.
اگر نمایه سخت افزاری مورد نظر خود را نمی بینید، می توانید یک نمایه سخت افزاری ایجاد یا وارد کنید ، همانطور که در بخش های دیگر این صفحه توضیح داده شده است.
پنجره System Image ظاهر می شود.
- تصویر سیستم را برای یک سطح API خاص انتخاب کنید و سپس روی Next کلیک کنید.
- خواص AVD را در صورت نیاز تغییر دهید و سپس روی Finish کلیک کنید.
برای نمایش تنظیمات بیشتر، مانند پوسته، روی Show Advanced Settings کلیک کنید.
پنجره Verify Configuration ظاهر می شود.
AVD جدید در تب مجازی Device Manager و منوی دستگاه مورد نظر ظاهر می شود.
برای ایجاد یک AVD که با یک کپی شروع می شود:
- از تب Virtual Device Manager، روی Menu کلیک کنید و Duplicate را انتخاب کنید.
پنجره Verify Configuration ظاهر می شود.
- اگر نیاز به ایجاد تغییرات در تصویر سیستم یا انتخاب پنجره های سخت افزاری دارید، روی گزینه قبلی کلیک کنید.
- هر تغییری را که نیاز دارید انجام دهید و سپس روی Finish کلیک کنید.
AVD در تب مجازی Device Manager ظاهر می شود.
یک نمایه سخت افزاری ایجاد کنید
Device Manager پروفایل های سخت افزاری از پیش تعریف شده ای را برای دستگاه های معمولی فراهم می کند تا بتوانید به راحتی آنها را به تعاریف AVD خود اضافه کنید. اگر نیاز به تعریف دستگاه دیگری دارید، می توانید یک نمایه سخت افزاری جدید ایجاد کنید.
می توانید از ابتدا یک نمایه سخت افزاری جدید تعریف کنید یا یک نمایه سخت افزاری را به عنوان نقطه شروع کپی کنید. نمایه های سخت افزاری از پیش بارگذاری شده قابل ویرایش نیستند.
برای ایجاد یک نمایه سخت افزاری جدید از ابتدا:
- در پنجره Select Hardware ، روی New Hardware Profile کلیک کنید.
در پنجره Configure Hardware Profile ، مشخصات مشخصات سخت افزار را در صورت نیاز تغییر دهید.
- روی Finish کلیک کنید.
نمایه سخت افزار جدید شما در پنجره Select Hardware ظاهر می شود. میتوانید یک AVD که از نمایه سختافزاری استفاده میکند، با کلیک بر روی Next یا روی Cancel کلیک کنید تا به تب مجازی یا منوی دستگاه مورد نظر بازگردید.
برای ایجاد نمایه سخت افزاری با استفاده از یک کپی به عنوان نقطه شروع:
- در پنجره Select Hardware ، یک نمایه سخت افزاری را انتخاب کنید و روی Clone Device کلیک کنید یا روی یک نمایه سخت افزاری کلیک راست کرده و Clone را انتخاب کنید.
- در پنجره Configure Hardware Profile ، مشخصات مشخصات سخت افزار را در صورت نیاز تغییر دهید.
- روی 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 ویژگیهای نمایه سختافزار را نادیده میگیرند، و ویژگیهای شبیهساز که هنگام اجرای شبیهساز تنظیم میکنید، هر دو را نادیده میگیرند.
دارایی AVD | توضیحات |
---|---|
نام AVD | یک نام برای AVD وارد کنید. نام می تواند شامل حروف بزرگ یا کوچک، اعداد، نقطه، زیرخط، پرانتز، خط تیره و فاصله باشد. نام فایلی که پیکربندی AVD را ذخیره می کند از نام AVD گرفته شده است. |
AVD ID (پیشرفته) | شناسه AVD را مشاهده کنید. شناسه AVD از نام AVD گرفته شده است. می توانید از ID برای مراجعه به AVD از خط فرمان استفاده کنید. |
مشخصات سخت افزاری | برای انتخاب نمایه سخت افزاری متفاوت از پنجره Select Hardware روی Change کلیک کنید. |
تصویر سیستم | برای انتخاب یک تصویر سیستم متفاوت از پنجره System Image روی تغییر کلیک کنید. برای دانلود یک تصویر جدید به یک اتصال اینترنتی فعال نیاز است. |
گرایش راه اندازی | یک گزینه برای جهت گیری شبیه ساز اولیه انتخاب کنید:
یک گزینه فقط در صورتی فعال می شود که در نمایه سخت افزاری پشتیبانی شود. هنگامی که AVD را در شبیه ساز اجرا می کنید، اگر هر دو حالت عمودی و افقی در نمایه سخت افزاری پشتیبانی می شوند، می توانید جهت را تغییر دهید. |
دوربین (پیشرفته) | یک گزینه برای هر دوربین فعال انتخاب کنید. تنظیمات Emulated و VirtualScene یک تصویر تولید شده توسط نرم افزار تولید می کنند، در حالی که تنظیمات وب کم از وب کم رایانه توسعه شما برای گرفتن عکس استفاده می کند. گزینه های دوربین فقط در صورتی در دسترس هستند که دوربینی در نمایه سخت افزاری پشتیبانی شود. آنها برای Wear OS، Android TV یا Google TV در دسترس نیستند. |
شبکه: سرعت (پیشرفته) | یک پروتکل شبکه را برای تعیین سرعت انتقال داده انتخاب کنید:
|
شبکه: تأخیر (پیشرفته) | یک پروتکل شبکه را انتخاب کنید تا تعیین کنید پروتکل چقدر زمان می برد تا یک بسته داده را از یک نقطه به نقطه دیگر منتقل کند. |
عملکرد شبیه سازی شده: گرافیک | نحوه نمایش گرافیک ها در شبیه ساز را انتخاب کنید:
|
عملکرد شبیه سازی شده: گزینه بوت (پیشرفته) |
نحوه بوت شدن AVD را انتخاب کنید: |
عملکرد شبیه سازی شده: CPU چند هسته ای (پیشرفته) | تعداد هستههای پردازنده رایانه خود را که میخواهید برای شبیهساز استفاده کنید، انتخاب کنید. استفاده از هسته های پردازنده بیشتر باعث افزایش سرعت شبیه ساز می شود. |
حافظه و حافظه: رم (پیشرفته) | مقدار RAM دستگاه را که توسط سازنده سخت افزار تنظیم شده است، لغو کنید. افزایش اندازه از منابع بیشتری در رایانه شما استفاده می کند اما از عملیات شبیه ساز سریعتر پشتیبانی می کند. اندازه RAM را وارد کرده و واحدها را انتخاب کنید، یکی از B (بایت)، کیلوبایت (کیلو بایت)، مگابایت (مگابایت)، گیگابایت (گیگا بایت)، یا TB (ترابایت). |
حافظه و حافظه: VM Heap (پیشرفته) | اندازه پشته VM تنظیم شده توسط سازنده سخت افزار را لغو کنید. اندازه پشته را وارد کنید و واحدها را انتخاب کنید، یکی از B (بایت)، کیلوبایت (کیلو بایت)، مگابایت (مگابایت)، گیگابایت (گیگا بایت)، یا TB (ترابایت). |
حافظه و حافظه: حافظه داخلی (پیشرفته) | مقدار فضای حافظه غیرقابل جابجایی موجود در دستگاه را که توسط سازنده سخت افزار تنظیم شده است، لغو کنید. اندازه ای را وارد کنید و واحدها را انتخاب کنید، یکی از B (بایت)، کیلوبایت (کیلو بایت)، مگابایت (مگابایت)، گیگابایت (گیگا بایت)، یا TB (ترابایت). |
حافظه و حافظه: کارت SD (پیشرفته) | میزان فضای حافظه قابل جابجایی را برای ذخیره داده ها در دستگاه مشخص کنید. برای استفاده از یک کارت SD مجازی که توسط Android Studio اداره می شود ، استودیو را با مدیریت انتخاب کنید ، اندازه را وارد کنید و واحدها را انتخاب کنید ، یکی از B (بایت) ، KB (کیلوبیت) ، MB (مگابیت) ، GB (گیگابایت) یا سل (TB) terabyte). حداقل 100 مگابایت برای استفاده از دوربین توصیه می شود. برای مدیریت فضا در یک پرونده ، فایل خارجی را انتخاب کرده و روی ... کلیک کنید تا فایل و مکان مشخص شود. برای اطلاعات بیشتر ، به فهرست داده های |
قاب دستگاه: قاب دستگاه را فعال کنید | برای فعال کردن یک قاب در اطراف پنجره شبیه ساز که از ظاهر یک دستگاه واقعی تقلید می کند ، انتخاب کنید. |
تعریف پوست سفارشی (پیشرفته) | پوستی را انتخاب کنید که دستگاه را هنگام نمایش در شبیه ساز کنترل می کند. مشخص کردن اندازه صفحه نمایش که برای پوست بسیار بزرگ است می تواند به معنای قطع صفحه باشد ، بنابراین نمی توانید کل صفحه را ببینید. برای اطلاعات بیشتر به بخش ایجاد یک شبیه ساز پوست مراجعه کنید. |
صفحه کلید: ورودی صفحه کلید را فعال کنید (پیشرفته) | این گزینه را انتخاب کنید تا از صفحه کلید سخت افزار خود برای تعامل با شبیه ساز استفاده کنید. این گزینه برای Wear Os و Android TV غیرفعال است. |
خصوصیات پروفایل سخت افزار
می توانید ویژگی های زیر را برای پروفایل های سخت افزاری در پنجره مشخصات سخت افزار پیکربندی مشخص کنید. ویژگی های پیکربندی AVD از خصوصیات پروفایل سخت افزار و خصوصیات شبیه ساز که در حالی که شبیه ساز در حال اجرا است ، بر روی هر دو مورد غلبه می کند.
پروفایل سخت افزاری از پیش تعریف شده موجود در مدیر دستگاه قابل ویرایش نیست. با این حال ، می توانید پروفایل ها را کپی کرده و نسخه ها را ویرایش کنید.
برخی از خصوصیات برای برخی از انواع دستگاه ها غیرفعال هستند. به عنوان مثال ، خاصیت "دور" فقط در دستگاه های سیستم عامل Wear موجود است.
ویژگی پروفایل سخت افزار | توضیحات |
---|---|
نام دستگاه | نامی را برای نمایه سخت افزار وارد کنید. این نام می تواند حاوی حروف بزرگ یا کوچک ، اعداد ، دوره ها ، تأثیرات ، پرانتز و فضاها باشد. نام پرونده ای که نمایه سخت افزار را ذخیره می کند از نام پروفایل سخت افزار گرفته شده است. |
نوع دستگاه | یکی از موارد زیر را انتخاب کنید:
|
صفحه: اندازه صفحه نمایش | اندازه فیزیکی صفحه را در اینچ مشخص کنید ، که روی مورب اندازه گیری می شود. اگر اندازه از صفحه رایانه شما بزرگتر باشد ، در هنگام راه اندازی اندازه آن کاهش می یابد. |
صفحه: وضوح صفحه نمایش | عرض و ارتفاع را در پیکسل ها وارد کنید تا تعداد کل پیکسل ها در صفحه شبیه سازی شده مشخص شود. |
صفحه: دور | اگر دستگاه دارای صفحه نمایش گرد است ، مانند برخی از دستگاه های سیستم عامل Wear ، این گزینه را انتخاب کنید. |
حافظه: رم | اندازه رم دستگاه را وارد کرده و واحدها ، یکی از B (بایت) ، KB (کیلوبیت) ، MB (مگابیت) ، GB (گیگابایت) یا سل (terabyte) را انتخاب کنید. |
ورودی: دکمه های سخت افزاری (پشت/خانه/منو) | اگر دستگاه شما دارای دکمه های ناوبری سخت افزار است ، این گزینه را انتخاب کنید. اگر این دکمه ها فقط در نرم افزار اجرا شوند ، آن را انتخاب کنید. اگر این گزینه را انتخاب کنید ، دکمه ها روی صفحه ظاهر نمی شوند. در هر صورت ، می توانید از پانل جانبی Emulator برای شبیه سازی فشار دادن دکمه ها استفاده کنید. |
ورودی: دارای صفحه کلید سخت افزار است | اگر دستگاه شما دارای صفحه کلید سخت افزار است ، این گزینه را انتخاب کنید. اگر این کار را نکند ، آن را انتخاب کنید. اگر این گزینه را انتخاب کنید ، یک صفحه کلید روی صفحه نمایش داده نمی شود. در هر صورت ، می توانید از صفحه کلید رایانه خود برای ارسال کلیدهای کلید به شبیه ساز استفاده کنید. |
ورودی: سبک ناوبری | یکی از موارد زیر را انتخاب کنید:
این گزینه ها برای کنترل سخت افزار در خود دستگاه است. با این حال ، وقایع ارسال شده توسط یک کنترلر خارجی به دستگاه یکسان است. |
دستگاه های پشتیبانی شده | یکی یا هر دو گزینه را انتخاب کنید:
شما باید حداقل یک گزینه را انتخاب کنید. اگر هر دو گزینه را انتخاب کنید ، می توانید بین جهت گیری در شبیه ساز جابجا شوید. |
دوربین ها | برای فعال کردن دوربین ، یکی یا هر دو گزینه را انتخاب کنید:
اگر دوربین فعال باشد ، می توانید بر اساس گزینه هایی که در پیکربندی AVD انتخاب می کنید ، از وب کم دستگاه توسعه خود یا عکسی که توسط شبیه ساز تهیه شده است استفاده کنید. |
سنسورها: شتاب سنج | اگر دستگاه سخت افزاری دارد که به تعیین جهت گیری آن کمک می کند ، این گزینه را انتخاب کنید. |
سنسورها: ژیروسکوپ | اگر دستگاه دارای سخت افزاری است که چرخش یا پیچش را تشخیص می دهد ، این گزینه را انتخاب کنید. در ترکیب با شتاب سنج ، یک ژیروسکوپ می تواند تشخیص جهت گیری نرم و صاف را فراهم کند و از یک سیستم جهت گیری شش محور پشتیبانی کند. |
سنسورها: GPS | اگر دستگاه دارای سخت افزاری است که از سیستم ناوبری مبتنی بر ماهواره ای سیستم موقعیت یابی (GPS) پشتیبانی می کند ، این گزینه را انتخاب کنید. |
سنسورها: سنسور مجاورت | این گزینه را انتخاب کنید اگر دستگاه دارای سخت افزاری است که در هنگام تماس تلفنی به صورت کاربر نزدیک است تا بتواند ورودی را از صفحه غیرفعال کند. |
پوست پیش فرض | پوستی را انتخاب کنید که دستگاه را هنگام نمایش در شبیه ساز کنترل می کند. مشخص کردن اندازه صفحه نمایش که برای وضوح بسیار بزرگ است می تواند به معنای قطع صفحه باشد ، بنابراین نمی توانید کل صفحه را ببینید. برای اطلاعات بیشتر به بخشی که در مورد ایجاد پوست شبیه ساز در زیر آمده است ، مراجعه کنید. |
پوست شبیه ساز ایجاد کنید
پوست شبیه ساز اندرویدی مجموعه ای از پرونده ها است که عناصر بصری و کنترل یک نمایشگر شبیه ساز را تعریف می کند. اگر تعاریف پوستی موجود در تنظیمات AVD نیازهای شما را برآورده نمی کند ، می توانید تعریف پوست سفارشی خود را ایجاد کرده و سپس آن را در AVD خود بمالید.
هر پوست شبیه ساز شامل:
- یک فایل
hardware.ini
- پرونده های چیدمان برای جهت گیری های پشتیبانی شده و تنظیمات فیزیکی
- پرونده های تصویری برای عناصر نمایشگر مانند پس زمینه ، کلیدها و دکمه ها
برای ایجاد و استفاده از پوست سفارشی:
- یک دایرکتوری ایجاد کنید که در آن بتوانید پرونده های پیکربندی پوست خود را ذخیره کنید.
- ظاهر بصری پوست را در یک فایل متنی به نام
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 } } } ... }
- فایلهای bitmap تصاویر دستگاه را به همان فهرست اضافه کنید.
- تنظیمات دستگاه های خاص سخت افزاری خاص را در یک فایل INI برای تنظیمات دستگاه مانند
hw.keyboard
وhw.lcd.density
مشخص کنید. - پرونده ها را در پوشه پوست بایگانی کنید و پرونده بایگانی را به عنوان پوست سفارشی انتخاب کنید.
برای کسب اطلاعات بیشتر در مورد ایجاد پوسته های شبیه ساز ، به مشخصات فایل پوست Android Emulator Skin در کد منبع Tools مراجعه کنید.
،یک دستگاه مجازی Android (AVD) پیکربندی است که ویژگی های تلفن Android ، رایانه لوحی ، Wear Os ، Android TV یا دستگاه سیستم عامل خودرویی را که می خواهید در شبیه ساز Android شبیه سازی کنید ، تعریف می کند. مدیر دستگاه ابزاری است که می توانید از Android Studio راه اندازی کنید که به شما در ایجاد و مدیریت AVD کمک می کند.
برای باز کردن مدیر دستگاه جدید ، یکی از موارد زیر را انجام دهید:
- از صفحه خوشآمدگویی Android Studio، گزینههای More Actions > Virtual Device Manager را انتخاب کنید.
- پس از باز کردن یک پروژه ، از نوار منو اصلی ، View> Tool Windows> Manager Manager را انتخاب کنید ، سپس روی + کلیک کنید و سپس بر روی ایجاد دستگاه مجازی کلیک کنید.
پس از ایجاد دستگاه های خود ، می توانید لیستی از تمام دستگاه های موجود در پانل دستگاه مدیر را مشاهده کنید.
اگر می خواهید از دستگاه های مجازی استفاده کنید تا تست های سازهای خودکار خود را به روشی مقیاس پذیر و خود مدیریت کنید ، از دستگاه های مدیریت شده درجه بندی استفاده کنید.
درباره AVDS
AVD حاوی مشخصات سخت افزاری ، تصویر سیستم ، فضای ذخیره سازی ، پوست و سایر خصوصیات است.
توصیه می کنیم برای هر تصویر سیستم یک AVD ایجاد کنید که برنامه شما به طور بالقوه می تواند بر اساس تنظیم <uses-sdk>
در مانیفست خود پشتیبانی کند.
نمایه سخت افزار
مشخصات سخت افزار ویژگی های یک دستگاه را به عنوان ارسال شده از کارخانه تعریف می کند. مدیر دستگاه با پروفایل های سخت افزاری خاصی مانند دستگاه های پیکسل از قبل بارگیری می شود و می توانید در صورت لزوم پروفایل های سخت افزاری را تعریف یا سفارشی کنید.
تعریف دستگاهی که با آرم Google Play در ستون Play Store برچسب گذاری شده است شامل برنامه Google Play Store و دسترسی به خدمات Google Play ، از جمله یک برگه Google Play در گفتگوی Extended Controls است که یک دکمه مناسب برای به روزرسانی خدمات Google Play در این زمینه فراهم می کند دستگاه
دستگاه هایی با این آرم و نوع دستگاه "تلفن" نیز سازگار با CT هستند و ممکن است از تصاویر سیستم استفاده کنند که شامل برنامه Play Store است.
تصاویر سیستم
یک تصویر سیستم با برچسب Google API شامل دسترسی به خدمات Google Play است.
برگه توصیه شده تصاویر سیستم توصیه شده را لیست می کند. برگه های دیگر شامل یک لیست کامل تر است. صفحه سمت راست تصویر سیستم انتخاب شده را توصیف می کند.
اگر یک نماد بارگیری را در کنار یک تصویر سیستم مشاهده می کنید ، آن تصویر در حال حاضر روی دستگاه توسعه شما نصب نشده است. برای بارگیری تصویر سیستم ، روی نماد کلیک کنید. برای بارگیری تصاویر سیستم باید به اینترنت وصل شوید.
سطح API دستگاه هدف مهم است ، زیرا برنامه شما بر روی تصویر سیستم با سطح API که پایین تر از برنامه مورد نیاز برنامه شما است ، اجرا نمی شود ، همانطور که در ویژگی minSdk
در پرونده مانیفست برنامه مشخص شده است. برای کسب اطلاعات بیشتر در مورد رابطه بین سطح API سیستم و minSdk
، به نسخه برنامه خود مراجعه کنید.
اگر برنامه شما یک عنصر <uses-library>
را در پرونده مانیفست اعلام کند ، برنامه به یک تصویر سیستم نیاز دارد که شامل آن کتابخانه خارجی باشد. برای اجرای برنامه خود بر روی یک شبیه ساز ، یک AVD ایجاد کنید که شامل کتابخانه مورد نیاز باشد. برای انجام این کار ، ممکن است لازم باشد از یک مؤلفه افزودنی برای پلت فرم AVD استفاده کنید. به عنوان مثال ، افزودنی Google APIS شامل کتابخانه Google Maps است.
برای اطمینان از امنیت برنامه و یک تجربه مداوم با دستگاه های فیزیکی ، تصاویر سیستم با فروشگاه Google Play با یک کلید انتشار امضا می شوند ، به این معنی که شما نمی توانید با این تصاویر امتیازات بالا (ROOT) بدست آورید.
اگر برای کمک به عیب یابی برنامه به امتیازات بالا (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 شبیه سازی شده را ذخیره می کند. در صورت لزوم ، می توانید از مدیر دستگاه برای پاک کردن داده های کاربر استفاده کنید تا دستگاه داده های مشابهی داشته باشد که گویی جدید است.
پوست
پوست شبیه ساز ظاهر یک دستگاه را مشخص می کند. مدیر دستگاه برخی از پوست های از پیش تعریف شده را ارائه می دهد. همچنین می توانید پوست خود را تعریف کنید یا از پوست های ارائه شده توسط اشخاص ثالث استفاده کنید.
ویژگی های AVD و برنامه
اطمینان حاصل کنید که تعریف AVD شما شامل ویژگی های دستگاه شما بستگی دارد. برای لیست ویژگی هایی که می توانید در AVD های خود تعریف کنید ، بخش های مربوط به خصوصیات پروفایل سخت افزار و ویژگی های AVD را مشاهده کنید.
ایجاد AVD
برای ایجاد یک AVD جدید:
- Device Manager را باز کنید.
- روی ایجاد دستگاه کلیک کنید.
پنجره Select Hardware ظاهر می شود.
توجه کنید که فقط برخی از پروفایل های سخت افزاری شامل فروشگاه Play هستند. این پروفایل ها کاملاً سازگار با CT هستند و ممکن است از تصاویر سیستم استفاده کنند که شامل برنامه Play Store است.
- یک پروفایل سخت افزار را انتخاب کنید ، سپس روی Next کلیک کنید.
اگر نمایه سخت افزاری مورد نظر خود را نمی بینید ، می توانید مشخصات سخت افزاری را ایجاد یا وارد کنید ، همانطور که در بخش های دیگر این صفحه توضیح داده شده است.
پنجره تصویر سیستم ظاهر می شود.
- تصویر سیستم را برای یک سطح API خاص انتخاب کرده و سپس روی Next کلیک کنید.
- خواص AVD را در صورت لزوم تغییر دهید و سپس روی Finish کلیک کنید.
برای نمایش تنظیمات بیشتر مانند پوست ، روی نمایش تنظیمات پیشرفته کلیک کنید.
پنجره Verify Configuration ظاهر می شود.
AVD جدید در برگه مجازی مدیر دستگاه و منوی دستگاه هدف ظاهر می شود.
برای ایجاد AVD با یک نسخه:
- از برگه مجازی مدیر دستگاه ، روی منوی کلیک کنید و کپی را انتخاب کنید.
پنجره Verify Configuration ظاهر می شود.
- در صورت نیاز به ایجاد تغییر در تصویر سیستم یا انتخاب ویندوز سخت افزاری ، روی قبلی کلیک کنید.
- هرگونه تغییر مورد نیاز خود را ایجاد کنید و سپس روی Finish کلیک کنید.
AVD در برگه مجازی مدیر دستگاه ظاهر می شود.
یک پروفایل سخت افزار ایجاد کنید
مدیر دستگاه پروفایل های سخت افزاری از پیش تعریف شده را برای دستگاه های مشترک فراهم می کند تا بتوانید به راحتی آنها را به تعاریف AVD خود اضافه کنید. اگر نیاز به تعریف دستگاه دیگری دارید ، می توانید یک نمایه سخت افزار جدید ایجاد کنید.
می توانید از ابتدا یک پروفایل سخت افزار جدید را تعریف کنید یا یک پروفایل سخت افزار را به عنوان نقطه شروع کپی کنید. پروفایل های سخت افزاری از پیش بارگذاری شده قابل ویرایش نیستند.
برای ایجاد یک پروفایل سخت افزار جدید از ابتدا:
- در پنجره Select Hardware ، روی نمایه سخت افزار جدید کلیک کنید.
در پنجره مشخصات سخت افزار Configure ، در صورت لزوم خصوصیات پروفایل سخت افزار را تغییر دهید.
- روی Finish کلیک کنید.
نمایه سخت افزار جدید شما در پنجره Select Hardware ظاهر می شود. می توانید یک AVD ایجاد کنید که با کلیک بر روی Next یا روی Cancel کلیک کنید تا به برگه مجازی یا منوی دستگاه هدف برگردید.
برای ایجاد پروفایل سخت افزار با استفاده از یک کپی به عنوان نقطه شروع:
- در پنجره Select Hardware ، یک پروفایل سخت افزار را انتخاب کرده و روی دستگاه Clone کلیک کنید یا روی یک پروفایل سخت افزار کلیک راست کرده و کلون را انتخاب کنید.
- در پنجره مشخصات سخت افزار Configure ، در صورت لزوم خصوصیات پروفایل سخت افزار را تغییر دهید.
- روی Finish کلیک کنید.
نمایه سخت افزار جدید شما در پنجره Select Hardware ظاهر می شود. می توانید یک AVD ایجاد کنید که با کلیک بر روی Next یا روی Cancel کلیک کنید تا به برگه مجازی یا منوی دستگاه هدف برگردید.
AVD های موجود را ویرایش کنید
می توانید عملیات زیر را از طریق برگه مجازی مدیر دستگاه انجام دهید:
- برای ویرایش AVD ، روی ویرایش این AVD کلیک کنید و تغییرات خود را انجام دهید.
- برای حذف یک AVD ، روی منوی کلیک کنید و حذف را انتخاب کنید.
- برای نشان دادن پرونده های AVD INI و IMG در دیسک ، روی منوی کلیک کنید و Show on Disk را انتخاب کنید.
- برای مشاهده جزئیات پیکربندی AVD که می توانید در گزارش های اشکال به تیم استودیوی Android درج کنید ، روی منوی کلیک کنید و مشاهده جزئیات را انتخاب کنید.
پروفایل های سخت افزاری موجود را ویرایش کنید
شما نمی توانید پروفایل های سخت افزاری از پیش بارگذاری شده را ویرایش یا حذف کنید ، اما می توانید عملیات زیر را در سایر پروفایل های سخت افزاری از پنجره Select Hardware انجام دهید:
- برای ویرایش نمایه سخت افزاری ، آن را انتخاب کرده و بر روی ویرایش دستگاه کلیک کنید. همچنین می توانید روی یک پروفایل سخت افزار راست کلیک کرده و Edit را انتخاب کنید. بعد ، تغییرات خود را انجام دهید.
- برای حذف نمایه سخت افزاری ، روی آن کلیک راست کرده و Delete را انتخاب کنید.
یک شبیه ساز را اجرا و متوقف کنید و داده ها را پاک کنید
از برگه مجازی می توانید عملیات زیر را بر روی یک شبیه ساز انجام دهید:
- برای اجرای یک شبیه ساز که از AVD استفاده می کند ، روی پرتاب کلیک کنید .
- برای متوقف کردن یک شبیه ساز در حال اجرا ، روی منو کلیک کنید و SELECT STOP .
- برای پاک کردن داده های یک شبیه ساز ، روی منوی کلیک کنید و داده های Wipe را انتخاب کنید.
پروفایل سخت افزار واردات و صادرات
از پنجره Select Hardware ، می توانید پروفایل های سخت افزاری را به شرح زیر وارد و صادر کنید:
- برای وارد کردن یک پروفایل سخت افزار ، روی واردات پروفایل های سخت افزاری کلیک کنید و پرونده XML را در رایانه خود با تعریف انتخاب کنید.
- برای صادر کردن نمایه سخت افزار ، روی آن کلیک راست کرده و Export را انتخاب کنید. مکانی را که می خواهید فایل XML حاوی تعریف را در آن ذخیره کنید، مشخص کنید.
خواص AVD
پیکربندی AVD تعامل بین رایانه توسعه و شبیه ساز و همچنین خواصی را که می خواهید در پروفایل سخت افزار نادیده بگیرید ، مشخص می کند. می توانید ویژگی های زیر را برای تنظیمات AVD در پنجره تأیید پیکربندی مشخص کنید. ویژگی های دارای برچسب (پیشرفته) فقط در صورت کلیک بر روی نمایش تنظیمات پیشرفته نمایش داده می شوند.
ویژگی های پیکربندی AVD از خصوصیات پروفایل سخت افزار و خصوصیات شبیه ساز که در حالی که شبیه ساز در حال اجرا است ، بر روی هر دو مورد غلبه می کند.
دارایی AVD | توضیحات |
---|---|
نام AVD | نامی را برای AVD وارد کنید. این نام می تواند حاوی حروف بزرگ یا کوچک ، اعداد ، دوره ها ، تأکیدات ، پرانتز ، خط و فضاها باشد. نام پرونده ذخیره شده در پیکربندی AVD از نام AVD گرفته شده است. |
شناسه AVD (پیشرفته) | شناسه AVD را مشاهده کنید. شناسه AVD از نام AVD گرفته شده است. می توانید از ID برای مراجعه به AVD از خط فرمان استفاده کنید. |
نمایه سخت افزار | برای انتخاب یک نمایه سخت افزار متفاوت از پنجره Select Hardware ، روی تغییر کلیک کنید. |
تصویر سیستم | برای انتخاب یک تصویر سیستم متفاوت از پنجره Image System ، روی تغییر کلیک کنید. برای بارگیری یک تصویر جدید ، یک اتصال اینترنتی فعال لازم است. |
جهت گیری | گزینه ای را برای جهت گیری اولیه شبیه ساز انتخاب کنید:
گزینه فقط در صورت پشتیبانی در پروفایل سخت افزار فعال می شود. هنگام اجرای AVD در شبیه ساز ، اگر هم پرتره و هم منظره در پروفایل سخت افزار پشتیبانی شوند ، می توانید جهت گیری را تغییر دهید. |
دوربین (پیشرفته) | گزینه ای را برای هر دوربین فعال انتخاب کنید. تنظیمات تقلید شده و VirtualScene تصویری تولید شده توسط نرم افزار تولید می کنند ، در حالی که تنظیمات وب کم از وب کم رایانه توسعه شما برای گرفتن عکس استفاده می کند گزینه های دوربین فقط در صورت پشتیبانی از دوربین در پروفایل سخت افزار در دسترس هستند. آنها برای Wear Os ، Android TV یا Google TV در دسترس نیستند. |
شبکه: سرعت (پیشرفته) | برای تعیین سرعت انتقال داده ، یک پروتکل شبکه را انتخاب کنید:
|
شبکه: تأخیر (پیشرفته) | یک پروتکل شبکه را انتخاب کنید تا تعیین کنید که مدت زمان لازم برای پروتکل برای انتقال یک بسته داده از یک نقطه به نقطه دیگر است. |
عملکرد تقلید شده: گرافیک | نحوه ارائه گرافیک در شبیه ساز را انتخاب کنید:
|
عملکرد تقلید شده: گزینه بوت (پیشرفته) |
نحوه چکمه های AVD را انتخاب کنید: |
عملکرد شبیه سازی شده: CPU چند هسته ای (پیشرفته) | تعداد هسته های پردازنده را در رایانه خود انتخاب کنید که می خواهید برای شبیه ساز استفاده کنید. با استفاده از هسته های پردازنده بیشتر ، شبیه ساز را سرعت می بخشد. |
حافظه و ذخیره سازی: RAM (پیشرفته) | مقدار رم را روی دستگاه تعیین شده توسط سازنده سخت افزار نادیده بگیرید. افزایش اندازه از منابع بیشتری در رایانه شما استفاده می کند اما از عملکرد شبیه ساز سریعتر پشتیبانی می کند. اندازه رم را وارد کنید و واحدها ، یکی از B (بایت) ، KB (کیلوبیت) ، MB (مگابیت) ، GB (گیگابایت) یا سل (terabyte) را انتخاب کنید. |
حافظه و ذخیره سازی: VM Heap (پیشرفته) | اندازه VM پشته تنظیم شده توسط سازنده سخت افزار را نادیده بگیرید. اندازه پشته را وارد کنید و واحدها ، یکی از B (بایت) ، KB (کیلوبیت) ، MB (مگابیت) ، GB (گیگابایت) یا سل (terabyte) را انتخاب کنید. |
حافظه و ذخیره سازی: حافظه داخلی (پیشرفته) | مقدار فضای حافظه غیر قابل جابجایی موجود در دستگاه تعیین شده توسط سازنده سخت افزار را نادیده بگیرید. اندازه را وارد کنید و واحدها ، یکی از B (بایت) ، KB (کیلوبیت) ، MB (مگابیت) ، GB (گیگابایت) یا سل (terabyte) را انتخاب کنید. |
حافظه و ذخیره سازی: کارت SD (پیشرفته) | میزان فضای حافظه قابل جابجایی را برای ذخیره داده ها در دستگاه مشخص کنید. برای استفاده از یک کارت SD مجازی که توسط Android Studio اداره می شود ، استودیو را با مدیریت انتخاب کنید ، اندازه را وارد کنید و واحدها را انتخاب کنید ، یکی از B (بایت) ، KB (کیلوبیت) ، MB (مگابیت) ، GB (گیگابایت) یا سل (TB) terabyte). حداقل 100 مگابایت برای استفاده از دوربین توصیه می شود. برای مدیریت فضا در یک پرونده ، فایل خارجی را انتخاب کرده و روی ... کلیک کنید تا فایل و مکان مشخص شود. برای اطلاعات بیشتر ، به فهرست داده های |
قاب دستگاه: قاب دستگاه را فعال کنید | برای فعال کردن یک قاب در اطراف پنجره شبیه ساز که از ظاهر یک دستگاه واقعی تقلید می کند ، انتخاب کنید. |
تعریف پوست سفارشی (پیشرفته) | پوستی را انتخاب کنید که دستگاه را هنگام نمایش در شبیه ساز کنترل می کند. مشخص کردن اندازه صفحه نمایش که برای پوست بسیار بزرگ است می تواند به معنای قطع صفحه باشد ، بنابراین نمی توانید کل صفحه را ببینید. برای اطلاعات بیشتر به بخش ایجاد یک شبیه ساز پوست مراجعه کنید. |
صفحه کلید: ورودی صفحه کلید را فعال کنید (پیشرفته) | این گزینه را انتخاب کنید تا از صفحه کلید سخت افزار خود برای تعامل با شبیه ساز استفاده کنید. این گزینه برای Wear Os و Android TV غیرفعال است. |
خصوصیات پروفایل سخت افزار
می توانید ویژگی های زیر را برای پروفایل های سخت افزاری در پنجره مشخصات سخت افزار پیکربندی مشخص کنید. ویژگی های پیکربندی AVD از خصوصیات پروفایل سخت افزار و خصوصیات شبیه ساز که در حالی که شبیه ساز در حال اجرا است ، بر روی هر دو مورد غلبه می کند.
پروفایل سخت افزاری از پیش تعریف شده موجود در مدیر دستگاه قابل ویرایش نیست. با این حال ، می توانید پروفایل ها را کپی کرده و نسخه ها را ویرایش کنید.
برخی از خصوصیات برای برخی از انواع دستگاه ها غیرفعال هستند. به عنوان مثال ، خاصیت "دور" فقط در دستگاه های سیستم عامل Wear موجود است.
ویژگی پروفایل سخت افزار | توضیحات |
---|---|
نام دستگاه | نامی را برای نمایه سخت افزار وارد کنید. این نام می تواند حاوی حروف بزرگ یا کوچک ، اعداد ، دوره ها ، تأثیرات ، پرانتز و فضاها باشد. نام پرونده ای که نمایه سخت افزار را ذخیره می کند از نام پروفایل سخت افزار گرفته شده است. |
نوع دستگاه | یکی از موارد زیر را انتخاب کنید:
|
صفحه: اندازه صفحه نمایش | اندازه فیزیکی صفحه را در اینچ مشخص کنید ، که روی مورب اندازه گیری می شود. اگر اندازه از صفحه رایانه شما بزرگتر باشد ، در هنگام راه اندازی اندازه آن کاهش می یابد. |
صفحه: وضوح صفحه نمایش | عرض و ارتفاع را در پیکسل ها وارد کنید تا تعداد کل پیکسل ها در صفحه شبیه سازی شده مشخص شود. |
صفحه: دور | اگر دستگاه دارای صفحه نمایش گرد است ، مانند برخی از دستگاه های سیستم عامل Wear ، این گزینه را انتخاب کنید. |
حافظه: رم | اندازه رم دستگاه را وارد کرده و واحدها ، یکی از B (بایت) ، KB (کیلوبیت) ، MB (مگابیت) ، GB (گیگابایت) یا سل (terabyte) را انتخاب کنید. |
ورودی: دکمه های سخت افزاری (پشت/خانه/منو) | اگر دستگاه شما دارای دکمه های ناوبری سخت افزار است ، این گزینه را انتخاب کنید. اگر این دکمه ها فقط در نرم افزار اجرا شوند ، آن را انتخاب کنید. اگر این گزینه را انتخاب کنید ، دکمه ها روی صفحه ظاهر نمی شوند. در هر صورت ، می توانید از پانل جانبی Emulator برای شبیه سازی فشار دادن دکمه ها استفاده کنید. |
ورودی: دارای صفحه کلید سخت افزار است | اگر دستگاه شما دارای صفحه کلید سخت افزار است ، این گزینه را انتخاب کنید. اگر این کار را نکند ، آن را انتخاب کنید. اگر این گزینه را انتخاب کنید ، یک صفحه کلید روی صفحه نمایش داده نمی شود. در هر صورت ، می توانید از صفحه کلید رایانه خود برای ارسال کلیدهای کلید به شبیه ساز استفاده کنید. |
ورودی: سبک ناوبری | یکی از موارد زیر را انتخاب کنید:
این گزینه ها برای کنترل سخت افزار در خود دستگاه است. با این حال ، وقایع ارسال شده توسط یک کنترلر خارجی به دستگاه یکسان است. |
دستگاه های پشتیبانی شده | یکی یا هر دو گزینه را انتخاب کنید:
شما باید حداقل یک گزینه را انتخاب کنید. اگر هر دو گزینه را انتخاب کنید ، می توانید بین جهت گیری در شبیه ساز جابجا شوید. |
دوربین ها | برای فعال کردن دوربین ، یکی یا هر دو گزینه را انتخاب کنید:
اگر دوربین فعال باشد ، می توانید بر اساس گزینه هایی که در پیکربندی AVD انتخاب می کنید ، از وب کم دستگاه توسعه خود یا عکسی که توسط شبیه ساز تهیه شده است استفاده کنید. |
سنسورها: شتاب سنج | اگر دستگاه سخت افزاری دارد که به تعیین جهت گیری آن کمک می کند ، این گزینه را انتخاب کنید. |
سنسورها: ژیروسکوپ | اگر دستگاه دارای سخت افزاری است که چرخش یا پیچش را تشخیص می دهد ، این گزینه را انتخاب کنید. در ترکیب با شتاب سنج ، یک ژیروسکوپ می تواند تشخیص جهت گیری نرم و صاف را فراهم کند و از یک سیستم جهت گیری شش محور پشتیبانی کند. |
سنسورها: GPS | اگر دستگاه دارای سخت افزاری است که از سیستم ناوبری مبتنی بر ماهواره ای سیستم موقعیت یابی (GPS) پشتیبانی می کند ، این گزینه را انتخاب کنید. |
سنسورها: سنسور مجاورت | این گزینه را انتخاب کنید اگر دستگاه دارای سخت افزاری است که در هنگام تماس تلفنی به صورت کاربر نزدیک است تا بتواند ورودی را از صفحه غیرفعال کند. |
پوست پیش فرض | پوستی را انتخاب کنید که دستگاه را هنگام نمایش در شبیه ساز کنترل می کند. مشخص کردن اندازه صفحه نمایش که برای وضوح بسیار بزرگ است می تواند به معنای قطع صفحه باشد ، بنابراین نمی توانید کل صفحه را ببینید. برای اطلاعات بیشتر به بخشی که در مورد ایجاد پوست شبیه ساز در زیر آمده است ، مراجعه کنید. |
پوست شبیه ساز ایجاد کنید
پوست شبیه ساز اندرویدی مجموعه ای از پرونده ها است که عناصر بصری و کنترل یک نمایشگر شبیه ساز را تعریف می کند. اگر تعاریف پوستی موجود در تنظیمات AVD نیازهای شما را برآورده نمی کند ، می توانید تعریف پوست سفارشی خود را ایجاد کرده و سپس آن را در AVD خود بمالید.
هر پوست شبیه ساز شامل:
- یک فایل
hardware.ini
- پرونده های چیدمان برای جهت گیری های پشتیبانی شده و تنظیمات فیزیکی
- پرونده های تصویری برای عناصر نمایشگر مانند پس زمینه ، کلیدها و دکمه ها
برای ایجاد و استفاده از پوست سفارشی:
- یک دایرکتوری ایجاد کنید که در آن بتوانید پرونده های پیکربندی پوست خود را ذخیره کنید.
- ظاهر بصری پوست را در یک فایل متنی به نام
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 } } } ... }
- فایلهای bitmap تصاویر دستگاه را به همان فهرست اضافه کنید.
- تنظیمات دستگاه های خاص سخت افزاری خاص را در یک فایل INI برای تنظیمات دستگاه مانند
hw.keyboard
وhw.lcd.density
مشخص کنید. - پرونده ها را در پوشه پوست بایگانی کنید و پرونده بایگانی را به عنوان پوست سفارشی انتخاب کنید.
برای کسب اطلاعات بیشتر در مورد ایجاد پوسته های شبیه ساز ، به مشخصات فایل پوست Android Emulator Skin در کد منبع Tools مراجعه کنید.
،یک دستگاه مجازی Android (AVD) پیکربندی است که ویژگی های تلفن Android ، رایانه لوحی ، Wear Os ، Android TV یا دستگاه سیستم عامل خودرویی را که می خواهید در شبیه ساز Android شبیه سازی کنید ، تعریف می کند. مدیر دستگاه ابزاری است که می توانید از Android Studio راه اندازی کنید که به شما در ایجاد و مدیریت AVD کمک می کند.
برای باز کردن مدیر دستگاه جدید ، یکی از موارد زیر را انجام دهید:
- از صفحه خوشآمدگویی Android Studio، گزینههای More Actions > Virtual Device Manager را انتخاب کنید.
- پس از باز کردن یک پروژه ، از نوار منو اصلی ، View> Tool Windows> Manager Manager را انتخاب کنید ، سپس روی + کلیک کنید و سپس بر روی ایجاد دستگاه مجازی کلیک کنید.
پس از ایجاد دستگاه های خود ، می توانید لیستی از تمام دستگاه های موجود در پانل دستگاه مدیر را مشاهده کنید.
اگر می خواهید از دستگاه های مجازی استفاده کنید تا تست های سازهای خودکار خود را به روشی مقیاس پذیر و خود مدیریت کنید ، از دستگاه های مدیریت شده درجه بندی استفاده کنید.
درباره AVDS
AVD حاوی مشخصات سخت افزاری ، تصویر سیستم ، فضای ذخیره سازی ، پوست و سایر خصوصیات است.
توصیه می کنیم برای هر تصویر سیستم یک AVD ایجاد کنید که برنامه شما به طور بالقوه می تواند بر اساس تنظیم <uses-sdk>
در مانیفست خود پشتیبانی کند.
نمایه سخت افزار
مشخصات سخت افزار ویژگی های یک دستگاه را به عنوان ارسال شده از کارخانه تعریف می کند. مدیر دستگاه با پروفایل های سخت افزاری خاصی مانند دستگاه های پیکسل از قبل بارگیری می شود و می توانید در صورت لزوم پروفایل های سخت افزاری را تعریف یا سفارشی کنید.
تعریف دستگاهی که با آرم Google Play در ستون Play Store برچسب گذاری شده است شامل برنامه Google Play Store و دسترسی به خدمات Google Play ، از جمله یک برگه Google Play در گفتگوی Extended Controls است که یک دکمه مناسب برای به روزرسانی خدمات Google Play در این زمینه فراهم می کند دستگاه
دستگاه هایی با این آرم و نوع دستگاه "تلفن" نیز سازگار با CT هستند و ممکن است از تصاویر سیستم استفاده کنند که شامل برنامه Play Store است.
تصاویر سیستم
یک تصویر سیستم با برچسب Google API شامل دسترسی به خدمات Google Play است.
برگه توصیه شده تصاویر سیستم توصیه شده را لیست می کند. برگه های دیگر شامل یک لیست کامل تر است. صفحه سمت راست تصویر سیستم انتخاب شده را توصیف می کند.
اگر یک نماد بارگیری را در کنار یک تصویر سیستم مشاهده می کنید ، آن تصویر در حال حاضر روی دستگاه توسعه شما نصب نشده است. برای بارگیری تصویر سیستم ، روی نماد کلیک کنید. برای بارگیری تصاویر سیستم باید به اینترنت وصل شوید.
سطح API دستگاه هدف مهم است ، زیرا برنامه شما بر روی تصویر سیستم با سطح API که پایین تر از برنامه مورد نیاز برنامه شما است ، اجرا نمی شود ، همانطور که در ویژگی minSdk
در پرونده مانیفست برنامه مشخص شده است. برای کسب اطلاعات بیشتر در مورد رابطه بین سطح API سیستم و minSdk
، به نسخه برنامه خود مراجعه کنید.
اگر برنامه شما یک عنصر <uses-library>
را در پرونده مانیفست اعلام کند ، برنامه به یک تصویر سیستم نیاز دارد که شامل آن کتابخانه خارجی باشد. برای اجرای برنامه خود بر روی یک شبیه ساز ، یک AVD ایجاد کنید که شامل کتابخانه مورد نیاز باشد. برای انجام این کار ، ممکن است لازم باشد از یک مؤلفه افزودنی برای پلت فرم AVD استفاده کنید. به عنوان مثال ، افزودنی Google APIS شامل کتابخانه Google Maps است.
برای اطمینان از امنیت برنامه و یک تجربه مداوم با دستگاه های فیزیکی ، تصاویر سیستم با فروشگاه Google Play با یک کلید انتشار امضا می شوند ، به این معنی که شما نمی توانید با این تصاویر امتیازات بالا (ROOT) بدست آورید.
اگر برای کمک به عیب یابی برنامه به امتیازات بالا (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 شبیه سازی شده را ذخیره می کند. در صورت لزوم ، می توانید از مدیر دستگاه برای پاک کردن داده های کاربر استفاده کنید تا دستگاه داده های مشابهی داشته باشد که گویی جدید است.
پوست
پوست شبیه ساز ظاهر یک دستگاه را مشخص می کند. مدیر دستگاه برخی از پوست های از پیش تعریف شده را ارائه می دهد. همچنین می توانید پوست خود را تعریف کنید یا از پوست های ارائه شده توسط اشخاص ثالث استفاده کنید.
ویژگی های AVD و برنامه
اطمینان حاصل کنید که تعریف AVD شما شامل ویژگی های دستگاه شما بستگی دارد. برای لیست ویژگی هایی که می توانید در AVD های خود تعریف کنید ، بخش های مربوط به خصوصیات پروفایل سخت افزار و ویژگی های AVD را مشاهده کنید.
ایجاد AVD
برای ایجاد یک AVD جدید:
- Device Manager را باز کنید.
- روی ایجاد دستگاه کلیک کنید.
پنجره Select Hardware ظاهر می شود.
توجه کنید که فقط برخی از پروفایل های سخت افزاری شامل فروشگاه Play هستند. این پروفایل ها کاملاً سازگار با CT هستند و ممکن است از تصاویر سیستم استفاده کنند که شامل برنامه Play Store است.
- یک پروفایل سخت افزار را انتخاب کنید ، سپس روی Next کلیک کنید.
اگر نمایه سخت افزاری مورد نظر خود را نمی بینید ، می توانید مشخصات سخت افزاری را ایجاد یا وارد کنید ، همانطور که در بخش های دیگر این صفحه توضیح داده شده است.
پنجره تصویر سیستم ظاهر می شود.
- تصویر سیستم را برای یک سطح API خاص انتخاب کرده و سپس روی Next کلیک کنید.
- خواص AVD را در صورت لزوم تغییر دهید و سپس روی Finish کلیک کنید.
برای نمایش تنظیمات بیشتر مانند پوست ، روی نمایش تنظیمات پیشرفته کلیک کنید.
پنجره Verify Configuration ظاهر می شود.
AVD جدید در برگه مجازی مدیر دستگاه و منوی دستگاه هدف ظاهر می شود.
برای ایجاد AVD با یک نسخه:
- از برگه مجازی مدیر دستگاه ، روی منوی کلیک کنید و کپی را انتخاب کنید.
پنجره Verify Configuration ظاهر می شود.
- در صورت نیاز به ایجاد تغییر در تصویر سیستم یا انتخاب ویندوز سخت افزاری ، روی قبلی کلیک کنید.
- هرگونه تغییر مورد نیاز خود را ایجاد کنید و سپس روی Finish کلیک کنید.
AVD در برگه مجازی مدیر دستگاه ظاهر می شود.
یک پروفایل سخت افزار ایجاد کنید
مدیر دستگاه پروفایل های سخت افزاری از پیش تعریف شده را برای دستگاه های مشترک فراهم می کند تا بتوانید به راحتی آنها را به تعاریف AVD خود اضافه کنید. اگر نیاز به تعریف دستگاه دیگری دارید ، می توانید یک نمایه سخت افزار جدید ایجاد کنید.
می توانید از ابتدا یک پروفایل سخت افزار جدید را تعریف کنید یا یک پروفایل سخت افزار را به عنوان نقطه شروع کپی کنید. پروفایل های سخت افزاری از پیش بارگذاری شده قابل ویرایش نیستند.
برای ایجاد یک پروفایل سخت افزار جدید از ابتدا:
- در پنجره Select Hardware ، روی نمایه سخت افزار جدید کلیک کنید.
در پنجره مشخصات سخت افزار Configure ، در صورت لزوم خصوصیات پروفایل سخت افزار را تغییر دهید.
- روی Finish کلیک کنید.
نمایه سخت افزار جدید شما در پنجره Select Hardware ظاهر می شود. You can create an AVD that uses the hardware profile by clicking Next or click Cancel to return to the Virtual tab or target device menu.
To create a hardware profile using a copy as a starting point:
- In the Select Hardware window, select a hardware profile and click Clone Device or right-click a hardware profile and select Clone .
- In the Configure Hardware Profile window, change the hardware profile properties as needed.
- روی Finish کلیک کنید.
Your new hardware profile appears in the Select Hardware window. You can create an AVD that uses the hardware profile by clicking Next or click Cancel to return to the Virtual tab or target device menu.
Edit existing AVDs
You can perform the following operations on an AVD from the Device Manager's Virtual tab:
- To edit an AVD, click Edit this AVD and make your changes.
- To delete an AVD, click Menuand select Delete .
- To show the associated AVD INI and IMG files on disk, click Menuand select Show on Disk .
- To view AVD configuration details that you can include in bug reports to the Android Studio team, click Menuand select View Details .
Edit existing hardware profiles
You can't edit or delete the preloaded hardware profiles, but you can perform the following operations on other hardware profiles from the Select Hardware window:
- To edit a hardware profile, select it and click Edit Device . You can also right-click a hardware profile and select Edit . Next, make your changes.
- To delete a hardware profile, right-click it and select Delete .
یک شبیه ساز را اجرا و متوقف کنید و داده ها را پاک کنید
From the Virtual tab, you can perform the following operations on an emulator:
- To run an emulator that uses an AVD, click Launch .
- To stop a running emulator, click Menuand select Stop .
- To clear the data for an emulator, click Menuand select Wipe Data .
Import and export hardware profiles
From the Select Hardware window, you can import and export hardware profiles as follows:
- To import a hardware profile, click Import Hardware Profiles and select the XML file on your computer containing the definition.
- To export a hardware profile, right-click it and select Export . مکانی را که می خواهید فایل XML حاوی تعریف را در آن ذخیره کنید، مشخص کنید.
AVD properties
The AVD configuration specifies the interaction between the development computer and the emulator as well as properties you want to override in the hardware profile. You can specify the following properties for AVD configurations in the Verify Configuration window. The properties labeled (Advanced) are only displayed if you click Show Advanced Settings .
AVD configuration properties override hardware profile properties, and emulator properties that you set while the emulator is running override them both.
AVD property | توضیحات |
---|---|
AVD Name | Enter a name for the AVD. The name can contain uppercase or lowercase letters, numbers, periods, underscores, parentheses, dashes, and spaces. The name of the file storing the AVD configuration is derived from the AVD name. |
AVD ID (Advanced) | View the AVD ID. The AVD ID is derived from the AVD name. You can use the ID to refer to the AVD from the command line. |
Hardware Profile | Click Change to select a different hardware profile from the Select Hardware window. |
System Image | Click Change to select a different system image from the System Image window. An active internet connection is required to download a new image. |
Startup orientation | Select an option for the initial emulator orientation:
An option is enabled only if it's supported in the hardware profile. When running the AVD in the emulator, you can change the orientation if both portrait and landscape are supported in the hardware profile. |
Camera (Advanced) | Select an option for any enabled cameras. The Emulated and VirtualScene settings produce a software-generated image, while the Webcam setting uses your development computer's webcam to take a picture Camera options are available only if a camera is supported in the hardware profile. They are not available for Wear OS, Android TV, or Google TV. |
Network: Speed (Advanced) | Select a network protocol to determine the speed of data transfer:
|
Network: Latency (Advanced) | Select a network protocol to set how much time it takes for the protocol to transfer a data packet from one point to another point. |
Emulated Performance: Graphics | Select how graphics are rendered in the emulator:
|
Emulated Performance: Boot option (Advanced) |
Select how the AVD boots: |
Emulated Performance: Multi-Core CPU (Advanced) | Select the number of processor cores on your computer that you want to use for the emulator. Using more processor cores speeds up the emulator. |
Memory and Storage: RAM (Advanced) | Override the amount of RAM on the device set by the hardware manufacturer. Increasing the size uses more resources on your computer but supports faster emulator operation. Enter a RAM size and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte). |
Memory and Storage: VM Heap (Advanced) | Override the VM heap size set by the hardware manufacturer. Enter a heap size and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte). |
Memory and Storage: Internal Storage (Advanced) | Override the amount of non-removable memory space available on the device set by the hardware manufacturer. Enter a size and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte). |
Memory and Storage: SD Card (Advanced) | Specify the amount of removable memory space available to store data on the device. To use a virtual SD card managed by Android Studio, select Studio-managed , enter a size, and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte). A minimum of 100 MB is recommended to use the camera. To manage the space in a file, select External file and click ... to specify the file and location. For more information, see |
Device Frame: Enable Device Frame | Select to enable a frame around the emulator window that mimics the look of a real device. |
Custom Skin Definition (Advanced) | Select a skin that controls what the device looks like when displayed in the emulator. Specifying a screen size that's too big for the skin can mean that the screen is cut off, so you can't see the whole screen. See the Create an emulator skin section for more information. |
Keyboard: Enable Keyboard Input (Advanced) | Select this option to use your hardware keyboard to interact with the emulator. This option is disabled for Wear OS and Android TV. |
Hardware profile properties
You can specify the following properties for hardware profiles in the Configure Hardware Profile window. AVD configuration properties override hardware profile properties, and emulator properties that you set while the emulator is running override them both.
The predefined hardware profiles included with the Device Manager aren't editable. However, you can copy the profiles and edit the copies.
Some properties are disabled for some device types. For example, the "Round" property is only available on Wear OS devices.
Hardware profile property | توضیحات |
---|---|
نام دستگاه | Enter a name for the hardware profile. The name can contain uppercase or lowercase letters, numbers, periods, underscores, parentheses, and spaces. The name of the file storing the hardware profile is derived from the hardware profile name. |
نوع دستگاه | Select one of the following:
|
Screen: Screen Size | Specify the physical size of the screen in inches, measured on the diagonal. If the size is larger than your computer screen, it's reduced in size at launch. |
Screen: Screen Resolution | Enter a width and height in pixels to specify the total number of pixels on the simulated screen. |
Screen: Round | Select this option if the device has a round screen, such as some Wear OS devices. |
Memory: RAM | Enter the RAM size of the device and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte). |
Input: Has Hardware Buttons (Back/Home/Menu) | Select this option if your device has hardware navigation buttons. Deselect it if these buttons are implemented in software only. If you select this option, the buttons don't appear on the screen. In either case, you can use the emulator side panel to simulate pressing the buttons. |
Input: Has Hardware Keyboard | Select this option if your device has a hardware keyboard. Deselect it if it doesn't. If you select this option, a keyboard doesn't appear on the screen. In either case, you can use your computer keyboard to send keystrokes to the emulator. |
Input: Navigation Style | Select one of the following:
These options are for hardware controls on the device itself. However, the events sent to the device by an external controller are the same. |
Supported device states | Select one or both options:
You must select at least one option. If you select both options, you can switch between orientations in the emulator. |
دوربین ها | To enable the camera, select one or both options:
If the camera is enabled, you can use your development machine's webcam or a photo provided by the emulator to simulate taking a photo, based on the options you select in the AVD configuration. |
Sensors: Accelerometer | Select this option if the device has hardware that helps it determine its orientation. |
Sensors: Gyroscope | Select this option if the device has hardware that detects rotation or twist. In combination with an accelerometer, a gyroscope can provide smoother orientation detection and support a six-axis orientation system. |
Sensors: GPS | Select this option if the device has hardware that supports the Global Positioning System (GPS) satellite-based navigation system. |
Sensors: Proximity Sensor | Select this option if the device has hardware that detects when the device is close to the user's face during a phone call to disable input from the screen. |
Default Skin | Select a skin that controls what the device looks like when displayed in the emulator. Specifying a screen size that's too big for the resolution can mean that the screen is cut off, so you can't see the whole screen. See the section that follows about creating an emulator skin for more information. |
Create an emulator skin
An Android emulator skin is a collection of files that define the visual and control elements of an emulator display. If the skin definitions available in the AVD settings don't meet your requirements, you can create your own custom skin definition and then apply it to your AVD.
Each emulator skin contains:
- A
hardware.ini
file - Layout files for supported orientations and physical configurations
- Image files for display elements, such as background, keys, and buttons
To create and use a custom skin:
- Create a directory where you can save your skin configuration files.
- Define the visual appearance of the skin in a text file named
layout
. This file defines many characteristics of the skin, such as the size and image assets for specific buttons. به عنوان مثال: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 } } } ... }
- Add bitmap files of the device images to the same directory.
- Specify additional hardware-specific device configurations in an INI file for the device settings, such as
hw.keyboard
andhw.lcd.density
. - Archive the files in the skin folder and select the archive file as a custom skin.
For more detailed information about creating emulator skins, see the Android Emulator Skin File Specification in the tools source code.