פתרון בעיות ב-Android Studio

בדף הזה מפורטות הנחיות לפתרון בעיות נפוצות ובעיות בהגדרות ב-Android Studio.

מסכים עם צפיפות פיקסלים גבוהה

החל מגרסה 1.5, ‏ Android Studio מספק תמיכה בצגים עם צפיפות פיקסלים גבוהה (כמו צגי HiDPI ו-Retina) בכל הפלטפורמות.

הגדרות של גורם לקביעת קנה מידה

‫Android Studio קובע את גורם קנה המידה של התצוגה באופן הבא:

Mac
במסכי Retina, רכיבי ממשק המשתמש מוגדלים פי 2 ותמונות מוצגות ברזולוציה גבוהה. לא אמור להיות טשטוש בגלל שינוי גודל, גם לא בהגדרות של כמה מסכים. שימו לב: אין תמיכה בפקטורים של שינוי גודל מלבד 100% (למסכים שאינם מסכי Retina) ו-200% (למסכי Retina).
Windows
‫Android Studio משתמש בהגדרות ה-DPI של המסך הראשי כדי לקבוע את גורם קנה המידה של רכיבי ממשק המשתמש. בתמונות, אם מקדם ההתאמה לגודל קטן מ-150%, תמונות ברזולוציה רגילה מוגדלות. אם גורם ההתאמה גדול מ-150%, תמונות ברזולוציה גבוהה מותאמות באופן הולם.
Linux
‫Android Studio קובע את גורם קביעת קנה המידה על סמך הערך של Text Scaling Factor (גורם קביעת קנה מידה של טקסט), ואז על סמך הגדרת ה-DPI של מערכת XWindow.
הגדרת DPI של 96 מתאימה לגורם קנה מידה של 100% (ללא שינוי קנה מידה), והגדרת DPI של 192 מתאימה לגורם קנה מידה של 200% (הגודל של רכיבי ממשק המשתמש מוכפל). בשלב הזה, Android Studio תומך בהגדרות DPI בין 96 (100% scaling) ל-288 (300% scaling). אם Android Studio לא מזהה את ה-DPI הנכון של המערכת במחשב Linux או Windows, אפשר להגדיר אותו באופן ידני על ידי הגדרת המאפיין hidpi בקובץ idea.properties, כמו שמתואר במאמר התאמה אישית של מאפייני ה-IDE. הערה: למאפיין הזה אין השפעה על מחשבי Mac. הנכס הזה פועל באופן הבא:
hidpi=true
מגדיר את ה-DPI ל-192 (שינוי גודל של 200%), תוך התעלמות מהגדרות המערכת.
hidpi=false
מגדיר את ה-DPI ל-96 (100% שינוי גודל), תוך התעלמות מהגדרות המערכת.

רכיבים מטושטשים או מפוקסלים במסכים עם צפיפות פיקסלים גבוהה

אם אחד או יותר מהאלמנטים בממשק המשתמש של Android Studio מופיעים מטושטשים או מפוקסלים במסך ברזולוציה גבוהה, יכול להיות שאתם נתקלים באחת מהבעיות הבאות:

  • אם רוב ממשק המשתמש של Android Studio נראה טוב, אבל סמל מסוים מטושטש או מפוקסל, או שאלמנט מסוים בממשק המשתמש משתמש בגודל גופן שגוי, כנראה שהאלמנט המסוים הזה עדיין לא עודכן באופן מלא לתמיכה ב-HiDPI. כדי לשלוח דוח על באג, לוחצים על עזרה > שליחת משוב. חשוב לצרף צילום מסך ולספק כמה שיותר מידע על הגדרות המערכת.
  • אם אתם משתמשים במחשב עם Windows או Linux, והתצוגה מוגדרת עם גורם קנה מידה שאינו 100% או 200%, יכול להיות שהתמונות ייראו מטושטשות מעט בגלל שינוי קנה המידה.
  • אם אתם משתמשים במחשב עם Windows ושיניתם את גודל הגופן של Windows בלוח הבקרה, יכול להיות שהגופן יהיה מטושטש או מפוקסל. כדי לפתור את הבעיה הזו, צריך לצאת מ-Windows ואז להיכנס שוב.
  • במערך עם כמה מסכים שפועל ב-Windows 8.1 ואילך, כשמעבירים חלון ממסך אחד למסך אחר עם רזולוציה או DPI שונים, יכולות להיות בעיות בגופן או בתמונה (ראו באג 186007). אין פתרון עקיף ידוע בשלב הזה.
  • בגרסאות ישנות יותר של JRE 1.8 הייתה בעיה שגרמה לטשטוש של גופנים (במיוחד ב-JRE 1.8.0_25-b18 amd64, ראו באג 192316). החל מגרסה 2.2, ‏ Android Studio כולל גרסה מאוגדת של ה-JDK העדכני הנתמך, שכוללת את ה-JDE. כדי לפתור את הבעיה, צריך לעדכן את Android Studio לגרסה 2.2 ואילך ולעבור לשימוש ב-JDK שצורף לחבילה. לשם כך, לוחצים על File > Project Structure > SDK Location ומסמנים את התיבה Use embedded JDK.

רכיבים בגודל שגוי בצגים עם צפיפות פיקסלים גבוהה

אם כל ממשק המשתמש של Android Studio בגודל שגוי במסך עם צפיפות פיקסלים גבוהה, אפשר לעיין בהגדרות של גורם קנה המידה. אם חלק מהרכיבים בממשק המשתמש של Android Studio מוצגים בגודל שגוי במסך עם צפיפות פיקסלים גבוהה, אבל רכיבים אחרים מוצגים בגודל הנכון, יכול להיות שאתם נתקלים באחת מהבעיות הבאות:

  • אם אתם משתמשים בסכימת עריכה בהתאמה אישית, יכול להיות שהגופן בעורך ייראה קטן מדי או גדול מדי בהשוואה לשאר רכיבי ממשק המשתמש במסך עם צפיפות פיקסלים גבוהה. כדי לפתור את הבעיה, לוחצים על קובץ > הגדרות ואז על עורך > צבעים וגופנים > גופן ומשנים את הגודל של הגופן בעורך. הערה: כשהסכימה שמוגדרת כברירת מחדל פעילה, גודל הגופן בכלי העריכה משתנה אוטומטית (ראו באג 186920).
  • אם חלק מרכיבי ממשק המשתמש של Android Studio הם בגודל הנכון, אבל אחרים קטנים מדי או גדולים מדי, יכול להיות שאתם נתקלים בבעיה 186923. כדי לשלוח דוח על באג, לוחצים על עזרה > שליחת משוב. חשוב לכלול צילום מסך ומידע מפורט ככל האפשר על הגדרות המערכת.

בעיות בסנכרון פרויקטים

כשמנסים לסנכרן את הפרויקט, יכול להיות שתוצג הודעת השגיאה הבאה: 'הגישה לאינטרנט נדחתה. ('Permission denied: connect')". כדי לפתור את הבעיה שמוצגת בהודעת השגיאה, צריך להוסיף את מאפיין המערכת -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. כדי שהשינויים ייכנסו לתוקף, צריך להפעיל מחדש את Android Studio.
  4. לוחצים על Sync Project with Gradle Files (סנכרון הפרויקט עם קובצי Gradle) כדי לסנכרן את הפרויקט.

בעיות בעדכון סביבת הפיתוח המשולבת ב-Windows

ב-Windows, אי אפשר למחוק קבצים שנמצאים בשימוש על ידי תהליך. כשמנסים להשתמש במנגנון העדכון המובנה בסביבת הפיתוח המשולבת (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

פתרון בעיות ב-Android Emulator

מדריכים

הספריות הבאות משמשות את Android Studio לאחסון הגדרות, מטמון, פלאגינים ויומנים.

Windows

  • הגדרה (idea.config.path): %APPDATA%\Google\AndroidStudioVERSION
  • תוספים (idea.plugins.path): %APPDATA%\Google\AndroidStudioVERSION\plugins
  • מערכת (idea.system.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION
  • יומנים (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • %APPDATA% דוגמה: C:\Users\YourUserName\AppData\Roaming
  • %LOCALAPPDATA% דוגמה: C:\Users\YourUserName\AppData\Local

macOS

  • הגדרה (idea.config.path): ~/Library/Application Support/Google/AndroidStudioVERSION
  • תוספים (idea.plugins.path): ~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • מערכת (idea.system.path): ~/Library/Caches/Google/AndroidStudioVERSION
  • יומנים (idea.log.path): ~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • הגדרה (idea.config.path): ~/.config/Google/AndroidStudioVERSION
  • תוספים (idea.plugins.path): ~/.local/share/Google/AndroidStudioVERSION
  • מערכת (idea.system.path): ~/.cache/Google/AndroidStudioVERSION
  • יומנים (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

כל ספרייה מפורטת בפורמט הבא:

מחליפים את:

  • ‫AndroidStudio עם שם המוצר, שהוא AndroidStudio לגרסאות יציבות, או AndroidStudioPreview לגרסאות RC ו-Canary.
  • ‫VERSION עם הגרסה. לדוגמה: 2023.1 או 2023.3.