Skip to content

Most visited

Recently visited

navigation

Configurar Android Studio

Android Studio proporciona asistentes y plantillas que verifican los requisitos de tu sistema, como el Java Development Kit (JDK) y la memoria RAM disponible, y configuran los ajustes predeterminados, como una emulación optimizada predeterminada del Android Virtual Device (AVD) e imágenes del sistema actualizadas. En este documento, se describen ajustes de configuración adicionales que puedes usar para personalizar tu uso de Android Studio.

Android Studio proporciona acceso a dos archivos de configuración a través del menú Help:

Para acceder a documentación específica acerca de la configuración y el uso del emulador y el dispositivo, consulta Administración de dispositivos virtuales, Uso de dispositivos de hardware, y Controladores USB de OEM.

Buscar tus archivos de configuración

Los archivos de configuración se almacenan en la carpeta de configuración para Android Studio. El nombre de la carpeta depende de tu versión de Studio. Por ejemplo, el nombre de la carpeta para Android Studio 2.2 es AndroidStudio2.2. La ubicación de esta carpeta depende de tu sistema operativo:

También puedes usar las siguientes variables de entorno para señalar archivos de anulación específicos en otro lugar:

Personalizar las opciones del VM

El archivo studio.vmoptions te permite personalizar las opciones para la JVM de Android Studio. Para mejorar el rendimiento de Studio, la opción más común es ajustar el tamaño máximo de montón; sin embargo, también puedes usar el archivo studio.vmoptions a fin de anular otras configuraciones predeterminadas, como los cambios de tamaño inicial de montón, tamaño de caché y recolección de elementos no usados de Java.

Para crear un archivo studio.vmoptions nuevo o abrir uno existente, realiza los siguientes pasos:

  1. Haz clic en Help > Edit Custom VM Options. Si nunca editaste las opciones de VM de Android Studio, el IDE te solicitará crear un archivo studio.vmoptions nuevo. Haz clic en Yes para crear el archivo.
  2. El archivo studio.vmoptions se abrirá en la ventana del editor de Android Studio. Edita el archivo para agregar tus propias opciones personalizadas de VM. Para hallar una lista completa de opciones de JVM personalizables, consulta la página de opciones de VM de Java HotSpot de Oracle.

El archivo studio.vmoptions que crees se agregará al archivo studio.vmoptions predeterminado, ubicado en el directorio bin/ de tu carpeta de instalación de Android Studio.

Ten en cuenta que nunca debes editar directamente el archivo studio.vmoptions situado dentro de la carpeta de programa de Android Studio. Cuando puedas acceder al archivo para ver las opciones predeterminadas del VM de Studio, editar solo tu archivo studio.vmoptions te garantizará que no anules configuraciones predeterminadas importantes para Android Studio. Por lo tanto, en tu archivo studio.vmoptions, anula solo los atributos que te importen y permite que Android Studio continúe usando los valores predeterminados para cualquier atributo que no hayas cambiado.

Tamaño máximo de montón

De forma predeterminada, Android Studio tiene un tamaño máximo de montón de 1280 MB. Si trabajas en un proyecto grande o tu sistema tiene mucha RAM, puedes mejorar el rendimiento aumentando el tamaño máximo de montón en las opciones del VM para Android Studio. Si tu sistema tiene restricciones de memoria, tal vez desees reducir el tamaño máximo de montón.

Para cambiar el tamaño máximo de montón, sigue estos pasos:

  1. Haz clic en Help > Edit Custom VM Options para abrir tu archivo studio.vmoptions.
  2. Agrega una línea al archivo studio.vmoptions para fijar el tamaño máximo de montón usando la sintaxis -XmxheapSize. El tamaño que elijas se debe basar en el tamaño de tu proyecto y la memoria RAM disponible en tu equipo. Como referencia, si tienes más de 4 GB de memoria RAM y un proyecto de tamaño medio, debes fijar el tamaño máximo del montón en 2 GB o más. Con la siguiente línea, se fija el tamaño máximo de montón en 2 GB:
    -Xmx2g
  3. Guarda tus cambios en el archivo studio.vmoptions y reinicia Android Studio para que se apliquen esos cambios.
  4. Para confirmar tu nuevo tamaño máximo de montón, abre la línea de comandos y escribe el siguiente:
    jps -lvm

    Verás una lista de JVM instrumentadas que se ejecutan en tu equipo; se incluirán el nombre completo del paquete de cada uno y los argumentos pasados. Ubica el elemento que corresponde a tu instancia de Android Studio. Debe terminar con -Didea.paths.selector=AndroidStudio[Version]. Verás dos argumentos que comienzan con -Xmx para este JVM: uno con el valor predeterminado de 1280 MB y otro con tu valor nuevo, como se muestra en la figura 1.

    Figura 1: Salida terminal muestra los argumentos actuales para el JVM de Android Studio.

    1. El argumento -Xmx muestra el tamaño máximo de montón predeterminado; en este caso, 1280 m.
    2. El argumento -Didea.paths.selector muestra la versión de Android Studio que actualmente se ejecuta.
    3. El argumento -Xmx muestra el nuevo tamaño máximo del montón personalizado. Ten en cuenta que a esto le sigue la ubicación del archivo personalizado studio.vmoptions que creaste anteriormente.

Exportar e importar configuraciones de IDE

Puedes exportar un archivo de configuración JAR (Settings.jar) que contenga todas tus configuraciones de IDE o un subconjunto de estas que prefieras para un proyecto. Luego, puedes importar el archivo JAR a tus demás proyectos y hacer que esté disponible para que tus colegas lo importen a sus proyectos.

Para obtener más información, consulta Exportar e importar configuraciones en IntelliJ IDEA.

Personalizar tus propiedades de IDE

El archivo idea.properties te permite personalizar las propiedades de IDE para Android Studio, como la ruta de acceso a los complementos instalados por el usuario y el tamaño máximo de archivo admitido por el IDE. El archivo idea.properties se fusiona con las propiedades predeterminadas para el IDE, de modo que puedas especificar solo las propiedades anuladas.

Para crear un archivo nuevo idea.properties o abrir uno existente, realiza los siguientes pasos:

  1. Haz clic en Help > Edit Custom Properties. Si nunca editaste las propiedades del IDE antes, Android Studio te solicitará crear un archivo idea.properties nuevo. Haz clic en Yes para crear el archivo.
  2. El archivo idea.properties se abrirá en la ventana del editor de Android Studio. Edita el archivo para agregar tus propias propiedades personalizadas de IDE.

En el siguiente archivo idea.properties se incluyen las propiedades de IDE comúnmente personalizadas. Para obtener una lista completa de propiedades, lee información sobre el archivo idea.properties para 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 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

Configurar el IDE para equipos de memoria insuficiente

Si ejecutas Android Studio en un equipo con menos especificaciones de las recomendadas (consulta Requisitos del sistema), puedes personalizar el IDE para mejorar el rendimiento de tu equipo de la siguiente manera:

Configurar tu proyecto para Instant Run

Instant Run es un comportamiento para los comandos Run y Debug que reduce significativamente el tiempo entre actualizaciones de tu app. Si bien la primera compilación puede demorar más tiempo en completarse, Instant Run aplica actualizaciones posteriores en tu app sin compilar un APK nuevo, de modo que los cambios se visualicen mucho más rápido.

Android Studio habilita Instant Run de forma predeterminada para proyectos generados con un complemento de Android para Gradle 2.0.0 y versiones posteriores. Puedes mejorar el rendimiento de la compilación con Instant Run modificando algunas configuraciones para tu proyecto. Si deseas obtener más información sobre la configuración de tu proyecto para Instant Run, lee Configurar y optimizar tu proyecto para Instant Run.

Establecer la versión de JDK

Una copia del último OpenJDK se incluye en un paquete con Android Studio 2.2 y versiones posteriores, y esta es la versión de JDK que te recomendamos usar para tus proyectos de Android. Para usar el JDK incluido, sigue estos pasos:

  1. Abre tu proyecto en Android Studio y selecciona File > Project Structure en la barra de menú.
  2. En la página SDK Location y en JDK Location, marca la casilla de verificación Use embedded JDK.
  3. Haz clic en OK.

De forma predeterminada, la versión en lenguaje Java que se usa para compilar tu proyecto se basa en la compileSdkVersion de tu proyecto (porque las versiones diferentes de Android admiten diferentes versiones de Java). Si es necesario, puedes anular esta versión predeterminada de Java agregando el siguiente bloque CompileOptions {} a tu archivo build.gradle:

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_6
        targetCompatibility JavaVersion.VERSION_1_6
    }
}

Para obtener más información sobre el punto en el que se define la compileSdkVersion, lee la documentación sobre el archivo de compilación de nivel de módulo.

Establecer configuraciones de proxy

Los proxy sirven como puntos de conexión intermedios entre los clientes HTTP y los servidores web, y proporcionan seguridad y privacidad para las conexiones de Internet.

Para admitir la ejecución de Android Studio con un firewall, establece las configuraciones de proxy para el IDE de Android Studio. Usa la página de ajustes de proxy HTTP del IDE de Android Studio para configurar estos ajustes.

Cuando se ejecuta el complemento de Android para Gradle desde la línea de comandos o en equipos sin Android Studio, como los servidores de integración continua, establece las configuraciones de proxy en el archivo de compilación de Gradle.

Nota: Después de la instalación inicial del paquete de Android Studio, puedes ejecutarlo con acceso a Internet o sin conexión. No obstante, Android Studio requiere una conexión a Internet para la sincronización del asistente de configuración, el acceso a bibliotecas de terceros, el acceso a repositorios remotos, la inicialización y sincronización de Gradle, y actualizaciones de versión de Android Studio.

Configurar el proxy de Android Studio

Android Studio admite ajustes de configuración de proxy HTTP para que puedas ejecutar Android Studio detrás de un firewall o una red segura. Para configurar el proxy HTTP en Android Studio:

  1. En la barra de menú, haz clic en File > Settings (en Mac, en Android Studio > Preferences).
  2. En el subpanel izquierdo, haz clic en Appearance & Behavior > System Settings > HTTP Proxy. Aparecerá la página del Proxy HTTP.
  3. Selecciona Auto-detect proxy settings para usar una URL de configuración automática de proxy o Manual proxy configuration para ingresar cada una de las configuraciones tú mismo. Para acceder a una explicación detallada de estos ajustes, consulta Proxy HTTP.
  4. Haz clic en Apply u OK para que se apliquen los cambios.

Complemento de Android para las configuraciones de proxy HTTP de Gradle

Cuando se ejecuta el complemento de Android desde la línea de comandos o en equipos sin Android Studio, establece la configuración de proxy del complemento de Android para Gradle en el archivo de compilación de Gradle.

Para configuraciones de proxy HTTP específicas de aplicaciones, establece la configuración de proxy en el archivo build.gradle según sea necesario para cada módulo de la aplicación.

apply plugin: '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
    }
    ...
}

Para configuraciones de proxy HTTP en un proyecto, establece la configuración de proxy en el archivo gradle/gradle.properties.

# 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

...

Si deseas obtener información sobre el uso de propiedades de Gradle para la configuración del proxy, consulta la Guía del usuario de Gradle.

Nota: Al usar Android Studio, los ajustes que se realicen en la página de configuración del proxy HTTP del IDE de Android Studio reemplazarán la configuración del proxy HTTP del archivo gradle.properties.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)