Das Meta XR Core SDK bietet einen Mechanismus, um die App direkt von Unity zum Meta Horizon Developer Dashboard⁠ hochzuladen. Mit dem Tool kannst du nach Bedarf Entwicklungs-Builds zu Veröffentlichungskanälen hochladen.

App-Komponenten verstehen

Ein App besteht aus einem Build und Metadaten. Meta Quest unterstützt zwei Arten von Apps: Quest und Link-PC-VR. Ein Quest-Build enthält eine APK-Datei und optional OBB- und Asset-Dateien. Ein Link-PC-VR-Build-Ordner enthält eine ausführbare Datei und optional Asset-Dateien. Asset-Dateien, bei denen es sich um generische Infrastruktur handelt, werden verwendet, um Content, DLC, Zusatz-Content und Zugriff auf optionale Asset-Dateien hinzuzufügen. Metadaten enthalten Informationen wir App-Name, Screenshots, Beschreibung und Content-Einstufung. Die meisten Änderungen an etablierten Metadaten erfordern eine Überprüfung durch Meta Quest.

Build hochladen

Du kannst Builds auf verschiedene Arten hochladen, wie etwa über das Developer Dashboard, die Befehlszeilenschnittstelle oder direkt von Unity, indem du das OVR Platform Tool verwendest. Die folgende Anleitung beschreibt den Prozess, den Build von Unity hochzuladen:

Meta Quest-Builds hochladen

Gehe Menü zu File > Build Profiles > Build, um den Build zu kompilieren.

Wenn der Build kompiliert ist, gehe im Menü zu Meta > Tools > Oculus Platform Tool.

Abhängig vom Ziel-Build, das du im Build-Einstellungen-Fenster festgelegt hast, legt Target Oculus Platform automatisch das Zielgerät auf Quest oder Link-PC-VR fest.

Gib in Oculus Application ID und Oculus App Token die ID und das Token von der API-Seite⁠ im Meta Horizon Developer Dashboard an.

Hinweis: Du musst ein Admin-Konto verwenden, um den App-Geheimcode zu sehen. Falls du kein*e Admin bist, gehe zum Meta Horizon Developer Dashboard⁠ und verifiziere die Admin-Konten, die auf dem Tab Mitglieder aufgelistet sind.

Gib in der Release Channel List den Namen des Release Channels ein. Siehe Befehlszeilen-Hilfsprogramm der Oculus-Plattform bezüglich gültiger Namen für Veröffentlichungskanäle.

Gib unter Release Note die Versionshinweise für die Version ein.

Wähle in Build APK File Path die APK-Datei aus.

Wähle in Debug Symbols Directory den Verzeichnispfad für Debug-Symbole aus, um den Android-Absturz zu symbolisieren und die Absturzprotokolle auf dem Crash Analytics-Dashboard zu analysieren. Das Tool wählt per Standard den Verzeichnispfad der libil2cpp.sym.so-Datei, was die Standardsymboldatei für Projekte ist, die das IL2CPP-Scripting-Backend verwenden. Wenn du das IL2CPP-Scripting-Backend verwendest, um dein Projekt zu erstellen, musst du nichts tun, es sei denn, du möchtest eine andere Symboldatei verwenden oder die Datei nicht hochladen.

Für Projekte, die mit dem Mono-Scripting-Backend erstellt wurden, wähle den Verzeichnispfad C:\Program Files\Unity\Hub\Editor\<version>\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Symbols\armeabi-v7a aus, um die libunity.sym.so-Symboldatei hochzuladen. Falls du die Symboldatei nicht hochladen möchtest, klicke auf das X-Symbol, um den Dateipfad zu leeren.

Um Debug-Symbole zu einem bestehenden Build hochzuladen, aktiviere das Kontrollkästchen Upload Debug Symbols Only und gib in das Feld Build ID die Build-ID ein. Du findest die Build-ID im Meta Horizon Developer Dashboard⁠ unter Distribution auf dem Tab Release Channel.

Erweitere Optional Commands > Expansion Files, um weitere Dateien hinzuzufügen, wie etwa OBB- und Asset-Dateien. Führe folgende Schritte aus:

Klicke auf Choose, um die OBB-Datei auszuwählen. Die OBB-Datei erweitert die Gesamtgröße deiner App. Meta Quest unterstützt eine OBB-Dateigröße von bis zu 4 GB.

Klicke auf Choose, um den Ordner mit den Asset-Dateien zu lokalisieren. Meta Quest unterstützt Asset-Dateien von bis zu 2 GB, die als DLC verwendet werden können.

Klicke auf Upload.

Link-PC-VR-Builds hochladen

Gehe Menü zu File > Build Profiles > Build, um den Build zu kompilieren.

Wenn der Build kompiliert ist, gehe im Menü zu Meta > Tools > Oculus Platform Tool.

Je nach dem Ziel-Build, den du im Fenster „Build Settings“ festgelegt hast, legt Target Oculus Platform automatisch Quest oder Rift (Link-PC-VR) als Zielgerät fest.

Gib in Oculus Application ID und Oculus App Token die ID und das Token von der API-Seite⁠ im Meta Horizon Developer Dashboard an. Um die App-ID und das Token zu erhalten, melde dich beim Dashboard an, finde die App in der App-Liste unter deinem Team, gehe zur Seite „Getting Started API“ und kopiere die App-ID und das Token. Du musst ein Admin-Konto verwenden, um den App-Geheimcode zu sehen. Falls du kein*e Admin bist, gehe zu Einstellungen und verifiziere die Admin-Konten auf der Mitglieder-Seite.

Gib in der Release Channel List den Namen des Release Channels ein. Siehe Befehlszeilen-Hilfsprogramm der Oculus-Plattform bezüglich gültiger Namen für Veröffentlichungskanäle.

Gib unter Release Note die Versionshinweise für die Version ein.

Wähle in Rift Build Directory das Verzeichnis aus, das die Build-Dateien enthält.

Gib in Version Number die Nummer der Build-Version ein.

Wähle in Launch File Path die EXE-Datei aus.

Erweitere Optional Commands und gehe folgendermaßen vor:

Gib Launch Parameters Argumente ein, die an die Launcher-Datei weitergegeben werden.

Wähle Firewall Exception aus, um die Windows-Firewall-Ausnahme zu aktivieren.

Wähle in der Liste Gamepad Emulation den Typ der Gamepad-Emulation aus, der von den Meta Touch-Controllern verwendet wird.

Wähle unter 2D in 2D Launch File die EXE-Datei aus, um die App im 2D-Modus zu starten, und gib in 2D Launch Parameters Argumente ein, die an die Launcher-Datei übergeben werden.

Wähle unter Expansion Files in Language Pack Directory das Verzeichnis aus, das das Sprachpaket enthält, und wähle in Assets Directory das Verzeichnis aus, das die DLCs enthält.

Klicke auf Upload.