Build from Source

This page is for contributors who want to build LeviLaunchroid itself. Native mod build notes live in Native Mod Quick Start.

Prerequisites

Git.
Android Studio.
JDK 21 or later.
Android SDK for API 28 or later.
Android NDK and CMake components installed through Android Studio when native code is built.

Open the Project

bash

git clone https://github.com/LiteLDev/LeviLaunchroid.git
cd LeviLaunchroid

Open the project directory in Android Studio and allow Gradle sync to finish. The project root is named levilauncher in Gradle settings, while the repository remains LeviLaunchroid.

Build and Run

Connect an Android device or start an emulator that matches the supported Android baseline.
Select the app run configuration.
Build and run from Android Studio.
Install the official Minecraft app on the test device before testing launcher flows.

Command Line Build

bash

./gradlew assembleDebug

On Windows:

powershell

.\gradlew.bat assembleDebug

Contributor Checks

Before submitting launcher changes, build the app and test the touched flow on a device. Documentation-only changes should at least pass the VitePress build from docs/.

Build from Source ​

Prerequisites ​

Open the Project ​

Build and Run ​

Command Line Build ​