Compilación Android

Este contenido es para la versión 0.1.0. Cambia a la última versión para documentación actualizada.

Esta guía cubre la compilación de APKs tanto de debug (pruebas) como de release (producción) para tu juego de RPG Maker envuelto con Ludens.

Compilación Debug

Para pruebas rápidas en un emulador o dispositivo físico.

Opción A: Configuración de Ejecución (Recomendado)

Si prefieres usar la interfaz de Android Studio:

Abre el menú de configuraciones y selecciona Edit Configurations….

Acceso al menú de configuraciones.

Agrega una nueva tarea de Gradle.

Creación de una nueva tarea de Gradle.

Nombra la tarea (ej. assembleDebug) y en el campo Arguments escribe: assembleDebug.

Configuración de los argumentos de la tarea.

Haz clic en Run para iniciar la compilación.

Opción B: Terminal

Abre la pestaña Terminal en Android Studio.
Ejecuta:
Ventana de terminal
```
./gradlew assembleDebug
```

Resultado

El APK se generará en:

composeApp/build/outputs/apk/debug/composeApp-debug.apk

Resultado exitoso de la compilación.

Instala este APK en un emulador o dispositivo real para verificar que el juego carga y los plugins funcionan correctamente antes de proceder con una compilación release.

Si encuentras errores extraños de compilación o tus assets no se actualizan, puedes limpiar la caché de Gradle ejecutando:

./gradlew clean

Compilación Release

Para generar un APK firmado para distribución en producción.

Opción A: Asistente de Android Studio

Esta opción te guía paso a paso para firmar tu aplicación.

Ve a Build > Generate Signed Bundle / APK.

Iniciar el asistente de firma.

Selecciona APK y haz clic en Next.
Configura tu Keystore:

Crear Nueva — Si no tienes una, haz clic en Create new….

Usar Existente — Si ya tienes una, cárgala e introduce las credenciales.
Selecciona el build flavor release y haz clic en Create.

Selección de la variante de salida.

Resultado:

Notificación de APK generado exitosamente.

Opción B: Tarea Gradle

Ideal para automatizar la compilación, pero requiere configuración manual previa.

Asegúrate de tener tu archivo .jks (Keystore) generado. Puedes usar el Paso 3 de la Opción A para crearlo.

Crea o edita el archivo keystore.properties en la raíz del proyecto con la ruta y credenciales:

storePassword=tu_store_password
keyPassword=tu_key_password
keyAlias=tu_alias
storeFile=C:/Ruta/A/Tu/llave.jks

Ejecuta la tarea assembleRelease:
Ventana de terminal
```
./gradlew assembleRelease
```
Resultado:

Resultado de la compilación desde Gradle.

Ubicación del Archivo

Método	Ubicación del APK
Asistente (Opción A)	`composeApp/release/` (o la carpeta que seleccionaste durante el asistente)
Gradle (Opción B)	`composeApp/build/outputs/apk/release/composeApp-release.apk`