Android SDK شامل یک شبیه ساز دستگاه Android است - یک دستگاه مجازی که روی رایانه شما اجرا می شود. شبیه ساز اندروید به شما امکان می دهد برنامه های اندروید را بدون استفاده از دستگاه فیزیکی توسعه و آزمایش کنید.
این صفحه ویژگی‌های خط فرمان را توضیح می‌دهد که می‌توانید با شبیه‌ساز اندروید استفاده کنید. برای اطلاعات در مورد استفاده از رابط کاربری شبیه ساز Android، به اجرای برنامه ها در شبیه ساز Android مراجعه کنید.
شبیه ساز را راه اندازی کنید
از دستور emulator برای شروع شبیه ساز، به عنوان جایگزینی برای اجرای پروژه خود یا شروع آن از طریق مدیر AVD استفاده کنید.
در اینجا دستور خط فرمان اولیه برای راه اندازی یک دستگاه مجازی از خط فرمان ترمینال آمده است:
emulator -avd avd_name [ {-option [value]} … ]
یا
emulator @avd_name [ {-option [value]} … ]
به عنوان مثال، اگر شبیه ساز را از داخل اندروید استودیو در حال اجرا بر روی مک راه اندازی کنید، خط فرمان پیش فرض مشابه موارد زیر خواهد بود:
/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout
لطفاً توجه داشته باشید که آرگومان های -qt-hide-window -grpc-use-token -idle-grpc-timeout فقط برای اجرای پنجره شبیه ساز در Android Studio استفاده می شود. اگر می خواهید شبیه ساز را روی پنجره خودش اجرا کنید، نباید از آن پارامترهای اضافی استفاده کنید.
هنگام راه اندازی شبیه ساز می توانید گزینه های راه اندازی را مشخص کنید، اما نه پس از شروع آن.
برای لیستی از نام های AVD، دستور زیر را وارد کنید:
emulator -list-avds
از این گزینه برای نمایش لیستی از نام های AVD از فهرست اصلی اندروید خود استفاده کنید. می توانید با تنظیم متغیر محیطی ANDROID_SDK_HOME که ریشه دایرکتوری مخصوص کاربر را که در آن تمام تنظیمات و محتوای AVD ذخیره می شود، فهرست راهنمای اصلی پیش فرض را لغو کنید.
می توانید قبل از راه اندازی یک دستگاه مجازی یا از طریق تنظیمات کاربر خود در سیستم عامل، متغیر محیط را در پنجره ترمینال تنظیم کنید. به عنوان مثال، در فایل .bashrc شما در لینوکس.
برای توقف شبیه ساز اندروید، پنجره شبیه ساز را ببندید.
یک اپلیکیشن نصب کنید
علاوه بر نصب یک برنامه از طریق اندروید استودیو یا رابط کاربری شبیه ساز ، می توانید با استفاده از ابزار adb برنامه خود را روی یک دستگاه مجازی نصب کنید.
برای استفاده از adb برای نصب، اجرا و آزمایش برنامه خود، این مراحل کلی را دنبال کنید:
- همانطور که در ساخت و اجرای برنامه توضیح داده شده است، برنامه خود را در یک APK بسازید و بسته بندی کنید.
- شبیه ساز را از خط فرمان، همانطور که در بخش قبل توضیح داده شد، با استفاده از هر گزینه راه اندازی لازم شروع کنید.
- برنامه خود را با استفاده از
adbنصب کنید. - برنامه خود را روی شبیه ساز اجرا و تست کنید.
هنگامی که شبیه ساز در حال اجرا است، می توانید از کنسول Emulator برای صدور دستورات در صورت نیاز استفاده کنید.
برای حذف نصب یک برنامه، این کار را همانطور که در دستگاه Android انجام می دهید انجام دهید.
دستگاه مجازی برنامه و داده های وضعیت آن را در طول راه اندازی مجدد در یک پارتیشن دیسک داده کاربر ( userdata-qemu.img ) حفظ می کند. برای پاک کردن این داده ها، شبیه ساز را با گزینه -wipe-data راه اندازی کنید یا داده ها را در AVD Manager پاک کنید. برای اطلاعات بیشتر در مورد پارتیشن داده های کاربر و سایر ذخیره سازی ها، به بخش زیر مراجعه کنید.
توجه: ابزار adb دستگاه مجازی را به عنوان یک دستگاه فیزیکی واقعی مشاهده می کند. به همین دلیل، ممکن است مجبور شوید از پرچم -d با برخی از دستورات رایج adb مانند install استفاده کنید. پرچم -d به شما امکان می دهد تعیین کنید که کدام یک از چندین دستگاه متصل را به عنوان هدف یک فرمان استفاده کنید. اگر -d مشخص نکنید، شبیه ساز اولین دستگاه را در لیست خود هدف قرار می دهد.
دایرکتوری ها و فایل های پیش فرض را درک کنید
شبیه ساز از فایل های مرتبط استفاده می کند که سیستم AVD و دایرکتوری های داده مهم ترین آنها هستند. درک ساختار دایرکتوری و فایل‌های شبیه‌ساز هنگام تعیین گزینه‌های خط فرمان مفید است، اگرچه معمولاً نیازی به تغییر دایرکتوری‌ها یا فایل‌های پیش‌فرض ندارید.
شبیه ساز اندروید از هایپروایزر ( QEMU ) استفاده می کند.
فهرست راهنمای سیستم AVD
فهرست راهنمای سیستم حاوی تصاویر سیستم اندروید است که شبیه ساز برای شبیه سازی سیستم عامل از آنها استفاده می کند. این فهرست دارای فایل‌های مخصوص پلتفرم و فقط خواندنی است که توسط همه AVDهای یک نوع، از جمله سطح API، معماری CPU، و نوع اندروید به اشتراک گذاشته شده است. مکان های پیش فرض به شرح زیر است:
- macOS و Linux -
~/Library/Android/sdk/system-images/android- apiLevel / variant / arch / - Windows -
C:\Users\ user \Library\Android\sdk\system-images\android- apiLevel \ variant \ arch \
کجا:
-
apiLevelیک سطح API عددی یا حرفی برای انتشار پیش نمایش است. به عنوان مثال،android-Vپیش نمایش Android VanillaIceCream را نشان می دهد. در زمان انتشار، به سطح API 35 تبدیل شد که توسطandroid-35تعیین شد. -
variantنامی است که مربوط به ویژگی های خاصی است که توسط تصویر سیستم پیاده سازی شده است. به عنوان مثال،google_apisیاandroid-wear. -
archمعماری CPU هدف است. به عنوان مثال،x86.
از گزینه -sysdir برای تعیین دایرکتوری سیستم دیگری برای AVD استفاده کنید.
شبیه ساز فایل های زیر را از دایرکتوری سیستم می خواند:
جدول 1. فایل های دایرکتوری سیستم که توسط شبیه ساز اندروید خوانده می شود
| فایل | توضیحات | گزینه ای برای تعیین یک فایل متفاوت |
|---|---|---|
kernel-qemu یا kernel-ranchu | تصویر هسته باینری برای AVD. kernel-ranchu بر اساس شبیه ساز QEMU است. | -kernel |
ramdisk.img | تصویر پارتیشن بوت این زیر مجموعه ای از system.img است که ابتدا قبل از نصب تصویر سیستم توسط هسته بارگذاری می شود. معمولاً فقط شامل چند اسکریپت باینری و مقداردهی اولیه است. | -ramdisk |
system.img | نسخه اولیه فقط خواندنی تصویر سیستم. به طور خاص، پارتیشن حاوی کتابخانه های سیستم و داده های مربوط به سطح و نوع API. | -system |
userdata.img | نسخه اولیه پارتیشن داده که به صورت data/ در سیستم شبیه سازی شده ظاهر می شود و شامل تمام داده های قابل نوشتن برای AVD است. هنگامی که یک AVD جدید ایجاد می کنید یا از گزینه ‑wipe-data استفاده می کنید، شبیه ساز از این فایل استفاده می کند. برای اطلاعات بیشتر، توضیحات فایل userdata-qemu.img را در قسمت زیر ببینید. | -initdata-init-data |
دایرکتوری داده AVD
دایرکتوری داده AVD که فهرست محتوا نیز نامیده می شود، مختص یک نمونه AVD است و شامل تمام داده های قابل تغییر برای AVD است.
مکان پیش فرض به صورت زیر است که name آن نام AVD است:
- macOS و Linux -
~/.android/avd/ name .avd/ - ویندوز 10 و بالاتر -
C:\Users\ user \.android\ name .avd\
از گزینه -datadir برای تعیین دایرکتوری داده AVD متفاوت استفاده کنید.
جدول زیر مهم ترین فایل های موجود در این دایرکتوری را فهرست می کند:
جدول 2. فایل های مهم در دایرکتوری داده AVD
| فایل | توضیحات | گزینه ای برای تعیین یک فایل متفاوت |
|---|---|---|
userdata-qemu.img | محتوای پارتیشن داده که به صورت هر نمونه دستگاه مجازی از یک تصویر داده کاربر قابل نوشتن برای ذخیره داده های کاربر و جلسه خاص استفاده می کند. به عنوان مثال، از تصویر برای ذخیره داده های برنامه نصب شده، تنظیمات، پایگاه داده و فایل های یک کاربر منحصر به فرد استفاده می کند. هر کاربر یک دایرکتوری | -data |
cache.img | تصویر پارتیشن کش که به صورت cache/ در سیستم شبیه سازی شده ظاهر می شود. وقتی برای اولین بار یک AVD ایجاد می کنید یا از گزینه -wipe-data استفاده می کنید خالی است. فایل های دانلود موقت را ذخیره می کند و توسط مدیر دانلود و گاهی اوقات سیستم پر می شود. به عنوان مثال، مرورگر از آن برای ذخیره صفحات وب و تصاویر دانلود شده در حین اجرای شبیه ساز استفاده می کند. وقتی دستگاه مجازی را خاموش می کنید، فایل حذف می شود. با استفاده از گزینه -cache می توانید فایل را حفظ کنید. | -cache |
sdcard.img | (اختیاری) یک تصویر پارتیشن کارت SD که به شما امکان می دهد کارت SD را در یک دستگاه مجازی شبیه سازی کنید. می توانید یک فایل تصویری کارت SD در AVD Manager یا با استفاده از ابزار هنگام تعریف AVD در مدیر AVD، می توانید انتخاب کنید که از یک فایل کارت SD مدیریت شده به طور خودکار یا فایلی که با ابزار می‌توانید با استفاده از رابط کاربری شبیه‌ساز یا ابزار برای کپی کردن فایل‌ها در فایل کارت SD قبل از بارگیری، فایل تصویر را به عنوان یک دستگاه حلقه سوار کنید و سپس فایل‌ها را کپی کنید. یا از ابزاری مانند بسته شبیه ساز فایل را به عنوان مجموعه ای از بایت ها در نظر می گیرد، بنابراین فرمت کارت SD مهم نیست. گزینه | -sdcard |
فهرست دایرکتوری ها و فایل های مورد استفاده توسط شبیه ساز
شما می توانید به دو روش کشف کنید که فایل ها در کجا قرار دارند:
- هنگامی که شبیه ساز را از خط فرمان راه اندازی می کنید، از گزینه
-verboseیا-debug initاستفاده کنید. به خروجی نگاه کنید. - از دستور
emulator-help- optionبرای فهرست کردن دایرکتوری پیش فرض استفاده کنید. به عنوان مثال:emulator -help-datadir
Use '-datadir <dir>' to specify a directory where writable image files will be searched. On this system, the default directory is: /Users/me/.android See '-help-disk-images' for more information about disk image files.
گزینه های راه اندازی خط فرمان
این بخش گزینه هایی را لیست می کند که می توانید هنگام راه اندازی شبیه ساز در خط فرمان ارائه کنید.
توجه: شبیه ساز اندروید به طور مداوم در حال توسعه است تا قابل اطمینان تر شود. برای وضعیت مشکلات گزارش شده در مورد گزینه های مختلف خط فرمان و گزارش اشکالات، به ردیاب مشکلات Android مراجعه کنید.
گزینه های رایج
جدول زیر گزینه های راه اندازی خط فرمان را فهرست می کند که ممکن است بیشتر از آنها استفاده کنید:
جدول 3. گزینه های خط فرمان رایج
| گزینه خط فرمان | توضیحات |
|---|---|
| بوت سریع | |
-no-snapshot-load | بوت سرد را انجام می دهد و حالت شبیه ساز را در هنگام خروج ذخیره می کند. |
-no-snapshot-save | در صورت امکان یک بوت سریع انجام می دهد، اما حالت شبیه ساز را در هنگام خروج ذخیره نمی کند. |
-no-snapshot | ویژگی Quick Boot را به طور کامل غیرفعال می کند و حالت شبیه ساز را بارگیری یا ذخیره نمی کند. |
| سخت افزار دستگاه | |
-camera-back mode-camera-front mode | حالت شبیه سازی را برای دوربین رو به عقب یا جلو تنظیم می کند. این تنظیمات دوربین در AVD را لغو می کند.
به عنوان مثال: emulator @Pixel8_API_34 -camera-back webcam0 |
-webcam-list | وب‌کم‌های موجود در رایانه توسعه‌دهنده شما را که برای شبیه‌سازی در دسترس هستند، فهرست می‌کند. به عنوان مثال:emulator @Pixel8_API_34 -webcam-list
List of web cameras connected to the computer:
Camera 'webcam0' is connected to device 'webcam0'
on channel 0 using pixel format 'UYVY' در مثال، اولین از SDK Tools 25.2.4، نام AVD مورد نیاز است. |
| تصاویر دیسک و حافظه | |
-memory size | اندازه رم فیزیکی را از 1536 تا 8192 مگابایت مشخص می کند. به عنوان مثال: emulator @Pixel8_API_34 -memory 2048 این مقدار تنظیمات AVD را لغو می کند. |
-sdcard filepath | نام فایل و مسیر فایل تصویری پارتیشن کارت SD را مشخص می کند. به عنوان مثال:
emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img اگر فایل پیدا نشد، شبیه ساز همچنان راه اندازی می شود، اما بدون کارت SD. این فرمان یک اخطار بدون تصویر کارت SD برمی‌گرداند. اگر این گزینه را مشخص نکنید، پیش‌فرض |
-wipe-data | داده های کاربر را حذف می کند و داده ها را از فایل داده اولیه کپی می کند. این گزینه داده های دستگاه مجازی را پاک می کند و به همان حالتی که برای اولین بار تعریف شده بود برمی گرداند. همه برنامه ها و تنظیمات نصب شده حذف می شوند. به عنوان مثال:
emulator @Pixel8_API_34 -wipe-data به طور پیش فرض، فایل داده های کاربر |
| اشکال زدایی | |
-debug tags | نمایش پیام های اشکال زدایی را برای یک یا چند تگ فعال یا غیرفعال می کند. چندین تگ را با فاصله، کاما یا ستون جدا کنید. به عنوان مثال:
$ emulator @Pixel8_API_34 -debug init,metrics برای غیرفعال کردن یک برچسب، یک خط تیره (-) در مقابل آن قرار دهید. به عنوان مثال، گزینه زیر تمام پیام های اشکال زدایی را نشان می دهد، به جز موارد مربوط به سوکت ها و معیارهای شبکه: برای لیستی از برچسب ها و توضیحات، از گزینه
emulator -help-debug-tags می توانید تگ های پیش فرض اشکال زدایی را در متغیر محیطی
ANDROID_VERBOSE=socket,gles معادل استفاده از: یا |
-debug- tag-debug-no- tag | یک نوع پیام اشکال زدایی خاص را فعال می کند. برای غیرفعال کردن نوع پیام اشکال زدایی از فرم no استفاده کنید. به عنوان مثال:
emulator @Pixel8_API_34 -debug-all -debug-no-metrics برای لیستی از برچسب ها، از دستور |
-logcat logtags | نمایش پیام های Logcat را برای یک یا چند تگ فعال می کند و آنها را در پنجره ترمینال می نویسد. به عنوان مثال، دستور زیر پیام های خطا را از همه اجزا فعال می کند:
emulator @Pixel8_API_34 -logcat *:e
مثال زیر پیام های مؤلفه GSM را در سطح گزارش اطلاعاتی نمایش می دهد:
emulator @Pixel8_API_34 -logcat '*:s GSM:i' اگر گزینه برای اطلاعات بیشتر در مورد Logcat و |
-show-kernel | پیام های اشکال زدایی هسته را در پنجره ترمینال نمایش می دهد. به عنوان مثال:
emulator @Pixel8_API_34 -show-kernel یکی از کاربردهای این گزینه بررسی درست کارکرد فرآیند بوت است. |
-verbose | پیام های اولیه سازی شبیه ساز را در پنجره ترمینال چاپ می کند. به عنوان مثال:
emulator @Pixel8_API_34 -verbose این نشان می دهد که کدام فایل ها و تنظیمات واقعاً هنگام راه اندازی یک دستگاه مجازی تعریف شده در AVD انتخاب شده اند. این گزینه مانند تعیین |
| شبکه | |
-dns-server servers | از سرورهای DNS مشخص شده استفاده می کند. servers یک لیست با کاما از حداکثر چهار نام سرور DNS یا آدرس IP است. به عنوان مثال: emulator @Pixel8_API_34 -dns-server 192.0.2.0, به طور پیش فرض، شبیه ساز سعی می کند سرورهای DNS مورد استفاده شما را شناسایی کند و نام مستعار خاصی را در شبکه فایروال شبیه سازی شده تنظیم می کند تا به سیستم اندروید اجازه دهد مستقیماً به سرورها متصل شود. از گزینه |
-http-proxy proxy | تمام اتصالات TCP را از طریق یک پروکسی مشخص HTTP/HTTPS ایجاد می کند. اگر شبیه ساز شما باید از طریق یک سرور پراکسی به اینترنت دسترسی داشته باشد، می توانید از این گزینه یا متغیر محیط http_proxy برای تنظیم تغییر مسیر مناسب استفاده کنید. به عنوان مثال:
emulator @Pixel8_API_34 -http-proxy myserver:1981 پیشوند اگر این گزینه ارائه نشده باشد، شبیه ساز متغیر محیط |
-netdelay delay | تقلید تاخیر شبکه را به یکی از مقادیر
به عنوان مثال: emulator @Pixel8_API_34 -netdelay gsm شبیه ساز از throttling شبکه و همچنین تاخیرهای اتصال بالاتر پشتیبانی می کند. می‌توانید آن را از طریق پیکربندی پوسته یا با گزینه‌های |
-netfast | throttling شبکه را غیرفعال می کند. به عنوان مثال:
emulator @Pixel8_API_34 -netfast این گزینه مانند تعیین |
-netspeed speed | شبیه سازی سرعت شبکه را تنظیم می کند. حداکثر سرعت آپلود و دانلود شبکه را با یکی از مقادیر
به عنوان مثال: emulator @Pixel8_API_34 -netspeed edge شبیه ساز از throttling شبکه و همچنین تاخیرهای اتصال بالاتر پشتیبانی می کند. می‌توانید آن را از طریق پیکربندی پوسته یا با گزینه‌های |
-port port | شماره پورت TCP را که برای کنسول و adb استفاده می شود را تنظیم می کند. به عنوان مثال:
emulator @Pixel8_API_34 -port 5556 مقدار پیش فرض برای اولین نمونه دستگاه مجازی که روی دستگاه شما اجرا می شود 5554 است. یک دستگاه مجازی معمولاً یک جفت پورت مجاور را اشغال می کند: یک پورت کنسول و یک پورت تخصیص پورت اغلب مانند تعیین گزینه توجه داشته باشید که اگر مقدار |
-ports | پورت های TCP مورد استفاده برای کنسول و adb را تنظیم می کند. به عنوان مثال:
emulator @Pixel8_API_34 -ports 5556,5559 محدوده پورت های معتبر 5554 تا 5682 است که امکان 64 دستگاه مجازی همزمان را فراهم می کند. گزینه توصیه می کنیم در صورت امکان از گزینه برای اطلاعات بیشتر در مورد تنظیم پورت های کنسول و |
-tcpdump filepath | بسته های شبکه را می گیرد و در یک فایل ذخیره می کند. به عنوان مثال:
emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap از این گزینه برای شروع گرفتن تمام بسته های شبکه که از طریق شبکه اترنت مجازی شبیه ساز ارسال می شوند، استفاده کنید. پس از آن، می توانید از ابزاری مانند Wireshark برای تجزیه و تحلیل ترافیک استفاده کنید. توجه داشته باشید که این گزینه تمام بسته های اترنت را می گیرد و به اتصالات TCP محدود نمی شود. |
| سیستم | |
-accel mode | شتاب VM شبیه ساز را پیکربندی می کند. به عنوان مثال:
emulator @Pixel8_API_34 -accel auto شبیه سازی شتاب فقط برای تصاویر سیستم x86 و x86_64 کار می کند. در لینوکس، به KVM متکی است. در ویندوز و مک، به پردازنده اینتل و درایور HAXM اینتل متکی است. اگر دستگاه x86 یا x86_64 را شبیه‌سازی نمی‌کنید، این گزینه نادیده گرفته می‌شود. مقادیر معتبر برای
برای اطلاعات بیشتر، پیکربندی شتاب سخت افزاری برای شبیه ساز Android را ببینید. |
-accel-check | بررسی می کند که آیا یک Hypervisor مورد نیاز برای شتاب دهنده VM شبیه ساز (HAXM یا KVM) نصب شده است یا خیر. به عنوان مثال:
emulator -accel-check برای اطلاعات بیشتر، به بررسی نصب هایپروایزر مراجعه کنید. |
-engine engine | موتور شبیه ساز را مشخص می کند:
به عنوان مثال:
emulator @Pixel8_API_34 -engine auto تشخیص خودکار باید مقداری را انتخاب کند که بهترین عملکرد را هنگام شبیه‌سازی یک AVD خاص ارائه دهد. از گزینه |
-gpu mode | حالت شبیه سازی GPU را انتخاب می کند. به عنوان مثال:
emulator @Pixel8_API_34 -gpu swiftshader_indirect برای اطلاعات بیشتر، پیکربندی شتاب گرافیکی را ببینید. |
-no-accel | هنگام استفاده از تصویر سیستم x86 یا x86_64، شتاب شبیه ساز VM را غیرفعال می کند. این فقط برای اشکال زدایی مفید است و مانند تعیین -accel off است. به عنوان مثال:
emulator @Pixel8_API_34 -no-accel برای اطلاعات بیشتر، پیکربندی شتاب سخت افزاری برای شبیه ساز Android را ببینید. |
-nojni-no-jni | بررسی های رابط بومی جاوا (JNI) توسعه یافته را در زمان اجرا Android Dalvik یا ART غیرفعال می کند. به عنوان مثال:
emulator @Pixel8_API_34 -nojni هنگامی که یک دستگاه مجازی را راه اندازی می کنید، بررسی های گسترده JNI به طور پیش فرض فعال می شوند. برای اطلاعات بیشتر، نکات JNI را ببینید. |
-selinux {disabled|permissive} | ماژول امنیتی لینوکس تقویت‌شده با امنیت ( SELinux ) را در یک سیستم عامل لینوکس روی حالت disabled یا permissive تنظیم می‌کند. به عنوان مثال:
me-linux$ emulator @Pixel8_API_34 -selinux permissive به طور پیش فرض، SELinux در حالت |
-timezone timezone | منطقه زمانی دستگاه مجازی را به جای منطقه زمانی میزبان بر روی منطقه emulator @Pixel8_API_34 -timezone Europe/Paris به طور پیش فرض، شبیه ساز از منطقه زمانی رایانه توسعه دهنده شما استفاده می کند. از این گزینه برای تعیین منطقه زمانی متفاوت یا اگر تشخیص خودکار به درستی کار نمی کند، استفاده کنید. مقدار
منطقه زمانی مشخص شده باید در پایگاه داده zoneinfo باشد. |
-version | شماره نسخه شبیه ساز را نمایش می دهد. به عنوان مثال:
emulator @Pixel8_API_34 -version یا
emulator -version |
| UI | |
-no-boot-anim | برای بوت شدن سریعتر، انیمیشن بوت را در هنگام راه اندازی شبیه ساز غیرفعال می کند. به عنوان مثال:
emulator @Pixel8_API_34 -no-boot-anim در رایانه های کندتر، این گزینه می تواند به طور قابل توجهی سرعت بوت را افزایش دهد. |
-screen mode | حالت صفحه نمایش لمسی شبیه سازی شده را تنظیم می کند. به عنوان مثال:
emulator @Pixel8_API_34 -screen no-touch
|
گزینه های پیشرفته
گزینه های راه اندازی خط فرمان در جدول زیر در دسترس هستند اما معمولاً توسط توسعه دهندگان برنامه معمولی استفاده نمی شود.
در توضیحات، دایرکتوری کاری دایرکتوری فعلی در ترمینالی است که در آن دستورات را وارد می‌کنید. برای اطلاعات در مورد دایرکتوری سیستم AVD و فهرست داده ها و فایل های ذخیره شده در آنها، به بخش مربوط به فهرست ها و فایل های پیش فرض مراجعه کنید.
برخی از این گزینه ها برای توسعه دهندگان برنامه های خارجی مناسب هستند و برخی از آنها عمدتاً توسط توسعه دهندگان پلت فرم استفاده می شوند. توسعه دهندگان برنامه، برنامه های اندرویدی ایجاد می کنند و آنها را روی AVD های خاص اجرا می کنند. توسعه دهندگان پلتفرم روی سیستم اندروید کار می کنند و آن را در داخل شبیه ساز بدون AVD از پیش ساخته شده اجرا می کنند.
جدول 4. گزینه های خط فرمان پیشرفته
| گزینه پیشرفته | شرح مختصر |
|---|---|
-bootchart timeout | بوتچارت را با وقفه در چند ثانیه فعال می کند. برخی از تصاویر سیستم اندروید دارای یک سیستم init اصلاح شده هستند که یک تسهیلات بوتچارتینگ را ادغام می کند. با این گزینه می توانید یک بازه زمانی بوتچارتینگ را به سیستم منتقل کنید. اگر سیستم init شما بوتچارتینگ را فعال نکرده باشد، این گزینه کاری انجام نمی دهد. این گزینه در درجه اول برای توسعه دهندگان پلت فرم مفید است، نه توسعه دهندگان برنامه های خارجی. به عنوان مثال: emulator @Pixel8_API_34 -bootchart 120 |
-cache filepath | یک فایل تصویری پارتیشن کش را مشخص می کند. یک نام فایل و یک مسیر مطلق یا یک مسیر نسبت به دایرکتوری داده برای راه اندازی یک فایل کش پایدار ارائه می دهد. اگر فایل وجود نداشته باشد، شبیه ساز آن را به عنوان یک فایل خالی ایجاد می کند. به عنوان مثال: emulator @Pixel8_API_34 -cache ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img اگر از این گزینه استفاده نمی کنید، پیش فرض یک فایل موقت به نام |
-cache-size size | اندازه پارتیشن کش را بر حسب مگابایت تنظیم می کند. به عنوان مثال: emulator @Pixel8_API_34 -cache-size 1000 اگر این گزینه را مشخص نکنید، پیش فرض 66 مگابایت است. به طور معمول، اکثر توسعه دهندگان برنامه به این گزینه نیاز ندارند، مگر اینکه نیاز به دانلود فایل های بسیار بزرگی داشته باشند که بزرگتر از حافظه پنهان پیش فرض هستند. برای اطلاعات بیشتر در مورد فایل کش، به فهرست راهنمای داده AVD مراجعه کنید. |
-data filepath | فایل تصویری پارتیشن داده های کاربر را تنظیم می کند. یک نام فایل و یک مسیر مطلق یا یک مسیر نسبت به دایرکتوری کاری برای تنظیم یک فایل داده کاربر دائمی ارائه می دهد. اگر فایل وجود نداشته باشد، شبیه‌ساز یک تصویر از فایل به عنوان مثال: emulator @Pixel8_API_34 -data ~/.android/avd/Pixel8_API_34.avd/userdata-test.img اگر از این گزینه استفاده نمی کنید، پیش فرض فایلی با نام |
-datadir dir | یک دایرکتوری داده را با استفاده از یک مسیر مطلق مشخص می کند. برای اطلاعات بیشتر، دایرکتوری داده AVD را ببینید. به عنوان مثال: emulator @Pixel8_API_34 -datadir ~/.android/avd/Pixel8_API_34.avd/mytest |
-force-32bit | از شبیه ساز 32 بیتی در پلتفرم های 64 بیتی استفاده می کند. گاهی اوقات، این گزینه برای آزمایش یا اشکال زدایی مفید است. به عنوان مثال، مشکلی وجود داشت که شبیه ساز گاهی اوقات روی ویندوز 64 بیتی اجرا نمی شد، اما 32 بیتی اجرا می شد. این گزینه برای انجام مقایسه برای رفع اشکال مفید بود. در اینجا یک مثال است: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images | درباره تصاویر دیسک کمک می گیرد. این گزینه اطلاعات مربوط به توسعه دهندگان برنامه و پلتفرم را ارائه می دهد. به عنوان مثال: emulator -help-disk-images |
-help-char-devices | درباره مشخصات emulator -help-char-devices |
-help-sdk-images | درباره تصاویر دیسک مربوط به برنامه‌نویسان کمک می‌گیرد. این گزینه اطلاعاتی در مورد محل قرارگیری فایل های تصویری برای AVD ایجاد شده با ابزارهای SDK دریافت می کند. به عنوان مثال: emulator -help-sdk-images |
-help-build-images | درباره تصاویر دیسک مربوط به توسعه دهندگان پلتفرم کمک می گیرد. به عنوان مثال: emulator -help-build-images |
-initdata filepath-init-data filepath | نسخه اولیه پارتیشن داده را مشخص می کند. پس از پاک کردن اطلاعات کاربر، شبیه ساز به جای استفاده از فایل پیش فرض به عنوان مثال: emulator @Pixel8_API_34 -initdata ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/userdata-test.img اگر مسیری را مشخص نکنید، فایل را در دایرکتوری سیستم قرار می دهد. برای اطلاعات بیشتر، دایرکتوری سیستم AVD را ببینید. |
-kernel filepath | از یک هسته شبیه سازی شده خاص استفاده می کند. اگر مسیری را مشخص نکنید، شبیه ساز در دایرکتوری سیستم نگاه می کند. از گزینه‑show‑kernel برای مشاهده پیام‌های اشکال‌زدایی هسته استفاده کنید.به عنوان مثال: emulator @Pixel8_API_34 -kernel ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/kernel-test.img -show-kernel اگر این گزینه را مشخص نکنید، پیش‌فرض |
-noaudio-no-audio | پشتیبانی صوتی این دستگاه مجازی را غیرفعال می کند. برخی از رایانه های لینوکس و ویندوز دارای درایورهای صوتی معیوب هستند که علائم مختلفی مانند جلوگیری از شروع شبیه ساز ایجاد می کند. در این صورت از این گزینه برای غلبه بر مشکل استفاده کنید. همچنین، می‌توانید از متغیر محیطی به عنوان مثال: emulator @Pixel8_API_34 -noaudio |
-nocache-no-cache | شبیه ساز را بدون پارتیشن کش راه اندازی می کند. اگر از این گزینه استفاده نمی کنید، پیش فرض یک فایل موقت به نام به عنوان مثال: emulator @Pixel8_API_34 -nocache |
-no-snapshot | هر دو عملیات بارگذاری و ذخیره خودکار را مهار می کند و باعث می شود شبیه ساز یک دنباله راه اندازی کامل را اجرا کند و در صورت بسته شدن حالت خود را از دست بدهد. این گزینه به عنوان مثال: emulator @Pixel8_API_34 -no-snapshot |
-no-snapshot-load | از بارگیری حالت AVD توسط شبیه ساز از ذخیره سازی عکس فوری جلوگیری می کند. بوت کامل را انجام می دهد. به عنوان مثال: emulator @Pixel8_API_34 -no-snapshot-load |
-no-snapshot-save | از ذخیره حالت AVD توسط شبیه ساز در ذخیره سازی عکس فوری در هنگام خروج جلوگیری می کند، به این معنی که همه تغییرات از بین خواهند رفت. به عنوان مثال: emulator @Pixel8_API_34 -no-snapshot-save |
-no-snapshot-update-time | سعی نمی‌کند بلافاصله پس از بازیابی عکس فوری، زمان ساعت AVD را تصحیح کند. این گزینه می تواند در طول آزمایش مفید باشد زیرا از پرش زمانی ناگهانی جلوگیری می کند. به روز رسانی های زمان همچنان تقریباً هر 15 ثانیه به AVD ارسال می شود. به عنوان مثال: emulator @Pixel8_API_34 -no-snapshot-update-time |
-no-snapstorage | شبیه‌ساز را بدون نصب فایل برای ذخیره یا بارگیری عکس‌های فوری، راه‌اندازی کامل و غیرفعال کردن عملکرد عکس فوری حالت را شروع می‌کند. این گزینه گزینه های به عنوان مثال: emulator @Pixel8_API_34 -no-snapstorage |
-no-window | نمایش پنجره گرافیکی در شبیه ساز را غیرفعال می کند. این گزینه هنگام اجرای شبیه ساز روی سرورهایی که نمایشگر ندارند مفید است. شما می توانید از طریق emulator @Pixel8_API_34 -no-window |
-partition-size size | اندازه پارتیشن داده های سیستم را بر حسب مگابایت مشخص می کند. به عنوان مثال: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name = value | هنگام بوت شدن، یک ویژگی سیستم اندروید را در شبیه ساز تنظیم می کند. emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args | آرگومان ها را به نرم افزار شبیه ساز QEMU منتقل می کند. هنگام استفاده از این گزینه، مطمئن شوید که آخرین گزینه مشخص شده است، زیرا همه گزینه های پس از آن به عنوان گزینه های خاص QEMU تفسیر می شوند. این گزینه کاملاً پیشرفته است و فقط باید توسط توسعه دهندگانی استفاده شود که با QEMU و شبیه سازی اندروید آشنا هستند. |
-qemu -h | کمک emulator -qemu -h |
-ramdisk filepath | یک تصویر بوت ramdisk را مشخص می کند. نام فایل و مسیر مطلق یا مسیری را نسبت به دایرکتوری کاری مشخص می کند. به عنوان مثال: emulator @Pixel8_API_34 -ramdisk ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/ramdisk-test.img اگر از این گزینه استفاده نمی کنید، پیش فرض فایل |
-report-console socket | قبل از شروع شبیه سازی، پورت کنسول را به شخص ثالث راه دور گزارش می کند. می تواند برای یک اسکریپت تست خودکار مفید باشد.
برای اطلاعات بیشتر، از گزینه |
-shell | یک کنسول پوسته ریشه در ترمینال فعلی ایجاد می کند. این گزینه به روش های زیر با دستور
به عنوان مثال: emulator @Pixel8_API_34 -shell |
-snapshot name | نام یک عکس فوری را در یک فایل ذخیره‌سازی عکس فوری برای شروع و ذخیره خودکار عملیات مشخص می‌کند. به جای اجرای یک دنباله راه‌اندازی کامل، شبیه‌ساز می‌تواند اجرا را از یک عکس فوری حالت قبلی، که معمولاً بسیار سریعتر است، از سر بگیرد. وقتی این گزینه را ارائه می‌کنید، شبیه‌ساز عکس فوری آن نام را از تصویر لحظه‌ای بارگیری می‌کند و در هنگام خروج آن را با همان نام ذخیره می‌کند. اگر از این گزینه استفاده نمی کنید، پیش فرض یک دنباله بوت کامل است. اگر عکس فوری مشخص شده وجود نداشته باشد، شبیه ساز به جای آن یک دنباله کامل بوت را انجام می دهد و یک عملیات ذخیره را انجام می دهد. برای اطلاعات در مورد تعیین فایل ذخیره سازی عکس فوری و فایل پیش فرض، گزینه emulator @Pixel8_API_34 -snapshot snapshot2 به یاد داشته باشید که در فرآیند بارگیری یک عکس فوری، تمام محتویات سیستم، داده های کاربر و تصاویر کارت SD با محتویاتی که در هنگام تهیه عکس فوری نگه داشته اند، بازنویسی می شوند. مگر اینکه این اطلاعات را در یک عکس فوری دیگر ذخیره کنید، هر گونه تغییری که از آن زمان به بعد بوده است از بین می رود. همچنین می توانید با استفاده از دستور |
-snapshot-list | لیستی از عکس های فوری موجود را نمایش می دهد. این دستور جدولی از عکس‌های فوری را چاپ می‌کند که در فایل ذخیره‌سازی snapshot که شبیه‌ساز با آن شروع شده است ذخیره می‌شود، سپس خارج می‌شود. اگر به عنوان مثال: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img می توانید از مقادیر ستون ID و TAG در خروجی به عنوان آرگومان برای گزینه |
-snapstorage filepath | یک فایل مخزن را مشخص می کند که شامل تمام عکس های فوری وضعیت باشد. تمام عکس های گرفته شده در حین اجرا در این فایل ذخیره می شوند. فقط عکس های فوری در این فایل در طول اجرای شبیه ساز قابل بازیابی هستند. به عنوان مثال: emulator @Pixel8_API_34 -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img اگر این گزینه را مشخص نکنید، پیش فرض |
-sysdir dir | یک دایرکتوری سیستم را با استفاده از یک مسیر مطلق مشخص می کند. برای اطلاعات بیشتر، دایرکتوری سیستم AVD را ببینید. به عنوان مثال: emulator @Pixel8_API_34 -sysdir ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/test |
-system filepath | یک فایل سیستمی اولیه را مشخص می کند. نام فایل و یک مسیر مطلق یا یک مسیر نسبت به دایرکتوری کاری را ارائه می دهد. به عنوان مثال: emulator @Pixel8_API_34 -system ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/system-test.img اگر از این گزینه استفاده نمی کنید، پیش فرض فایل |
-use-system-libs | در لینوکس، به جای نسخه همراه با سیستم شبیه ساز، از سیستم به عنوان مثال: me-linux$ emulator @Pixel8_API_34 -use-system-libs |
-writable-system | از این گزینه برای داشتن یک تصویر سیستم قابل نوشتن در طول جلسه شبیه سازی خود استفاده کنید. برای انجام این کار:
استفاده از این پرچم یک کپی موقت از تصویر سیستم ایجاد می کند که می تواند بسیار بزرگ باشد، تا چند صد مگابایت، اما با خروج شبیه ساز از بین می رود. |
گزینه های منسوخ شده
گزینه های خط فرمان زیر منسوخ شده اند:
-
-audio-in -
-audio-out -
-charmap -
-code-profile -
-cpu-delay -
-dpi-device -
-dynamic_skin -
-enable-kvm -
-gps -
-image -
-keyset -
-help-keys -
-help-keyset-file -
-nand-limits -
-noskin -
-no-skin -
-onion -
-onion-alpha -
-onion-rotation -
-radio -
-ranchu -
-raw-keys -
-scale -
-shared-net-id -
-shell-serial -
-skin -
-skindir -
-trace -
-useaudio
در مورد گزینه های خط فرمان راهنمایی دریافت کنید
این بخش نحوه دریافت کمک در مورد گزینه های خط فرمان را توضیح می دهد. اطلاعات عمیق تری در مورد گزینه های خط فرمان شبیه ساز معمولی که هنگام راه اندازی شبیه ساز در دسترس هستند، ارائه می دهد.
تمام گزینه های شبیه ساز را فهرست کنید
برای چاپ لیستی از تمام گزینه های شبیه ساز، از جمله توضیحات کوتاه، دستور زیر را وارد کنید:
emulator -help
برای یک گزینه خاص راهنمایی دقیق دریافت کنید
برای چاپ راهنما برای یک گزینه راه اندازی خاص، دستور زیر را وارد کنید:
emulator -help-option
به عنوان مثال:
emulator -help-netspeed
این کمک بیشتر از توضیحات ارائه شده توسط گزینه -help است.
برای همه گزینه ها راهنمایی دقیق دریافت کنید
برای دریافت راهنمایی دقیق برای همه گزینه های شبیه ساز، دستور زیر را وارد کنید:
emulator -help-all
لیست متغیرهای محیط شبیه ساز
برای دریافت لیستی از متغیرهای محیط شبیه ساز، دستور زیر را وارد کنید:
emulator -help-environment
می‌توانید قبل از راه‌اندازی یک دستگاه مجازی، متغیرهای محیط را در پنجره ترمینال تنظیم کنید، یا می‌توانید آن را از طریق تنظیمات کاربر خود در سیستم عامل تنظیم کنید. به عنوان مثال، آن را در فایل .bashrc خود در لینوکس تنظیم کنید.
برچسب های اشکال زدایی را فهرست کنید
برای چاپ لیستی از برچسب ها برای گزینه های -debug ، دستور زیر را وارد کنید:
emulator -help-debug-tags
گزینه های -debug به شما امکان می دهد پیام های اشکال زدایی را از اجزای شبیه ساز خاص، همانطور که توسط برچسب ها مشخص شده است، فعال یا غیرفعال کنید.