Guía de migración
Consulta la guía de migración de AGP 9 para conocer los cambios importantes, muchos de ellos incompatibles, en AGP 9 en comparación con AGP 8.
Requisitos
Si el usuario solicita actualizar o migrar a AGP 9, primero verifica la versión de AGP utilizada en el proyecto. Si es inferior a 9, detente y pide al usuario que ejecute el Asistente de Actualización de AGP en Android Studio para actualizar a la última versión estable de AGP, y confirma cuando esté listo. El usuario también puede solicitar que se omita este requisito; en ese caso, debes actualizar la versión de AGP a la última versión estable como parte de la migración a AGP 9. Consulta la guía de migración de AGP 9 para saber cómo hacerlo.
Cada versión de AGP tiene su propio conjunto de compatibilidades con otras herramientas, como Gradle, JDK y Kotlin. Las notas de la versión para cada una de estas versiones incluirán una tabla de Compatibilidad que indica las versiones mínimas para estas herramientas.
No uses esta habilidad para proyectos KMP, ya que no son compatibles.
Pasos
Si AGP ya está en la versión 9 o superior, sigue estos pasos:
Paso 1: Actualizar dependencias
Si KSP (com.google.devtools.ksp) se utiliza en el proyecto, asegúrate de que esté en la versión 2.3.6 o superior.
Si Hilt se utiliza en el proyecto, asegúrate de que esté en la versión 2.59.2 o superior.
Paso 2: Migrar a Kotlin integrado
Consulta la guía para obtener información detallada.
Paso 3: Migrar al nuevo DSL de AGP
Consulta la guía para obtener información detallada.
Consulta también gradle-recipes para ejemplos sobre cómo migrar código antiguo a código compatible con AGP 9 y el nuevo DSL.
Paso 4: Migrar kapt a KSP o legacy-kapt
Si KSP (com.google.devtools.ksp) o kapt (org.jetbrains.kotlin.kapt) se utilizan en el proyecto, consulta KSP, kapt y legacy-kapt para conocer los pasos de migración detallados.
Paso 5: BuildConfig
Si algún módulo de Android contiene campos personalizados de BuildConfig, consulta BuildConfig para obtener información detallada.
Paso 6: Actualizar gradle.properties
Después de la migración, revisa gradle.properties. Elimina los siguientes indicadores:
- android.builtInKotlin
- android.newDsl
- android.uniquePackageNames
- android.enableAppCompileTimeRClass
Adicionalmente, elimina todos los archivos temporales que hayas creado.
Directrices
- Nunca escribas ni ejecutes scripts de Python.
- Solo busca en el caché de dependencias de Gradle al inspeccionar dependencias externas, y solo como último recurso.
- Nunca agregues
android.disallowKotlinSourceSets=falseagradle.properties. - Al verificar cambios, no ejecutes la tarea
clean. Es una pérdida de tiempo.
Verificación
Después de la migración, verifica lo siguiente:
- La sincronización de Gradle en el IDE se completa correctamente.
./gradlew helpse ejecuta correctamente../gradlew build --dry-runse ejecuta correctamente.
Solución de problemas
Paparazzi v2.0.0-alpha04 y versiones anteriores tienen problemas con AGP 9. Consulta references/paparazzi-gradle-9.md para obtener más detalles.