Android Studio konfigurieren

Android Studio bietet Assistenten und Vorlagen, mit denen Sie Ihre Systemanforderungen überprüfen, z. B. das Java Development Kit (JDK) und den verfügbaren RAM, und Standardeinstellungen konfigurieren, z. B. eine optimierte Standardemulation für Android Virtual Device (AVD) und aktualisierte System-Images. In diesem Dokument werden zusätzliche Konfigurationseinstellungen beschrieben, mit denen du die Nutzung von Android Studio individuell anpassen kannst.

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

• studio.vmoptions: Passen Sie Optionen für die Java Virtual Machine (JVM) von Android Studio an, z. B. die Heap-Größe und die Cache-Größe. Hinweis: Auf Linux-Computern kann diese Datei je nach Version von Android Studio den Namen studio64.vmoptions haben.
• idea.properties: Passe Android Studio-Eigenschaften an, z. B. den Ordnerpfad der Plug-ins oder die maximal unterstützte Dateigröße.

Weitere Informationen zum Einrichten und Verwenden von Emulatoren und Geräten finden Sie in den folgenden Themen:

• Virtuelle Geräte erstellen und verwalten
• Apps auf einem Hardwaregerät ausführen
• OEM-USB-Treiber installieren

Konfigurationsdateien finden

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

Hinweis: Um das Konfigurationsverzeichnis schnell zu finden, gehen Sie in Android Studio zu Help > Edit Custom VM Options (Hilfe > Benutzerdefinierte VM-Optionen bearbeiten) oder Help > Edit Custom Properties (Benutzerdefinierte Eigenschaften bearbeiten). Dadurch wird eine Konfigurationsdatei geöffnet. Sehen Sie sich den Pfad der Konfigurationsdatei an und finden Sie das Konfigurationsverzeichnis.

Sie können die folgenden Umgebungsvariablen verwenden, um auf bestimmte Überschreibungsdateien an anderer Stelle zu 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.

Auf der Seite 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. Die gängigste Option zur Anpassung ist die maximale Heap-Größe, um die Leistung von Android Studio zu verbessern. Sie können jedoch auch die Datei studio.vmoptions verwenden, um andere Standardeinstellungen wie die anfängliche Heap-Größe, Cache-Größe und Java-automatische Speicherbereinigungs-Switches zu überschreiben.

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

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. Fügen Sie der Datei die benutzerdefinierten VM-Optionen hinzu. Eine vollständige Liste der anpassbaren JVM-Optionen finden Sie auf der Oracle-Seite Java HotSpot-VM-Optionen.

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

Bearbeiten Sie die Datei studio.vmoptions im Programmordner von Android Studio nicht direkt. Sie können auf die Datei zugreifen, um sich die Standard-VM-Optionen von Android Studio anzusehen. Wenn Sie jedoch nur Ihre eigene studio.vmoptions-Datei bearbeiten, können Sie wichtige Standardeinstellungen für Android Studio nicht überschreiben. Ü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 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 Core IDE, den Gradle-Daemon und den Kotlin-Daemon erhöhen.

Android Studio prüft automatisch auf mögliche Heap-Größenoptimierungen und benachrichtigt Sie, wenn es erkennt, dass die Leistung verbessert werden kann.

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 Datei > Einstellungen (Android Studio > Einstellungen unter macOS).

2. Klicken Sie auf Darstellung und Verhalten > Systemeinstellungen > Arbeitsspeichereinstellungen.

   

   Abbildung 2: Konfigurieren Sie die maximale RAM-Kapazität 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 Arbeitsspeichereinstellungen angewendet werden.

Hinweis :Wenn zu viel Arbeitsspeicher zugewiesen wird, kann dies die Leistung beeinträchtigen.

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 Ihren Kollegen zum Importieren in ihre Projekte zur Verfügung stellen.

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 vom Nutzer installierten Plug-ins und die maximale Dateigröße, die von der IDE unterstützt wird. Die Datei idea.properties wird mit den Standardeigenschaften für die IDE zusammengeführt, sodass Sie nur die Überschreibungseigenschaften 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 du die IDE-Eigenschaften noch nie zuvor bearbeitet hast, wirst du 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 der Datei Ihre benutzerdefinierten IDE-Eigenschaften hinzu.

Die folgende Datei idea.properties enthält häufig angepasste 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 ausführen, dessen Spezifikationen nicht den empfohlenen Spezifikationen entsprechen (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 von den neuesten Leistungsverbesserungen zu profitieren. Weitere Informationen zum Aktualisieren von Gradle und des Android-Gradle-Plug-ins finden Sie in den Versionshinweisen zum Android-Gradle-Plug-in.
• Energiesparmodus aktivieren:Durch Aktivieren des Energiesparmodus werden verschiedene speicher- und akkuintensive Hintergrundvorgänge deaktiviert, darunter Fehlerhervorhebung und spontane Inspektionen, automatische Pop-up-Codevervollständigung und automatische inkrementelle Hintergrundkompilierung. Klicken Sie auf Datei > Energiesparmodus, um den Energiesparmodus zu aktivieren.

• Nicht erforderliche 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 Bereich Editor und klicken Sie auf Prüfungen.
  3. Klicken Sie die Kästchen an, um die für Ihr Projekt geeigneten Lint-Prüfungen 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. Beim Debugging mit einem Emulator wird mehr Arbeitsspeicher benötigt als beim Debugging auf einem physischen Gerät.

• Nur erforderliche Google Play-Dienste als Abhängigkeiten einschließen:Nehmen Sie nur erforderliche Google Play-Dienste als Abhängigkeiten in Ihr Projekt auf. Abhängigkeiten erhöhen den erforderlichen Arbeitsspeicher und verbessern so die Arbeitsspeichernutzung und die Leistung. Weitere Informationen finden Sie unter Abhängigkeiten für Google Play-Dienste deklarieren.

• Maximale Heap-Größe für Gradle reduzieren:Reduzieren Sie den Wert der maximalen Heap-Größe von Gradle von der Standardeinstellung von 1.536 MB. Überschreiben Sie dazu das Attribut org.gradle.jvmargs in der Datei gradle.properties wie hier gezeigt:

  # 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 überprü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 Zwischenverbindungspunkte zwischen HTTP-Clients und Webservern und erhöhen die Sicherheit und den Datenschutz für Internetverbindungen.

Wenn Sie Android Studio hinter einer Firewall ausführen möchten, legen Sie die HTTP-Proxy-Einstellungen auf der Seite mit den IDE-HTTP-Proxy-Einstellungen von Android Studio fest.

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

Hinweis :Nach der Erstinstallation des Android Studio-Bundles kann Android Studio mit Internet oder offline ausgeführt werden. Android Studio benötigt jedoch eine Internetverbindung für die Synchronisierung des Einrichtungsassistenten, den Zugriff auf die Bibliothek von Drittanbietern, den Zugriff auf Remote-Repositories, die Gradle-Initialisierung und -Synchronisierung sowie die Android Studio-Versionsupdates.

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. Klicke in der Menüleiste auf Datei > Einstellungen (unter macOS klicke 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 Proxyeinstellungen automatisch erkennen aus, wenn Sie eine URL für die automatische Proxykonfiguration verwenden möchten, oder wählen Sie Manuelle Proxykonfiguration aus, um jede Einstellung selbst einzugeben. 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 Proxy-Einstellungen 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 die Proxyeinstellungen finden Sie im Gradle-Nutzerhandbuch.

Hinweis: Wenn Sie Android Studio verwenden, überschreiben die Einstellungen auf der HTTP-Proxy-Einstellungsseite der Android Studio-ID die HTTP-Proxy-Einstellungen in der Datei gradle.properties.

Leistung von Android Studio unter Windows optimieren

Die Leistung von Android Studio unter Windows kann von verschiedenen 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 Build-Prozess von Android Studio 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. Während dieses Vorgangs werden viele Dateien auf Ihrem Computer erstellt. Wenn in Ihrer Antivirensoftware das Scannen in Echtzeit aktiviert ist, kann die Antivirensoftware erzwingen, dass der Build-Prozess jedes Mal angehalten wird, wenn eine Datei erstellt wird, während sie diese Datei scannt.

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.

Achtung :Damit Ihr Computer vor schädlicher Software geschützt ist, sollten Sie das Echtzeitscannen oder Ihre Antivirensoftware nicht vollständig deaktivieren.

In der folgenden Liste sehen Sie 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 von Gruppenrichtlinien kontrollierte Umgebungen anpassen

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

In der folgenden Liste sehen Sie, wie Sie den Speicherort jedes Android Studio-Verzeichnisses anpassen können, wobei C:\WorkFolder das Verzeichnis ist, das von Ihrer Gruppenrichtlinie bereits 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 ein geeignetes 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 (Einstellungen unter macOS) und gehen Sie dann zu Darstellung und Verhalten > Systemeinstellungen > Android SDK.

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

   Damit das SDK nicht noch einmal heruntergeladen wird, 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 Eigenschaften bearbeiten.

   Android Studio fordert dich auf, eine idea.properties-Datei zu erstellen, falls du noch keine hast.

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

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