73 lines
2.4 KiB
Markdown
73 lines
2.4 KiB
Markdown
---
|
|
name: gradle_run
|
|
kind: function
|
|
lang: bash
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "gradle_run(project_dir: string, task...: string) -> int"
|
|
description: "Wrapper canonico para invocar gradlew Android en WSL2 con JDK 17 + ANDROID_HOME validados."
|
|
tags: [android, gradle, kotlin, build]
|
|
params:
|
|
- name: project_dir
|
|
desc: "Path absoluto al proyecto Gradle (debe contener gradlew)"
|
|
- name: task
|
|
desc: "Tarea(s) Gradle a ejecutar (ej. assembleDebug, :app:test). Variadic"
|
|
output: "Stdout/stderr del build Gradle. Exit code = exit code de gradlew. Exit 1 si JDK17 missing, exit 2 si no hay gradlew."
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: []
|
|
tested: false
|
|
tests: []
|
|
test_file_path: ""
|
|
file_path: "bash/functions/infra/gradle_run.sh"
|
|
notes: "Las demas funciones gradle_* lo sourcean. Reutiliza patron de adb_wsl_bash_infra para ser source-able+ejecutable. Cubre tanto SDK Linux (~/Android/Sdk via install_android_sdk) como SDK Windows (/mnt/c/...) montado en WSL."
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```bash
|
|
# Como libreria (en otro script gradle_*)
|
|
source "$(dirname "${BASH_SOURCE[0]}")/gradle_run.sh"
|
|
gradle_run "$project_dir" assembleDebug
|
|
|
|
# Directo
|
|
bash bash/functions/infra/gradle_run.sh /path/to/MyApp assembleDebug
|
|
bash bash/functions/infra/gradle_run.sh /path/to/MyApp :app:test :app:lint
|
|
```
|
|
|
|
## Comportamiento de resolucion
|
|
|
|
### JAVA_HOME
|
|
Si no esta fijado en el entorno, busca en orden:
|
|
1. `/usr/lib/jvm/java-17-openjdk-amd64`
|
|
2. `/usr/lib/jvm/temurin-17-jdk-amd64`
|
|
3. `/opt/android-studio-jbr/jbr`
|
|
|
|
Si ninguno existe → error en stderr y `return 1`.
|
|
|
|
### ANDROID_HOME
|
|
Si no esta fijado:
|
|
1. Intenta `$HOME/Android/Sdk` (SDK Linux via `install_android_sdk_bash_infra`)
|
|
2. Si no existe, intenta `$ANDROID_SDK_WIN` (SDK Windows montado en `/mnt/c/...`)
|
|
3. Si ninguno, lo deja vacio — gradle mostrara el error adecuado para builds JVM puros
|
|
|
|
## Exit codes
|
|
|
|
| Codigo | Significado |
|
|
|--------|-------------|
|
|
| 0 | Build exitoso |
|
|
| 1 | JDK 17 no encontrado |
|
|
| 2 | `./gradlew` no existe en `project_dir` |
|
|
| * | Exit code propagado de gradlew |
|
|
|
|
## Notas
|
|
|
|
Source-able y ejecutable directo. Al sourcear, el caller importa la funcion `gradle_run` sin ejecutarla. Al ejecutar directamente, delega `"$@"` a `gradle_run`.
|
|
|
|
No exporta `JAVA_HOME`/`ANDROID_HOME` al entorno del shell padre — los variables se pasan solo al subshell de gradlew para evitar contaminar el entorno.
|
|
---
|