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 wird Folgendes beschrieben: zusätzliche Konfigurationseinstellungen, um die Nutzung anzupassen von Android Studio

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

  • studio.vmoptions: Optionen für Android Studio anpassen Java Virtual Machine (JVM), z. B. Heap- und Cache-Größe. Beachten Sie, dass bei Linux-Maschinen hat diese Datei möglicherweise den Namen studio64.vmoptions, je nachdem, Version von Android Studio.
  • 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 suchen

Beide Konfigurationsdateien werden im Konfigurationsverzeichnis für Android gespeichert. Studio 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

Mit der Datei studio.vmoptions kannst du Optionen für die JVM 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.

Wenn Sie eine neue studio.vmoptions-Datei erstellen oder eine vorhandene öffnen möchten, folgen Sie diese Schritte:

  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 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 Seite mit Java HotSpot-VM-Optionen von Oracle.

Die von Ihnen erstellte studio.vmoptions-Datei wird der Standardeinstellung hinzugefügt Die Datei studio.vmoptions, die sich auf Ihrem Android-Gerät im Verzeichnis bin/ befindet Studio-Installationsordner.

Bearbeiten Sie die Datei studio.vmoptions im Programmordner von Android Studio nicht direkt. Sie können zwar auf die Datei zugreifen, Standard-VM-Optionen von Android Studio ansehen und nur Ihre eigenen bearbeiten Mit der studio.vmoptions-Datei werden wichtige Standardeinstellungen nicht überschrieben Einstellungen für Android Studio. Ü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 oder Ihr System verfügt über viel RAM, können Sie die Leistung indem Sie die maximale Heap-Größe für Android Studio-Prozesse erhöhen, z. B. Core IDE, Gradle-Daemon und Kotlin-Daemon.

Android Studio prüft automatisch mögliche Heap-Größenoptimierungen und werden Sie benachrichtigt, 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 über empfohlenen Arbeitsspeichereinstellungen.

Wenn Sie ein 64-Bit-System mit mindestens 5 GB RAM verwenden, können Sie manuell die Heap-Größen für Ihr Projekt festlegen. 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 bei IntelliJ IDEA.

IDE-Properties 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.

Wenn Sie eine neue idea.properties-Datei erstellen oder eine vorhandene Datei öffnen möchten, folgen Sie diese Schritte:

  1. Klicke 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. Bearbeiten um Ihre benutzerdefinierten IDE-Eigenschaften hinzuzufügen.

Die folgende idea.properties-Datei enthält eine häufig angepasste IDE Eigenschaften. Eine vollständige Liste der Properties finden Sie in den 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 Maschinen mit wenig Arbeitsspeicher konfigurieren

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

  • Reduzieren Sie die maximale Heap-Größe, die für Android Studio verfügbar ist: Reduzieren Sie die Maximale Heap-Größe für Android Studio auf 512 MB. Weitere Informationen zum Ändern Informationen zur 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 zur Aktualisierung von Gradle und des Android-Gradle-Plug-ins Versionshinweise 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 (Build, Ausführung, Bereitstellung) und klicken Sie 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 im Hintergrund ausführen können. eine Firewall oder ein sicheres Netzwerk. So legen Sie die HTTP-Proxy-Einstellungen in Android Studio fest:

  1. Klicken Sie in der Menüleiste auf Datei > Einstellungen (unter macOS klicken Sie 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 automatische Proxy-Konfiguration zu verwenden. URL für die Proxy-Einstellungen oder Manuelle Proxy-Konfiguration, um die einzelnen Proxy-Einstellungen einzugeben die Einstellungen selbst vornehmen. 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.

Für anwendungsspezifische HTTP-Proxy-Einstellungen legen Sie die Proxy-Einstellungen in der build.gradle, wie für jedes Anwendungsmodul erforderlich:

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.

Android Studio-Leistung 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, 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, wodurch Builds deutlich langsamer laufen. Wenn Sie einen Build in Android ausführen Studio kompiliert Gradle die Ressourcen und den Quellcode Ihrer App und packt dann die kompilierten Ressourcen in einem APK oder AAB zusammen. Dabei werden viele Dateien auf Ihrem Computer erstellt. Wenn Ihre Antivirensoftware Echtzeit-Updates enthält, Scans aktiviert ist, kann die Antivirensoftware das Anhalten des Build-Prozesses erzwingen jedes Mal, wenn eine Datei erstellt wird, während diese Datei gescannt wird.

Um dieses Problem zu vermeiden, können Sie bestimmte Verzeichnisse aus Echtzeit ausschließen. das Scannen in Ihrer Antivirensoftware. Für Windows: Build Analyzer kann Ihnen helfen, die Verzeichnisse, die vom aktiven Scan ausgeschlossen werden sollen, und schließen diese aus.

In der folgenden Liste sehen Sie den Standardspeicherort jedes Android Studio-Verzeichnisses die 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 anpassen, die über Gruppenrichtlinien gesteuert werden

Wenn durch eine Gruppenrichtlinie eingeschränkt wird, welche Verzeichnisse Sie von Echtzeit ausschließen können können Sie Ihre Android Studio-Verzeichnisse einen der Standorte, die von der zentralen Gruppenrichtlinie bereits 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
Die Umgebungsvariable GRADLE_USER_HOME definieren, auf die verwiesen werden soll C:\WorkFolder\.gradle
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