Download-Seite: Playtest-APK + Sideload-Anleitung (SideQuest/ADB)

This commit is contained in:
ops-deploy-bot 2026-10-15 11:19:38 +02:00
commit 4e3575eea1
2 changed files with 120 additions and 0 deletions

38
README.md Normal file
View file

@ -0,0 +1,38 @@
# ScopedVR — Playtest-Downloads (Meta Quest 3)
Hier gibt es die aktuelle Playtest-APK zum **direkten Download — ohne Account, ohne Anmeldung**.
## Aktueller Build
| | |
|---|---|
| Datei | `scopedvr-client_v0.1.0-m2b.apk` |
| Version | 0.1.0 (versionCode 14) |
| Stand | Commit `9ebe8ef` (origin/main, 15.10.2026) |
| Größe | 81.973.165 Bytes (~78 MB) |
| SHA256 | `5a7f91211091745aa4d9a20ee8238c5e472b8044a5d9da176b251bcaa2989bf9` |
| Zielgerät | Meta Quest 3 (arm64, OpenXR) |
**→ [APK direkt herunterladen](releases/download/m1-playtest/scopedvr-client_v0.1.0-m2b.apk)**
(Release-Seite mit Details und älteren Builds: [Releases](releases))
## Installation (Sideload)
Die APK ist **nicht im Meta-Store** — sie muss per Sideload auf die Quest 3.
Das ist mit der Anleitung unten auch ohne Technik-Erfahrung in ca. 15–20 Minuten erledigt.
**→ [Sideload-Anleitung (SideQuest / ADB, Schritt für Schritt)](SIDELOAD-ANLEITUNG.md)**
## Schnell-Checkliste
1. APK über den Link oben herunterladen
2. Sideload-Anleitung folgen (Entwicklermodus an der Quest 3 aktivieren, dann SideQuest oder ADB)
3. In der Quest: App-Bibliothek → „Unbekannte Quellen“ → **ScopedVR** starten
4. Wrist-Panel → **Server-Browser** → offiziellem Server beitreten
## Hinweise
- Die APK ist selbst signiert (CN=ScopedVR, OU=Playtest) — Android/Quest warnt beim ersten Start ggf. vor „unbekannter Quelle“. Das ist bei Sideloads normal.
- Nach Updates: einfach die neue APK-Datei derselben Installationsmethode installieren — sie überschreibt die alte.
- Bugs: Issue in diesem Repo anlegen (Forgejo-Account nötig) oder direkt Sly Bescheid geben.

82
SIDELOAD-ANLEITUNG.md Normal file
View file

@ -0,0 +1,82 @@
# ScopedVR auf der Meta Quest 3 installieren (Sideload-Anleitung)
Diese Anleitung ist für Einsteiger ohne Technik-Vorkenntnisse geschrieben. Zeitaufwand: ca. 15–20 Minuten (einmalig; spätere Updates gehen in 2 Minuten).
## Was du brauchst
- Meta Quest 3
- Windows-PC oder Mac
- USB-C-Kabel (das Ladekabel der Quest funktioniert, es muss ein **Datenkabel** sein)
- Die APK-Datei: `scopedvr-client_v0.1.0-m2b.apk` — Download-Link siehe [README](README.md)
---
## Schritt 1: Entwicklermodus aktivieren (einmalig, für beide Methoden nötig)
1. Auf dem Handy die App **„Meta Horizon“** öffnen (früher hieß sie „Oculus“; kostenlos im App Store / Play Store)
2. Deine Quest 3 ist dort unter **Geräte** verbunden (dein Meta-Account)
3. Headset auswählen → **Headset-Einstellungen** → **Entwicklermodus** auf AN schalten
- Falls der Schalter fehlt oder grau ist: Einmal auf [developer.oculus.com](https://developer.oculus.com) mit demselben Meta-Account eine **Entwickler-Organisation anlegen** (kostenlos, der Name ist egal — z. B. dein Spitzname). Danach erscheint der Schalter.
4. Quest 3 **neu starten** (ein-/ausschalten), sonst ist der Modus nicht aktiv
## Schritt 2: USB-Debugging zulassen
1. Quest per USB-C an den PC anschließen
2. **Brille aufsetzen** — im Headset erscheint ein Dialog: **„USB-Debugging zulassen?“** → **Zulassen** (falls angeboten: „Immer von diesem Computer“ anhaken)
3. Ohne diesen bestätigten Dialog kann keine Software von außen installieren — dieser Schritt ist der häufigste Stolperstein
---
## Methode A (empfohlen): SideQuest
1. Auf dem PC herunterladen: [sidequestvr.com/download](https://sidequestvr.com/download) → installieren → öffnen
2. Quest per USB verbinden (Schritte 1–2 oben). Oben links in SideQuest erscheint ein grünes Gerät/Häkchen, wenn die Verbindung steht
3. In SideQuest die Kachel **„Install APK file from folder on device“** anklicken — oder die APK-Datei einfach **per Drag & Drop** ins SideQuest-Fenster ziehen
4. Die heruntergeladene `scopedvr-client_v0.1.0-m2b.apk` auswählen → warten, bis **„Installed“** erscheint
5. Weiter unten bei **„Erster Start in der Quest“** lesen
## Methode B (Alternative): Direkt per ADB (ohne SideQuest)
1. Die **Platform-Tools** herunterladen: [developer.android.com/tools/releases/platform-tools](https://developer.android.com/tools/releases/platform-tools) → ZIP entpacken, z. B. nach `C:\platform-tools`
2. In diesem Ordner ein Terminal öffnen (Windows: den Ordner öffnen, in die Adressleiste des Explorers `cmd` eintippen, Enter)
3. Prüfen, ob die Quest erkannt wird:
```
adb devices
```
→ Es muss ein Gerät mit dem Status **device** gelistet werden (sonst Schritt 1–2 oben wiederholen)
4. Installieren:
```
adb install -r scopedvr-client_v0.1.0-m2b.apk
```
→ **„Success“** = fertig. (Pfad zur Datei ggf. anpassen, z. B. `adb install -r C:\Downloads\scopedvr-client_v0.1.0-m2b.apk`)
---
## Erster Start in der Quest
1. App-Bibliothek öffnen (Leiste unten in der Kopfleiste)
2. Rechts oben im Filter **„Unbekannte Quellen“** („Unknown Sources“) auswählen
3. **ScopedVR** starten
4. Beim ersten Start fragt die App nach **Mikrofon-Berechtigung** → zulassen (wird für Voice im Spiel gebraucht)
5. **Nickname** vergeben
6. Wrist-Panel öffnen → **Server-Browser** → offiziellem Server beitreten
---
## Probleme?
| Problem | Lösung |
|---|---|
| SideQuest/`adb devices` zeigt kein Gerät | Datenkabel prüfen (kein reines Ladekabel), Dialog „USB-Debugging zulassen“ im Headset bestätigen, Entwicklermodus (Schritt 1) prüfen + Quest neu starten |
| App nach der Installation nicht zu finden | App-Bibliothek → Filter **„Unbekannte Quellen“** |
| Installation schlägt fehl, Meldung wie `INSTALL_FAILED_UPDATE_INCOMPATIBLE` | Erst die alte Version entfernen: `adb uninstall de.slyphax.questtest` — dann neu installieren |
| „Verbindung fehlgeschlagen“ im Server-Browser | Quest braucht Internet (WLAN). Kurz warten und **Aktualisieren** drücken; falls es dauerhaft scheitert, Sly Bescheid geben |
| Neue Version installieren | Gleiche Methode wie oben — die neue APK überschreibt die alte, Einstellungen bleiben erhalten |
## Sicherheits-Hinweis
Diese APK kommt direkt von Sly und ist selbst signiert — sie steht **nicht** im Meta-Store. Warnt Android/Quest vor „unbekannter Quelle“, ist das bei Sideloads normal und hier genau der Sinn der Sache.