Troubleshooting

Troubleshooting

❌ Error: La ruta no existe

The path you passed as the first argument does not exist. Check the path to the project or module. Remember you can use . if you're already inside the directory.

❌ Motor 'dynamic' falló: ...

The dynamic engine (--engine dynamic or auto) could not configure the build. Common causes:

• No JDK available or not on PATH.
• No Gradle wrapper (gradlew / gradlew.bat) at the project root.
• The project build fails during configuration.

Solution: use the static engine (--engine static, the default) — it requires no JDK or wrapper and only reads text. See Static vs Dynamic Engine.

Some dependencies are not detected

• For .kts files, install the AST parser: pip install tree-sitter tree-sitter-kotlin (or pipx install "android-gradle-analyzer[kts]"). Without it, .kts files are parsed with regex and multiline or commented-out cases may be missed.
• For .gradle files, the preprocessor already handles multiline and comments. If the problem persists, check the recognized scopes in analyzer_utils.py (constant DEPENDENCY_SCOPES).
• For full accuracy with Version Catalogs, variables, or convention plugins, use --engine dynamic on a trusted repo.

The menu doesn't start after cloning

Install the package in editable mode: pip install -e . (or pip install -e ".[kts,yaml]" for all optional features).

Diagram is too cramped / lines cross

Increase the spacing values in gradle_analyzer.py (generate_plantuml()). See the spacing table in How it works. For large projects, you can also scope the graph with gradle-analyzer <path> --focus <module> or analyze submodules separately.

analyzer.yml is not applied

• Requires pyyaml: pip install "android-gradle-analyzer[yaml]". If not installed, the yml is silently ignored without error.
• The yml is looked up from the path you pass as the first argument, not from the CWD.
• Remember that CLI flags always override the yml. See Configuration.