Sie können das Verhalten von Android Studio und der Befehlszeilentools durch Festlegen von Umgebungsvariablen konfigurieren. Eine der nützlichsten Umgebungsvariablen, die festgelegt werden sollten, ist ANDROID_HOME
. Viele Tools lesen damit das Android SDK-Installationsverzeichnis.
Wenn Sie Tools über die Befehlszeile ausführen möchten, ohne den vollständigen Pfad zur ausführbaren Datei anzugeben, legen Sie für die Umgebungsvariable für den Befehlssuchpfad ANDROID_HOME/tools
, ANDROID_HOME/tools/bin
und ANDROID_HOME/platform-tools
fest.
Umgebungsvariablen festlegen
Die folgenden Beispiele zeigen, wie Umgebungsvariablen in einem Terminalfenster und in einem Shell-Skript für verschiedene Betriebssysteme festgelegt werden. Variableneinstellungen in Terminalfenstern gelten nur so lange, wie das Fenster geöffnet ist. Unter macOS und Linux werden bei jedem Start einer neuen Shell Variableneinstellungen in Shell-Initialisierungsskripts festgelegt. Unter Windows können Variableneinstellungen über die Systemeinstellungen festgelegt werden.
Windows: Geben Sie in einem Terminalfenster Folgendes ein:
set HTTP_PROXY=myserver:1981
Sie können ihn auch über die Windows-Benutzeroberfläche hinzufügen. Weitere Informationen dazu finden Sie in der Dokumentation zu Ihrer Windows-Version.
macOS und Linux:Die genaue Methode zum Festlegen von Umgebungsvariablen hängt von der verwendeten Shell ab. Geben Sie Folgendes ein, um zu ermitteln, welcher Shell-Typ ausgeführt wird:
echo $0
In Shells wie Gnu Bash oder Zsh werden Variablen mit der folgenden Syntax festgelegt:
export VARIABLE_NAME=<new-value>
In anderen Shells wie TCSH werden Variablen mit der folgenden Syntax festgelegt:
setenv VARIABLE_NAME <new-value>
Diese Befehle können dem Shell-Initialisierungsskript hinzugefügt werden, um die Variablen bei jeder Ausführung einer neuen Shell-Instanz festzulegen.
Der Speicherort des Shell-Initialisierungsskripts hängt von der verwendeten Shell ab.
Für Gnu Bash kann der Standort ~/.bash_profile
sein. Bei Zsh kann der Standort ~/.zprofile
sein. Für TCSH kann der Standort ~/.cshrc
sein. Weitere Informationen finden Sie in der Dokumentation der verwendeten Shell.
Sie können auch die Umgebungsvariable PATH
so aktualisieren, dass die Speicherorte für das Tool enthalten sind.
Für Gnu Bash oder Zsh:
export ANDROID_HOME ~/Library/Android/sdk export PATH $PATH:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/platform-tools
Und für TCSH:
setenv ANDROID_HOME ~/Library/Android/sdk setenv PATH $PATH\:$ANDROID_HOME/tools\:$ANDROID_HOME/tools/bin\:$ANDROID_HOME/platform-tools
Variablenreferenz
In der folgenden Tabelle werden häufig verwendete Umgebungsvariablen für die Android SDK-Tools beschrieben.
Android SDK-Umgebungsvariablen | |
---|---|
ANDROID_HOME |
Legt den Pfad zum SDK-Installationsverzeichnis fest. Einmal festgelegt, ändert sich der Wert in der Regel nicht und kann von mehreren Nutzern auf demselben Computer gemeinsam verwendet werden.
ANDROID_SDK_ROOT , das auch auf das SDK-Installationsverzeichnis verweist, wurde eingestellt. Wenn Sie es weiterhin verwenden, prüfen Android Studio und das Android-Gradle-Plug-in, ob die alten und neuen Variablen einheitlich sind.
|
ANDROID_USER_HOME |
Legt den Pfad zum Nutzereinstellungsverzeichnis für Tools fest, die Teil des Android SDK sind.
Die Standardeinstellung ist $HOME/.android/ .
Bei einigen älteren Tools wie Android Studio 4.3 und früheren Versionen wird |
REPO_OS_OVERRIDE
|
Setzen Sie diese Variable auf windows , macosx oder linux , wenn Sie sdkmanager verwenden, um Pakete für ein Betriebssystem herunterzuladen, das sich vom aktuellen Computer unterscheidet.
|
Umgebungsvariablen für die Android Studio-Konfiguration | |
Die Android Studio-Konfigurationsvariablen enthalten Einstellungen, mit denen der Speicherort der Konfigurationsdateien und des JDK angepasst wird. Beim Start prüft Android Studio diese Variablen auf Einstellungen. Weitere Informationen findest du unter Android Studio konfigurieren. | |
STUDIO_VM_OPTIONS
|
Legt den Speicherort der Datei studio.vmoptions fest.
Diese Datei enthält Einstellungen, die sich auf die Leistungsmerkmale der virtuellen Java HotSpot-Maschine auswirken. Sie können auch über Android Studio auf diese Datei zugreifen. Weitere Informationen finden Sie unter VM-Optionen anpassen.
|
STUDIO_PROPERTIES
|
Legt den Speicherort der Datei idea.properties fest. Mit dieser Datei können Sie Eigenschaften der Android Studio IDE anpassen, z. B. den Pfad zu den vom Nutzer installierten Plug-ins und die maximale Dateigröße, die von der IDE unterstützt wird. Weitere Informationen finden Sie unter IDE-Eigenschaften anpassen.
|
STUDIO_JDK
|
Legt den Speicherort des JDK fest, in dem Android Studio ausgeführt wird. Wenn Sie die IDE starten, werden die Umgebungsvariablen STUDIO_JDK , JDK_HOME und JAVA_HOME in dieser Reihenfolge geprüft.
|
STUDIO_GRADLE_JDK
|
Legt den Speicherort des JDK fest, mit dem Android Studio den Gradle-Daemon startet. Wenn Sie die IDE starten, wird zuerst STUDIO_GRADLE_JDK geprüft. Wenn STUDIO_GRADLE_JDK nicht definiert ist, verwendet die IDE den Wert, der in den Einstellungen für die Projektstruktur festgelegt ist.
|
Emulator-Umgebungsvariablen | |
Standardmäßig speichert der Emulator die Konfigurationsdateien unter $HOME/.android/ und die AVD-Daten unter $HOME/.android/avd/ . Sie können die Standardeinstellungen überschreiben, indem Sie die folgenden Umgebungsvariablen festlegen.
Mit dem Befehl emulator -avd <avd_name> wird das Verzeichnis avd in der Reihenfolge der Werte in $ANDROID_AVD_HOME , $ANDROID_USER_HOME/avd/ und $HOME/.android/avd/ durchsucht.
Geben Sie in der Befehlszeile |
|
ANDROID_EMULATOR_HOME
|
Legt den Pfad zum nutzerspezifischen Konfigurationsverzeichnis des Emulators fest. Die Standardeinstellung ist $ANDROID_USER_HOME .
Ältere Tools wie Android Studio 4.3 und frühere Versionen können |
ANDROID_AVD_HOME
|
Legt den Pfad zu dem Verzeichnis fest, das alle AVD-spezifischen Dateien enthält, die größtenteils aus sehr großen Laufwerk-Images bestehen. Der Standardspeicherort ist $ANDROID_EMULATOR_HOME/avd/ . Sie können einen neuen Speicherort angeben, wenn der Standardspeicherort wenig freien Speicherplatz hat.
|
Der Android Emulator fragt beim Start die folgenden Umgebungsvariablen ab: | |
ANDROID_LOG_TAGS
|
Weitere Informationen finden Sie unter ANDROID_LOG_TAGS .
|
HTTP_PROXY
|
Enthält die HTTP-/HTTPS-Proxy-Einstellung für einen globalen HTTP-Proxy. Verwendet ein Doppelpunkt-Trennzeichen (:) zwischen Host und Port. Beispiel: Dies entspricht der Angabe des Arguments
|
ANDROID_VERBOSE
|
Weitere Informationen finden Sie unter ANDROID_VERBOSE .
|
ANDROID_HOME
|
Weitere Informationen finden Sie unter ANDROID_HOME .
|
ANDROID_EMULATOR_USE_SYSTEM_LIBS
|
Enthält den Wert „0“ (Standardeinstellung) oder „1“. Ein Wert von „1“ bedeutet, dass die libstdc++.so -Datei des Systems anstelle der im Emulator gebündelten Datei verwendet wird.
Legen Sie diese Umgebungsvariable nur fest, wenn der Emulator aufgrund eines Problems mit der Systembibliothek nicht auf Ihrem Linux-System startet. Einige Linux Radeon GL-Treiberbibliotheken erfordern beispielsweise eine neuere libstdc++.so -Datei.
|
Quick Emulator (QEMU) für Audio | |
QEMU_AUDIO_DRV
QEMU_AUDIO_OUT_DRV
QEMU_AUDIO_IN_DRV
|
Unter Linux können Sie das Standard-Audio-Back-End des Emulators ändern, indem Sie die Umgebungsvariable QEMU_AUDIO_DRV auf einen der folgenden Werte setzen:
set QEMU_AUDIO_DRV=alsa
Sie können auch unterschiedliche Back-Ends für die Audioeingabe und -ausgabe verwenden. Wählen Sie dazu einen der QEMU-Werte für die Umgebungsvariablen set QEMU_AUDIO_OUT=esd set QEMU_AUDIO_IN=oss
Wenn Sie die Audiounterstützung deaktivieren möchten, verwenden Sie die Option
|
ADB-Umgebungsvariablen | |
ANDROID_SERIAL
|
Verwenden Sie diese Variable, um die Seriennummer eines Emulators, z. B. emulator-5555, für einen adb -Befehl anzugeben. Wenn Sie diese Variable festlegen, aber mit der Option -s eine Seriennummer über die Befehlszeile angeben, überschreibt die Befehlszeileneingabe den Wert in ANDROID_SERIAL .
Im folgenden Beispiel wird set ANDROID_SERIAL=emulator-555 adb install helloWorld.apk |
ADB-Logcat-Umgebungsvariablen | |
ANDROID_LOG_TAGS
|
Verwenden Sie diese Umgebungsvariable, um einen Standardfilterausdruck festzulegen, wenn Sie logcat auf Ihrem Entwicklungscomputer ausführen. Beispiel:
set
Dies entspricht der Angabe des Arguments Weitere Informationen und Beispiele finden Sie unter Logausgabe filtern. |
ADB_TRACE
|
Enthält eine durch Kommas getrennte Liste der zu protokollierenden Informationen zur Fehlerbehebung.
Mögliche Werte sind all , adb , sockets , packets , rwx , usb , sync , sysdeps , transport und jdwp .
Zum Anzeigen der set ADB_TRACE=all adb logcat |
ANDROID_VERBOSE
|
Enthält eine durch Kommas getrennte Liste ausführlicher Ausgabeoptionen (Debug-Tags), die vom Emulator verwendet werden. Im folgenden Beispiel sehen Sie ANDROID_VERBOSE , das mit den Fehlerbehebungs-Tags debug-socket und debug-radio definiert wurde:
set ANDROID_VERBOSE=socket,radio Dies entspricht der gemeinsamen Angabe der
Nicht unterstützte Tags zur Fehlerbehebung werden ignoriert. Weitere Informationen zu Tags zur Fehlerbehebung erhalten Sie mit |