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

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

نمایشگرهای با تراکم بالا

از نسخه 1.5، Android Studio از نمایشگرهای با چگالی بالا (مانند مانیتورهای HiDPI و Retina) در همه پلتفرم ها پشتیبانی می کند.

تنظیمات فاکتور مقیاس

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

مک
برای نمایشگرهای رتینا، عناصر UI با ضریب 200 درصد مقیاس بندی می شوند و تصاویر با وضوح بالا ارائه می شوند. حتی در تنظیمات چند مانیتوری نباید به دلیل پوسته پوسته شدن تاری وجود داشته باشد. توجه داشته باشید که هیچ پشتیبانی از فاکتورهای مقیاس پذیری به جز 100% (برای نمایشگرهای غیر شبکیه چشم) و 200% (برای نمایشگرهای رتینا) وجود ندارد.
ویندوز
Android Studio از تنظیمات DPI نمایشگر اصلی برای تعیین ضریب مقیاس پذیری عناصر UI استفاده می کند. برای تصاویر، اگر ضریب پوسته پوسته شدن کمتر از 150٪ باشد، تصاویر با وضوح معمولی بزرگ می شوند. اگر ضریب پوسته پوسته شدن بیشتر از 150٪ باشد، تصاویر با وضوح بالا به طور مناسب مقیاس بندی می شوند.
لینوکس
Android Studio ضریب مقیاس را با نگاه کردن به "Text Scaling Factor" و سپس به تنظیمات DPI سیستم XWindow تعیین می کند.
تنظیم DPI 96 مربوط به ضریب مقیاس 100٪ (بدون مقیاس بندی) و تنظیم DPI 192 مربوط به ضریب مقیاس پذیری 200٪ است (اندازه عناصر UI دو برابر شده است). اندروید استودیو در حال حاضر از تنظیمات DPI بین 96 (100٪ مقیاس) و 288 (300٪ مقیاس) پشتیبانی می کند. اگر Android Studio DPI صحیح سیستم را در دستگاه لینوکس یا ویندوز شما تشخیص نمی‌دهد، می‌توانید با تنظیم ویژگی hidpi در فایل idea.properties همانطور که در Customize your IDE properties توضیح داده شده است، آن را به صورت دستی تنظیم کنید. توجه داشته باشید که این ویژگی روی ماشین های مک تاثیری ندارد. عملکرد این ویژگی به صورت زیر است:
hidpi=true
DPI را روی 192 تنظیم می کند (200% مقیاس بندی)، بدون توجه به تنظیمات سیستم.
hidpi=false
DPI را روی 96 تنظیم می کند (100% مقیاس بندی)، بدون توجه به تنظیمات سیستم.

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

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

  • اگر بیشتر رابط کاربری Android Studio خوب به نظر می رسد، اما یک نماد خاص تار یا پیکسلی است، یا یک عنصر رابط کاربری خاص از فونت اندازه اشتباه استفاده می کند، احتمالاً آن عنصر خاص هنوز به طور کامل برای پشتیبانی از HiDPI به روز نشده است. لطفاً با کلیک روی راهنما > ارسال بازخورد، یک اشکال را ثبت کنید. لطفاً یک اسکرین شات و تا حد امکان اطلاعات مربوط به پیکربندی سیستم خود را وارد کنید.
  • اگر از یک ماشین ویندوز یا لینوکس استفاده می کنید و صفحه نمایش شما از ضریب مقیاس پذیری غیر از 100٪ یا 200٪ استفاده می کند، ممکن است به دلیل مقیاس بندی، تصاویر کمی تار به نظر برسند.
  • اگر از یک دستگاه ویندوز استفاده می کنید و اندازه فونت ویندوز را در کنترل پنل تغییر داده اید، ممکن است فونت تار یا پیکسلی را تجربه کنید. می‌توانید با خروج از ویندوز و سپس ورود مجدد، این مشکل را حل کنید.
  • در یک راه‌اندازی چند مانیتور با ویندوز 8.1 یا جدیدتر، وقتی پنجره‌ای را از یک نمایشگر به نمایشگر دیگری با وضوح یا DPI متفاوت منتقل می‌کنید، ممکن است با مشکلات فونت یا تصویر مواجه شوید (اشکال 186007 را ببینید). در حال حاضر هیچ راه حل شناخته شده ای وجود ندارد.
  • نسخه‌های قدیمی‌تر JRE 1.8 با فونت‌های تار مشکل داشتند (به‌ویژه JRE 1.8.0_25-b18 amd64، به اشکال 192316 مراجعه کنید.) از نسخه 2.2، استودیو Android دارای یک نسخه همراه از آخرین JDK پشتیبانی‌شده است که شامل JDE می‌شود. برای حل این مشکل، Android Studio را به نسخه 2.2 یا بالاتر به‌روزرسانی کنید و با کلیک روی File > Project Structure > SDK Location و علامت زدن کادر استفاده از JDK جاسازی شده، به استفاده از JDK همراه بروید.

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

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

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

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

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

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

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

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

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

مشکلات minSdkVersion

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

: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 برای به روز رسانی به آخرین نسخه (غیر پیش نمایش) کتابخانه های پشتیبانی Android استفاده کنید. برای اطلاعات بیشتر درباره راه‌اندازی کتابخانه‌های پشتیبانی، به تنظیمات کتابخانه پشتیبانی مراجعه کنید.

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

عیب یابی شبیه ساز اندروید را ببینید.

دایرکتوری ها

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

ویندوز

  • پیکربندی (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

macOS

  • پیکربندی (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

هر دایرکتوری در قالب زیر فهرست شده است:

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

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