Capacitor Solución del error de construcción de Plugin AGP 9

Si su Capacitor plugin dejó de funcionar después de actualizar a Android Gradle Plugin 9 (AGP 9), probablemente esté golpeando un pequeño pero crítico problema de configuración de Gradle.

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

Capacitor error de compilación de plugin AGP 9
Error de compilación de plugin de Android Gradle Plugin 9
proguard-android.txt no encontrado
AGP 9 getDefaultProguardFile error
Capacitor error de compilación de Android después de la actualización de AGP

The short version:

proguard-android.txt Ya no es la referencia de seguridad por defecto para utilizar en compilaciones de plugins de AGP 9.
Switch to proguard-android-optimize.txt.
Rebuild and verify.

La versión más 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 liberación?
El cambio exacto de AGP 9 que rompe los antiguos modelos de plantilla de plugins
Una estrategia de migración segura para un repositorio o muchos repositorios

What is Android in this context?

¿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, .apko .aab salidas.

Cuando cambian las 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 base removida o obsoleta.

¿Qué es Capacitor?

Capacitor es una plataforma transversal que te permite construir aplicaciones iOS/Android con web code (TypeScript, JavaScript, HTML, CSS) mientras aún puedes llamar a APIs nativas.

Capacitor

Las aplicaciones __CAPGO_KEEP_0__ suelen incluir:
Un capa web (tu interfaz de usuario y lógica de negocio)ios/, android/)
Conchas nativas (

Plugins que exponen características nativas a JavaScript android/build.gradle Cada plugin tiene su propia configuración de compilación nativa. En Android, esto significa que cada plugin incluye un

If plugin Gradle settings are outdated, the whole app build can fail, even when your web code is correct.

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 Capgo es correcta.

¿Qué es Capgo? Capacitor 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 actualización amigables con CI/CD para Capacitor equipos

Incluso con actualizaciones en vivo, la estabilidad de compilación nativa no es negociable. Todavía necesitas compilaciones de Android limpias para:

Lanzamientos de la Tienda de Aplicaciones / Tienda de Juegos
Actualizaciones de plugins nativos
Migraciones de plataforma SDK
Incorporación de equipo y confiabilidad de CI

Por eso, los arreglos de compatibilidad con AGP 9 son importantes: mantienen tu capa de plugin confiable para que los flujos de entrega sean predictibles.

Por qué AGP 9 rompe las configuraciones de plugins más antiguas

Muchos modelos de plugins utilizaron históricamente:

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

In 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 la assemble, lint, o build fases, a menudo apuntando a recursos de línea base de ProGuard faltantes o referencias de archivo predeterminado 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 son las reglas de conservación personalizadas de su proyecto/plugin.
getDefaultProguardFile(...) inyecta una línea base proporcionada por Android.

Cuando se refiere a:

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

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

La solución de una línea

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

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

Al menos, verifique:

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

Guía de migración para un plugin

1. Encuentre la referencia antigua

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

2. Reemplácela

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

3. Verifique con Bun

bun run verify:android

If su plugin tiene scripts de verificación completos, ejecuta:

bun run verify

Actualizar en lote todos los repositorios de plugins

Si mantienes muchos repositorios de plugins en un workspace, automatízalo:

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"

Entonces, valida 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 referencia de línea base antigua ha desaparecido de los archivos de plugin rastreados.

Capgo estado de lanzamiento

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

Los módulos de Android de los plugins ahora se refieren a proguard-android-optimize.txt
Las aplicaciones de ejemplo 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 fallas de actualización de AGP 9 antes de que lleguen a CI.

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

You no podrías ver fallas inmediatamente si:

Tu caché de CI todavía oculta el problema
Tienes versiones mixtas de AGP en proyectos
Sólo algunas módulos se recompilan en desarrollo local

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

Resolviendo problemas si los compilados todavía fallan después de la reemplazo

Verifica estos puntos:

Cada módulo está parcheado. Mira a los módulos de plugins, módulos de aplicación, muestras y activos de plantilla.
No hay segunda referencia en scripts compartidos. Busca en todo el repositorio (incluyendo scripts Gradle personalizados).
Las cachés están limpias. Ejecuta ./gradlew clean y reconstruye.
Las versiones de AGP / Gradle / JDK están alineadas. Utiliza combinaciones soportadas por la documentación de Android para tu versión de AGP.
Utiliza la misma versión que local. Pin las versiones de JDK y Gradle wrapper en CI para evitar el desplazamiento 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: AGP 9 Capacitor errores de compilación del plugin

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

Sustituye:

getDefaultProguardFile('proguard-android.txt')

Por:

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

Luego realiza una reconstrucción limpia.

¿Por qué mi Capacitor plugin de compilación falla después de actualizar a Android Gradle Plugin 9?

La mayoría de las fallas provienen de la configuración de Gradle legado en los archivos del plugin android/build.gradle que aún hacen referencia a proguard-android.txt. Proyectos AGP 9 deben utilizar proguard-android-optimize.txt.

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

Use 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 Android (aplicación o biblioteca) que utilice referencias de ProGuard de línea base obsoletas puede generar errores de compilación similares en 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
Archivo de ProGuard de Android Gradle Plugin 9 faltante
Compilación de plugin Capacitor de Android fallida
proguard-android.txt reemplazo
proguard-android-optimize.txt migración

Desarrolladores de Android: Resumen de la construcción de tu aplicación
Android Gradle Plugin: Notas de lanzamiento
Android code reducción de tamaño: R8 y reglas
Documentación de Gradle: Fundamentos de herramientas de construcción
Capacitor documentación: Documentación oficial
Capgo documentos: Actualización automática de documentos

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 compilados de Android vuelven a ser predecibles.

If you use Capgo plugins, this migration is already applied in official repositories so you can upgrade with fewer surprises.

Capacitor plugins, esta migración ya se ha aplicado en repositorios oficiales, por lo que puede actualizar con menos sorpresas.

Sigue adelante desde el Capacitor Plugin AGP 9 Error de compilación de Android Si está utilizando el plugin de compilación de Android de AGP 9 para planificar la automatización de CI/CD, conectéalo con Capgo Integración CI/CD para el flujo de trabajo del producto en Capgo Integración CI/CD, Capgo Compilaciones Nativas para el flujo de trabajo del producto en Capgo Compilaciones Nativas, Capgo Integraciones para el flujo de trabajo del producto en Capgo Integraciones, Integración CI/CD para el detalle de implementación en Integración CI/CD, y GitHub Integración de Acciones para el detalle de implementación en GitHub Integración de Acciones.

Capacitor Error de compilación del plugin AGP 9: solución rápida