Troubleshooting

Troubleshooting

❌ Error: La ruta no existe

La ruta que pasaste como primer argumento no existe. Verifica el path al proyecto o al módulo. Recuerda que puedes usar . si ya estás dentro del directorio.

❌ Motor 'dynamic' falló: ...

El motor dinámico (--engine dynamic o auto) no pudo configurar el build. Causas habituales:

• No hay JDK disponible o no está en el PATH.
• No existe el wrapper de Gradle (gradlew / gradlew.bat) en la raíz del proyecto.
• El build del proyecto falla al configurar.

Solución: usa el motor estático (--engine static, el default) — no necesita JDK ni wrapper y solo lee texto. Ver Motor estático vs dinámico.

No detecta algunas dependencias

• Para archivos .kts, instala el parser AST: pip install tree-sitter tree-sitter-kotlin (o pipx install "android-gradle-analyzer[kts]"). Sin él, los .kts se parsean con regex y pueden escaparse casos multilínea o comentados.
• Para .gradle, el preprocesador ya maneja multilínea y comentarios. Si el problema persiste, revisa los scopes reconocidos en analyzer_utils.py (constante DEPENDENCY_SCOPES).
• Si quieres precisión total con Version Catalogs, variables o convention plugins, usa --engine dynamic sobre un repo de confianza.

El menú no arranca tras clonar

Instala el paquete en modo editable: pip install -e . (o pip install -e ".[kts,yaml]" para todas las features opcionales).

Diagrama apretado / líneas cruzadas

Sube los valores de espaciado en gradle_analyzer.py (generate_plantuml()). Ver la tabla de espaciado en Cómo funciona. Para proyectos grandes, también puedes acotar el grafo con gradle-analyzer <ruta> --focus <modulo> o analizar submódulos por separado.

El analyzer.yml no se aplica

• Requiere pyyaml: pip install "android-gradle-analyzer[yaml]". Si no está instalado, el yml se ignora sin error.
• El yml se busca en la ruta que pasas como primer argumento, no en el CWD.
• Recuerda que los flags de CLI siempre ganan sobre el yml. Ver Configuración.