Nuevas funciones de la versión preliminar de Android Studio

En esta página, se enumeran las nuevas funciones que se introdujeron en las versiones preliminares de Android Studio. Las compilaciones de versión preliminar proporcionan acceso anticipado a las mejoras y funciones más recientes de Android Studio. Puedes descargar estas versiones preliminares. Si encuentras un problema mientras usas una versión preliminar de Android Studio, avísanos. Tus informes de errores nos ayudan a mejorar Android Studio.

Las versiones canary contienen funciones de vanguardia en desarrollo activo y se someten a pruebas ligeras. Si bien puedes usar compilaciones de Canary para el desarrollo, ten en cuenta que es posible que se agreguen o cambien funciones. Las versiones candidatas (RC) son la próxima versión de Android Studio y están casi listas para su lanzamiento estable. Se estabilizó el conjunto de funciones para la próxima versión. Consulta Nombres de versiones de Android Studio para comprender la nomenclatura de las versiones de Android Studio.

Para conocer las novedades sobre las versiones preliminares de Android Studio, incluida una lista de las correcciones destacadas de cada una, consulta las actualizaciones de las versiones en el blog de Android Studio.

Versiones actuales de Android Studio

En la siguiente tabla, se enumeran las versiones actuales de Android Studio y sus respectivos canales.

Versión Canal
Actualización de funciones de Android Studio Narwhal | 2025.1.2 Estable
Complemento de Android para Gradle 8.12.0 Estable
Actualización de funciones de Android Studio Narwhal 3 | 2025.1.3 RC
Actualización de funciones de Android Studio Narwhal 4 | 2025.1.4 Canary

Compatibilidad con las vistas previas del complemento de Android para Gradle

Cada versión preliminar de Android Studio se publica junto con una versión correspondiente del complemento de Android para Gradle (AGP). Las versiones preliminares de Studio deberían funcionar con cualquier versión estable compatible de AGP. Sin embargo, si usas una versión preliminar de AGP, debes usar la versión preliminar correspondiente de Studio (por ejemplo, Android Studio Chipmunk Canary 7 con AGP 7.2.0-alpha07). Si intentas usar versiones divergentes (por ejemplo, Android Studio Chipmunk Beta 1 con AGP 7.2.0-alpha07), se producirá un error de sincronización, lo que generará un mensaje para actualizar a la versión correspondiente de AGP.

Para obtener un registro detallado de las bajas y las eliminaciones de la API del complemento de Android para Gradle, consulta las actualizaciones de la API del complemento de Android para Gradle.

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
Cómo adjuntar imágenes Adjunta una imagen a tu consulta para generar la IU, depurar errores de la IU, documentar la arquitectura de una app y mucho más. Cómo adjuntar imágenes
Adjuntar archivos Adjunta archivos a tu consulta para ayudar a Gemini a comprender mejor el contexto de tu pregunta y a identificar qué código debe actualizarse. Cómo adjuntar archivos
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

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

Las siguientes son funciones nuevas de la actualización de funciones de Android Studio Narwhal 3 | 2025.1.3.

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

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.

Android Studio Narwhal te permite generar una copia de seguridad de tu app y restaurarla 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.

Funciones que dejan Studio Labs

Las siguientes funciones experimentales de Studio Labs son estables a partir de la actualización de funciones de Narwhal 3:

Actualización de funciones de Android Studio Narwhal 4 | 2025.1.4

Las siguientes son funciones nuevas de la actualización de funciones de Android Studio Narwhal 4 | 2025.1.4.

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

Journeys para Android Studio

Journeys for Android Studio te ayuda a escribir y mantener pruebas de extremo a extremo con facilidad, ya que te permite usar lenguaje natural para describir los pasos y las aserciones de cada prueba, lo que se denomina un recorrido. Aprovechando las capacidades de visión y razonamiento de Gemini, los pasos escritos en lenguaje natural se convierten en acciones que Gemini realiza en tu app, lo que hace que tus recorridos sean fáciles de escribir y comprender. Además, puedes escribir y describir aserciones más complejas, que Gemini evalúa en función de lo que ve en el dispositivo para determinar si tus recorridos se aprueban o rechazan.

Además, como Gemini razona sobre qué acciones realizar para satisfacer los objetivos, los recorridos son más resistentes a los cambios sutiles en el diseño o el comportamiento de tu app, lo que genera menos pruebas inestables cuando se ejecutan en diferentes versiones de tu app y diferentes configuraciones de dispositivos.

Escribe y ejecuta recorridos directamente desde Android Studio en cualquier dispositivo Android local o remoto. El IDE proporciona una nueva experiencia de editor para crear recorridos, así como resultados enriquecidos que te ayudan a comprender mejor el razonamiento y la ejecución de tu recorrido por parte de Gemini.

Copia de seguridad y sincronización

Ahora puedes crear copias de seguridad de la configuración de Android Studio en el almacenamiento en la nube con tu cuenta de Google o JetBrains. Esto ayuda a sincronizar tus parámetros de configuración, como las asignaciones de teclas, la configuración del editor de código, la configuración del sistema y mucho más. Para comenzar, realiza una de las siguientes acciones:

  • Después de abrir un proyecto en Android Studio, accede a tu Cuenta de Google haciendo clic en el avatar que se encuentra en la esquina superior derecha del IDE y, luego, en Acceder.

    1. Sigue las instrucciones del diálogo que aparece y asegúrate de marcar la casilla para autorizar a Android Studio a acceder a tu almacenamiento de la Cuenta de Google.
    2. Sigue las indicaciones para autorizar Android Studio.
  • Navega a Configuración > Copia de seguridad y sincronización.

    1. Selecciona Google para usar el almacenamiento de tu Cuenta de Google y sincronizar los datos de tu app en todas las instalaciones de Android Studio. Como alternativa, puedes usar una cuenta de JetBrains para sincronizar los datos de tu app en las instalaciones de IntelliJ y Android Studio.
    2. Después de seguir las instrucciones para autorizar a Android Studio a acceder al almacenamiento de tu cuenta preferida, regresa a Android Studio.
    3. En la página Configuración > Copia de seguridad y sincronización, puedes revisar las categorías de datos de apps que deseas sincronizar con tu cuenta.
    4. Para inhabilitar Copia de seguridad y sincronización, desmarca la casilla que habilita la función.

Si ya sincronizaste datos con el dispositivo seleccionado, Android Studio te ofrece la opción de descargar la configuración de tu almacenamiento remoto (esta es la opción predeterminada) o subir tu configuración local y reemplazar la configuración sincronizada con tu almacenamiento remoto.

Correcciones sugeridas para fallas

En la actualización de funciones de Android Studio Meerkat, lanzamos estadísticas de Gemini para las fallas informadas en la ventana de herramientas App Quality Insights. Ahora, Android Studio puede usar Gemini para analizar los datos de fallas junto con tu código fuente y sugerir posibles correcciones. Después de seleccionar una falla en la ventana de herramientas de App Quality Insights, navega a la pestaña Insights y haz clic en Suggest a fix después de que Gemini genere una sugerencia para la falla. Luego, Gemini genera cambios de código sugeridos que puedes revisar y aceptar en una pestaña de diferencias del editor.

Nuevo parámetro de configuración para abrir proyectos nuevos con la vista Proyecto

Hay un nuevo parámetro de configuración para que los proyectos nuevos se abran en la vista de proyecto de forma predeterminada. Para habilitar el parámetro de configuración, ve a File (Android Studio en macOS) > Settings > Advanced Settings > Project View y selecciona Set Project view as the default.

Herramienta de prueba de capturas de pantalla de la vista previa de Compose

Usa la herramienta de pruebas de capturas de pantalla de Compose Preview para probar tus IU de Compose y evitar regresiones. La nueva herramienta te ayuda a generar informes HTML que te permiten detectar visualmente cualquier cambio en la IU de tu app. Obtén más información en Pruebas de capturas de pantalla de Compose Preview.

Mejora del árbol de componentes del Inspector de diseño incorporado

Ahora, interactuar con el árbol de componentes en el Inspector de diseño incorporado es más intuitivo y eficiente gracias a varias mejoras clave. Estas actualizaciones están diseñadas para optimizar tu flujo de trabajo y proporcionar estadísticas más claras sobre las estructuras de tu IU de Compose.

  1. Desplazamiento horizontal: Ahora puedes desplazarte horizontalmente dentro del árbol de componentes, lo que facilita la navegación y la inspección de diseños amplios o anidados profundamente sin perder el contexto.
  2. Desplazamiento automático en la selección: Cuando selecciones un elemento en el árbol de componentes, la vista se desplazará automáticamente, tanto horizontal como verticalmente, para enfocar el elemento seleccionado. Esto garantiza que el elemento que te interesa siempre esté al frente y en el centro.
  3. Visualización de relaciones mejorada: Perfeccionamos las líneas de soporte dentro del árbol de componentes para ofrecer indicadores visuales más explícitos que permitan comprender las relaciones entre los nodos. Las líneas punteadas ahora indican claramente una relación de pila de llamadas entre un nodo principal y su nodo secundario, lo que te ayuda a rastrear las conexiones programáticas de manera más eficaz. Las líneas continuas siguen representando todas las demás relaciones estándar entre elementos superiores y secundarios dentro del árbol.

El objetivo de estas mejoras es proporcionar una experiencia de depuración más fluida y eficiente, lo que te permitirá comprender y definir mejor tu IU rápidamente.

El árbol de componentes del Inspector de diseño incorporado ahora admite el desplazamiento horizontal y el desplazamiento automático en la selección.
Mejora del árbol de componentes del Inspector de diseño incorporado

Cómo usar un LLM local

La versión 4 de Android Studio Narwhal Feature Drop te permite elegir el LLM que potencia las funciones basadas en IA del IDE.

Ventana de chat de Gemini en Android Studio que muestra el selector de modelos con opciones para Gemini y un LLM local.
Selector de modelos en Android Studio.

El LLM debe estar en tu máquina local, lo que es ventajoso si tienes conectividad a Internet limitada o restricciones con respecto al uso de modelos de IA, o si solo quieres experimentar con modelos de investigación de código abierto.

Un LLM local ofrece una alternativa a la compatibilidad con LLM integrada en Android Studio. Sin embargo, Gemini en Android Studio suele proporcionar la mejor experiencia de desarrollo de Android, ya que Gemini está optimizado para Android y admite todas las funciones de Android Studio. Con Gemini, puedes elegir entre una variedad de modelos para tus tareas de desarrollo de Android, incluido el modelo predeterminado sin costo o los modelos a los que se accede con una clave de API de Gemini pagada.

Para admitir LLM locales, se requiere la instalación de un proveedor de LLM, como LM Studio o Ollama, en tu computadora local junto con un modelo compatible de tu elección.

El Asistente de actualización del SDK de Android ahora admite Android 16 / API 36

Se agregó la migración de Android 15 (API 35) a Android 16 (API 36) al Asistente de actualización del SDK de Android. Para obtener ayuda con la migración, ve a Tools > Android SDK Upgrade Assistant.

Complemento de Android para Gradle 9.0

El complemento de Android para Gradle 9.0 es una nueva versión principal del AGP que incluye cambios en el comportamiento y la API.

Para actualizar al complemento de Android para Gradle 9.0.0-alpha02, usa el Asistente de actualización del complemento de Android para Gradle en Android Studio Narwhal 4 Feature Drop | 2025.1.4.

El asistente de actualización del AGP ayuda a conservar los comportamientos existentes cuando actualizas tu proyecto, si es apropiado, lo que te permite actualizar tu proyecto para usar AGP 9.0, incluso si no estás listo para adoptar todos los nuevos valores predeterminados en AGP 9.0.

Compatibilidad

El nivel máximo de API de Android que admite el complemento de Android para Gradle 9.0.0-alpha02 es el nivel de API 36.

El complemento de Android para Gradle 9.0.0-alpha02 requiere Gradle 9.0.0.

Cambios en el comportamiento

El complemento de Android para Gradle 9.0 tiene los siguientes comportamientos nuevos:

Comportamiento Recomendación
El complemento de Android para Gradle 9.0 usa la versión r28c del NDK de forma predeterminada. Considera especificar explícitamente la versión del NDK que deseas usar.
De forma predeterminada, el complemento de Android Gradle 9.0 requiere que los consumidores de una biblioteca usen la misma versión del SDK de compilación o una superior. Usa el mismo SDK de compilación o uno superior cuando consumas una biblioteca. Si esto no es posible o quieres darles más tiempo a los consumidores de una biblioteca que publicas para que cambien, establece AarMetadata.minCompileSdk de forma explícita.

AGP 9.0 incluye actualizaciones en los valores predeterminados de las siguientes propiedades de Gradle. Esto te permite conservar el comportamiento de AGP 8.13 cuando realices la actualización:

Propiedad Función Cambio de AGP 8.13 a AGP 9.0 Recomendación
android.uniquePackageNames Exige que cada biblioteca tenga un nombre de paquete distinto. falsetrue Especifica nombres de paquetes únicos para todas las bibliotecas de tu proyecto. Si eso no es posible, puedes inhabilitar esta marca mientras realizas la migración.
android.dependency.useConstraints Controla el uso de restricciones de dependencia entre configuraciones.
El valor predeterminado en AGP 9.0 es false, que solo usa restricciones en las pruebas de dispositivos de la aplicación (AndroidTest). Si se establece en true, se volverá al comportamiento de la versión 8.13.
truefalse No uses restricciones de dependencia en todas partes, a menos que las necesites. Aceptar el nuevo valor predeterminado de esta marca también habilita optimizaciones en el proceso de importación del proyecto, lo que debería reducir el tiempo de importación de las compilaciones con muchos subproyectos de bibliotecas de Android.
aandroid.enableAppCompileTimeRClass Compila código en aplicaciones con una clase R no final, lo que alinea la compilación de la aplicación con la compilación de la biblioteca.
Esto mejora la incrementalidad y allana el camino para futuras optimizaciones del rendimiento en el flujo de procesamiento de recursos.
falsetrue Muchos proyectos pueden adoptar el nuevo comportamiento sin cambios en el código fuente. Si los campos de la clase R se usan en cualquier lugar que requiera una constante, como los casos de cambio, refactoriza para usar sentencias if encadenadas.
android.sdk.defaultTargetSdkToCompileSdkIfUnset Usa la versión del SDK de compilación como valor predeterminado para la versión del SDK de destino en apps y pruebas.
Antes de este cambio, la versión del SDK de destino se establecía de forma predeterminada en la versión del SDK mínimo.
falsetrue Especifica la versión del SDK de destino de forma explícita para las apps y las pruebas.
android.onlyEnableUnitTestForTheTestedBuildType Solo crea componentes de pruebas de unidades para el tipo de compilación probado.
En el proyecto predeterminado, esto genera una sola prueba de unidades para la depuración, mientras que el comportamiento anterior era ejecutar pruebas de unidades para la depuración o la versión.
falsetrue Si tu proyecto no requiere que se ejecuten pruebas para la versión de depuración y la de lanzamiento, no es necesario realizar ningún cambio.
android.proguard.failOnMissingFiles Si alguno de los archivos de conservación especificados en el DSL de AGP no existe en el disco, la compilación falla con un error. Antes de este cambio, los errores de escritura en los nombres de los archivos hacían que estos se ignoraran de forma silenciosa. falsetrue Quita las declaraciones de archivos ProGuard no válidas
android.r8.optimizedResourceShrinking Permite que R8 conserve menos recursos de Android, ya que considera las clases y los recursos de Android en conjunto. falsetrue Si las reglas de conservación de tu proyecto ya están completas, no es necesario que realices ningún cambio.
android.r8.strictFullModeForKeepRules Permite que R8 conserve menos elementos, ya que no conserva de forma implícita el constructor predeterminado cuando se conserva una clase. Es decir, -keep class A ya no implica -keep class A { <init>(); }
.
falsetrue Si las reglas de conservación de tu proyecto ya están completas, no es necesario que realices ningún cambio.

Reemplaza -keep class A por -keep class A { <init>(); } en las reglas de conservación de tu proyecto para los casos en los que necesites que se conserve el constructor predeterminado.
android.defaults.buildfeatures.shaders Habilita la compilación de sombreadores en todos los subproyectos. truefalse Habilita la compilación de sombreadores solo en los subproyectos que contengan sombreadores para compilar estableciendo lo siguiente en los archivos de compilación de Gradle de esos proyectos:
android {
  buildFeatures {
    shaders = true
  }
}

Funciones quitadas

El complemento de Android para Gradle 9.0 quita las siguientes funciones:

DSL cambiada

El complemento de Android para Gradle 9.0 incluye los siguientes cambios rotundos en el DSL:

Se quitó la DSL

El complemento de Android para Gradle 9.0 quita lo siguiente:

Se quitaron propiedades de Gradle

Inicialmente, las siguientes propiedades de Gradle se agregaron como formas de inhabilitar de manera global las funciones que estaban habilitadas de forma predeterminada.

Estas funciones están inhabilitadas de forma predeterminada desde AGP 8.0 o versiones anteriores. Habilita estas funciones solo en los subproyectos que las usen para lograr una compilación más eficiente.

Propiedad Función Reemplazo
android.defaults.buildfeatures.aidl Habilita la compilación de AIDL en todos los subproyectos. Habilita la compilación de AIDL solo en los subproyectos en los que haya fuentes de AIDL. Para ello, configura la siguiente propiedad en los archivos de compilación de Gradle de esos proyectos:
android {
  buildFeatures {
    aidl = true
  }
}
en el archivo de compilación de Gradle de cada subproyecto que contenga fuentes de AIDL
android.defaults.buildfeatures.renderscript Habilita la compilación de RenderScript en todos los subproyectos Habilita la compilación de RenderScript solo en los subproyectos en los que haya fuentes de RenderScript. Para ello, configura la siguiente propiedad en los archivos de compilación de Gradle de esos proyectos:
android {
  buildFeatures {
    renderScript = true
  }
}

APIs que se quitaron

El complemento de Android para Gradle 9.0 quita lo siguiente:

  • Las APIs de BaseExtension.registerTransform inhabilitadas y obsoletas, que solo permanecieron para permitir la compilación con la versión más reciente de AGP mientras se segmentaba para ejecutarse en AGP 4.2 o versiones anteriores.

Propiedades de Gradle aplicadas

AGP 9.0 arroja un error si estableces las siguientes propiedades de Gradle.

El Asistente de actualización del complemento de Android para Gradle no actualizará los proyectos a la versión 9.0 del AGP que usen estas propiedades.

Propiedad Función
android.r8.integratedResourceShrinking La reducción de recursos ahora siempre se ejecuta como parte de R8. Se quitó la implementación anterior.