Android Studio konfigurieren

Android Studio bietet Assistenten und Vorlagen, mit denen Ihre Systemanforderungen, z. B. das Java Development Kit (JDK) und der verfügbare RAM, überprüft werden. Außerdem können Sie Standardeinstellungen konfigurieren, z. B. eine optimierte standardmäßige AVD-Emulation (Android Virtual Device, AVD) und aktualisierte System-Images. In diesem Dokument werden zusätzliche Konfigurationseinstellungen beschrieben, mit denen Sie die Verwendung von Android Studio individuell anpassen können.

Android Studio bietet über das Menü Hilfe Zugriff auf zwei Konfigurationsdateien:

  • studio.vmoptions: Passt Optionen für die Java Virtual Machine (JVM) von Android Studio an, z. B. die Heap-Größe und die Cache-Größe. Beachten Sie, dass diese Datei auf Linux-Computern je nach Ihrer Android Studio-Version den Namen studio64.vmoptions hat.
  • idea.properties: Passt Android Studio-Attribute an, z. B. den Plug-in-Ordnerpfad oder die maximal unterstützte Dateigröße.

Eine spezifische Dokumentation zum Emulator und zur Einrichtung und Verwendung von Geräten finden Sie in den folgenden Themen:

Konfigurationsdateien suchen

Beide Konfigurationsdateien werden im Konfigurationsverzeichnis für Android Studio gespeichert. Das Konfigurationsverzeichnis finden Sie unter Verzeichnisse.

Mit den folgenden Umgebungsvariablen können Sie auf bestimmte Überschreibungsdateien an anderer Stelle verweisen:

  • STUDIO_VM_OPTIONS: Legen Sie den Namen und den Speicherort der Datei .vmoptions fest.
  • STUDIO_PROPERTIES: Legen Sie den Namen und den Speicherort der Datei .properties fest.

Unter Java-Versionen in Android-Builds können Sie konfigurieren, welche JDKs verwendet werden.

VM-Optionen anpassen

Mit der Datei studio.vmoptions können Sie Optionen für die JVM von Android Studio anpassen. Um die Leistung von Android Studio zu verbessern, wird am häufigsten die maximale Heap-Größe angepasst. Sie können aber auch die Datei studio.vmoptions verwenden, um andere Standardeinstellungen wie anfängliche Heap-Größe, Cache-Größe und Java-Speicherbereinigungs-Switches zu überschreiben.

So erstellen Sie eine neue studio.vmoptions-Datei oder öffnen eine vorhandene Datei:

  1. Klicken Sie auf Help > Edit Custom VM Options (Hilfe > Benutzerdefinierte VM-Optionen bearbeiten). Wenn Sie noch nie VM-Optionen für Android Studio bearbeitet haben, werden Sie von der IDE aufgefordert, eine neue studio.vmoptions-Datei zu erstellen. Klicken Sie auf Erstellen, um die Datei anzulegen.
  2. Die Datei studio.vmoptions wird im Editorfenster von Android Studio geöffnet. Fügen Sie Ihre benutzerdefinierten VM-Optionen in die Datei ein. Eine vollständige Liste der anpassbaren JVM-Optionen finden Sie auf der Oracle-Seite Java HotSpot-VM-Optionen.

Die von Ihnen erstellte Datei studio.vmoptions wird der Standarddatei studio.vmoptions hinzugefügt, die sich im Verzeichnis bin/ in Ihrem Android Studio-Installationsordner befindet.

Bearbeiten Sie die Datei studio.vmoptions im Android Studio-Programmordner nicht direkt. Sie können zwar auf die Datei zugreifen, um die Standard-VM-Optionen von Android Studio anzusehen, aber wenn Sie nur Ihre eigene studio.vmoptions-Datei bearbeiten, wird sichergestellt, dass wichtige Standardeinstellungen für Android Studio nicht überschrieben werden. Überschreiben Sie daher in Ihrer studio.vmoptions-Datei nur die Attribute, die für Sie von Interesse sind, und lassen Sie Android Studio weiterhin Standardwerte für alle Attribute verwenden, die Sie nicht geändert haben.

Maximale Heap-Größe

Die maximale Heap-Größe in Android Studio beträgt standardmäßig 1.280 MB. Wenn Sie an einem großen Projekt arbeiten oder Ihr System viel RAM hat, können Sie die Leistung verbessern, indem Sie die maximale Heap-Größe für Android Studio-Prozesse wie die Kern-IDE, den Gradle-Daemon und den Kotlin-Daemon erhöhen.

Android Studio sucht automatisch nach möglichen Heap-Größenoptimierungen und benachrichtigt Sie, wenn es feststellt, dass die Leistung verbessert werden kann.

Die Speichereinstellungen, mit denen Sie die maximale RAM-Größe für Android Studio-Prozesse konfigurieren können.

Abbildung 1: Eine Benachrichtigung zu den empfohlenen Arbeitsspeichereinstellungen.

Wenn Sie ein 64-Bit-System mit mindestens 5 GB RAM verwenden, können Sie die Heap-Größen für Ihr Projekt auch manuell anpassen. Das funktioniert so:

  1. Klicken Sie in der Menüleiste auf File > Settings (Datei > Einstellungen) (Android Studio > Einstellungen unter macOS).
  2. Klicken Sie auf Darstellung und Verhalten > Systemeinstellungen > Speichereinstellungen.

    Die Speichereinstellungen, mit denen Sie die maximale RAM-Größe für Android Studio-Prozesse konfigurieren können.

    Abbildung 2: Konfigurieren Sie die maximale RAM-Größe in den Arbeitsspeichereinstellungen.

  3. Passen Sie die Heap-Größen an.

  4. Klicken Sie auf Übernehmen.

    Wenn Sie die Heap-Größe für die IDE ändern, müssen Sie Android Studio neu starten, damit die neuen Speichereinstellungen angewendet werden.

IDE-Einstellungen exportieren und importieren

Sie können eine Settings.jar-Datei exportieren, die alle oder einen Teil Ihrer bevorzugten IDE-Einstellungen für ein Projekt enthält. Anschließend können Sie die JAR-Datei in Ihre anderen Projekte importieren und/oder die JAR-Datei Ihren Kollegen für den Import in ihre Projekte zur Verfügung stellen.

Weitere Informationen finden Sie unter IDE-Einstellungen freigeben unter IntelliJ IDEA.

IDE-Properties anpassen

Mit der Datei idea.properties können Sie die IDE-Attribute für Android Studio anpassen, z. B. den Pfad zu vom Nutzer installierten Plug-ins und die maximale Dateigröße, die von der IDE unterstützt wird. Die Datei idea.properties wird mit den Standardattributen für die IDE zusammengeführt, sodass Sie nur die Überschreibungsattribute angeben können.

So erstellen Sie eine neue idea.properties-Datei oder öffnen eine vorhandene Datei:

  1. Klicken Sie auf Hilfe > Benutzerdefinierte Eigenschaften bearbeiten. Wenn Sie die IDE-Eigenschaften noch nie bearbeitet haben, werden Sie von Android Studio aufgefordert, eine neue idea.properties-Datei zu erstellen. Klicken Sie auf Ja, um die Datei zu erstellen.
  2. Die Datei idea.properties wird im Editorfenster von Android Studio geöffnet. Fügen Sie Ihre benutzerdefinierten IDE-Eigenschaften in die Datei ein.

Die folgende idea.properties-Datei enthält häufig benutzerdefinierte IDE-Eigenschaften. Eine vollständige Liste der Attribute finden Sie in der Datei idea.properties für IntelliJ IDEA.

#---------------------------------------------------------------------
# Uncomment this option if you want to customize path to user installed plugins folder. Make sure
# you're using forward slashes.
#---------------------------------------------------------------------
# idea.plugins.path=${idea.config.path}/plugins
#---------------------------------------------------------------------
# Maximum file size (kilobytes) IDE should provide code assistance for.
# The larger the file is, the slower its editor works and higher overall system memory requirements are
# if code assistance is enabled. Remove this property or set to very large number if you need
# code assistance for any files available regardless their size.
#---------------------------------------------------------------------
idea.max.intellisense.filesize=2500
#---------------------------------------------------------------------
# This option controls console cyclic buffer: keeps the console output size not higher than the
# specified buffer size (Kb). Older lines are deleted. In order to disable cycle buffer use
# idea.cycle.buffer.size=disabled
#---------------------------------------------------------------------
idea.cycle.buffer.size=1024
#---------------------------------------------------------------------
# Configure if a special launcher should be used when running processes from within IDE.
# Using Launcher enables "soft exit" and "thread dump" features.
#---------------------------------------------------------------------
idea.no.launcher=false
#---------------------------------------------------------------------
# To avoid too long classpath
#---------------------------------------------------------------------
idea.dynamic.classpath=false
#---------------------------------------------------------------------
# There are two possible values of idea.popup.weight property: "heavy" and "medium".
# If you have WM configured as "Focus follows mouse with Auto Raise", then you have to
# set this property to "medium". It prevents problems with popup menus on some
# configurations.
#---------------------------------------------------------------------
idea.popup.weight=heavy
#---------------------------------------------------------------------
# Use default anti-aliasing in system, i.e. override value of
# "Settings|Editor|Appearance|Use anti-aliased font" option. May be useful when using Windows
# Remote Desktop Connection for instance.
#---------------------------------------------------------------------
idea.use.default.antialiasing.in.editor=false
#---------------------------------------------------------------------
# Disabling this property may lead to visual glitches like blinking and fail to repaint
# on certain display adapter cards.
#---------------------------------------------------------------------
sun.java2d.noddraw=true
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under Windows.
#---------------------------------------------------------------------
sun.java2d.d3d=false
#---------------------------------------------------------------------
# Workaround for slow scrolling in JDK6.
#---------------------------------------------------------------------
swing.bufferPerWindow=false
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under X Window.
#---------------------------------------------------------------------
sun.java2d.pmoffscreen=false
#---------------------------------------------------------------------
# Workaround to avoid long hangs while accessing clipboard under Mac OS X.
#---------------------------------------------------------------------
# ide.mac.useNativeClipboard=True
#---------------------------------------------------------------------
# Maximum size (kilobytes) IDEA will load for showing past file contents -
# in Show Diff or when calculating Digest Diff.
#---------------------------------------------------------------------
# idea.max.vcs.loaded.size.kb=20480

IDE für Maschinen mit wenig Arbeitsspeicher konfigurieren

Wenn Sie Android Studio auf einem Computer mit weniger als den empfohlenen Spezifikationen ausführen (siehe Systemanforderungen), können Sie die IDE anpassen, um die Leistung auf Ihrem Computer zu verbessern:

  • Reduziere die maximale Heap-Größe, die für Android Studio verfügbar ist:Reduziere die maximale Heap-Größe für Android Studio auf 512 MB. Weitere Informationen zum Ändern der maximalen Heap-Größe finden Sie unter Maximale Heap-Größe.
  • Gradle und das Android-Gradle-Plug-in aktualisieren:Aktualisieren Sie auf die neuesten Versionen von Gradle und dem Android-Gradle-Plug-in, um von den neuesten Leistungsverbesserungen zu profitieren. Weitere Informationen zum Aktualisieren von Gradle und des Android-Gradle-Plug-ins finden Sie in den Versionshinweisen für das Android-Gradle-Plug-in.
  • Energiesparmodus aktivieren: Aktivieren Sie den Energiesparmodus, um eine Reihe von speicher- und energieintensiven Hintergrundvorgängen zu deaktivieren. Dazu gehören die Fehlerhervorhebung und On-the-Fly-Prüfungen, die automatische Pop-up-Codevervollständigung und die automatische inkrementelle Hintergrundkompilierung. Klicken Sie auf Datei > Energiesparmodus, um den Energiesparmodus zu aktivieren.
  • Unnötige Lint-Prüfungen deaktivieren:So ändern Sie, welche Lint-Prüfungen Android Studio für Ihren Code ausführt:

    1. Klicken Sie auf Datei > Einstellungen (unter macOS: Android Studio > Einstellungen), um das Dialogfeld Einstellungen zu öffnen.
    2. Maximieren Sie im linken Bereich den Abschnitt Editor und klicken Sie auf Inspections.
    3. Klicken Sie auf die Kästchen, um Lint-Prüfungen für Ihr Projekt auszuwählen oder die Auswahl aufzuheben.
    4. Klicken Sie auf Übernehmen oder OK, um die Änderungen zu speichern.
  • Fehler auf einem physischen Gerät beheben:Verbessern Sie die Gesamtleistung von Android Studio, indem Sie Fehler auf einem physischen Gerät beheben. Die Fehlerbehebung in einem Emulator erfordert mehr Arbeitsspeicher als die Fehlerbehebung auf einem physischen Gerät.

  • Nur erforderliche Google Play-Dienste als Abhängigkeiten einschließen:Schließen Sie nur die erforderlichen Google Play-Dienste als Abhängigkeiten in Ihr Projekt ein. Abhängigkeiten erhöhen den erforderlichen Arbeitsspeicher, sodass ihre Begrenzung die Arbeitsspeichernutzung und die Leistung verbessert. Weitere Informationen findest du unter Abhängigkeiten für Google Play-Dienste deklarieren.

  • Reduzieren Sie die für Gradle verfügbare maximale Heap-Größe:Reduzieren Sie den Wert der maximalen Heap-Größe von Gradle von der Standardeinstellung von 1.536 MB, indem Sie das Attribut org.gradle.jvmargs in der Datei gradle.properties wie hier gezeigt überschreiben:

    # Make sure to gradually decrease this value and note
    # changes in performance. Allocating too little memory can
    # also decrease performance.
    org.gradle.jvmargs = -Xmx1536m
    
  • Achten Sie darauf, dass die parallele Kompilierung nicht aktiviert ist: Android Studio kann unabhängige Module parallel kompilieren. Diese Funktion kann jedoch deaktiviert bleiben, wenn Sie ein System mit wenig Arbeitsspeicher verwenden. So prüfen Sie diese Einstellung:

    1. Klicken Sie auf Datei > Einstellungen (unter macOS: Android Studio > Einstellungen), um das Dialogfeld Einstellungen zu öffnen.
    2. Maximieren Sie im linken Bereich Build, Execution, Deployment (Build, Ausführung, Bereitstellung) und klicken Sie dann auf Compiler.
    3. Achten Sie darauf, dass die Option Unabhängige Module parallel kompilieren deaktiviert ist.
    4. Wenn Sie eine Änderung vorgenommen haben, klicken Sie auf Übernehmen oder OK, damit die Änderung wirksam wird.

Proxy-Einstellungen festlegen

Proxys dienen als Verbindungspunkte zwischen HTTP-Clients und Webservern, die Sicherheit und Datenschutz bei Internetverbindungen erhöhen.

Wenn Sie die Ausführung von Android Studio hinter einer Firewall unterstützen möchten, verwenden Sie die Android Studio IDE-HTTP-Proxy-Einstellungsseite, um die HTTP-Proxy-Einstellungen festzulegen.

Wenn Sie das Android-Gradle-Plug-in über die Befehlszeile oder auf Computern ausführen, auf denen Android Studio nicht installiert ist, z. B. auf Continuous Integration-Servern, legen Sie die Proxyeinstellungen in der Gradle-Build-Datei fest.

Android Studio-Proxy einrichten

Android Studio unterstützt HTTP-Proxy-Einstellungen, sodass Sie Android Studio hinter einer Firewall oder einem sicheren Netzwerk ausführen können. So legen Sie die HTTP-Proxy-Einstellungen in Android Studio fest:

  1. Klicken Sie in der Menüleiste auf Datei > Einstellungen (unter macOS auf Android Studio > Einstellungen).
  2. Klicken Sie im linken Bereich auf Darstellung und Verhalten > Systemeinstellungen > HTTP-Proxy. Die HTTP-Proxy-Seite wird angezeigt.
  3. Wählen Sie Proxy-Einstellungen automatisch erkennen aus, um eine automatische Proxy-Konfigurations-URL für die Proxy-Einstellungen zu verwenden, oder Manuelle Proxy-Konfiguration, um die einzelnen Einstellungen selbst festzulegen. Eine ausführliche Erläuterung dieser Einstellungen finden Sie unter HTTP-Proxy.
  4. Klicken Sie auf Übernehmen oder OK, damit die Änderungen wirksam werden.

Android-Plug-in für Gradle-HTTP-Proxy-Einstellungen

Wenn Sie das Android-Plug-in über die Befehlszeile oder auf Computern ausführen, auf denen Android Studio nicht installiert ist, legen Sie die Proxyeinstellungen des Android-Gradle-Plug-ins in der Gradle-Build-Datei fest.

Legen Sie für anwendungsspezifische HTTP-Proxy-Einstellungen die Proxy-Einstellungen in der Datei build.gradle nach Bedarf für jedes Anwendungsmodul fest:

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        ...
        systemProp.http.proxyHost=proxy.company.com
        systemProp.http.proxyPort=443
        systemProp.http.proxyUser=userid
        systemProp.http.proxyPassword=password
        systemProp.http.auth.ntlm.domain=domain
    }
    ...
}

Legen Sie für projektweite HTTP-Proxy-Einstellungen die Proxy-Einstellungen in der Datei gradle/gradle.properties fest:

# Project-wide Gradle settings.
...

systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=username
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain

systemProp.https.proxyHost=proxy.company.com
systemProp.https.proxyPort=443
systemProp.https.proxyUser=username
systemProp.https.proxyPassword=password
systemProp.https.auth.ntlm.domain=domain

...

Informationen zur Verwendung von Gradle-Attributen für Proxyeinstellungen finden Sie im Gradle-Nutzerhandbuch.

Android Studio-Leistung unter Windows optimieren

Die Leistung von Android Studio unter Windows kann durch verschiedene Faktoren beeinflusst werden. In diesem Abschnitt wird beschrieben, wie Sie die Android Studio-Einstellungen optimieren können, um die bestmögliche Leistung unter Windows zu erzielen.

Auswirkungen von Antivirensoftware auf die Build-Geschwindigkeit minimieren

Einige Antivirenprogramme können den Android Studio-Build-Prozess beeinträchtigen und dazu führen, dass Builds erheblich langsamer ausgeführt werden. Wenn Sie einen Build in Android Studio ausführen, kompiliert Gradle die Ressourcen und den Quellcode Ihrer App und verpackt die kompilierten Ressourcen dann in einem APK oder AAB. Bei diesem Vorgang werden viele Dateien auf Ihrem Computer erstellt. Wenn für Ihre Antivirensoftware das Scannen in Echtzeit aktiviert ist, kann sie den Build-Prozess jedes Mal anhalten, wenn eine Datei erstellt wird, während diese Datei gescannt wird.

Um dieses Problem zu vermeiden, können Sie bestimmte Verzeichnisse vom Echtzeitscan in Ihrer Antivirensoftware ausschließen. Unter Windows können Sie mit dem Build Analyzer die Verzeichnisse ermitteln, die vom aktiven Scan ausgeschlossen werden sollen, und diese ausschließen.

Die folgende Liste enthält den Standardspeicherort jedes Android Studio-Verzeichnisses, das Sie vom Echtzeitscan ausschließen können:

Gradle-Cache
%USERPROFILE%\.gradle
Android Studio-Projekte
%USERPROFILE%\AndroidStudioProjects
Android SDK
%USERPROFILE%\AppData\Local\Android\SDK

Android Studio-Systemdateien

Syntax: %LOCALAPPDATA%\Google\<product><version>

Beispiel: C:\Users\YourUserName\AppData\Local\Google\AndroidStudio4.1

Verzeichnisspeicherorte für Umgebungen anpassen, die über Gruppenrichtlinien gesteuert werden

Wenn durch eine Gruppenrichtlinie eingeschränkt wird, welche Verzeichnisse Sie vom Echtzeitscan auf Ihrem Computer ausschließen können, können Sie Ihre Android Studio-Verzeichnisse an einen der Speicherorte verschieben, die von der zentralen Gruppenrichtlinie bereits ausgeschlossen sind.

Die folgende Liste zeigt, wie Sie den Speicherort jedes Android Studio-Verzeichnisses anpassen können, wobei C:\WorkFolder das Verzeichnis ist, das Ihre Gruppenrichtlinien bereits ausgeschlossen haben:

Gradle-Cache
Definieren Sie die Umgebungsvariable GRADLE_USER_HOME, die auf C:\WorkFolder\.gradle verweist.
Android Studio-Projekte
Verschieben oder erstellen Sie Projektverzeichnisse in ein entsprechendes Unterverzeichnis von C:\WorkFolder. Beispiel: C:\WorkFolder\AndroidStudioProjects.
Android SDK

So passen Sie den Standort an:

  1. Öffnen Sie in Android Studio das Dialogfeld Einstellungen (unter macOS Einstellungen) und rufen Sie dann Darstellung und Verhalten > Systemeinstellungen > Android SDK auf.

  2. Ändern Sie den Wert für Android SDK Location (Android SDK-Standort) in C:\WorkFolder\AndroidSDK.

    Wenn Sie das SDK nicht noch einmal herunterladen möchten, kopieren Sie das vorhandene SDK-Verzeichnis, das sich standardmäßig unter %USERPROFILE%\AppData\Local\Android\SDK befindet, an den neuen Speicherort.

Android Studio-Systemdateien

So passen Sie den Standort an:

  1. Klicken Sie in Android Studio auf Help > Edit Custom Properties (Hilfe > Benutzerdefinierte Eigenschaften bearbeiten).

    Android Studio fordert Sie auf, eine idea.properties-Datei zu erstellen, falls Sie noch keine haben.

  2. Fügen Sie der Datei idea.properties die folgende Zeile hinzu:

    idea.system.path=c:/workfolder/studio/caches/trunk-system