Probleme mit Android Studio beheben

Diese Seite enthält eine Anleitung zur Behebung häufiger Probleme und Konfigurationsprobleme in Android Studio.

HD-Displays

Ab Version 1.5 unterstützt Android Studio HD-Displays (wie HiDPI- und Retina-Monitore) auf allen Plattformen.

Einstellungen für Skalierungsfaktor

Android Studio bestimmt den Skalierungsfaktor für die Anzeige wie folgt:

Mac
Bei Retina-Displays werden UI-Elemente um den Faktor 200% skaliert und Bilder in hoher Auflösung gerendert. Durch die Skalierung sollte es auch in Konfigurationen mit mehreren Monitoren zu keinen Unschärfen kommen. Beachten Sie, dass nur Skalierungsfaktoren von 100% (Nicht-Retina-Displays) und 200% (Retina-Displays) unterstützt werden.
Windows
Android Studio verwendet die DPI-Einstellungen der Hauptanzeige, um den Skalierungsfaktor von UI-Elementen zu bestimmen. Wenn der Skalierungsfaktor für Bilder weniger als 150 % beträgt, werden Bilder mit normaler Auflösung hochskaliert. Ist der Skalierungsfaktor größer als 150%, werden Bilder mit hoher Auflösung entsprechend skaliert.
Linux
In Android Studio wird der Skalierungsfaktor anhand des „Text-Skalierungsfaktors“ und dann anhand der DPI-Einstellung des XWindow-Systems bestimmt.
Eine DPI-Einstellung von 96 entspricht einem Skalierungsfaktor von 100% (keine Skalierung) und eine DPI-Einstellung von 192 entspricht einem Skalierungsfaktor von 200% (die Größe der UI-Elemente wird verdoppelt). In Android Studio werden derzeit DPI-Einstellungen zwischen 96 (Skalierung 100 %) und 288 (Skalierung 300 %) unterstützt. Wenn Android Studio auf Ihrem Linux- oder Windows-Computer die richtige System-DPI nicht erkennt, können Sie sie manuell festlegen. Dazu legen Sie das Attribut hidpi in der Datei idea.properties fest, wie unter IDE-Eigenschaften anpassen beschrieben. Beachten Sie, dass diese Eigenschaft auf Mac-Computern keine Auswirkungen hat. Diese Eigenschaft funktioniert so:
hidpi=true
Legt den DPI-Wert auf 192 fest (Skalierung von 200 %) und ignoriert die Systemeinstellungen.
hidpi=false
Die DPI wird auf 96 festgelegt (Skalierung von 100 %) und ignoriert die Systemeinstellungen.

Unscharfe oder verpixelte Elemente auf hochauflösenden Displays

Wenn ein oder mehrere Elemente der Benutzeroberfläche von Android Studio auf dem HD-Display verschwommen oder verpixelt erscheinen, liegt möglicherweise eines der folgenden Probleme vor:

  • Wenn ein Großteil der Android Studio-Benutzeroberfläche gut aussieht, ein bestimmtes Symbol jedoch unscharf oder verpixelt ist oder ein bestimmtes UI-Element eine falsche Schriftart verwendet, wurde dieses Element wahrscheinlich noch nicht vollständig für die HiDPI-Unterstützung aktualisiert. Bitte melden Sie einen Fehler, indem Sie auf Hilfe > Feedback geben klicken. Fügen Sie einen Screenshot und so viele Informationen wie möglich zu Ihrer Systemkonfiguration hinzu.
  • Wenn Sie einen Windows- oder Linux-Computer verwenden und Ihre Anzeige einen anderen Skalierungsfaktor als 100% oder 200 % verwendet, können die Bilder aufgrund der Skalierung leicht unscharf erscheinen.
  • Wenn Sie einen Windows-Computer verwenden und die Windows-Schriftgröße in der Systemsteuerung geändert haben, können verschwommene oder verpixelte Schriften auftreten. Sie können dieses Problem beheben, indem Sie sich von Windows abmelden und dann wieder anmelden.
  • Wenn Sie bei einer Konfiguration mit mehreren Monitoren unter Windows 8.1 oder höher ein Fenster von einem Bildschirm auf einen anderen Bildschirm mit einer anderen Auflösung oder DPI verschieben, können Probleme mit der Schriftart oder dem Bild auftreten (siehe Fehler 186007). Derzeit ist keine Problemumgehung bekannt.
  • In älteren Versionen der JRE 1.8 traten verschwommene Schriftarten auf (insbesondere JRE 1.8.0_25-b18 amd64, siehe Fehler 192316). Ab Version 2.2 enthält Android Studio eine gebündelte Version des neuesten unterstützten JDK, in dem auch die JDE enthalten ist. Um dieses Problem zu beheben, aktualisieren Sie Android Studio auf Version 2.2 oder höher und wechseln Sie zur Verwendung des gebündelten JDK. Klicken Sie dazu auf File > Project Structure > SDK Location (Datei > Projektstruktur > SDK-Speicherort) und markieren Sie das Kästchen Use eingebunden JDK.

Elemente mit falscher Größe auf Bildschirmen mit hoher Dichte

Wenn die gesamte Android Studio-Benutzeroberfläche auf dem HD-Display die falsche Größe hat, lesen Sie Einstellungen für Skalierungsfaktor. Wenn einige Elemente der Android Studio-Benutzeroberfläche auf dem HD-Display die falsche Größe haben, andere aber die richtige Größe, tritt möglicherweise eines der folgenden Probleme auf:

  • Wenn Sie ein benutzerdefiniertes Editorschema verwenden, wird die Editorschrift auf einem Bildschirm mit hoher Dichte möglicherweise zu klein oder zu groß im Vergleich zu den übrigen UI-Elementen angezeigt. Um dieses Problem zu beheben, klicken Sie auf Datei > Einstellungen und dann auf Editor > Farben und Schriftarten > Schriftart. Ändern Sie dann die Größe der Editorschrift. Hinweis: Wenn das Standardschema aktiv ist, wird die Schriftgröße des Editors automatisch skaliert (siehe Fehler 186920).
  • Wenn einige UI-Elemente von Android Studio die richtige Größe haben, andere aber zu klein oder zu groß sind, tritt möglicherweise das Problem 186923 auf. Bitte melden Sie einen Fehler, indem Sie auf Hilfe > Feedback geben klicken. Fügen Sie einen Screenshot und so viele Informationen wie möglich zu Ihrer Systemkonfiguration hinzu.

Probleme bei der Projektsynchronisierung

Beim Versuch, Ihr Projekt zu synchronisieren, wird möglicherweise die folgende Fehlermeldung angezeigt: „Die Verbindung zum Internet wurde verweigert. („Berechtigung verweigert: verbinden“). Sie können diese Fehlermeldung beheben, indem Sie der Datei gradle.properties in Android Studio die Systemeigenschaft -Djava.net.preferIPv4Stack=true hinzufügen:

  1. Öffnen Sie die Datei gradle.properties in Android Studio.
  2. Fügen Sie der Datei die folgende Zeile hinzu:
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    
    Wenn Sie der Datei gradle.properties bereits andere Gradle-JVM-Argumente hinzugefügt haben, können Sie dieses Attribut in dieselbe Zeile einfügen, wie im folgenden Beispiel gezeigt:
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
    
  3. Starten Sie Android Studio neu, damit die Änderungen wirksam werden.
  4. Klicke auf Projekt mit Gradle-Dateien synchronisieren, um dein Projekt zu synchronisieren.

Probleme beim Aktualisieren der IDE unter Windows

Unter Windows können Dateien, die von einem Prozess verwendet werden, nicht gelöscht werden. Wenn Sie versuchen, den integrierten Updatemechanismus in der IDE zu verwenden, wird die Installation des Updates manchmal abgelehnt. Dies führt in der Regel zu einer Fehlermeldung wie „C:\some\path\file kann nicht gelöscht werden“.

Sie können dieses Problem umgehen, indem Sie den Task-Manager öffnen und Prozesse beenden, die die Datei möglicherweise verwenden, z. B. Gradle-Daemons.

Probleme mit minSdkVersion

Wenn Sie eine veraltete Version der Android Support Libraries verwenden, erhalten Sie möglicherweise eine Fehlermeldung wie die folgende:

: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

Aktualisieren Sie zur Behebung dieses Problems mit dem SDK-Manager auf die neuesten Versionen der Android Support Libraries (keine Vorschau). Weitere Informationen zum Einrichten der Supportbibliotheken finden Sie unter Supportbibliothek einrichten.

Probleme mit dem Android-Emulator

Siehe Fehlerbehebung im Android-Emulator.

Verzeichnisse

Die folgenden Verzeichnisse werden von Android Studio zum Speichern von Einstellungen, Caches, Plug-ins und Logs verwendet.

Windows

  • Konfiguration (idea.config.path): %APPDATA%\Google\AndroidStudioVERSION
  • Plug-ins (idea.plugins.path): %APPDATA%\Google\AndroidStudioVERSION\plugins
  • System (idea.system.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION
  • Logs (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • Beispiel für %APPDATA%: C:\Users\YourUserName\AppData\Roaming
  • Beispiel für %LOCALAPPDATA%: C:\Users\YourUserName\AppData\Local

macOS

  • Konfiguration (idea.config.path): ~/Library/Application Support/Google/AndroidStudioVERSION
  • Plug-ins (idea.plugins.path): ~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • System (idea.system.path): ~/Library/Caches/Google/AndroidStudioVERSION
  • Logs (idea.log.path): ~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • Konfiguration (idea.config.path): ~/.config/Google/AndroidStudioVERSION
  • Plug-ins (idea.plugins.path): ~/.local/share/Google/AndroidStudioVERSION
  • System (idea.system.path): ~/.cache/Google/AndroidStudioVERSION
  • Logs (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

Jedes Verzeichnis wird im folgenden Format aufgeführt:

Ersetzen:

  • AndroidStudio durch den Produktnamen, der AndroidStudio für stabile Releases oder AndroidStudioPreview für Beta- und Canary-Releases ist.
  • VERSION durch die Version. Beispiel: 2023.1 oder 2023.3.