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

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

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

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

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

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

Mac
במסכי Retina, רכיבי ממשק המשתמש מוגדלים ב-200% והתמונות מוצגות ברזולוציה גבוהה. לא אמור להיות טשטוש בגלל שינוי הגודל, גם בהגדרות של כמה מסכים. שימו לב שאין תמיכה בפקטורים של שינוי גודל מלבד 100% (למסכים שאינם מסכי Retina) ו-200% (למסכי Retina).
Windows
‫Android Studio משתמש בהגדרות ה-DPI של המסך הראשי כדי לקבוע את גורם לקביעת קנה מידה של רכיבי ממשק המשתמש. בתמונות, אם מקדם ההתאמה לגודל קטן מ-150%, תמונות ברזולוציה רגילה מוגדלות. אם גורם קביעת קנה המידה גדול מ-150%, התמונות ברזולוציה גבוהה מותאמות באופן הולם.
Linux
‫Android Studio קובע את גורם לקביעת קנה מידה על ידי בדיקה של 'גורם קנה המידה של הטקסט', ואז של הגדרת ה-DPI של מערכת XWindow.
הגדרת DPI של 96 מתאימה לגורם לקביעת קנה מידה של 100% (ללא שינוי קנה מידה), והגדרת DPI של 192 מתאימה לגורם לקביעת קנה מידה של 200% (הגודל של רכיבי ממשק המשתמש מוכפל). בשלב הזה, Android Studio תומך בהגדרות DPI בין 96 (100% שינוי גודל) ל-288 (300% שינוי גודל). אם 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 (קובץ > מבנה הפרויקט > מיקום ה-SDK) ומסמנים את התיבה Use embedded JDK (שימוש ב-JDK מוטמע).

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

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

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

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

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

בעיות בעדכון סביבת הפיתוח המשולבת (IDE) ב-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

מדריכים

הספריות הבאות משמשות את 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.