این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

عیب یابی اندروید استودیو

این صفحه شامل راهنمایی‌هایی برای عیب‌یابی مشکلات رایج و مشکلات پیکربندی در اندروید استودیو است.

نمایشگرهای با چگالی بالا

از نسخه ۱.۵ به بعد، اندروید استودیو از نمایشگرهای با تراکم بالا (مانند مانیتورهای HiDPI و Retina) در همه پلتفرم‌ها پشتیبانی می‌کند.

تنظیمات ضریب مقیاس‌بندی

اندروید استودیو ضریب مقیاس‌بندی نمایشگر شما را به صورت زیر تعیین می‌کند:

مک: برای نمایشگرهای رتینا، عناصر رابط کاربری با ضریب ۲۰۰٪ مقیاس‌بندی می‌شوند و تصاویر با وضوح بالا رندر می‌شوند. حتی در پیکربندی‌های چند مانیتوری، نباید هیچ تاری ناشی از مقیاس‌بندی وجود داشته باشد. توجه داشته باشید که هیچ پشتیبانی برای مقیاس‌بندی به غیر از ۱۰۰٪ (برای نمایشگرهای غیر رتینا) و ۲۰۰٪ (برای نمایشگرهای رتینا) وجود ندارد.
ویندوز: اندروید استودیو از تنظیمات DPI نمایشگر اصلی برای تعیین ضریب مقیاس‌بندی عناصر رابط کاربری استفاده می‌کند. برای تصاویر، اگر ضریب مقیاس‌بندی کمتر از ۱۵۰٪ باشد، تصاویر با وضوح معمولی افزایش مقیاس داده می‌شوند. اگر ضریب مقیاس‌بندی بیشتر از ۱۵۰٪ باشد، تصاویر با وضوح بالا به طور مناسب مقیاس‌بندی می‌شوند.
لینوکس: اندروید استودیو با نگاه کردن به «ضریب مقیاس‌بندی متن» و سپس با نگاه کردن به تنظیمات DPI سیستم XWindow، ضریب مقیاس‌بندی را تعیین می‌کند.

تنظیم DPI روی ۹۶ معادل ضریب مقیاس‌بندی ۱۰۰٪ (بدون مقیاس‌بندی) و تنظیم DPI روی ۱۹۲ معادل ضریب مقیاس‌بندی ۲۰۰٪ (دو برابر شدن اندازه عناصر رابط کاربری) است. اندروید استودیو در حال حاضر از تنظیمات DPI بین ۹۶ (مقیاس‌بندی ۱۰۰٪) و ۲۸۸ (مقیاس‌بندی ۳۰۰٪) پشتیبانی می‌کند. اگر اندروید استودیو DPI سیستم صحیح را در دستگاه لینوکس یا ویندوز شما تشخیص نداد، می‌توانید آن را به صورت دستی با تنظیم ویژگی hidpi در فایل idea.properties همانطور که در بخش «سفارشی‌سازی ویژگی‌های IDE» توضیح داده شده است، تنظیم کنید. توجه داشته باشید که این ویژگی هیچ تاثیری بر دستگاه‌های مک ندارد. این ویژگی به شرح زیر عمل می‌کند:

hidpi=true: DPI را روی ۱۹۲ (با مقیاس ۲۰۰٪) تنظیم می‌کند و تنظیمات سیستم را نادیده می‌گیرد.
hidpi=false: DPI را روی ۹۶ (مقیاس‌بندی ۱۰۰٪) تنظیم می‌کند و تنظیمات سیستم را نادیده می‌گیرد.

عناصر تار یا پیکسلی در نمایشگرهای با تراکم بالا

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

اگر بیشتر رابط کاربری اندروید استودیو خوب به نظر می‌رسد، اما یک آیکون خاص تار یا پیکسلی است، یا یک عنصر خاص رابط کاربری از فونت با اندازه اشتباه استفاده می‌کند، احتمالاً آن عنصر خاص هنوز به طور کامل برای پشتیبانی از HiDPI به‌روزرسانی نشده است. لطفاً با کلیک روی راهنما > ارسال بازخورد، یک اشکال را ثبت کنید. لطفاً یک تصویر از صفحه و تا حد امکان اطلاعات مربوط به پیکربندی سیستم خود را ضمیمه کنید.
اگر از دستگاه ویندوز یا لینوکس استفاده می‌کنید و نمایشگر شما از ضریب مقیاس‌بندی غیر از ۱۰۰٪ یا ۲۰۰٪ استفاده می‌کند، ممکن است تصاویر به دلیل مقیاس‌بندی کمی تار به نظر برسند.
اگر از دستگاه ویندوزی استفاده می‌کنید و اندازه فونت ویندوز را در کنترل پنل تغییر داده‌اید، ممکن است با تار شدن یا پیکسلی شدن فونت مواجه شوید. می‌توانید با خروج از ویندوز و سپس ورود مجدد به آن، این مشکل را حل کنید.
در یک سیستم چند مانیتوره که ویندوز ۸.۱ یا بالاتر را اجرا می‌کند، وقتی یک پنجره را از یک نمایشگر به نمایشگر دیگری با وضوح یا DPI متفاوت منتقل می‌کنید، ممکن است با مشکلات فونت یا تصویر مواجه شوید (به اشکال ۱۸۶۰۰۷ مراجعه کنید). در حال حاضر هیچ راه حل شناخته شده‌ای وجود ندارد.
نسخه‌های قدیمی‌تر JRE 1.8 مشکل فونت‌های تار داشتند (به‌ویژه JRE 1.8.0_25-b18 amd64، به اشکال 192316 مراجعه کنید.) از نسخه 2.2، اندروید استودیو شامل یک نسخه همراه از آخرین JDK پشتیبانی‌شده است که شامل JDE نیز می‌شود. برای حل این مشکل، اندروید استودیو را به نسخه 2.2 یا بالاتر به‌روزرسانی کنید و با کلیک روی File > Project Structure > SDK Location و علامت زدن کادر انتخاب Use embedded JDK ، به استفاده از JDK همراه تغییر دهید.

عناصر با اندازه نادرست در نمایشگرهای با چگالی بالا

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

اگر از یک طرح ویرایشگر سفارشی استفاده می‌کنید، ممکن است فونت ویرایشگر در مقایسه با بقیه عناصر رابط کاربری در یک صفحه نمایش با تراکم بالا، خیلی کوچک یا خیلی بزرگ به نظر برسد. برای رفع این مشکل، روی File > Settings کلیک کنید، سپس روی Editor > Colors and Fonts > Font کلیک کنید و اندازه فونت ویرایشگر را تغییر دهید. توجه داشته باشید که وقتی طرح پیش‌فرض فعال است، اندازه فونت ویرایشگر به طور خودکار مقیاس‌بندی می‌شود (به اشکال ۱۸۶۹۲۰ مراجعه کنید).
اگر برخی از عناصر رابط کاربری اندروید استودیو اندازه مناسبی دارند، اما برخی دیگر خیلی کوچک یا خیلی بزرگ هستند، ممکن است با مشکل ۱۸۶۹۲۳ مواجه باشید. لطفاً با کلیک روی راهنما > ارسال بازخورد، یک اشکال (باگ) ثبت کنید. لطفاً یک تصویر از صفحه و تا حد امکان اطلاعات مربوط به پیکربندی سیستم خود را ضمیمه کنید.

مشکلات همگام‌سازی پروژه

هنگام تلاش برای همگام‌سازی پروژه، ممکن است پیام خطای زیر را دریافت کنید: "اتصال به اینترنت رد شد. ('اجازه رد شد: اتصال')". می‌توانید این پیام خطا را با اضافه کردن ویژگی سیستمی -Djava.net.preferIPv4Stack=true به فایل gradle.properties خود در اندروید استودیو به شرح زیر برطرف کنید:

فایل gradle.properties خود را در اندروید استودیو باز کنید.
خط زیر را به فایل اضافه کنید:
```
org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
```
توجه داشته باشید که اگر قبلاً آرگومان‌های دیگری از Gradle JVM را به فایل gradle.properties خود اضافه کرده‌اید، می‌توانید این ویژگی را به همان خطی که در مثال زیر نشان داده شده است، اضافه کنید:
```
org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
```
برای اعمال تغییرات، اندروید استودیو را مجدداً راه‌اندازی کنید.
روی همگام‌سازی پروژه با فایل‌های Gradle کلیک کنید برای همگام‌سازی پروژه شما.

مشکل در به‌روزرسانی IDE در ویندوز

در ویندوز، فایل‌هایی که توسط یک فرآیند در حال استفاده هستند را نمی‌توان حذف کرد. وقتی سعی می‌کنید از مکانیزم به‌روزرسانی داخلی در IDE استفاده کنید، گاهی اوقات از نصب به‌روزرسانی خودداری می‌کند و معمولاً پیام خطایی مانند "Can't delete C:\some\path\file" را نشان می‌دهد.

برای حل این مشکل، task manager را باز کنید و سعی کنید فرآیندهایی را که ممکن است از این فایل استفاده کنند، مانند هر سرویس Gradle، از بین ببرید.

مشکلات نسخه minSDk

اگر از نسخه منسوخ‌شده‌ی Android Support Libraries استفاده می‌کنید، ممکن است پیام خطایی مانند زیر دریافت کنید:

:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml
Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

برای حل این مشکل، از SDK manager برای به‌روزرسانی به آخرین نسخه‌های (غیر پیش‌نمایش) کتابخانه‌های پشتیبانی اندروید استفاده کنید. برای اطلاعات بیشتر در مورد راه‌اندازی کتابخانه‌های پشتیبانی، به بخش راه‌اندازی کتابخانه پشتیبانی مراجعه کنید.

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

به بخش عیب‌یابی شبیه‌ساز اندروید مراجعه کنید.

دایرکتوری‌ها

دایرکتوری‌های زیر توسط اندروید استودیو برای ذخیره تنظیمات، حافظه‌های پنهان، افزونه‌ها و گزارش‌ها استفاده می‌شوند.

ویندوز

پیکربندی (idea.config.path): %APPDATA%\Google\ AndroidStudio VERSION
افزونه‌ها (idea.plugins.path): %APPDATA%\Google\ AndroidStudio VERSION \plugins
سیستم (idea.system.path): %LOCALAPPDATA%\Google\ AndroidStudio VERSION
لاگ‌ها (idea.log.path): %LOCALAPPDATA%\Google\ AndroidStudio VERSION \log

مثال %APPDATA% : C:\Users\YourUserName\AppData\Roaming
مثال %LOCALAPPDATA% : C:\Users\YourUserName\AppData\Local

مک‌او‌اس

پیکربندی (idea.config.path): ~/Library/Application Support/Google/ AndroidStudio VERSION
افزونه‌ها (idea.plugins.path): ~/Library/Application Support/Google/ AndroidStudio VERSION /plugins
سیستم (idea.system.path): ~/Library/Caches/Google/ AndroidStudio VERSION
لاگ‌ها (idea.log.path): ~/Library/Logs/Google/ AndroidStudio VERSION

لینوکس

پیکربندی (idea.config.path): ~/.config/Google/ AndroidStudio VERSION
افزونه‌ها (idea.plugins.path): ~/.local/share/Google/ AndroidStudio VERSION
سیستم (idea.system.path): ~/.cache/Google/ AndroidStudio VERSION
لاگ‌ها (idea.log.path): ~/.cache/Google/ AndroidStudio VERSION /log

هر دایرکتوری با فرمت زیر فهرست می‌شود:

<informal directory name> ( <IDE property> ): <default path> .

جایگزین کنید:

AndroidStudio با نام محصول، که برای نسخه‌های پایدار AndroidStudio یا برای نسخه‌های RC و Canary AndroidStudioPreview است.
VERSION به همراه نسخه. برای مثال: 2023.1 یا 2023.3 .

عیب یابی اندروید استودیو با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.