iOS-App selbst bauen mit Xcode

Die iOS-App ist dasselbe Tauri-2-Projekt wie der Launcher auf dem PC, nur für iPhone und iPad gebaut. Diese Seite ist für alle, die mitentwickeln, und für Spieler, die die IPA lieber selbst bauen als unsere zu nehmen. Wenn du nur spielen willst, installier die offizielle App – siehe iPhone/iPad: mit AltStore/SideStore installieren.

Die Befehle hier sind die, die das CI ausführt (.github/workflows/ci.yml Job launcher-ios, release.yml Jobs iOS und iOS engine, .github/workflows/ios-engine.yml). Das CI signiert die App nie – es baut eine unsignierte IPA, und AltStore/SideStore signieren sie beim Installieren mit der Apple-ID des Nutzers.

Was wo liegt

Voraussetzungen

Die App braucht iOS 15 (minimumSystemVersion in tauri.ios.conf.json). Das CI setzt für die App IPHONEOS_DEPLOYMENT_TARGET=15.0, weil die Swift-Pakete der Plugins APIs ab iOS 14 nutzen; die Engine selbst wird für 14.0 gebaut.

IPA bauen

git clone https://github.com/theredstonee/TRS-Launcher.git
cd TRS-Launcher
pnpm install
rustup target add aarch64-apple-ios
brew install ldid cmake

pnpm generate

bash scripts/ios-project.sh

export IPHONEOS_DEPLOYMENT_TARGET=15.0
bash scripts/ios-unsigned-ipa.sh release build/TRS-Launcher-app.ipa

JAVA8_HOME=$(/usr/libexec/java_home -v 1.8) bash scripts/ios/build-engine.sh build/engine-ios

bash scripts/ios/package-ipa.sh build/TRS-Launcher-app.ipa build/engine-ios build/TRS-Launcher.ipa

Aus Xcode mit eigener Apple-ID starten

Du kannst die App auch direkt aus Xcode auf einem angeschlossenen iPhone starten und mit deinem eigenen Team signieren (eine kostenlose Apple-ID geht als „Personal Team“). Das ist praktisch, wenn du an der Oberfläche arbeitest. Zwei Dinge dazu:

• Auf diesem Weg hat die App keine Spiel-Engine – beim Start einer Instanz meldet sie, dass die Engine fehlt. Anmeldung, Sozial, Garderobe, Modpacks und alles andere funktionieren.
• Das CI signiert nie mit einem Team – diesen Weg haben wir nicht getestet.

export IPHONEOS_DEPLOYMENT_TARGET=15.0
bash scripts/ios-unsigned-ipa.sh debug build/TRS-Launcher-debug.ipa

open src-tauri/gen/apple/*.xcodeproj

Zu deiner eigenen App machen

• Bundle-ID: AltStore/SideStore signieren die IPA mit deiner Apple-ID – dafür musst du nichts ändern. Für Xcode änderst du die Bundle-ID dort (siehe oben).
• identifier in src-tauri/tauri.conf.json nicht ändern. Er gilt auch für Android, wo das Kotlin-Paket und der Rust-Code daran hängen – der Android-Build bricht dann ab (siehe Android-App selbst bauen). Ein identifier nur für iOS in tauri.ios.conf.json könnte gehen, ist aber nicht getestet.
• Die ID der Hintergrundaufgabe dev.theredstonee.trslauncher.push-poll bleibt, wie sie ist: Sie steht sowohl in src-tauri/Info.ios.plist als auch im Swift-Code des Push-Plugins, und iOS führt nur Aufgaben aus, die in der Info.plist stehen.

Was in deinem eigenen Build laut Code weiter funktioniert:

• Microsoft-Anmeldung läuft per Gerätecode (du tippst einen Code auf der Microsoft-Seite ein) – sie hängt nicht an der Bundle-ID.
• TRS-Dienste (Freunde, Chat, Umhänge, TRS-API) sprechen mit derselben API; App oder Signatur werden nicht geprüft.
• Links wie trs-launcher://pack/<code> haben in jedem Build dasselbe Schema.
• Updates: Dein Build hängt nicht an unserer AltStore-/SideStore-Quelle. Du aktualisierst ihn, indem du neu baust und installierst.

Wenn in deinem eigenen Build etwas nicht geht, melde es bitte.

Prüfungen ausführen

Dieselben Prüfungen wie im CI:

pnpm generate
cd src-tauri
IPHONEOS_DEPLOYMENT_TARGET=15.0 cargo clippy --workspace --target aarch64-apple-ios -- -D warnings
# Spiel-Plugin für iOS, Rust und sein Swift-Paket (Job „iOS engine“):
IPHONEOS_DEPLOYMENT_TARGET=14.0 cargo build -p tauri-plugin-trs-game --target aarch64-apple-ios

Probleme

„Build-Phase tauri ios xcode-script nicht gefunden“

scripts/ios-unsigned-ipa.sh schaltet diese Build-Phase beim ersten Lauf ab – ein zweiter Lauf findet sie nicht mehr und bricht mit dieser Meldung ab. Das CI fängt immer mit einem frischen Projekt an. Lokal löschst du das erzeugte Projekt und legst es neu an:

rm -rf src-tauri/gen/apple
bash scripts/ios-project.sh

Fehler zum Deployment Target oder zu iOS-14-APIs

Setz IPHONEOS_DEPLOYMENT_TARGET=15.0, bevor du die App baust (14.0 für die Prüfung des Engine-Plugins) – die Swift-Pakete brauchen mindestens iOS 14.

Die App schließt sich gleich nach dem Öffnen

Wenn du die Rust-Bibliothek von Hand gebaut hast, fehlt wahrscheinlich --features tauri/custom-protocol – dann wartet die App auf einen Entwicklungsserver auf localhost:3000. Nimm scripts/ios-unsigned-ipa.sh, das setzt es immer.

„JDK 8 fehlt (JAVA8_HOME setzen)“ oder „JAVA8_HOME ist kein JDK 8“

Der Java-Teil der Engine braucht genau ein JDK 8. Installier eins und lass JAVA8_HOME darauf zeigen.

„ldid fehlt (brew install ldid)“

package-ipa.sh signiert mit ldid: brew install ldid.

„vendored Datei weicht von Upstream ab“

Eine Datei unter ios/Engine/vendor/amethyst-ios weicht vom festen Amethyst-iOS-Commit ab. Abweichen dürfen nur die gepatchten Dateien, die in UPSTREAM.md in diesem Ordner stehen – mach deine Änderung rückgängig oder pass die Liste an.

Das Spiel schließt sich gleich nach dem Start

Fast immer ist JIT nicht an. Siehe JIT einschalten. Das Log der Engine findest du in der Dateien-App unter Auf meinem iPhone → TRS Launcher (trs-engine.log).

Minecraft 26.3 startet nicht

26.3 läuft auf iOS noch nicht (der Engine fehlt dort die SDL3-Anbindung). Nimm 26.2 oder älter.

„App kann nicht überprüft werden“ nach einer Woche

Die 7 Tage der kostenlosen Apple-ID sind um. Frisch die App in AltStore/SideStore auf oder starte sie noch einmal aus Xcode.

Lizenz und Name

Der TRS Launcher ist freie Software unter der GNU General Public License v3.0 (LICENSE, Urheberrechtshinweise in NOTICE). Du darfst die App bauen, ändern und weitergeben. Gibst du eine IPA weiter, verlangt die GPL, dass das unter derselben Lizenz passiert und du den vollständigen Quellcode genau dieses Builds samt deiner Änderungen zugänglich machst. Die iOS-Engine basiert auf Amethyst-iOS (GPL-3.0) und bringt weitere fremde Teile mit; ihre Lizenztexte liegen in der App (licenses/engine) und stehen in NOTICE – lass sie drin.

Eigene Markenregeln hat das Repository nicht. Trotzdem: Wenn du deinen Build weitergibst, gib ihm einen eigenen Namen und eine eigene Bundle-ID, damit ihn niemand für den offiziellen TRS Launcher hält, und verweise auf deinen Quellcode – nicht auf unseren Support.

Weiter geht's