Plugin de Capacitor Error de compilación con AGP 9

Si su Capacitor Este post se centra específicamente en intenciones de búsqueda comunes como:

__CAPGO_KEEP_0__ plugin build error AGP 9

Capacitor plugin build error AGP 9
No encontrado
proguard-android.txt AGP 9
plugin de Android Gradle 9 falló al compilar getDefaultProguardFile error
Capacitor El error de compilación de Android falló después de la actualización de AGP

La versión corta:

proguard-android.txt Ya no es la referencia de línea base segura por defecto para referencias en compilaciones de plugins de AGP 9.
Switch a proguard-android-optimize.txt.
Reconstruya y verifique.

La versión larga también importa, especialmente si mantienes muchos plugins o grandes Capacitor espacios de trabajo. En este artículo cubrimos:

¿Qué son Android y AGP en la cadena de compilación?
¿Qué es Capacitor y cómo funcionan las compilaciones de plugins?
¿Qué Capgo es y por qué esto importa para la confiabilidad de la versión de lanzamiento
El cambio exacto de AGP 9 que rompe las plantillas de plugin antiguas
Una estrategia de migración segura para un repositorio o muchos repositorios

¿Qué es Android en este contexto?

Android es tanto un sistema operativo como un ecosistema de compilación. Cuando envíes una aplicación o plugin Capacitor en Android, tu proyecto pasa por:

Gradle como sistema de compilación.
Android Gradle Plugin (AGP) como integración de Gradle específica de Android.
La herramienta de cadena de herramientas de Android SDK para empaquetar, reducir, analizar y producir .aar, .apk, o .aab salidas.

When los cambios de versiones de AGP, algunos valores por defecto y archivos internos pueden cambiar también. Una configuración de plugin que funcionó para AGP 8 puede fallar en AGP 9 si apunta a una línea base eliminada o obsoleta.

What es Capacitor?

Capacitor es un tiempo de ejecución transversal de la plataforma que te permite crear aplicaciones iOS/Android con web code (TypeScript, JavaScript, HTML, CSS) mientras aún llamas a APIs nativas.

Los aplicaciones Capacitor suelen incluir:

Una capa web (tu interfaz de usuario y lógica de negocio)
Conchas nativas (ios/, android/)
Plugins que exponen características nativas a JavaScript

Cada plugin tiene su propia configuración de compilación nativa. En Android, esto significa que cada plugin incluye un android/build.gradle archivo que AGP debe parsear y compilar correctamente.

Si los ajustes de Gradle de los plugins están desactualizados, la compilación de toda la aplicación puede fallar, incluso cuando tu web code es correcta.

What es Capgo?

Capgo proporciona herramientas alrededor de la entrega y operaciones de Capacitor:

Actualizaciones en vivo para cambios en el paquete de la web
ecosistema de plugins y paquetes de características nativas
Flujos de trabajo de actualizaciones amigables con CI/CD para equipos de Capacitor

Si bien las actualizaciones en vivo son importantes, la estabilidad de la compilación nativa no es negociable. Todavía necesitas compilaciones de Android limpias para:

Lanzamientos de App Store / Play Store
Actualizaciones de plugins nativos
Migraciones de plataforma SDK
Adquisición de equipo y confiabilidad de CI

Por eso, los arreglos de compatibilidad con AGP 9 son importantes: mantienen la capa de plugins fiable para que los flujos de entrega sean predecibles.

Why AGP 9 breaks older plugin configs

Muchas plantillas de plugins históricamente usaron:

proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'

In las configuraciones de AGP 9, esta referencia de línea base legada puede fallar porque el archivo antiguo ya no está garantizado en la ubicación esperada por las plantillas/configuraciones más antiguas.

Los síntomas típicos incluyen errores de Gradle durante assemble, lint, o build etapas, a menudo apuntando a recursos de línea base de ProGuard faltantes o referencias de archivo predeterminadas inválidas.

Antecedentes rápidos: ProGuard, R8 y archivos de línea base

R8 es el moderno code reductor/optimizador en compilaciones de Android.
proguard-rules.pro es sus reglas de conservación personalizadas para el proyecto/plugin.
getDefaultProguardFile(...) injecta una línea base proporcionada por Android.

Cuando se hace referencia a:

proguard-android.txt -> legado, línea base mínima
proguard-android-optimize.txt -> línea base moderna optimizada (recomendado por defecto en configuraciones actuales)

Para la compatibilidad con AGP 9, cambiar a proguard-android-optimize.txt es la solución práctica.

La solución de una sola línea

Actualizar archivos de Gradle de plugin y módulo de aplicación:

proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'

Al menos, compruebe:

android/build.gradle en cada plugin
example-app/android/app/build.gradle en repositorios de plugins
Cualquier archivo de generador/plantilla que cree una nueva configuración de Gradle de plugin

Guía de migración para un plugin

1. Encuentre la referencia antigua

rg -n "proguard-android\\.txt" android example-app

Sustitúyelo

perl -pi -e "s/proguard-android\\.txt/proguard-android-optimize.txt/g" \
  android/build.gradle example-app/android/app/build.gradle

3. Verificar con Bun

bun run verify:android

Si su plugin tiene scripts de verificación completos, ejecute:

bun run verify

Actualice en lote todos los repositorios de plugin

Si mantiene muchos repositorios de plugin en un workspace, automatícelo:

rg -l "proguard-android\\.txt" capacitor-* \
  --glob '!**/node_modules/**' \
  --glob '!**/.gradle/**' \
  --glob '!**/build/**' \
| xargs perl -pi -e "s/proguard-android\\.txt/proguard-android-optimize.txt/g"

Luego valide que ninguna fuente de plugin rastreada aún utilice el archivo antiguo:

for d in capacitor-*; do
  [ -d "$d/.git" ] || continue
  git -C "$d" grep -n "proguard-android\\.txt" -- || true
done

No hay coincidencias significa que la referencia de línea base antigua ha desaparecido de los archivos de plugin rastreados.

Capgo status del lanzamiento

Completamos esta migración en todos los repositorios y plantillas de plugin oficiales Capgo Capacitor:

Las módulos de Android de los plugins ahora hacen referencia a proguard-android-optimize.txt
Los ejemplos de aplicaciones de Android de los plugins se actualizaron también
Las plantillas de scaffolding de los plugins se actualizaron para que los nuevos plugins sean seguros por defecto con AGP 9

Esto evita una clase común de errores de actualización de AGP 9 antes de que lleguen a CI.

¿Por qué esto es importante incluso si tu compilación pasa hoy?

Es posible que no veas errores inmediatamente si:

Tu caché de CI aún oculta el problema.
Tienes versiones mixtas de AGP en proyectos.
Solo algunas módulos se recompilan en desarrollo local.

Pero eventualmente, compilaciones limpias, nuevos entornos o ejecutores actualizados lo revelan. Hacer la migración ahora elimina la inestabilidad oculta.

Solucionar problemas si las compilaciones siguen fallando después de la sustitución

Verifica estos puntos:

Todos los módulos están parcheados. Mira los módulos de plugins, los módulos de la aplicación, las muestras y los activos de plantilla.
No hay una segunda referencia en scripts compartidos. Busca en todo el repositorio (incluyendo scripts de Gradle personalizados).
Las cachés están limpias. Ejecuta ./gradlew clean y reconstruir.
Las versiones de AGP / Gradle / JDK están alineadas. Utilice combinaciones admitidas por la documentación de Android para su versión de AGP.
El CI utiliza las mismas versiones que la local. Pin las versiones de JDK y wrapper de Gradle en el CI para evitar la deriva del entorno.
No estás parcheando solo node_modules. Corrige la fuente del plugin rastreado, no los directorios de dependencias transitorias.

Preguntas frecuentes de SEO: errores de compilación de plugin en AGP 9 Capacitor

Cómo arreglo `proguard-android.txt` No se encuentra en AGP 9?

Sustituye:

getDefaultProguardFile('proguard-android.txt')

Por:

getDefaultProguardFile('proguard-android-optimize.txt')

Luego ejecuta una reconstrucción limpia.

¿Por qué mi Capacitor plugin falla al compilar después de actualizar a Android Gradle Plugin 9?

La mayoría de los errores provienen de la configuración de Gradle heredada en el plugin. android/build.gradle los archivos que aún se refieren a proguard-android.txt. Los proyectos de AGP 9 deben utilizar proguard-android-optimize.txt.

¿Cuál es el camino de migración más rápido de AGP 9 para muchos plugins Capacitor?

Utilice un comando de búsqueda y reemplazo en todo el workspace, luego valide con git grep y ejecute bun run verify:android en plugins representativos.

¿Es esto solo un problema de Capacitor?

No. Cualquier módulo de Android (aplicación o biblioteca) que utilice referencias de ProGuard de línea base obsoletas puede tener errores de compilación similares de AGP 9. Es especialmente visible en ecosistemas de plugins porque muchos repositorios comparten plantillas antiguas.

¿Cuáles son las palabras clave relevantes para esta migración?

Si está documentando esto en runbooks internos o páginas de soporte, incluya términos como:

error de compilación de AGP 9
Plugin de Gradle para Android 9 archivo ProGuard faltante
Capacitor plugin falla en la compilación de Android
proguard-android.txt reemplazo
proguard-android-optimize.txt migración

Desarrolladores de Android: Resumen de la compilación de tu aplicación
Plugin de Gradle para Android: Notas de lanzamiento
Shrinking de Android code: R8 y reglas
Documentación de Gradle: Fundamentos de herramientas de construcción
Capacitor documentación: Documentación oficial
Capgo documentación: Documentación de actualización automática

Conclusión final

Este problema de AGP 9 es simple, pero es fácil de pasar por alto en entornos de trabajo con múltiples plugins. Una vez que reemplaces proguard-android.txt con proguard-android-optimize.txt en todos los lugares relevantes, los builds de Android vuelven a ser predecibles.

Si utilizas plugins de Capgo, esta migración ya se ha aplicado en repositorios oficiales, por lo que puedes actualizar con menos sorpresas.

Sigue adelante desde la solución de errores de construcción de AGP 9 para plugins de Capacitor

Si estás utilizando Capacitor Plugin Error de Construcción de AGP 9 para planificar la automatización de CI/CD, conectarlo con Capgo Automatización de CI/CD para el flujo de trabajo del producto en Capgo Automatización de CI/CD, Capgo Construcción Nativa para el flujo de trabajo del producto en Capgo Construcción Nativa, Capgo Integraciones para el flujo de trabajo del producto en Capgo Integraciones, Integración de CI/CD para el detalle de implementación en Integración de CI/CD, y GitHub Integración de Acciones para el detalle de implementación en GitHub Integración de Acciones.

Capacitor Solución de errores de compilación del plugin AGP 9