Actualización de funciones de Android Studio Narwhal 3 | 2025.1.3

Android Studio es el IDE oficial para el desarrollo de Android e incluye todo lo necesario para compilar apps para Android.

En esta página, se enumeran las nuevas funciones y mejoras en la versión más reciente del canal estable, la Actualización de funciones 3 de Android Studio Narwhal. Puedes descárgala aquí o actualizar Android Studio si haces clic en Help > Check for updates (Android Studio > Check for updates en macOS).

Esta es una versión estable de Android Studio. Ten en cuenta que los parches pueden contener funciones secundarias nuevas y correcciones de errores. Consulta Nombres de versiones de Android Studio para comprender la nomenclatura de las versiones de Android Studio.

Para ver qué se corrigió en esta versión de Android Studio, consulta los errores cerrados.

Para ver las notas de las versiones anteriores de Android Studio, consulta la sección de versiones anteriores.

Si quieres obtener acceso anticipado a las próximas funciones y mejoras, consulta las versiones preliminares de Android Studio.

Si tienes problemas en Android Studio, consulta las páginas de problemas conocidos o solución de problemas.

Compatibilidad del complemento de Android para Gradle y Android Studio

El sistema de compilación de Android Studio se basa en Gradle, y el complemento de Android para Gradle (AGP) incorpora varias funciones específicas para compilar apps para Android. En la siguiente tabla, se muestra qué versión de AGP se requiere para cada versión de Android Studio.

Versión Android Studio Versión requerida del AGP
Actualización de funciones de Narwhal 3 | 2025.1.3 4.0-8.13
Actualización de funciones de Narwhal | 2025.1.2 4.0-8.12
Narwhal | 2025.1.1 3.2-8.11
Actualización de funciones de Meerkat | 2024.3.2 3.2-8.10
Suricata | 2024.3.1 3.2-8.9
Actualización de funciones de Ladybug | 2024.2.2 3.2-8.8
Ladybug | 2024.2.1 3.2-8.7
Actualización de funciones de Koala | 2024.1.2 3.2-8.6
Koala | 2024.1.1 3.2-8.5
Jellyfish | 2023.3.1 3.2-8.4
Iguana | 2023.2.1 3.2-8.3
Hedgehog | 2023.1.1 3.2-8.2
Giraffe | 2022.3.1 3.2-8.1
Flamingo | 2022.2.1 3.2-8.0

Versiones anteriores

Versión Android Studio Versión requerida del AGP
Electric Eel | 2022.1.1 3.2-7.4
Dolphin | 2021.3.1 3.2-7.3
Chipmunk | 2021.2.1 3.2-7.2
Bumblebee | 2021.1.1 3.2-7.1
Arctic Fox | 2020.3.1 3.1-7.0

Para conocer las novedades del complemento de Android para Gradle, consulta las notas de la versión del complemento de Android para Gradle.

Versiones mínimas de herramientas para el nivel de API de Android

Hay versiones mínimas de Android Studio y AGP que admiten un nivel de API específico. El uso de versiones anteriores de Android Studio o AGP que las requeridas por targetSdk o compileSdk de tu proyecto podría generar problemas inesperados. Recomendamos usar la versión preliminar más reciente de Android Studio y AGP para trabajar en proyectos orientados a versiones preliminares del SO Android. Puedes instalar versiones preliminares de Android Studio junto con una versión estable.

Estas son las versiones mínimas de Android Studio y AGP:

Nivel de API Versión mínima de Android Studio Versión mínima del AGP
36.0 Suricata | 2024.3.1 parche 1 8.9.1
35 Actualización de funciones de Koala | 2024.2.1 8.6.0
34 Hedgehog | 2023.1.1 8.1.1
33 Flamingo | 2022.2.1 7.2

Compatibilidad de Android Studio y los servicios de Cloud

Android Studio incluye integraciones de servicios que te ayudan a ti y a tu equipo a avanzar más rápido a medida que desarrollan, lanzan y mantienen apps para Android. Esto incluye servicios de Cloud, como Gemini en Android Studio, Play Vitals y Firebase Crashlytics. Los servicios en la nube solo están disponibles en la versión estable más reciente del canal de Android Studio, las tres versiones principales anteriores más recientes y los parches asociados a esas versiones. Cuando una versión queda fuera de ese período de compatibilidad, se inhabilitan las integraciones de servicios y debes actualizar Android Studio.

Versiones de Android Studio que actualmente son compatibles con los servicios de Cloud

A partir del lanzamiento del canal estable de la actualización de funciones de Android Studio Meerkat, todas las versiones de Studio son compatibles con los servicios de Cloud. La aplicación de la política comenzará con la actualización de funciones de Android Studio Narwhal.

Studio Labs

Studio Labs te permite probar las funciones experimentales más recientes de IA en una versión estable de Android Studio, de modo que puedas integrar más rápido nuestras ofertas de asistencia de IA en tu flujo de trabajo de desarrollo. Para obtener más información, consulta Studio Labs.

Las siguientes son las funciones disponibles actualmente en Studio Labs.

Función Descripción Documentos
Generación de la vista previa de Compose Gemini puede generar automáticamente vistas previas de Compose, incluidos datos simulados para los parámetros de vista previa, para un elemento componible específico o todos los elementos componibles de un archivo. Cómo generar vistas previas de Compose
IU de transformación Usa lenguaje natural para actualizar la IU de tu app directamente desde el panel de vista previa de Compose. Transformar la IU

Las siguientes son funciones nuevas de la versión 3 de Feature Drop de Android Studio Narwhal.

Vistas previas de Compose redimensionables

La función de vista previa de Compose ahora admite el cambio de tamaño dinámico para brindarte comentarios visuales instantáneos sobre cómo se adapta tu IU a diferentes tamaños de pantalla.

Para usar la función, ingresa al modo Enfoque en la vista previa de Compose. Para ello, cambia la opción de vista en la barra de herramientas:

Modo de enfoque de la vista previa de Compose
Modo de enfoque de la vista previa de Compose

Ahora puedes cambiar el tamaño de la ventana de vista previa arrastrando sus bordes:

Cambiar el tamaño de la ventana de vista previa arrastrando sus bordes.

También puedes usar la barra de herramientas de cambio de tamaño, que se muestra después de que se cambia el tamaño de la vista previa:

Cambiar el tamaño de la ventana de vista previa con la barra de herramientas de cambio de tamaño.

Si quieres guardar el nuevo tamaño como una nueva anotación Preview, usa el menú que aparece cuando haces clic con el botón derecho:

Compose Resizeable Preview save new size
Compose Resizeable Preview save new size

La función de cambio de tamaño dinámico te ayuda a crear IU que se ven bien en cualquier tamaño de pantalla.

Configuración de la vista de Android para mostrar los archivos de compilación en los módulos correspondientes

Hay un nuevo parámetro de configuración para mostrar los archivos de compilación en su módulo correspondiente en la vista de Android. Esta vista puede ser útil cuando trabajas en proyectos con muchos módulos. Para habilitar la vista, abre el menú Opciones disponible junto a la vista de Android. Luego, selecciona Appearance > Display Build Files In Module.

Android View: Build Files In Module
Opción para ver los archivos de compilación en los módulos correspondientes en la vista de Android.

Información sobre las políticas de Play en Android Studio

Android Studio ahora incluye información y orientación más detalladas sobre las políticas de Google Play que podrían afectar tu app. Esta información te ayuda a crear apps más seguras desde el principio, lo que evita problemas que podrían interrumpir el proceso de lanzamiento y requerir más tiempo y recursos para corregirlos más adelante.

A partir de la versión de Android Studio Narwhal 3 Feature Drop, puedes ver la información sobre las políticas de Play como verificaciones de lint. Estas verificaciones de lint presentarán la siguiente información:

  • Es una descripción general de la política.
  • Sugerencias y precauciones para evitar errores comunes
  • Vínculos a las páginas de políticas de Play, en las que puedes encontrar la política formal completa y más información y recursos útiles

El objetivo de esta función es proporcionar orientación útil previa a la revisión para que puedas tener experiencias más fluidas al enviar apps. No abarca todas las políticas ni proporciona decisiones finales de revisión de apps. Siempre revisa la política completa en el Centro de políticas para obtener orientación. También estamos mejorando y desarrollando activamente esta integración. Si tienes comentarios, infórmanos al respecto.

Para ver si hay estadísticas de políticas de Play para tu proyecto, ve a Code > Inspect for Play Policy Insights…. Las estadísticas se mostrarán en la ventana de herramientas "Problems" y también aparecerán como advertencias de Lint en los archivos correspondientes.

Información sobre las políticas de Play en Android Studio
Información sobre las Políticas de Play en la actualización de funciones de Android Studio Narwhal 3.

Cómo realizar pruebas y desarrollar con la copia de seguridad y el restablecimiento de apps

Garantizar que la Copia de seguridad y restauración de Android funcione correctamente para tu app es un aspecto fundamental para garantizar que los usuarios sigan interactuando con ella después de cambiar a un dispositivo nuevo o restaurar desde la nube. Sin embargo, puede ser difícil probar si la copia de seguridad y el restablecimiento de datos funcionan para tu app.

La versión de Android Studio Narwhal 3 Feature Drop te permite generar una copia de seguridad de tu app y restablecerla en otro dispositivo. Esto puede ser útil para probar si tu app se comporta como se espera cuando se restablecen los datos de la app de un dispositivo a otro o desde una copia de seguridad en la nube, o si deseas una forma más rápida de configurar un dispositivo de prueba con los datos que necesitas para desarrollar y depurar tu app.

Genera una copia de seguridad

Para generar un archivo de copia de seguridad, haz lo siguiente:

  1. Implementa una versión de depuración de tu app en un dispositivo conectado
  2. Usa una de las siguientes acciones para generar una copia de seguridad:
    • En la ventana Running Device, haz clic en la acción Backup App Data en la barra de herramientas.
    • Selecciona Run > Backup App Data en la barra de menú principal.
    • En la pestaña Device Explorer > Processes, haz clic con el botón derecho en el proceso de la app y selecciona Backup App Data.
  3. En el cuadro de diálogo que aparece, haz lo siguiente:
    • Confirma el ID de la aplicación para la que deseas generar una copia de seguridad.
      • Selecciona si deseas generar una copia de seguridad de Dispositivo a dispositivo, Nube o Nube (sin encriptar).
    • Confirma el nombre y la ubicación de la copia de seguridad que deseas guardar. De forma predeterminada, la copia de seguridad se guarda en el directorio raíz del proyecto actual de Android Studio.
      Genera una copia de seguridad para tu app.
  4. Haz clic en Aceptar cuando Android Studio te pregunte si puede detener la app. Para generar la copia de seguridad, Android Studio debe detener el proceso de la app.

Puedes ver las copias de seguridad que generas en la ventana de herramientas Project > Android en el nodo Backup Files.

Tipos de copias de seguridad

Puedes generar diferentes tipos de copias de seguridad para tu app. Cuando generes una copia de seguridad, selecciona el tipo que se relacione con la situación que deseas probar:

  • De dispositivo a dispositivo: Genera una copia de seguridad de tu app, similar a la que se crea durante la transferencia de dispositivo a dispositivo. En las transferencias de dispositivo a dispositivo, los datos de copia de seguridad de la app se envían directamente a otro dispositivo, por ejemplo, a través de USB o Wi-Fi.
  • Nube: Genera una copia de seguridad de tu app, similar a la que se guarda en el almacenamiento de la Cuenta de Google del usuario. Cuando un usuario configura un dispositivo nuevo, puede elegir restablecerlo desde una copia de seguridad en Cloud.
  • Nube (sin encriptar): Genera una copia de seguridad de tu app, similar a la que se guarda en el almacenamiento de la Cuenta de Google del usuario en un dispositivo que no tiene habilitada la encriptación del cliente.

Nota: Cuando usas la función para probar Cloud, Cloud (sin encriptar) o copias de seguridad de dispositivo a dispositivo, la copia de seguridad generada no se envía a Cloud ni a otro dispositivo, a diferencia del flujo de copia de seguridad real. Genera la copia de seguridad de tu app como si se fuera a guardar en la nube o a enviar a otro dispositivo. Las copias de seguridad generadas para cualquier tipo de copia de seguridad pueden encontrarse en Backup Files en la ventana de herramientas Project > Android.

Cómo restablecer los datos de la app

Para restablecer los datos de la app, haz lo siguiente:

  1. Implementa tu app en el dispositivo conectado. La app debe tener el mismo ID de aplicación que el archivo de copia de seguridad que deseas restablecer en el dispositivo.
  2. Navega a una de las siguientes acciones y haz clic en ella:
    • En la ventana Running Device, haz clic en la acción Restore App Data de la barra de herramientas y selecciona un archivo de copia de seguridad del historial reciente o haz clic en Browse.
    • En la barra de menú principal, ve a Run > Restore App Data.
    • En la pestaña Device Explorer > Processes, haz clic con el botón derecho en el proceso de la app y selecciona Restore App Data.
    • En la ventana de herramientas Project > Android, haz clic con el botón derecho en una copia de seguridad en el nodo Backup Files y selecciona Restore App Data.
  3. Si corresponde, selecciona una copia de seguridad del historial reciente o haz clic en Explorar para seleccionar un archivo de copia de seguridad que se restablecerá desde el almacenamiento local.

Como alternativa, puedes incluir un archivo de copia de seguridad como parte de una configuración de ejecución, de modo que la implementación de tu app también restablezca los datos de la app desde un archivo de copia de seguridad. Para ello, haz lo siguiente:

  1. Navega a Run > Edit Configurations en la barra de menú principal.
  2. Selecciona una configuración de ejecución de la app y navega a Opciones de restablecimiento.
    Restablece las opciones en una configuración de ejecución.
  3. Para restablecer una app desde una copia de seguridad, marca la casilla junto a Restablecer el estado de la app.
  4. Selecciona un archivo de copia de seguridad del historial reciente o busca y selecciona el archivo de copia de seguridad del almacenamiento local.
  5. Si solo quieres restablecer los datos de la app en una instalación nueva, marca la casilla junto a Only restore on fresh apk installation. Esta opción puede ser útil si implementas la app en un dispositivo de prueba nuevo y quieres restablecer los datos para facilitar la depuración y el desarrollo de la app.
  6. Haz clic en Aceptar para guardar la configuración de ejecución.
  7. Implementa tu app con la configuración de ejecución para probar la restauración de los datos de la app en un dispositivo conectado.

Inspecciones de Proguard

Android Studio ahora incluye inspecciones para evitar reglas de ProGuard mal diseñadas o reglas que impiden las optimizaciones de R8. Las reglas de conservación demasiado amplias, como -keep class **.*, y las configuraciones de reglas de ProGuard del consumidor, como dontshrink y -dontoptimize, ahora activan una advertencia en el IDE de Studio. Para crear una buena regla de conservación que permita la reducción de código, defina el alcance de la regla para un paquete específico y sea explícito sobre lo que desea conservar.

Archivos AGENT.md para el contexto a nivel del proyecto

Ahora puedes incluir archivos AGENT.md en tu proyecto. Estos son archivos Markdown que proporcionan instrucciones específicas del proyecto, reglas de estilo de codificación y otras orientaciones a Gemini como contexto.

Gemini descubre y aplica automáticamente las instrucciones de cualquier archivo llamado AGENT.md en tu proyecto. Si no hay un archivo AGENT.md, Gemini busca un archivo GEMINI.md como alternativa.

Nuevo parámetro de configuración para inhabilitar la sincronización automática

Android Studio ahora ofrece un parámetro de configuración para cambiar del modo de sincronización automática predeterminado (p.ej., la sincronización se ejecuta automáticamente cuando se abre un proyecto) a un nuevo modo de sincronización manual con recordatorios. El comportamiento predeterminado sigue siendo la Sincronización automática. Para cambiar a la sincronización manual, ve a File (Android Studio en macOS) > Settings > Build, Execution, Deployment > Build Tools y establece Project Sync mode en Manual Sync with reminders como el modo de sincronización del proyecto.

Adjunto de imágenes en Gemini

Ahora puedes adjuntar archivos de imagen y proporcionar información adicional junto con tu instrucción. Por ejemplo, puedes adjuntar simulaciones o capturas de pantalla de la IU para brindarle contexto a Gemini sobre el diseño de tu app. Por lo tanto, Gemini puede generar código de Compose basado en una imagen proporcionada o explicar los elementos componibles y el flujo de datos de una captura de pantalla de la IU. Para obtener más información, consulta Cómo adjuntar una imagen a tu búsqueda.

Diálogo de Gemini con archivos adjuntos de imágenes
Generación de vistas previas y archivos adjuntos de imágenes con Gemini en Android Studio

@Contexto del archivo en Gemini

Ahora puedes adjuntar los archivos de tu proyecto como contexto en las interacciones de chat con Gemini en Android Studio. Esto te permite hacer referencia rápidamente a archivos en tus instrucciones para Gemini. En la entrada de chat de Gemini, escribe @ para que aparezca un menú de finalización de archivos y selecciona los archivos que quieras adjuntar. También puedes hacer clic en el menú desplegable Contexto para ver qué archivos adjuntó Gemini automáticamente. Esto te brinda más control sobre el contexto que se envía a Gemini. Para obtener más información, consulta Cómo adjuntar un archivo a tu consulta.

@Contexto del archivo en Gemini
@Contexto del archivo en Gemini