Android Studio konfigurieren

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

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

  • studio.vmoptions: Hier können Sie Optionen für die Java Virtual Machine (JVM) von Android Studio anpassen, z. B. die Heap- und Cache-Größe. Auf Linux-Computern kann diese Datei je nach Android Studio-Version den Namen studio64.vmoptions haben.
  • idea.properties: Hier können Sie Android Studio-Eigenschaften anpassen, z. B. den Pfad zum Plug-in-Ordner oder die maximal unterstützte Dateigröße.

Spezifische Dokumentationen zur Einrichtung und Verwendung von Emulatoren und Geräten finden Sie unter den folgenden Themen:

Konfigurationsdateien finden

Beide Konfigurationsdateien werden im Konfigurationsverzeichnis für Android Studio gespeichert. Informationen zum 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 Speicherort der .vmoptions-Datei fest.
  • STUDIO_PROPERTIES: Legen Sie den Namen und Speicherort der .properties-Datei fest.

Sie können konfigurieren, welche JDKs verwendet werden. Weitere Informationen finden Sie unter Java-Versionen in Android-Builds.

VM-Optionen anpassen

In 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 andere Standardeinstellungen wie die anfängliche Heap-Größe, die Cache-Größe und die Java-Garbage-Collection-Schalter über die Datei studio.vmoptions überschreiben.

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

  1. Klicken Sie auf 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 zu erstellen.
  2. Die Datei studio.vmoptions wird im Editorfenster von Android Studio geöffnet. Bearbeiten Sie die Datei, um Ihre benutzerdefinierten VM-Optionen hinzuzufügen. Eine vollständige Liste der anpassbaren JVM-Optionen finden Sie auf der Seite mit Java HotSpot-VM-Optionen von Oracle.

Die von Ihnen erstellte studio.vmoptions-Datei wird der Standarddatei studio.vmoptions im Verzeichnis bin/ im Installationsordner von Android Studio hinzugefügt.

Bearbeiten Sie die Datei studio.vmoptions im Programmordner von Android Studio nicht direkt. Sie können auf die Datei zugreifen, um die Standard-VM-Optionen von Android Studio aufzurufen. Wenn Sie jedoch nur Ihre eigene studio.vmoptions-Datei bearbeiten, werden keine wichtigen Standardeinstellungen für Android Studio überschrieben. Überschreiben Sie daher in Ihrer studio.vmoptions-Datei nur die Attribute, die für Sie wichtig sind, und lassen Sie Android Studio weiterhin Standardwerte für alle Attribute verwenden, die Sie nicht geändert haben.

Maximale Heap-Größe

Standardmäßig hat Android Studio eine maximale Heap-Größe von 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 IDE-Kernkomponente, den Gradle-Daemon und den Kotlin-Daemon erhöhen.

Android Studio prüft automatisch auf mögliche Optimierungen der Heap-Größe und benachrichtigt Sie, wenn die Leistung verbessert werden kann.

Speichereinstellungen, mit denen Sie den maximalen RAM für Android Studio-Prozesse konfigurieren können

Abbildung 1. Eine Benachrichtigung zu empfohlenen Speichereinstellungen.

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. Führen Sie dazu die folgenden Schritte aus:

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

    Speichereinstellungen, mit denen Sie den maximalen RAM für Android Studio-Prozesse konfigurieren können

    Abbildung 2. Konfigurieren Sie die maximale RAM-Menge in den Speichereinstellungen.

  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, bevor 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. Sie können die JAR-Datei dann in Ihre anderen Projekte importieren und/oder für Ihre Kollegen freigeben, damit sie sie in ihre Projekte importieren können.

Weitere Informationen finden Sie unter IDE-Einstellungen teilen in IntelliJ IDEA.

IDE-Eigenschaften anpassen

Mit der Datei idea.properties können Sie die IDE-Eigenschaften für Android Studio anpassen, z. B. den Pfad zu von Nutzern installierten Plug-ins und die von der IDE unterstützte maximale Dateigröße. Die idea.properties-Datei wird mit den Standardeigenschaften der IDE zusammengeführt. Sie können also nur die Überschreibungseigenschaften angeben.

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

  1. Klicken Sie auf Hilfe > Benutzerdefinierte Properties 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. Bearbeiten Sie die Datei, um Ihre benutzerdefinierten IDE-Eigenschaften hinzuzufügen.

Die folgende idea.properties-Datei enthält häufig angepasste IDE-Eigenschaften. Eine vollständige Liste der Properties finden Sie im Hilfeartikel zur idea.properties-Datei 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 Computer 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 so anpassen, dass die Leistung auf Ihrem Computer verbessert wird:

  • Maximale Heap-Größe für Android Studio reduzieren:Reduzieren Sie 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 Gradle und das Android Gradle-Plug-in auf die neuesten Versionen, um die neuesten Leistungsverbesserungen zu nutzen. Weitere Informationen zum Aktualisieren von Gradle und dem Android-Gradle-Plug-in finden Sie in den Versionshinweisen zum Android-Gradle-Plug-in.
  • Energiesparmodus aktivieren:Wenn Sie den Energiesparmodus aktivieren, werden eine Reihe von speicher- und akkuintensiven Hintergrundvorgängen deaktiviert, darunter Fehlerhervorhebung und On-the-fly-Prüfungen, automatisches Pop-up-Fenster für den Code-Abschluss und automatische inkrementelle Hintergrundkompilierung. Wenn Sie den Energiesparmodus aktivieren möchten, klicken Sie auf Datei > Energiesparmodus.
  • Unnötige Lint-Prüfungen deaktivieren:Wenn Sie ändern möchten, welche Lint-Prüfungen Android Studio auf Ihrem Code ausführt, gehen Sie so vor:

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

  • Nur erforderliche Google Play-Dienste als Abhängigkeiten angeben:Fügen Sie Ihrem Projekt nur die erforderlichen Google Play-Dienste als Abhängigkeiten hinzu. Abhängigkeiten erhöhen den benötigten Arbeitsspeicher. Durch deren Begrenzung wird die Arbeitsspeichernutzung und Leistung verbessert. Weitere Informationen finden Sie unter Abhängigkeiten für Google Play-Dienste angeben.

  • Maximale Heap-Größe für Gradle reduzieren:Reduzieren Sie den Wert der maximalen Heap-Größe von Gradle von 1.536 MB auf den Standardwert, indem Sie die Eigenschaft org.gradle.jvmargs in der Datei gradle.properties überschreiben. Gehen Sie dazu so vor:

    # 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. Lassen Sie diese Funktion jedoch deaktiviert, wenn Sie ein System mit wenig Arbeitsspeicher haben. 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 (Erstellen, Ausführen, Bereitstellen) und klicken Sie dann auf Compiler.
    3. Die Option Unabhängige Module parallel kompilieren darf nicht aktiviert sein.
    4. Wenn Sie eine Änderung vorgenommen haben, klicken Sie auf Übernehmen oder OK, damit sie wirksam wird.

Proxy-Einstellungen festlegen

Proxys dienen als Verbindungspunkte zwischen HTTP-Clients und Webservern, die Internetverbindungen sicherer und datenschutzfreundlicher machen.

Wenn Sie Android Studio hinter einer Firewall ausführen möchten, können Sie die HTTP-Proxy-Einstellungen auf der Seite „HTTP-Proxy-Einstellungen“ der Android Studio IDE festlegen.

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, müssen Sie die Proxy-Einstellungen in der Gradle-Build-Datei festlegen.

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 Seite „HTTP-Proxy“ wird angezeigt.
  3. Wählen Sie Proxy-Einstellungen automatisch erkennen aus, um eine URL für die automatische Proxykonfiguration für die Proxy-Einstellungen zu verwenden, oder Manuelle Proxykonfiguration, um alle Einstellungen selbst einzugeben. Eine ausführliche Erklärung 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 Proxy-Einstellungen für das Android Gradle-Plug-in in der Gradle-Builddatei fest.

Legen Sie für anwendungsspezifische HTTP-Proxy-Einstellungen die Proxy-Einstellungen in der Datei build.gradle 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
    }
    ...
}

Projektweite HTTP-Proxy-Einstellungen werden in der Datei gradle/gradle.properties festgelegt:

# 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-Eigenschaften für Proxy-Einstellungen finden Sie im Gradle-Nutzerhandbuch.

Leistung von Android Studio unter Windows optimieren

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

Auswirkungen von Antivirensoftware auf die Buildgeschwindigkeit minimieren

Einige Antivirenprogramme können den Android Studio-Build-Prozess beeinträchtigen und dazu führen, dass Builds deutlich 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. Dabei werden viele Dateien auf Ihrem Computer erstellt. Wenn in Ihrer Antivirensoftware der Echtzeit-Scan aktiviert ist, kann die Antivirensoftware den Build-Vorgang jedes Mal beenden, wenn eine Datei erstellt wird, während sie gescannt wird.

Sie können dieses Problem vermeiden, indem Sie bestimmte Verzeichnisse in Ihrer Antivirensoftware vom Echtzeit-Scan ausschließen. Unter Windows können Sie mit dem Build Analyzer die Verzeichnisse ermitteln, die vom aktiven Scannen ausgeschlossen werden sollen, und sie ausschließen.

In der folgenden Liste ist der Standardspeicherort jedes Android Studio-Ordners aufgeführt, den Sie vom Echtzeit-Scan 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 mit Gruppenrichtlinien anpassen

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

In der folgenden Liste wird beschrieben, wie Sie den Speicherort jedes Android Studio-Ordners anpassen. Dabei steht C:\WorkFolder für das Verzeichnis, das bereits von Ihrer Gruppenrichtlinie ausgeschlossen ist:

Gradle-Cache
Definieren Sie die Umgebungsvariable GRADLE_USER_HOME so, dass sie auf C:\WorkFolder\.gradle verweist.
Android Studio-Projekte
Verschieben oder erstellen Sie Projektverzeichnisse in einem geeigneten 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 (Preferences unter macOS) und gehen Sie zu Darstellung und Verhalten > Systemeinstellungen > Android SDK.

  2. Ändern Sie den Wert von Android SDK-Speicherort in C:\WorkFolder\AndroidSDK.

    Um das SDK nicht noch einmal herunterladen zu müssen, 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 Hilfe > Benutzerdefinierte Properties 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