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

הדף הזה כולל הנחיות לפתרון בעיות נפוצות שקשורות להגדרות או בעיות אחרות ב-Android Studio.

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

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

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

מערכת Android Studio קובעת את גורם ההתאמה לעומס (scaling) של המסך שלכם באופן הבא:

Mac
במסכים של רטינה, רכיבי ממשק המשתמש מותאמים בגורם של 200% ותמונות מעובדות ברזולוציה גבוהה. לא אמור להיות טשטוש בגלל התאמה לעומס (scaling), גם בתצורות של ריבוי צגים. לתשומת ליבכם: אין תמיכה עבור גורמי התאמה אחרים שאינם 100% (עבור מסכים שאינם רטינה) ו-200% (עבור תצוגות רטינה).
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%) ל-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 שכלול בחבילה בלחיצה על קובץ > מבנה הפרויקט > מיקום ה-SDK וסימון האפשרות שימוש 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. לוחצים על סנכרון הפרויקט עם Gradle Files כדי לסנכרן את הפרויקט.

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

ב-Windows, לא ניתן למחוק קבצים שנמצאים בשימוש של תהליך. אחרי ש מנסים להשתמש במנגנון העדכון המובנה בסביבת הפיתוח המשולבת (IDE), לפעמים הם מסרבים להתקין את העדכון, בדרך כלל מתקבלת הודעת שגיאה כמו "אין אפשרות למחוק C:\some\path\file".

כדי לעקוף את הבעיה, פותחים את מנהל המשימות ומנסים להפסיק תהליכים יכול להשתמש בקובץ, למשל כל דימון (daemon) של 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 לגרסאות בטא ו-Canary.
  • VERSION בגרסה. לדוגמה: 2023.1 או 2023.3.