Probleme mit Android Studio beheben

Auf dieser Seite finden Sie Anleitungen zur Behebung häufiger Probleme und Konfigurationsprobleme in Android Studio.

Displays mit hoher Pixeldichte

Ab Version 1.5 unterstützt Android Studio hochauflösende Displays (z. B. HiDPI- und Retina-Monitore) auf allen Plattformen.

Einstellungen für den Skalierungsfaktor

Android Studio bestimmt den Skalierungsfaktor für Ihren Bildschirm so:

Mac
Auf Retina-Displays werden UI-Elemente um 200% skaliert und Bilder werden in hoher Auflösung gerendert. Auch bei Konfigurationen mit mehreren Monitoren sollte es aufgrund der Skalierung nicht zu Unschärfe kommen. Es werden nur Skalierungsfaktoren von 100% (für Nicht-Retina-Displays) und 200% (für Retina-Displays) unterstützt.
Windows
Android Studio verwendet die DPI-Einstellungen des primären Displays, um den Skalierungsfaktor von UI-Elementen zu bestimmen. Bei Bildern werden Bilder mit normaler Auflösung hochskaliert, wenn der Skalierungsfaktor weniger als 150 % beträgt. Wenn der Skalierungsfaktor größer als 150 % ist, werden hochauflösende Bilder entsprechend skaliert.
Linux
Android Studio bestimmt den Skalierungsfaktor anhand des „Text Scaling Factor“ (Textskalierungsfaktor) und dann anhand der DPI-Einstellung des XWindow-Systems.
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). Android Studio unterstützt derzeit DPI-Einstellungen zwischen 96 (100% Skalierung) und 288 (300% Skalierung). Wenn Android Studio die richtige System-DPI auf Ihrem Linux- oder Windows-Computer nicht erkennt, können Sie sie manuell festlegen, indem Sie die Eigenschaft hidpi in der Datei idea.properties wie unter IDE-Eigenschaften anpassen beschrieben festlegen. Hinweis: Diese Eigenschaft hat keine Auswirkungen auf Mac-Computer. Das Attribut funktioniert so:
hidpi=true
Legt die DPI auf 192 fest (200% Skalierung) und ignoriert die Systemeinstellungen.
hidpi=false
Legt die DPI auf 96 (100% Skalierung) fest und ignoriert die Systemeinstellungen.

Unscharfe oder verpixelte Elemente auf Displays mit hoher Pixeldichte

Wenn ein oder mehrere Elemente der Android Studio-Benutzeroberfläche auf Ihrem Display mit hoher Pixeldichte verschwommen oder verpixelt dargestellt werden, liegt möglicherweise eines der folgenden Probleme vor:

  • Wenn die meisten Elemente der Android Studio-Benutzeroberfläche gut aussehen, aber ein bestimmtes Symbol unscharf oder verpixelt ist oder ein bestimmtes UI-Element die falsche Schriftgröße verwendet, wurde dieses Element wahrscheinlich noch nicht vollständig für HiDPI-Unterstützung aktualisiert. Bitte melden Sie einen Fehler, indem Sie auf Hilfe > Feedback geben klicken. Fügen Sie bitte einen Screenshot und so viele Informationen wie möglich zu Ihrer Systemkonfiguration bei.
  • Wenn Sie einen Windows- oder Linux-Computer verwenden und Ihr Display einen Skalierungsfaktor von mehr als 100% oder 200 % verwendet, können Bilder aufgrund der Skalierung leicht verschwommen dargestellt werden.
  • Wenn Sie einen Windows-Computer verwenden und die Windows-Schriftgröße in der Systemsteuerung geändert haben, kann es sein, dass die Schriftart verschwommen oder verpixelt dargestellt wird. Sie können das Problem beheben, indem Sie sich von Windows abmelden und dann wieder anmelden.
  • Wenn Sie in einer Konfiguration mit mehreren Monitoren unter Windows 8.1 oder höher ein Fenster von einem Display auf ein anderes mit einer anderen Auflösung oder DPI verschieben, können Probleme mit Schriftarten oder Bildern auftreten (siehe Fehler 186007). Derzeit ist keine Problemumgehung bekannt.
  • In älteren Versionen der JRE 1.8 gab es ein Problem mit unscharfen Schriftarten (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, das die JDE enthält. Aktualisieren Sie Android Studio auf Version 2.2 oder höher und wechseln Sie zur Verwendung des mitgelieferten JDK. Klicken Sie dazu auf File > Project Structure > SDK Location und aktivieren Sie das Kästchen Use embedded JDK.

Falsch dimensionierte Elemente auf Displays mit hoher Dichte

Wenn die gesamte Android Studio-Benutzeroberfläche auf Ihrem Display mit hoher Dichte die falsche Größe hat, lesen Sie den Abschnitt Einstellungen für den Skalierungsfaktor. Wenn einige Elemente der Android Studio-Benutzeroberfläche auf Ihrem Display mit hoher Dichte die falsche Größe haben, andere jedoch korrekt angezeigt werden, liegt möglicherweise eines der folgenden Probleme vor:

  • Wenn Sie ein benutzerdefiniertes Editorschema verwenden, kann die Schriftart des Editors auf einem Display mit hoher Pixeldichte im Vergleich zu den anderen UI-Elementen zu klein oder zu groß erscheinen. Klicken Sie zur Behebung dieses Problems auf Datei > Einstellungen und dann auf Editor > Farben und Schriftarten > Schriftart. Ändern Sie die Größe der Editorschriftart. 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 jedoch zu klein oder zu groß sind, liegt möglicherweise das Problem 186923 vor. 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 bei.

Probleme bei der Projektsynchronisierung

Wenn Sie versuchen, Ihr Projekt zu synchronisieren, erhalten Sie möglicherweise die folgende Fehlermeldung: „Verbindung zum Internet verweigert. („Permission denied: connect“). Sie können diese Fehlermeldung beheben, indem Sie die Systemattribute -Djava.net.preferIPv4Stack=true in Android Studio wie folgt in die Datei gradle.properties einfügen:

  1. Öffnen Sie Ihre gradle.properties-Datei in Android Studio.
  2. Fügen Sie der Datei die folgende Zeile hinzu: 
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    Wenn Sie Ihrer gradle.properties-Datei bereits andere Gradle-JVM-Argumente hinzugefügt haben, können Sie diese Eigenschaft in derselben Zeile hinzufü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. Klicken Sie auf Sync Project with Gradle Files, um Ihr 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 Aktualisierungsmechanismus in der IDE zu verwenden, wird die Installation des Updates manchmal abgelehnt. In der Regel wird dann eine Fehlermeldung wie „Can't delete C:\some\path\file“ (Datei kann nicht gelöscht werden) angezeigt.

Um dieses Problem zu umgehen, öffnen Sie den Task-Manager und versuchen Sie, Prozesse zu beenden, die die Datei möglicherweise verwenden, z. B. alle Gradle-Daemons.

Probleme mit minSdkVersion

Wenn Sie eine veraltete Version der Android-Supportbibliotheken 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

Verwenden Sie den SDK Manager, um auf die neuesten (nicht als Vorabversion gekennzeichneten) Versionen der Android-Supportbibliotheken zu aktualisieren, um dieses Problem zu beheben. Weitere Informationen zum Einrichten der Support-Bibliotheken finden Sie unter Support-Bibliothek einrichten.

Probleme mit dem Android Emulator

Weitere Informationen finden Sie unter Fehlerbehebung für den 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
  • Protokolle (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • %APPDATA%-Beispiel: C:\Users\YourUserName\AppData\Roaming
  • %LOCALAPPDATA%-Beispiel: 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
  • Protokolle (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
  • Protokolle (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

Jedes Verzeichnis wird im folgenden Format aufgeführt:

Ersetzen:

  • AndroidStudio mit dem Produktnamen, der bei stabilen Releases AndroidStudio und bei RC- und Canary-Releases AndroidStudioPreview ist.
  • VERSION durch die Version. Beispiel: 2023.1 oder 2023.3.