Cómo solucionar problemas relacionados con Android Studio

En esta página, se ofrece asistencia para solucionar problemas comunes y de configuración en Android Studio.

Pantallas de alta densidad

A partir de la versión 1.5, Android Studio proporciona compatibilidad con pantallas de alta densidad (como monitores Retina y HiDPI) en todas las plataformas.

Configuración del factor de escala

Android Studio determina el factor de ajuste de tamaño para tu pantalla de la siguiente manera:

Mac
En el caso de las pantallas Retina, los elementos de la IU reciben un ajuste de tamaño del 200% y las imágenes se presentan en alta resolución. No deberían verse imágenes borrosas debido al ajuste de tamaño, incluso en configuraciones de monitores múltiples. Ten en cuenta que no se ofrece compatibilidad para factores de escala que no sean del 100% (para pantallas que no sean Retina) y del 200% (para pantallas Retina).
Windows
Android Studio usa la configuración de DPI de la pantalla principal para determinar el factor de escala de los elementos de la IU. En el caso de las imágenes, si el factor es inferior al 150%, se ampliarán las imágenes con resolución normal. Si el factor supera el 150%, se ajustarán las imágenes de alta resolución de manera correspondiente.
Linux
Para determinar el factor de escala, Android Studio considera el "factor de escala de texto" y, luego, la configuración de DPI del sistema XWindow.
Una configuración de DPI con el valor 96 corresponde a un factor de escala del 100% (sin escala), mientras que una de 192 corresponde a un factor de escala del 200% (se duplica el tamaño de los elementos de la IU). Actualmente, Android Studio admite configuraciones de DPI de 96 (escala del 100%) a 288 (escala del 300%). Si Android Studio no detecta la configuración correcta de DPI del sistema en tu máquina Linux o Windows, puedes establecer este valor de forma manual. Para ello, configura la propiedad hidpi en el archivo idea.properties tal como se describe en Cómo personalizar tus propiedades de IDE. Ten en cuenta que esta propiedad no tiene efecto en las máquinas Mac. Funciona de la siguiente manera:
hidpi=true
Establece el valor de DPI en 192 (escala del 200%) e ignora la configuración del sistema.
hidpi=false
Establece el valor de DPI en 96 (escala del 100%) e ignora la configuración del sistema.

Elementos borrosos o pixelados en pantallas de alta densidad

Si uno o más elementos de la IU de Android Studio se ven borrosos o pixelados en tu pantalla de alta densidad, es posible que experimentes uno de los siguientes problemas:

  • Si se ve bien la mayor parte de la IU de Android Studio, pero un ícono en particular se muestra borroso o pixelado, o bien un elemento en particular de esa interfaz utiliza una fuente del tamaño incorrecto, es probable que aún no se haya actualizado por completo ese elemento específico para ser compatible con HiDPI. Haz clic en Help > Submit Feedback para informar un error. Incluye una captura de pantalla y la mayor cantidad de información posible acerca de la configuración de tu sistema.
  • Si usas una máquina Linux o Windows, y la pantalla utiliza un factor de ajuste de tamaño que no sea del 100 ni del 200%, es posible que se vean ligeramente borrosas las imágenes debido a dicho ajuste de tamaño.
  • Si usas una máquina Windows y modificaste el tamaño de fuente en el Panel de control, es posible que se vea borrosa o pixelada. Para resolver este problema, sal de la cuenta en Windows y vuelve a acceder.
  • En una configuración de varios monitores con Windows 8.1 o versiones posteriores, si mueves una ventana de una pantalla a otra con una resolución o un valor de DPI diferente, es posible que experimentes problemas vinculados con la fuente o la imagen (consulta el error 186007). Por el momento, no contamos con una solución conocida para este inconveniente.
  • Las versiones anteriores a JRE 1.8 presentaban un problema relacionado con fuentes borrosas (en particular, JRE 1.8.0_25-b18 amd64; consulta el error 192316). A partir de la versión 2.2, Android Studio presenta una versión agrupada del último JDK compatible, que incluye el JDE. Para resolver este problema, actualiza Android Studio a la versión 2.2 o a una versión posterior y comienza a utilizar el JDK integrado haciendo clic en File > Project Structure > SDK Location y seleccionando la casilla de verificación Use embedded JDK.

Elementos con tamaño incorrecto en pantallas de alta densidad

Si toda la IU de Android Studio presenta el tamaño incorrecto en una pantalla de alta densidad, consulta Configuración del factor de escala. Si algunos elementos de la IU de Android Studio presentan el tamaño incorrecto en una pantalla de alta densidad, pero otros tienen el tamaño correcto, es posible que experimentes uno de los siguientes problemas:

  • Si utilizas un esquema de editor personalizado, la fuente del editor puede parecer demasiado pequeña o demasiado grande en comparación con el resto de los elementos de esa IU en una pantalla de alta densidad. Para solucionar este problema, haz clic en File > Settings y, luego, en Editor > Colors and Fonts > Font para cambiar el tamaño de la fuente del editor. Ten en cuenta que, cuando está activo el esquema predeterminado, se ajusta automáticamente el tamaño de la fuente del editor (consulta el error 186920).
  • Si algunos elementos de la IU de Android Studio tienen el tamaño correcto, pero otros son demasiado pequeños o demasiado grandes, es posible que experimentes el problema 186923. Haz clic en Help > Submit Feedback para informar un error. Incluye una captura de pantalla y la mayor cantidad de información posible acerca de la configuración de tu sistema.

Problemas de sincronización de proyectos

Cuando intentes sincronizar tu proyecto, es posible que recibas el siguiente mensaje de error: "Connection to the Internet denied. ('Permission denied: connect')". Puedes eliminar este mensaje de error agregando la propiedad de sistema -Djava.net.preferIPv4Stack=true a tu archivo gradle.properties en Android Studio de la siguiente manera:

  1. Abre el archivo gradle.properties en Android Studio.
  2. Agrega la siguiente línea al archivo:
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    
    Ten en cuenta que, si ya agregaste otros argumentos de JVM de Gradle a tu gradle.properties, puedes agregar esta propiedad a la misma línea, como se muestra en el siguiente ejemplo:
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
    
  3. Reinicia Android Studio para aplicar los cambios que realizaste.
  4. Haz clic en Sync Project with Gradle Files para sincronizar el proyecto.

Problemas relacionados con la actualización del IDE en Windows

En Windows, los archivos no pueden borrarse cuando los usa un proceso. Cuando intentas utilizar el mecanismo de actualización incorporado en el IDE, este a veces no permite instalar la actualización y, por lo general, aparece un mensaje de error como "Can't delete C:\some\path\file".

Para solucionar este problema, abre el Administrador de tareas y cierra procesos que posiblemente estén utilizando el archivo; por ejemplo, cualquier daemon de Gradle.

Problemas relacionados con minSdkVersion

Si usas una versión obsoleta de las bibliotecas de compatibilidad de Android, es posible que recibas un mensaje de error como el siguiente:

:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml
Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

Para resolver este problema, usa SDK Manager a fin de actualizar el sistema a las versiones más recientes (que no sean de vista previa) de estas bibliotecas. Puedes obtener más información para configurar las bibliotecas de compatibilidad en Configuración de la biblioteca de compatibilidad.

Problemas de Android Emulator

Consulta Cómo solucionar problemas relacionados con Android Emulator.

Directorios

Android Studio usa los siguientes directorios para almacenar configuraciones: cachés, complementos y registros.

Windows

  • Configuración (idea.config.path): %APPDATA%\Google\AndroidStudioVERSION
  • Complementos (idea.plugins.path): %APPDATA%\Google\AndroidStudioVERSION\plugins
  • Sistema (idea.system.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION
  • Registros (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • Ejemplo de %APPDATA%: C:\Users\YourUserName\AppData\Roaming
  • Ejemplo de %LOCALAPPDATA%: C:\Users\YourUserName\AppData\Local

macOS

  • Configuración (idea.config.path): ~/Library/Application Support/Google/AndroidStudioVERSION
  • Complementos (idea.plugins.path): ~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • Sistema (idea.system.path): ~/Library/Caches/Google/AndroidStudioVERSION
  • Registros (idea.log.path): ~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • Configuración (idea.config.path): ~/.config/Google/AndroidStudioVERSION
  • Complementos (idea.plugins.path): ~/.local/share/Google/AndroidStudioVERSION
  • Sistema (idea.system.path): ~/.cache/Google/AndroidStudioVERSION
  • Registros (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

Cada directorio aparece en el siguiente formato:

Reemplazar:

  • AndroidStudio por el nombre del producto, que es AndroidStudio para los lanzamientos estables o AndroidStudioPreview para los lanzamientos beta y Canary.
  • VERSION por la versión Por ejemplo, 2023.1 o 2023.3.