Skip to content
Ludens Ludens Ludens 0.3.0
Search limited to the 0.1.0 version. Switch to the latest version for up-to-date results.

Android Build

This content is for the 0.1.0 version. Switch to the latest version for up-to-date documentation.

This guide covers building both debug (testing) and release (production) builds for your RPG Maker game wrapped with Ludens.

Debug Build

Section titled “Debug Build”

For quick testing on an emulator or physical device.

Section titled “Option A: Run Configuration (Recommended)”

If you prefer using the Android Studio interface:

  1. Open the configurations menu and select Edit Configurations….

Accessing the configurations menu.

  1. Add a new Gradle task.

Creating a new Gradle task.

  1. Name the task (e.g., assembleDebug) and in the Arguments field type: assembleDebug.

Configuring the task arguments.

  1. Click Run to start the build.

Option B: Terminal

Section titled “Option B: Terminal”
  1. Open the Terminal tab in Android Studio.
  2. Run:
    Terminal window
    ./gradlew assembleDebug

Result

Section titled “Result”

The APK will be generated at:

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

Successful build result.

Release Build

Section titled “Release Build”

To generate a signed APK for production distribution.

Option A: Android Studio Wizard

Section titled “Option A: Android Studio Wizard”

This option guides you step-by-step through signing your application.

  1. Go to Build > Generate Signed Bundle / APK.

Starting the signing wizard.

  1. Select APK and click Next.

  2. Configure your Keystore:

    Create New — If you don’t have one, click Create new….

    Creating a new Keystore. Keep your password and the .jks file safe.

    Use Existing — If you already have one, load it and enter credentials.

    Keystore credentials.

  3. Select the release build flavor and click Create.

Output variant selection.

  1. Result:

Notification of successfully generated APK.

Option B: Gradle Task

Section titled “Option B: Gradle Task”

Ideal for automating the build, but requires prior manual configuration.

  1. Ensure you have your .jks file (Keystore) generated. You can use Step 3 of Option A to create it.

  2. Create or edit the keystore.properties file in the project root with the path and credentials:

    storePassword=your_store_password
    keyPassword=your_key_password
    keyAlias=your_alias
    storeFile=C:/Path/To/Your/key.jks

  3. Run the assembleRelease task:

    Terminal window
    ./gradlew assembleRelease

  4. Result:

Build result from Gradle.

Output Location

Section titled “Output Location”
MethodAPK Location
Wizard (Option A)composeApp/release/ (or the folder you selected during the wizard)
Gradle (Option B)composeApp/build/outputs/apk/release/composeApp-release.apk