عیب‌یابی کردن مشکلات شناخته‌شده با «شبیه‌ساز Android»

این صفحه مشکلات شناخته‌شده، راه‌حل‌های موقت، و نکات عیب‌یابی را برای «شبیه‌ساز Android» فهرست می‌کند. اگر با مشکلی مواجه شدید که در اینجا فهرست نشده است یا نمی‌توانید با موفقیت از راه حل موقت فهرست‌شده در اینجا استفاده کنید، اشکال را گزارش کنید.

مشکلات کلی


خطاهای «این دستگاه دارای گواهینامه سپر ایمنی Play نیست» در دستگاه‌های مجازی Android با میانای برنامه‌سازی کاربردی ۳۷

هنگام اجرای تصاویر سیستم API 37 در «شبیه‌ساز Android»، ممکن است با اختلال در گردش کار سرویس‌ها و برنامه‌های Google مواجه شوید. از ۱۶ ژوئن ۲۰۲۶، دستگاه‌های مجازی Android 17 وصله‌نشده ممکن است نتوانند به «حساب‌های Google» وارد شوند و هنگام راه‌اندازی برنامه‌های شخص اول Google یا فراخوانی میاناهای برنامه‌سازی کاربردی GMSCore، با ازکارافتادگی یا مسدود شدن اصالت‌سنجی مواجه شوند.

راه‌حل: بااستفاده از مدیر SDK، ایمیج سیستم خود را به API 37 بازبینی 5 یا بالاتر به‌روز کنید، یا به جدیدترین ایمیج سیستم Canary Preview به‌روز کنید.

برگه «پلاتفرم‌های مدیر کیت توسعه نرم‌افزار» در «استودیو Android».
مدیر SDK.

Google Maps در کنترل‌های گسترده «شبیه‌ساز Android» نشان داده نمی‌شود

از اواسط ماه مه، نسخه‌های «شبیه‌ساز Android» قدیمی‌تر از نسخه ۳۴.۲.۱۳ دیگر Google Maps کاربردی در کنترل‌های گسترده نخواهند داشت. شبیه‌سازهای قدیمی‌تر با نسخه‌ای از Chromium عرضه می‌شوند که با Google Maps Javascript API ناسازگار است.

بررسی کافی بودن فضای دیسک

برای جلوگیری از خرابی و توقف به‌دلیل کمبود فضای دیسک آزاد، شبیه‌ساز در زمان راه‌اندازی کافی بودن فضای دیسک آزاد را بررسی می‌کند و تا زمانی که حداقل ۵ گیگابایت فضای آزاد وجود نداشته باشد، راه‌اندازی نمی‌شود. اگر شبیه‌ساز شروع نشد، بررسی کنید که فضای دیسک آزاد کافی داشته باشید.

نرم‌افزار ضدویروس

ازآنجایی‌که بسیاری از بسته‌های نرم‌افزاری امنیتی و ضدویروس با نظارت بر هر عملیات خواندن و نوشتن کار می‌کنند، استفاده از چنین نرم‌افزارهایی می‌تواند عملکرد ابزارهایی مانند «شبیه‌ساز Android» را کاهش دهد.

بسیاری از بسته‌های ضدویروس این امکان را فراهم می‌کنند که برنامه‌های خاصی به فهرست برنامه‌های مورداعتماد اضافه شوند، که این کار به برنامه‌های فهرست‌شده اجازه می‌دهد بدون افت عملکرد کار کنند. اگر عملکرد ضعیفی در ذخیره یا بار کردن عکس‌های آنی AVD دارید، می‌توانید با افزودن برنامه «شبیه‌ساز Android» به‌عنوان برنامه مورداعتماد در نرم‌افزار ضدویروس خود، این عملکرد را بهبود بخشید.

تأثیر بر عملکرد در بسته‌های نرم‌افزاری ضدویروس مختلف متفاوت است. اگر علاوه‌بر نرم‌افزار ضدویروس موجود در سیستم‌عاملتان، نرم‌افزار ضدویروس دیگری نصب کرده‌اید، می‌توانید آزمایش‌هایی را اجرا کنید تا مشخص شود کدام نرم‌افزار ضدویروس تأثیر بیشتری بر عملکرد بارگیری و ذخیره شبیه‌ساز دارد.

Windows: حافظه دسترسی تصادفی آزاد و هزینه تعهد

وقتی شبیه‌ساز شروع می‌شود، باید RAM سیستم‌عامل مهمان Android را مقداردهی اولیه کند. در Windows، شبیه‌ساز درخواست می‌کند که Windows در زمان شروع، کل اندازه حافظه مهمان را درنظر بگیرد، هرچند درطول عملکرد واقعی، ممکن است حافظه درصورت درخواست صفحه‌بندی شود. شبیه‌ساز در زمان شروع، کل مقدار حافظه مهمان را درخواست می‌کند زیرا Windows در اطمینان از اینکه RAM فیزیکی و فایل صفحه‌بندی کافی برای نگهداری کل مجموعه کاری بالقوه وجود دارد، محافظه‌کارانه عمل می‌کند. این درخواست برای بدترین حالت آماده می‌شود، جایی که تمام حافظه مهمان به‌سرعت لمس می‌شود بدون اینکه فرصتی برای دور انداختن یا آزاد کردن حافظه وجود داشته باشد.

گاهی اوقات، وقتی شبیه‌ساز از Windows می‌خواهد این اندازه کامل حافظه مهمان را حساب کند، درخواست از حد تخصیص فعلی فراتر می‌رود که مجموع RAM فیزیکی و فایل صفحه‌بندی موجود است. در این حالت، Windows نمی‌تواند تضمین کند که بدترین حالت مجموعه کاری در RAM فیزیکی یا فایل صفحه‌بندی جا می‌شود، و شبیه‌ساز راه‌اندازی نمی‌شود.

معمولاً فضای دیسک سخت برای فایل صفحه به‌علاوه RAM فیزیکی کافی است. اگر شبیه‌ساز به‌دلیل فراتر رفتن از حد تخصیص حافظه ناموفق بود، تخصیص حافظه را در برگه عملکرد در «مدیر وظیفه Windows» (Ctrl+Shift+Esc) بررسی کنید.

برای کاهش احتمال فراتر رفتن از حد تعهد به روش‌های مختلف:

  • قبل‌از راه‌اندازی شبیه‌ساز، با بستن برنامه‌ها و فایل‌های استفاده‌نشده، حافظه دسترسی تصادفی (RAM) فیزیکی را آزاد کنید.
  • ابزارهای مدیریت حافظه و فشرده‌سازی حافظه طرف سوم را غیرفعال کنید. این ابزارها می‌توانند به‌طور ناکارآمدی باعث ایجاد هزینه تعهد اضافی شوند و سیستم شما را به حد تعهد نزدیک‌تر کنند.
  • از اندازه مدیریت‌شده توسط سیستم برای فایل صفحه Windows استفاده کنید که می‌تواند به‌طور انعطاف‌پذیرتر و پویاتر اندازه فایل صفحه و درنتیجه حد تخصیص را در پاسخ به افزایش تقاضا ازسوی شبیه‌ساز و سایر برنامه‌ها افزایش دهد.

    برای اطلاعات بیشتر درباره هزینه‌های تعهد و اینکه چرا تنظیم انعطاف‌پذیر بهترین عملکرد را دارد، این مقاله Microsoft را بخوانید.

چندلمسی در پنجره ابزار کار نمی‌کند

اشاره‌های چندلمسی، ازجمله حرکت با دو انگشت، وقتی شبیه‌ساز در پنجره ابزار درحال اجرا باشد کار نمی‌کند. برای فعال کردن چندلمسی، شبیه‌ساز را در پنجره‌ای جداگانه راه‌اندازی کنید.

شبیه‌ساز کیفیت خروجی صوتی بلوتوث را کاهش می‌دهد

اگر از هدست بلوتوث استفاده می‌کنید، ممکن است متوجه شوید که خروجی صوتی هدفون بلوتوث هنگام اجرای شبیه‌ساز افت می‌کند (مشکل ۱۸۳۱۳۹۲۰۷). این اتفاق به این دلیل می‌افتد که وقتی شبیه‌ساز راه‌اندازی می‌شود، میکروفون هدست را روشن می‌کند، که باعث می‌شود هدست حالت دوطرفه را با کیفیت کاهش‌یافته تغییر دهد.

برای جلوگیری از این مشکل، میکروفون را در شبیه‌ساز با افزودن hw.audioInput=no به فایل config.ini «دستگاه مجازی Android» غیرفعال کنید. برای پیدا کردن فایل config.ini مربوط به «دستگاه مجازی Android»، به «دستگاه مجازی Android» در «مدیر دستگاه» بروید، روی منو سرریز آن کلیک کنید، و نمایش در دیسک را انتخاب کنید.

دستگاه‌های مجازی Android در ChromeOS راه‌اندازی نمی‌شوند

در ChromeOS، ممکن است «دستگاه‌های مجازی Android» (AVD) به‌دلیل نبودن وابستگی libnss3 راه‌اندازی نشوند. برای راه‌اندازی موفقیت‌آمیز AVD، sudo apt install libnss3 را اجرا کنید تا کتابخانه libnss3 به‌صورت دستی نصب شود.

هشدارهای حسگر کج کردن مچ در Wear OS

در Wear OS، شبیه‌ساز ممکن است پیام زیر را درباره حسگر کج کردن مچ دست به‌طور مکرر ثبت کند: the host has not provided value yet for sensorHandle=16

توسعه‌دهندگان می‌توانند بااطمینان این هشدارها را نادیده بگیرند.

پنجره شبیه‌ساز جاسازی‌شده خیلی کوچک است

در دستگاه‌هایی با وضوح پایین‌تر، مانند ۱۰۲۴×۷۶۸، خواندن صفحه شبیه‌ساز هنگام اجرا در پنجره ابزار در Android Studio ممکن است دشوار باشد. برای دادن فضای بیشتر به شبیه‌ساز، پنجره ابزار مدیر دستگاه را اگر باز است ببندید. همچنین می‌توانید پنجره شبیه‌ساز را از Android Studio بیرون بکشید. برای انجام این کار، در پنجره شبیه‌ساز، روی تنظیمات > حالت مشاهده کلیک کنید و به‌جای سنجاق‌شده به جایگاه، پنجره را انتخاب کنید.

مشکلات گرافیکی


«شبیه‌ساز Android» پس‌از به‌روزرسانی کند اجرا می‌شود

تعدادی از عوامل خارجی می‌توانند باعث شوند که «شبیه‌ساز Android» پس‌از به‌روزرسانی به‌کندی اجرا شود. برای شروع عیب‌یابی، مراحل زیر را توصیه می‌کنیم:

  • اگر واحد پردازش گرافیکی Intel (و به‌ویژه Intel HD 4000) دارید، مطمئن شوید که جدیدترین درایور گرافیک Intel را بارگیری و نصب کرده‌اید.
  • اگر دستگاهتان هم GPU Intel و هم GPU مجزا دارد، GPU Intel را در «مدیر دستگاه» غیرفعال کنید تا مطمئن شوید از GPU مجزا استفاده می‌کنید.
  • شبیه‌ساز را بااستفاده از حالت -gpu swiftshader اجرا کنید. برای اطلاعات بیشتر درباره پیکربندی گزینه‌های شتاب‌دهی گرافیکی در خط فرمان، به پیکربندی شتاب سخت‌افزاری مراجعه کنید.
  • اگر اتصال IPv6 ندارید، مطمئن شوید که رهیاب شما از نشانی‌های IPv6 استفاده نمی‌کند.

اگر همچنان با مشکل کندی اجرای «شبیه‌ساز Android» مواجه هستید، اشکالی را گزارش کنید و جزئیات لازم درباره «شبیه‌ساز Android» را اضافه کنید تا بتوانیم آن را بررسی کنیم.

خطا: vulkan-1.dll پیدا نشد

اگر شبیه‌ساز به‌دلیل خطای vulkan-1.dll cannot be found راه‌اندازی نشد، احتمالاً باید شبیه‌ساز را به‌روز کنید. برای به‌روزرسانی شبیه‌ساز در Android Studio، به ابزارها > مدیر SDK بروید و جدیدترین نسخه پایدار پلاتفرم Android را نصب کنید.

یا اگر به برنامه‌هایی که از کتابخانه گرافیکی Vulkan استفاده می‌کنند نیاز ندارید، Vulkan را با راه‌اندازی شبیه‌ساز از خط فرمان با پرچم -feature -Vulkan خاموش کنید.

عکس آنی ایجاد نشد

ایجاد عکس آنی از شبیه‌ساز که شامل کتابخانه گرافیکی Vulkan باشد پشتیبانی نمی‌شود. برای اجرای شبیه‌ساز بدون Vulkan، شبیه‌ساز را از خط فرمان با پرچم -feature -Vulkan راه‌اندازی کنید. یا اگر می‌خواهید از عکس‌های آنی به‌عنوان بخشی از گردش کار توسعه‌تان استفاده کنید، می‌توانید برنامه‌هایی را که از Vulkan استفاده می‌کنند (مثل Chrome در میانای برنامه‌سازی کاربردی ۳۰ یا بالاتر) حذف نصب کنید و از آن‌ها استفاده نکنید.

صفحه وب به‌درستی باز نمی‌شود

از سطح API‏ ۳۰،‏ Chrome از کتابخانه گرافیکی Vulkan به‌عنوان پسایان پرداز استفاده می‌کند و ممکن است در برخی‌از دستگاه‌ها مشکلات سازگاری داشته باشد. اگر Chrome به‌درستی برای شما رندر نمی‌شود، سعی کنید شبیه‌ساز را از خط فرمان با پرچم -feature -Vulkan راه‌اندازی کنید.

هشدار درایور واحد پردازش گرافیکی - بازگشت به نرم‌افزار

اگر هشداری درباره بازگشت درایور GPU دریافت می‌کنید، ممکن است از GPU پشتیبانی‌نشده استفاده می‌کنید. به‌طور پیش‌فرض از حالت خودکار استفاده می‌کند که ممکن است پردازش نرم‌افزاری را انتخاب کند. اگر سخت‌افزار را انتخاب کنید، باید بتوانید آن را مجبور کنید از پرداز سخت‌افزاری استفاده کند (ممکن است همچنان پیام هشداری نشان دهد).

برای تصویرهای غیرفروشگاه Play، می‌توانید این کار را در «مدیر دستگاه» -> ۳ نقطه -> ویرایش انجام دهید. برای تصاویر فروشگاه Play، باید آن ۲ فایل پیکربندی را به‌صورت دستی ویرایش کنید:

~/.android/your_avd_name.avd/config.ini

~/.android/your_avd_name.avd/hardware-qemu.ini

و hw.gpu.mode را به host تغییر دهید

توجه داشته باشید که انجام این کار ممکن است پایداری شبیه‌ساز را کاهش دهد. برای جزئیات بیشتر، اشکال را ببینید.

شبیه‌ساز در «میزکار از دور Chrome» در Windows راه‌اندازی نمی‌شود

اگر «شبیه‌ساز» هنگام استفاده از «میز کار از دور Chrome» در Windows راه‌اندازی نمی‌شود، راهکار توصیه‌شده فعلی استفاده از پرچم use-gpu مانند -gpu host یا -gpu swiftshader است.

شبیه‌ساز با کد خروج -۱۰۷۳۷۴۱۵۱۱ (Windows 8.1 یا Windows 10 N) خاتمه یافت

دلیل آن احتمالاً این است که سیستم شما (مثلاً:C:\Windows\System32 (سیستم ۶۴ بیتی)) msvcp140.dll،‏ msvcp140_1.dll، و msvcp140_2.dll را ندارد. در گذشته، کاربرانی که این مشکل را گزارش کرده‌اند توانسته‌اند آن را با نصب (یا بازنصب) Windows Media Feature که در نسخه‌های Windows 10 N اختیاری است برطرف کنند.

مشکل مشابهی در Windows 8.1 دیده می‌شود.

برای نحوه نصب Windows Media Feature، به وب‌سایت Microsoft مراجعه کنید.

توجه داشته باشید که Windows 8.1 دیگر پشتیبانی نمی‌شود، نه فقط توسط Android Studio و «شبیه‌ساز Android»، بلکه توسط Microsoft (از سال ۲۰۲۳). همان‌طور که Microsoft اعلام کرده است، پشتیبانی از Windows 10 در ۱۴ اکتبر ۲۰۲۵ به‌پایان می‌رسد، بنابراین می‌توان نظر مشابهی درباره Windows 10 نیز داد. درحالی‌که نیاز به راه‌حلی برای Windows 8.1/Windows 10 را درک می‌کنیم، ادامه توسعه و پشتیبانی از سیستم‌عامل‌های قدیمی‌تر چالش‌هایی را ایجاد می‌کند که می‌تواند بر پایداری و عملکرد شبیه‌ساز برای اکثر کاربران ما تأثیر بگذارد.

به‌عنوان یک راهکار احتمالی (اما پشتیبانی‌نشده)، اگر نمی‌توانید سیستم‌عاملتان را ارتقا دهید، می‌توانید نسخه قدیمی‌تری از «شبیه‌ساز Android» را در بایگانی ما (https://developer.android.com/studio/emulator_archive، آخرین نسخه پایدار 32.1.11 است) پیدا کنید که ممکن است با Windows 8.1 سازگار باشد. توجه داشته باشید که این نسخه‌های پایین‌تر پشتیبانی نمی‌شوند و ممکن است عملکرد درستی نداشته باشند، و اکیداً توصیه می‌کنیم از آن‌ها با نسخه‌های جدیدتر Android (مانند میانای برنامه‌سازی کاربردی ۳۴ و بالاتر) استفاده نکنید.

برای داشتن بهترین تجربه با «شبیه‌ساز Android»، توصیه می‌کنیم به سیستم‌عامل پشتیبانی‌شده ارتقا دهید.

برای هر مشکل احتمالی که از این بابت پیش می‌آید پوزش می‌طلبیم.

شبیه‌ساز در macOS در حالت پردازنده گرافیکی سخت‌افزاری به‌درستی رفتار نمی‌کند

در دستگاه‌های Mac با Apple Silicon، شبیه‌ساز از کتابخانه MoltenVK برای Vulkan API هنگام انتخاب حالت پردازش سخت‌افزاری استفاده می‌کند. درحالی‌که MoltenVK معمولاً عملکرد بسیار بهتری ارائه می‌دهد، کتابخانه از همه ویژگی‌های Vulkan پشتیبانی نمی‌کند. درصورت بروز مشکلات سازگاری، مثل عدم موفقیت در کامپایل سایه‌زن، اشکالات گرافیکی، یا ازکار افتادن برنامه‌ها، حالت پرداز را ازطریق تنظیمات AVD به نرم‌افزار تغییر دهید، یا از آرگومان خط فرمان -gpu swiftshader استفاده کنید.

یا می‌توانید پشتیبانی Vulkan را با آرگومان -feature -Vulkan غیرفعال کنید تا همچنان از شتاب سخت‌افزاری در برنامه‌های GLES استفاده کنید.

مشکلات شبکه


اینترنت وجود ندارد: نشانی ساناد سرور پیدا نشد

اگر شبیه‌ساز نمی‌تواند به اینترنت متصل شود، شبیه‌ساز را از خط فرمان بااستفاده از گزینه -dns-server "2001:4860:4860::8844,2001:4860:4860::8888,8.8.8.8,8.8.4.4" راه‌اندازی کنید. این فرمان فهرستی از نشانی‌های IP «سامانه نام دامنه عمومی Google» را ارائه می‌دهد که با کاما ازهم جدا شده‌اند. برای کسب اطلاعات بیشتر درباره «سامانه نام دامنه عمومی Google»، به سامانه نام دامنه عمومی Google برای دستگاه‌هایتان مراجعه کنید.

اینترنت وجود ندارد: مشکلات تفکیک ساناد

گاهی اوقات نشانی‌های DNS در فایل /etc/resolv.conf به‌درستی کار نمی‌کنند. می‌توانید با راه‌اندازی شبیه‌ساز از خط فرمان بااستفاده از گزینه -dns-server 8.8.8.8 یا -dns.server 2001:4860:4860::8888 برای اتصال ازطریق شبکه فقط IPv6، این مشکل را حل کنید.

اینترنت وجود ندارد: مشکلات تداخل مک آدرس

اگر چند شبیه‌ساز نشانی MAC یکسانی داشته باشند، فقط اولین شبیه‌ساز راه‌اندازی‌شده به اینترنت دسترسی خواهد داشت. این اتفاق زمانی می‌افتد که شبیه‌سازها درطول ایجاد به همان درگاه ADB اختصاص داده شده باشند یا از همان عکس آنی راه‌اندازی شده باشند.

برای حل این مشکل، می‌توانید داده‌های موجود در AVD دوم را پاک کنید یا AVD جدیدی ایجاد کنید.

محدودیت‌های پیکربندی شبکه خط فرمان (-netsim-args)

فقط هنگام راه‌اندازی اولین نمونه شبیه‌ساز می‌توانید تنظیمات شبکه خط فرمان مشخص‌شده با -netsim-args را اعمال کنید. شبیه‌ساز این تنظیمات را بر هر شبیه‌ساز دیگری که بعداً راه‌اندازی شود اعمال می‌کند. نمی‌توانید تنظیمات شبکه متفاوتی را بااستفاده از آرگومان‌های خط فرمان برای چند شبیه‌ساز که به‌طور هم‌زمان اجرا می‌شوند پیکربندی کنید.

مشکلات قدیمی (در شبیه‌سازهای منسوخ‌شده یا سیستم‌های قدیمی)


AVD راه‌اندازی نشد

اگر گزارش خرابی برای شبیه‌ساز جدیدتری وجود داشته باشد، ممکن است AVD راه‌اندازی نشود (مشکل شماره ۲۸۱۷۲۵۸۵۴). این مشکل فقط برای کاربرانی رخ می‌دهد که از نسخه قناری 33.x به 32.1.13 به‌روزرسانی می‌کنند، آخرین باری که نسخه 33.x را اجرا کردند دچار خرابی شدند، و پس‌از آن AVD خود را بازراه‌اندازی نکرده‌اند، بنابراین دایرکتوری %TEMP% یا /tmp هنوز روشن است. اگر با این مشکل مواجه هستید، سعی کنید دایرکتوری %TEMP% (/tmp در Linux یا macOS) را پاک کنید.

Windows: اگر در نام AVD یونی‌کد وجود داشته باشد، شبیه‌ساز راه‌اندازی نمی‌شود

در Windows، وقتی «مدیر دستگاه» یک «دستگاه مجازی Android» (AVD) ایجاد می‌کند، به‌طور پیش‌فرض AVD را در C:\Users\<name>\.android\avd ایجاد می‌کند. اما اگر نام AVD (<name>) دارای یونیکد باشد، شبیه‌ساز نمی‌تواند AVD را به‌درستی بااستفاده از این مکان پیش‌فرض راه‌اندازی کند.

این مشکل در «شبیه‌ساز» نسخه ۳۱.۳.۶ و بالاتر برطرف شده است. برای حل این مشکل، شبیه‌ساز را با انتخاب ابزارها > مدیر SDK به‌روز کنید.

یا برای حل این مشکل، متغیر محیطی ANDROID_SDK_HOME را قبل‌از ایجاد AVD روی دایرکتوری سفارشی تنظیم کنید. برای مثال، فهرست راهنمای C:\Android\home را ایجاد کنید، سپس ANDROID_SDK_HOME را روی این فهرست راهنمای جدیداً ایجادشده تنظیم کنید. برای کسب اطلاعات بیشتر، متغیرهای محیطی را ببینید.

Hypervisor نمی‌تواند برخی‌از ویژگی‌های CPU را که سیستم‌های Android x86 به آن‌ها نیاز دارند شبیه‌سازی کند

فراسرپرست‌ها معمولاً نمی‌توانند برخی‌از ویژگی‌های CPU را شبیه‌سازی کنند، مثل Streaming SIMD Extensions (SSE)، که برای سیستم‌های Android x86 لازم است.