Si tu Capacitor plugin empezó a fallar después de actualizar a Android Gradle Plugin 9 (AGP 9), probablemente estás encontrando un pequeño pero crítico problema de configuración de Gradle.
Esta publicación se centra específicamente en intenciones de búsqueda comunes como:
- error de build del plugin Capacitor con AGP 9
- Android Gradle Plugin 9: el build del plugin falló
proguard-android.txtno encontrado- AGP 9
getDefaultProguardFileerror - Capacitor Error de compilación de Android tras actualizar AGP
La versión corta:
proguard-android.txtya no es la línea base segura por defecto para referenciar en builds de plugins de AGP 9.- Cambia a
proguard-android-optimize.txt. - Recompila y verifica.
La versión larga también importa, sobre todo si mantienes muchos plugins o grandes workspaces de Capacitor. En este artículo veremos:
- Qué son Android y AGP en la cadena de build
- Qué es Capacitor y cómo funcionan los builds de plugins
- Qué Capgo es y por qué importa para la fiabilidad de los releases
- El cambio exacto de AGP 9 que rompe las plantillas de plugins antiguas
- Una estrategia de migración segura para uno o varios repos
¿Qué es Android en este contexto?
Android es tanto un sistema operativo como un ecosistema de build. Al lanzar una app o plugin Capacitor en Android, tu proyecto pasa por:
- Gradle como sistema de build.
- Android Gradle Plugin (AGP) como integración de Gradle específica de Android.
- La toolchain de Android SDK para empaquetar, reducir, hacer lint y generar
.aar,.apk, o.aabsalidas.
Cuando cambian las versiones de AGP, algunos valores predeterminados y archivos internos también pueden cambiar. Una configuración de plugin que funcionaba con AGP 8 puede fallar en AGP 9 si apunta a una baseline eliminada o deprecada.
¿Qué es Capacitor?
Capacitor es un runtime multiplataforma que te permite construir apps para iOS/Android con code web (TypeScript, JavaScript, HTML, CSS) mientras sigues llamando a APIs nativas.
Las apps de Capacitor suelen incluir:
- Una capa web (tu UI y lógica de negocio)
- Shells nativos (
ios/,android/) - Plugins que exponen funciones nativas a JavaScript
Cada plugin tiene su propia configuración de build nativo. En Android, esto significa que cada plugin incluye un android/build.gradle archivo que AGP debe analizar y compilar correctamente.
Si la configuración de Gradle del plugin está desactualizada, el build de toda la app puede fallar, incluso si tu web code es correcta.
¿Qué es Capgo?
Capgo ofrece herramientas para la entrega y operaciones de Capacitor:
- Actualizaciones en vivo para cambios en el bundle web
- Ecosistema de plugins y paquetes de funciones nativas
- Flujos de actualización para CI/CD ideales para equipos de Capacitor
Incluso con live updates, la estabilidad del Native Build es innegociable. Aun así, necesitas builds de Android limpios para:
- Lanzamientos en App Store / Play Store
- Actualizaciones de plugins nativos
- Migraciones de plataforma de SDK
- Onboarding del equipo y fiabilidad de CI
Por eso es clave la compatibilidad con AGP 9: mantiene tu capa de plugins confiable para que tus pipelines de entrega sean predecibles.
Por qué AGP 9 rompe las configs de plugins antiguos
Históricamente, muchas plantillas de plugins usaban:
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
En configuraciones con AGP 9, esta referencia legacy al baseline puede fallar porque el archivo antiguo ya no está garantizado en la ubicación que esperan las plantillas/configs antiguas.
Los síntomas típicos incluyen errores de Gradle durante assemble, lint, o build fases, que suelen indicar recursos de línea base de ProGuard faltantes o referencias de archivo predeterminado no válidas.
Contexto rápido: ProGuard, R8 y archivos baseline
- R8 es el code shrinker/optimizer moderno en builds de Android.
proguard-rules.proson las reglas de keep personalizadas de tu proyecto/plugin.getDefaultProguardFile(...)inyecta una baseline proporcionada por Android.
Cuando haces referencia a:
proguard-android.txt-> legacy, baseline mínimaproguard-android-optimize.txt-> baseline moderna optimizada (default recomendado en los setups actuales)
Para compatibilidad con AGP 9, cambiar a proguard-android-optimize.txt es la solución práctica.
La solución en una línea
Update plugin and app module Gradle files:
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
Como mínimo, verifica:
android/build.gradleen cada pluginexample-app/android/app/build.gradleen los repositorios de plugins- Cualquier archivo de generador/plantilla que cree una nueva configuración Gradle para plugins
Guía de migración para un plugin
1. Encuentra la referencia antigua
rg -n "proguard-android\\.txt" android example-app
2. Reemplázala
perl -pi -e "s/proguard-android\\.txt/proguard-android-optimize.txt/g" \
android/build.gradle example-app/android/app/build.gradle
3. Verifica con Bun
bun run verify:android
Si tu plugin tiene scripts de verificación completos, ejecuta:
bun run verify
Actualización masiva de todos los repos de plugins
Si mantienes varios repositorios de plugins en un solo 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"
Luego valida que ninguna fuente de plugin rastreada siga usando el archivo antiguo:
for d in capacitor-*; do
[ -d "$d/.git" ] || continue
git -C "$d" grep -n "proguard-android\\.txt" -- || true
done
No matches means the old baseline reference is gone from tracked plugin files.
Estado del rollout de Capgo
Completamos esta migración en todos los repositorios y plantillas oficiales de plugins de Capgo Capacitor:
- Plugin Android modules now reference
proguard-android-optimize.txt - También se actualizaron las apps de ejemplo de plugins
- Las plantillas de scaffolding de plugins se actualizaron para que los nuevos plugins sean seguros con AGP 9 por defecto
Esto evita una clase común de fallos al actualizar a AGP 9 antes de que lleguen a CI.
Por qué es importante aunque tu build pase hoy
Es posible que no veas fallos de inmediato si:
- La caché de tu CI aún oculta el problema
- Tienes versiones de AGP mezcladas entre proyectos
- Solo se reconstruyen algunos módulos en desarrollo local
Pero tarde o temprano, los clean builds, los nuevos entornos o los runners actualizados lo sacan a la luz. Migrar ahora elimina esa inestabilidad oculta.
Solución de problemas si los builds siguen fallando tras el reemplazo
Revisa estos puntos:
-
Todos los módulos están parcheados. Revisa los módulos de plugins, módulos de la app, ejemplos y assets de la plantilla.
-
No hay una segunda referencia en scripts compartidos. Busca en todos los repositorios (incluidos los scripts de Gradle personalizados).
-
Las cachés están limpias. Ejecuta
./gradlew cleany vuelve a compilar. -
Las versiones de AGP / Gradle / JDK están alineadas. Usa combinaciones compatibles según la documentación de Android para tu versión de AGP.
-
CI usa las mismas versiones que local. Fija las versiones de JDK y Gradle wrapper en CI para evitar discrepancias de entorno.
-
No estás parcheando solo
node_modules. Corrige el código fuente del plugin trackeado, no los directorios de dependencias transitorias.
SEO FAQ: errores de build de plugins en AGP 9 Capacitor
¿Cómo soluciono proguard-android.txt no encontrado en AGP 9?
Reemplaza:
getDefaultProguardFile('proguard-android.txt')
Con:
getDefaultProguardFile('proguard-android-optimize.txt')
Luego ejecuta un rebuild limpio.
¿Por qué falla el build de mi plugin Capacitor tras actualizar a Android Gradle Plugin 9?
Most failures come from legacy Gradle config in plugin android/build.gradle del plugin que aún hacen referencia a proguard-android.txt. Los proyectos con AGP 9 deberían usar proguard-android-optimize.txt.
¿Cuál es la ruta de migración a AGP 9 más rápida para muchos plugins de Capacitor?
Usa un comando de búsqueda y reemplazo en todo el workspace y valida con git grep y ejecuta bun run verify:android en plugins representativos.
¿Es esto un problema exclusivo de Capacitor?
No. Cualquier módulo de Android (app o librería) que use referencias obsoletas de baseline de ProGuard puede encontrarse con errores de build similares con AGP 9. Se nota especialmente en ecosistemas de plugins porque muchos repositorios comparten plantillas antiguas.
¿Qué palabras clave son relevantes para esta migración?
Si vas a documentar esto en runbooks internos o páginas de soporte, incluye términos como:
- error de build AGP 9
- falta el archivo ProGuard de Android Gradle Plugin 9
- falló el build de Android del plugin Capacitor
proguard-android.txtreemplazoproguard-android-optimize.txtmigración
Enlaces relacionados
- Desarrolladores de Android: Resumen del build de tu app
- Android Gradle Plugin: Notas de la versión
- Reducción de code en Android: R8 y reglas
- Docs de Gradle: Fundamentos de la herramienta de build
- Docs de Capacitor: Documentación oficial
- Docs de Capgo: Docs de actualización automática
Conclusión final
Este problema de AGP 9 es sencillo, pero es fácil pasarlo por alto en workspaces con varios plugins. Una vez que reemplaces proguard-android.txt con proguard-android-optimize.txt donde sea necesario, los builds de Android vuelven a ser predecibles.
Si usas plugins de Capgo, esta migración ya está aplicada en los repositorios oficiales para que actualices con menos sorpresas.
Continuar desde Capacitor Plugin AGP 9 Build Error Fix
Si estás usando Error de build de Capacitor Plugin con AGP 9: solución para planificar la automatización de CI/CD, conéctalo con CI/CD de Capgo para el flujo de trabajo del producto en Capgo CI/CD, Native Builds de Capgo para el flujo de trabajo del producto en Capgo Native Builds, Integraciones de Capgo para el flujo de trabajo del producto en Capgo Integraciones, Integración CI/CD para los detalles de implementación de CI/CD Integration, y Integración con GitHub Actions para los detalles de implementación de GitHub Actions Integration.