Compila tú mismo la app de Android

La app de Android es el mismo proyecto de Tauri 2 que el launcher de escritorio, compilado para Android. Esta página es para quien colabora en el proyecto y para jugadores que quieren compilar e instalar su propio APK. Si solo quieres jugar, usa el APK firmado de nuestra web: mira Android: instalar el APK.

Lo que obtienes: la app completa, con inicio de sesión, instancias, modpacks, social, vestuario y Minecraft: Java Edition a través del motor de juego integrado con controles táctiles. Lo que no obtienes: actualizaciones automáticas. La app consulta nuestro canal oficial de actualizaciones, pero Android solo instala una actualización con el mismo nombre de paquete y la misma clave de firma. Tu build tiene otra clave, así que lo actualizas compilando de nuevo.

Qué hay en cada sitio

Requisitos

La app se compila contra el SDK de Android 36 (compileSdk/targetSdk). En la CI solo se instalan a mano platform-tools y los dos NDK; el resto lo trae el plugin de Android para Gradle. Acepta una vez las licencias del SDK con sdkmanager --licenses.

Compilar un APK debug

git clone https://github.com/theredstonee/TRS-Launcher.git
cd TRS-Launcher
pnpm install

sdkmanager --install "platform-tools" "ndk;28.2.13676358" "ndk;27.3.13750724"
rustup target add aarch64-linux-android x86_64-linux-android

$env:ANDROID_HOME = "$env:LOCALAPPDATA\Android\Sdk"
$env:NDK_HOME     = "$env:ANDROID_HOME\ndk\28.2.13676358"
$env:JAVA_HOME    = "C:\Program Files\Android\Android Studio\jbr"

export ANDROID_HOME="$HOME/Android/Sdk"          # donde esté tu SDK
export NDK_HOME="$ANDROID_HOME/ndk/28.2.13676358"
export JAVA_HOME=/ruta/al/jdk-21

pnpm tauri android build --apk --debug --target aarch64

find src-tauri/gen/android/app/build/outputs/apk -name '*.apk'

Get-ChildItem -Recurse -Filter *.apk src-tauri\gen\android\app\build\outputs\apk

adb install -r ruta/al.apk

Para el emulador

pnpm tauri android build --apk --debug --target x86_64

Arranca el emulador con -gpu host: con SwiftShader el renderizador se cuelga en su comprobación de Vulkan. Minecraft 26.x no se puede jugar en el emulador (a su Vulkan le faltan extensiones necesarias y OpenGL se bloquea allí); prueba esas versiones en un móvil real.

Compilar un APK release

pnpm tauri android build --apk --target aarch64

Es el comando de release de la CI sin --ci. Los builds release se reducen con R8. Sin clave de firma sale un APK sin firmar (…-unsigned.apk), y Android no lo puede instalar. Fírmalo con tu propia clave:

keytool -genkeypair -v -keystore my-release.jks -alias my-key \
  -keyalg RSA -keysize 4096 -validity 10000

export ANDROID_KEYSTORE_PATH=/ruta/a/my-release.jks
export ANDROID_KEYSTORE_PASSWORD='…'
export ANDROID_KEY_ALIAS=my-key
export ANDROID_KEY_PASSWORD='…'      # igual que la del keystore si no elegiste otra

pnpm tauri android build --apk --target aarch64
"$ANDROID_HOME"/build-tools/<versión>/apksigner verify --print-certs <el.apk>

Hazla tu propia app

Si quieres instalar tu build junto a la app oficial o compartirlo con amigos, dale su propio ID de app y su propio nombre:

Lo que sigue funcionando en tu propio build, según el código:

• Inicio de sesión con Microsoft: la app usa el inicio de sesión con código de dispositivo (escribes un código en la página de Microsoft). No depende del nombre de paquete ni de una redirección a la app.
• Servicios de TRS (amigos, chat, capas, API de TRS): la app habla con la misma API; no se comprueba ni el nombre de paquete ni la firma.
• Enlaces como trs-launcher://pack/<code> usan el mismo esquema en todos los builds. Si tienes la app oficial y tu build instalados a la vez, Android te pregunta con cuál abrirlos.
• Actualizaciones: mira el principio de la página. El instalador de la app solo acepta un APK con su propio nombre de paquete, así que no puede sustituir tu build por la app oficial, y Android rechaza nuestro APK encima de un build con tu clave.

Nosotros todavía no hemos probado un build con otro nombre; si algo falla, avísanos.

Ejecutar las comprobaciones

Las mismas comprobaciones que el job Android de la CI:

pnpm generate                       # generate_context! necesita la interfaz compilada
cd src-tauri
cargo clippy --workspace --target aarch64-linux-android -- -D warnings
cd gen/android
./gradlew --no-daemon :tauri-plugin-trs-game:testDebugUnitTest   # capa táctil y lógica del motor, sin dispositivo

Clippy se ejecuta fuera de tauri android build y necesita el compilador del NDK para las partes en C (SQLite, ring). La CI define en Linux:

bin="$NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin"
export CC_aarch64_linux_android="$bin/aarch64-linux-android26-clang"
export AR_aarch64_linux_android="$bin/llvm-ar"
export CARGO_TARGET_AARCH64_LINUX_ANDROID_LINKER="$bin/aarch64-linux-android26-clang"

Problemas

«A required privilege is not held by the client»

En Windows, tauri android build enlaza la biblioteca de Rust en gen/android/app/src/main/jniLibs con un enlace simbólico. Sin el modo de desarrollador (o permisos de administrador) eso falla. Activa el modo de desarrollador en la configuración de Windows, o copia tú la biblioteca (src-tauri/target/<triple>/debug/libtrs_launcher_lib.so → jniLibs/<abi>/) y ejecuta la tarea de Gradle en src-tauri/gen/android; para el emulador, gradlew assembleX86_64Debug.

No encuentra el NDK o la versión del NDK es otra

NDK_HOME tiene que apuntar a 28.2.13676358, y 27.3.13750724 también tiene que estar en la carpeta ndk/ del SDK. Si tu r27d está en otro sitio, define android.ndkPath en src-tauri/gen/android/local.properties o la variable ANDROID_NDK_HOME (mira el comentario en el build.gradle.kts del plugin).

La instalación del SDK pide el paquete «tools»

El antiguo paquete tools del SDK ya no existe con las cmdline-tools actuales. Instala solo cmdline-tools, platform-tools y los dos NDK; la CI hace lo mismo.

El APK release no se instala

Está sin firmar (…-unsigned.apk). Define las cuatro variables de firma y vuelve a compilar, o usa un build debug.

«App no instalada» o «entra en conflicto con un paquete existente»

Ya hay instalado un build de la app con otra clave, a menudo nuestra app oficial. Desinstálalo antes (eso borra sus instancias) o dale a tu build su propio ID de app.

«SHA-256 stimmt nicht» al descargar las partes del motor

Una descarga de prebuilt.lock no coincide con su suma de comprobación (por ejemplo, por una conexión cortada o un proxy). El archivo se descarta; vuelve a lanzar el build.

El juego se cierra en el emulador o 26.x no arranca allí

Usa -gpu host y prueba Minecraft 26.x en un móvil real (mira Para el emulador).

La app no se instala en un móvil antiguo o de 32 bits

La app necesita Android 8.0 y un procesador de 64 bits: solo se empaquetan arm64-v8a y x86_64, porque el motor de juego solo existe para 64 bits.

Falta CurseForge

El build no tenía clave de API de CurseForge. En builds propios es normal; mira la nota sobre la clave más arriba.

Licencia y nombre

TRS Launcher es software libre bajo la GNU General Public License v3.0 (LICENSE, avisos de copyright en NOTICE). Puedes compilar, cambiar y compartir la app. Si compartes un APK, la GPL exige que sea bajo la misma licencia y que pongas a disposición el código fuente completo de ese build exacto, con tus cambios. El motor de juego incluye partes de terceros con sus propias licencias (Amethyst/PojavLauncher bajo LGPL-3.0 y otras); están en NOTICE y tienen que quedarse.

El repositorio no tiene reglas propias sobre la marca. Aun así: si repartes tu propio build, dale otro nombre y otro ID de app para que nadie lo confunda con el TRS Launcher oficial, y remite a tu código fuente, no a nuestro soporte.

Siguientes pasos