Puedes configurar el comportamiento de Android Studio y las herramientas de línea de comandos configurando variables de entorno. Una de las variables de entorno más útiles para configurar es ANDROID_HOME
, que muchas herramientas leen para determinar el directorio de instalación del SDK de Android.
A fin de ejecutar herramientas desde la línea de comandos sin incluir la ruta de acceso completa al ejecutable, configura la variable de entorno de la ruta de búsqueda de comandos de modo que incluya ANDROID_HOME/tools
, ANDROID_HOME/tools/bin
y ANDROID_HOME/platform-tools
.
Cómo configurar variables de entorno
En los siguientes ejemplos, se muestra cómo configurar variables de entorno en una ventana de terminal y en una secuencia de comandos de shell para diferentes sistemas operativos. La configuración de la variable en las ventanas de terminal se mantiene mientras la ventana está abierta. En macOS y Linux, cada vez que se inicia una shell nueva, se establece la configuración de la variable en las secuencias de comandos de inicialización de la shell. En Windows, la configuración de las variables se puede establecer mediante la configuración del sistema.
Windows: En una ventana de terminal, escribe lo siguiente:
set HTTP_PROXY=myserver:1981
De manera alternativa, agrégalo a la IU de Windows. Consulta la documentación de tu versión de Windows para descubrir cómo hacerlo.
macOS y Linux: El método preciso de configuración de variables del entorno depende de la shell que uses. Para determinar qué tipo de shell se está ejecutando, escribe lo siguiente:
echo $0
En shells como Gnu Bash o Zsh, las variables se configuran con la siguiente sintaxis:
export VARIABLE_NAME=<new-value>
En otras shells, como TCSH, las variables se configuran con la siguiente sintaxis:
setenv VARIABLE_NAME <new-value>
Estos comandos se pueden agregar a la secuencia de comandos de inicialización de la shell para configurar las variables cada vez que se ejecute una instancia de shell nueva.
La ubicación de la secuencia de comandos de inicialización de la shell depende de la shell que se utiliza.
Para Gnu Bash, la ubicación puede ser ~/.bash_profile
. Para Zsh, la ubicación puede ser ~/.zprofile
. Para TCSH, la ubicación puede ser ~/.cshrc
. Consulta la documentación de la shell que usas a fin de confirmarlo.
También puedes actualizar la variable de entorno PATH
a los efectos de incluir las ubicaciones de la herramienta.
Para Gnu Bash o Zsh:
export ANDROID_HOME=~/Library/Android/sdk export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/platform-tools
Para TCSH:
setenv ANDROID_HOME ~/Library/Android/sdk setenv PATH $PATH\:$ANDROID_HOME/tools\:$ANDROID_HOME/tools/bin\:$ANDROID_HOME/platform-tools
Referencia de variables
En la siguiente tabla, se describen las variables de entorno de uso frecuente para las herramientas del SDK de Android.
Tabla 1: Variables del entorno
Variables de entorno del SDK de Android | |
---|---|
ANDROID_HOME |
Configura la ruta de acceso al directorio de instalación del SDK. Una vez configurada, no suele cambiar el valor, y varios usuarios pueden compartirla en la misma máquina.
ANDROID_SDK_ROOT , que también dirige al directorio de instalación del SDK, dejó de estar disponible. Si sigues usándolo, Android Studio y el complemento de Android para Gradle verificarán que las variables anterior y nueva sean coherentes.
|
ANDROID_USER_HOME |
Establece la ruta de acceso al directorio de preferencias del usuario para las herramientas que forman parte del SDK de Android.
La configuración predeterminada es $HOME/.android/ .
Algunas herramientas anteriores, como Android Studio 4.3 y versiones previas, no leen |
REPO_OS_OVERRIDE
|
Establece esta variable en windows , macosx o linux cuando uses sdkmanager a fin de descargar paquetes para un sistema operativo diferente de la máquina actual.
|
Variables de entorno de configuración de Android Studio | |
Las variables de configuración de Android Studio contienen parámetros que permiten personalizar la ubicación de los archivos de configuración y el JDK. Cuando se inicia, Android Studio busca la configuración de estas variables. Para obtener más información, consulta Cómo configurar Android Studio. | |
STUDIO_VM_OPTIONS
|
Establece la ubicación del archivo studio.vmoptions .
Este archivo contiene una configuración que afecta las características de rendimiento de la máquina virtual de Java HotSpot. También se puede acceder a este desde Android Studio. Consulta la sección Cómo personalizar tus opciones de VM.
|
STUDIO_PROPERTIES
|
Establece la ubicación del archivo idea.properties . Este archivo te permite personalizar las propiedades del IDE de Android Studio, como la ruta de acceso a los complementos que instaló el usuario y el tamaño máximo de archivo que admite el IDE. Consulta la sección Cómo personalizar tus propiedades del IDE.
|
STUDIO_JDK
|
Establece la ubicación del JDK en el que se ejecuta Android Studio. Cuando inicias el IDE, este verificará las variables de entorno STUDIO_JDK , JDK_HOME y JAVA_HOME en ese orden.
|
STUDIO_GRADLE_JDK
|
Establece la ubicación del JDK que usa Android Studio para iniciar el daemon de Gradle. Cuando inicias el IDE, primero comprobará STUDIO_GRADLE_JDK . Si no se definió STUDIO_GRADLE_JDK , el IDE usará el valor establecido en la configuración de la estructura del proyecto.
|
Variables de entorno del emulador | |
De forma predeterminada, el emulador almacena los archivos de configuración en $HOME/.android/ y los datos de AVD en $HOME/.android/avd/ . Para anular los valores predeterminados, configura las siguientes variables de entorno.
El comando emulator -avd <avd_name> busca en el directorio avd , en el orden de los valores de $ANDROID_AVD_HOME , $ANDROID_USER_HOME/avd/ y $HOME/.android/avd/ .
Para obtener ayuda con la variable de entorno del emulador, escribe |
|
ANDROID_EMULATOR_HOME
|
Establece la ruta de acceso al directorio de configuración del emulador específico del usuario. La configuración predeterminada es $ANDROID_USER_HOME .
Las herramientas más antiguas, como Android Studio 4.3 y versiones anteriores, no leen |
ANDROID_AVD_HOME
|
Establece la ruta de acceso al directorio que contiene todos los archivos específicos de AVD, que en su mayoría consisten en imágenes de disco muy grandes. La ubicación predeterminada es $ANDROID_EMULATOR_HOME/avd/ . Se recomienda especificar una ubicación nueva si la predeterminada tiene poco espacio en el disco.
|
Android Emulator consulta las siguientes variables de entorno cuando se inicia: | |
ANDROID_LOG_TAGS
|
Consulta ANDROID_LOG_TAGS .
|
HTTP_PROXY
|
Contiene la configuración de proxy HTTP/HTTPS para un proxy HTTP global. Usa un separador de dos puntos (:) entre el host y el puerto. Por ejemplo, Esto es lo mismo que especificar el argumento
|
ANDROID_VERBOSE
|
Consulta ANDROID_VERBOSE .
|
ANDROID_HOME
|
Consulta ANDROID_HOME . |
ANDROID_EMULATOR_USE_SYSTEM_LIBS
|
Contiene un valor de 0 (predeterminado) o 1. Un valor de 1 significa que se usa el archivo libstdc++.so del sistema en lugar del que viene incluido con el emulador.
Configura esta variable de entorno solo cuando el emulador no se inicie en tu sistema Linux debido a un problema de la biblioteca del sistema. Por ejemplo, algunas bibliotecas de controladores Radeon GL para Linux requieren una versión más reciente del archivo libstdc++.so .
|
Audio de emulador rápido (QEMU) | |
QEMU_AUDIO_DRV
QEMU_AUDIO_OUT_DRV
QEMU_AUDIO_IN_DRV
|
En Linux, puedes cambiar el backend de audio predeterminado del emulador mediante la configuración de la variable de entorno QEMU_AUDIO_DRV en uno de los siguientes valores:
set QEMU_AUDIO_DRV=alsa También puedes usar backends distintos para entrada y salida de audio seleccionando uno de los valores de QEMU para las variables de entorno set QEMU_AUDIO_OUT=esd set QEMU_AUDIO_IN=oss
Si quieres inhabilitar la compatibilidad de audio, usa la opción
|
Variables de entorno adb | |
ANDROID_SERIAL
|
Usa esta variable para proporcionar el número de serie de un emulador, como emulator-5555, a un comando adb . Si configuras esta variable, pero usas la opción -s con el fin de especificar un número de serie desde la línea de comandos, la entrada de la línea de comandos anula el valor en ANDROID_SERIAL .
En el siguiente ejemplo, se configura set ANDROID_SERIAL=emulator-555 adb install helloWorld.apk |
Variables de entorno adb logcat | |
ANDROID_LOG_TAGS
|
Usa esta variable de entorno para configurar una expresión de filtro predeterminada cuando ejecutes logcat en tu computadora de desarrollo. Por ejemplo:
set
Esto es lo mismo que especificar el argumento Consulta el artículo para filtrar resultados de registros si quieres obtener más información y ejemplos. |
ADB_TRACE
|
Contiene una lista separada por comas de la información de depuración que se registrará.
Los valores pueden ser los siguientes: all , adb , sockets , packets , rwx , usb , sync , sysdeps , transport y jdwp .
Para mostrar los registros set ADB_TRACE=all adb logcat |
ANDROID_VERBOSE
|
Contiene una lista separada por comas de opciones detalladas de salida (etiquetas de depuración) que usa el emulador. En el siguiente ejemplo, se muestra ANDROID_VERBOSE
definido con las etiquetas de depuración debug-socket y debug-radio :
set ANDROID_VERBOSE=socket,radio Esto es lo mismo que especificar los argumentos
Se ignoran las etiquetas de depuración que no son compatibles. Para obtener más información sobre etiquetas de depuración, usa |