Variabili di ambiente

Puoi configurare il comportamento di Android Studio e degli strumenti a riga di comando impostando variabili di ambiente. Una delle variabili di ambiente più utili da impostare è ANDROID_HOME, che molti strumenti leggono determinare la directory di installazione di Android SDK. Per eseguire gli strumenti dalla riga di comando senza includere il percorso completo dell'eseguibile, imposta il tuo comando la variabile di ambiente del percorso di ricerca da includere ANDROID_HOME/tools, ANDROID_HOME/tools/bin e ANDROID_HOME/platform-tools.

Come impostare le variabili di ambiente

I seguenti esempi mostrano come impostare le variabili di ambiente in una finestra del terminale uno script shell per diversi sistemi operativi. Le impostazioni variabili nelle finestre del terminale sono ultime solo se la finestra è aperta. Su macOS e Linux, ogni volta che viene avviata una nuova shell, la variabile impostazioni configurate nella shell script di inizializzazione. Su Windows, le impostazioni delle variabili possono essere definire attraverso le impostazioni di sistema.

Windows:in una finestra del terminale, digita quanto segue: 

set HTTP_PROXY=myserver:1981

In alternativa, aggiungilo tramite l'interfaccia utente di Windows. Controlla la documentazione per la tua versione di Windows per scoprire come.

macOS e Linux: il metodo preciso per impostare le variabili di ambiente dipende da della shell in uso. Per determinare quale tipo di shell è in esecuzione, digita quanto segue: 

echo $0

Nelle shell come Gnu Bash o Zsh, le variabili vengono impostate utilizzando quanto segue: sintassi: 

export VARIABLE_NAME=<new-value>

In altre shell, come TCSH, le variabili vengono impostate utilizzando la seguente sintassi: 

setenv VARIABLE_NAME <new-value>

Questi comandi possono essere aggiunti allo script di inizializzazione della shell per impostare le variabili ogni volta che viene eseguita una nuova istanza di shell.

La posizione dello script di inizializzazione della shell dipende dalla shell utilizzata. Per Gnu Bash, la località può essere ~/.bash_profile. Per Zsh, la posizione può essere ~/.zprofile. Per il TCSH, la località può essere ~/.cshrc. Controllo e la documentazione relativa alla shell che stai utilizzando.

Puoi anche aggiornare la variabile di ambiente PATH in modo da includere le posizioni dello strumento.

Per Gnu Bash o Zsh: 

export ANDROID_HOME=~/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/platform-tools

Per il TCSH: 

setenv ANDROID_HOME ~/Library/Android/sdk
setenv PATH $PATH\:$ANDROID_HOME/tools\:$ANDROID_HOME/tools/bin\:$ANDROID_HOME/platform-tools

Riferimento per le variabili

La seguente tabella descrive le variabili di ambiente di uso comune per gli strumenti dell'SDK Android.

Tabella 1. Variabili di ambiente

Variabili di ambiente SDK Android
ANDROID_HOME Imposta il percorso della directory di installazione dell'SDK. Una volta impostato, il valore in genere non cambia e può essere condiviso da più utenti sullo stesso computer. ANDROID_SDK_ROOT, che rimanda anche alla directory di installazione dell'SDK, è deprecato. Se continui a utilizzarlo, Android Studio e il plug-in Android Gradle verifica che la vecchia e la nuova variabile siano coerenti.
ANDROID_USER_HOME Imposta il percorso della directory delle preferenze utente per gli strumenti che fanno parte dell'SDK Android. Il valore predefinito è $HOME/.android/.

Alcuni strumenti obsoleti, come Android Studio 4.3 e versioni precedenti, non leggono ANDROID_USER_HOME. Per sostituire la posizione preferita dell'utente per gli strumenti meno recenti, imposta ANDROID_SDK_HOME alla directory padre di cui vuoi che directory .android in cui creare.

REPO_OS_OVERRIDE Imposta questa variabile su windows, macosx o linux quando utilizzi sdkmanager per scaricare pacchetti per un sistema operativo diverso dal computer attuale.
Variabili di ambiente di configurazione di Android Studio
Le variabili di configurazione di Android Studio contengono impostazioni che personalizzano la posizione di configurazione e JDK. All'avvio, Android Studio controlla queste variabili per le impostazioni. Per ulteriori informazioni, vedi Configura Android Studio.
STUDIO_VM_OPTIONS Imposta la posizione del file studio.vmoptions. Questo file contiene le impostazioni che influiscono sulle caratteristiche prestazionali dell'hotSpot Java una macchina virtuale. È possibile accedere al file anche da Android Studio. Consulta Personalizzare le opzioni della VM.
STUDIO_PROPERTIES Imposta la posizione dell'evento idea.properties . Questo file ti consente di personalizzare le proprietà IDE di Android Studio, come il percorso i plug-in installati dall'utente e le dimensioni massime dei file supportate dall'IDE. Consulta Personalizza le proprietà IDE.
STUDIO_JDK Imposta la posizione del JDK in cui viene eseguito Android Studio. Quando avvii l'IDE, controlla STUDIO_JDK, JDK_HOME e JAVA_HOME variabili di ambiente, in quest'ordine.
STUDIO_GRADLE_JDK Imposta la posizione del JDK che Android Studio utilizza per avviare il daemon Gradle. Quando avvia l'IDE, verifica innanzitutto STUDIO_GRADLE_JDK. Se STUDIO_GRADLE_JDK non è definito, l'IDE utilizza il valore impostato in le impostazioni della struttura del progetto.
Variabili di ambiente dell'emulatore
Per impostazione predefinita, l'emulatore archivia i file di configurazione $HOME/.android/ e dati sulla durata di visualizzazione media in $HOME/.android/avd/. Puoi sostituisci i valori predefiniti impostando le seguenti variabili di ambiente. Il comando emulator -avd <avd_name> cerca avd nell'ordine dei valori in $ANDROID_AVD_HOME, $ANDROID_USER_HOME/avd/ e $HOME/.android/avd/.

Per la guida per la variabile di ambiente dell'emulatore, digita emulator -help-environment nella riga di comando. Per informazioni su emulator opzioni della riga di comando, vedi Avvia l'emulatore dalla riga di comando.

ANDROID_EMULATOR_HOME Imposta il percorso della configurazione dell'emulatore specifico per l'utente . Il valore predefinito è $ANDROID_USER_HOME.

Gli strumenti meno recenti, come Android Studio 4.3 e versioni precedenti, non leggono ANDROID_USER_HOME. Per questi strumenti, il valore predefinito è $ANDROID_SDK_HOME/.android.

ANDROID_AVD_HOME Imposta il percorso della directory che contiene tutte le durate specifiche della durata di visualizzazione media formati principalmente da immagini disco di grandi dimensioni. La località predefinita è $ANDROID_EMULATOR_HOME/avd/. Ti consigliamo di specificare una nuova località La posizione predefinita è in esaurimento dello spazio su disco.
L'emulatore Android esegue query sulle seguenti variabili di ambiente all'avvio:
ANDROID_LOG_TAGS Vedi ANDROID_LOG_TAGS.
HTTP_PROXY

Contiene il proxy HTTP/HTTPS per un proxy HTTP globale. Utilizza i due punti (:) separatori tra l'host e la porta. Per ad esempio set HTTP_PROXY=myserver:1981.

Equivale a specificare il parametro -http-proxy proxy durante l'esecuzione dell'emulatore dalla riga di comando.

ANDROID_VERBOSE Vedi ANDROID_VERBOSE.
ANDROID_HOME Vedi ANDROID_HOME.
ANDROID_EMULATOR_USE_SYSTEM_LIBS Contiene un valore pari a 0 (valore predefinito) o 1. Il valore 1 indica che Viene utilizzato il file libstdc++.so al posto di quello fornito in bundle con l'emulatore. Imposta questa variabile di ambiente solo quando l'emulatore non viene avviato sul tuo sistema Linux a causa di un problema con la libreria di sistema. Ad esempio, alcune librerie di driver Linux Radeon GL richiede un file libstdc++.so più recente.
Audio emulatore rapido (QEMU)
QEMU_AUDIO_DRV QEMU_AUDIO_OUT_DRV QEMU_AUDIO_IN_DRV Su Linux, puoi modificare l'audio predefinito backend dell'emulatore impostando la variabile di ambiente QEMU_AUDIO_DRV con uno dei seguenti valori:
  • alsa: utilizza il backend ALSA (Advanced Linux Sound Architecture)
  • esd: usa il backend Enlightened Sound Daemon (EsounD)
  • sdl: usa il backend audio Simple DirectMedia Layer (SDL) (nessun input audio). supportati)
  • oss:: usa il backend Open Sound System (OSS)
  • none:: l'audio non è supportato
set QEMU_AUDIO_DRV=alsa

Puoi anche utilizzare backend distinti per l'input audio e gli output audio selezionando uno dei Valori QEMU per QEMU_AUDIO_OUT_DRV e QEMU_AUDIO_IN_DRV variabili di ambiente: 

set QEMU_AUDIO_OUT=esd
set QEMU_AUDIO_IN=oss

Se vuoi disattivare il supporto audio, usa l'opzione emulator -no-audio oppure imposta QEMU_AUDIO_DRV su none. Potrebbe essere necessario disattivare l'audio nelle seguenti situazioni:

  • In rari casi, i driver audio possono causare il riavvio di Windows mentre l'emulatore è in esecuzione.
  • Su alcuni computer Linux, l'emulatore potrebbe bloccarsi all'avvio con il supporto audio abilitato.
variabili di ambiente adb
ANDROID_SERIAL Utilizza questa variabile per fornire un numero di serie dell'emulatore, ad esempio come emulatore-5555, a un comando adb. Se imposti questa variabile, ma utilizzi -s per specificare un numero di serie dalla riga di comando, l'input della riga di comando sostituisce il valore in ANDROID_SERIAL.

L'esempio seguente imposta ANDROID_SERIAL e chiamate adb install helloworld.apk, che installa quindi l'applicazione per Android. sull'emulatore-5555. 

set ANDROID_SERIAL=emulator-555
adb install helloWorld.apk
variabili di ambiente adb logcat
ANDROID_LOG_TAGS Utilizza questa variabile di ambiente per impostare un filtro predefinito quando esegui logcat dal computer di sviluppo. Ad esempio: 
set ANDROID_LOG_TAGS=ActivityManager:I MyApp:D *:.

Equivale a specificare il parametro -logcat tags durante l'esecuzione dell'emulatore dalla riga di comando.

Vedi Filtrare l'output del log per ulteriori informazioni ed esempi.

ADB_TRACE Contiene un elenco separato da virgole delle informazioni di debug da registrare. I valori possono essere i seguenti: all, adb, sockets, packets, rwx, usb, sync, sysdeps, transport e jdwp.

Per visualizzare i log adb per i client adb e il server adb, imposta ADB_TRACE a all, quindi chiama il comando adb logcat come segue: 

set ADB_TRACE=all
adb logcat
ANDROID_VERBOSE Contiene un elenco separato da virgole di opzioni di output dettagliate (tag di debug) utilizzati dall'emulatore. L'esempio seguente mostra ANDROID_VERBOSE definita con i tag di debug debug-socket e debug-radio: 
set ANDROID_VERBOSE=socket,radio

Equivale a specificare il valore -verbose -verbose-socket -verbose-radio durante l'esecuzione dell'emulatore dalla riga di comando.

I tag di debug non supportati vengono ignorati. Per ulteriori informazioni informazioni sui tag di debug, utilizza emulator -help-debug-tags.