App-ID: de.yourpart.app
App-Name: YourPart
Technologie: Capacitor mit lokal gebuendeltem frontend/dist
Backend: bestehendes Backend wird verwendet, keine Backend-Implementierung in diesem Android-Start
Erstes Ziel: interne Debug-/Test-APK

Vorbereitung

Frontend-Env-Vorlage kopieren und Werte pruefen:

cp ../frontend/.env.android.example ../frontend/.env.android

Android-Dependencies installieren:

npm install

Web-Bundle fuer Android bauen:

npm run build:web

Android-Projekt erzeugen:

npm run add:android

Danach synchronisieren:

npm run sync

Debug-Build

Nach npm run add:android:

npm run build:debug

Das erzeugte APK liegt danach unter android/app/build/outputs/apk/debug/. Innerhalb dieses Repositorys ist das der Pfad /android/android/app/build/outputs/apk/debug/.

Android Studio

In Android Studio muss das native Gradle-Projekt geoeffnet werden:

/home/torsten/Programs/YourPart3/android/android

Nicht /home/torsten/Programs/YourPart3/android oeffnen. Dieser Ordner ist nur die Capacitor-Projektwurzel mit package.json und capacitor.config.ts; die Android-Studio-App liegt eine Ebene tiefer in /android/android.

Nach dem Oeffnen:

Gradle Sync abwarten.
Run Configuration YourPart Debug auswaehlen.
Emulator auswaehlen.
Starten.

Wenn Android Studio die Konfiguration nicht sofort anzeigt, File > Sync Project with Gradle Files ausfuehren oder das Projektfenster neu laden.

Emulator-Eingabe

Die App verwendet die normale Android-WebView-Eingabe. android.captureInput ist bewusst nicht aktiviert, weil diese Capacitor-Option die WebView-InputConnection ersetzt und im Emulator verhindern kann, dass Textfelder normal beschrieben werden.

Backend-CORS fuer Android-Debug

Capacitor laedt die lokale Android-App standardmaessig unter:

https://localhost

Die API-Requests gehen weiterhin an https://www.your-part.de/api/.... Deshalb muss das Backend https://localhost in CORS_ORIGINS erlauben:

CORS_ORIGINS=https://www.your-part.de,https://localhost,http://localhost:5173,http://127.0.0.1:5173

server.hostname in capacitor.config.ts darf nicht auf www.your-part.de gesetzt werden. Sonst interpretiert Capacitor Backend- und Model-URLs wie /api/models/...glb als lokale App-Assets.

Wichtige Hinweise

frontend/.env.android darf echte produktive URLs enthalten, aber keine Secrets.
VITE_DISABLE_3D=true ist fuer Android-Debug absichtlich gesetzt. Das verhindert WebGL/GLB-Last auf der Login-Seite, bis CORS und 3D-Performance separat freigegeben sind.
OAuth ist im ersten Debug-APK nicht der Blocker; Username/Passwort-Login ist die Pflichtfunktion.
Push Notifications werden erst nach stabiler Shell geplant.
Play Store ist vorerst kein Ziel, bis Datenschutz, UGC, Moderation und Adult-Content separat geprueft sind.