For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /de/docs/mobile/local-setup.md (or send Accept: text/markdown).

Mobile App ausführen

Verbinden Sie Expo mit einer erreichbaren Entwicklungs-API.

Zu dieser Anleitung fragen

1. Bereiten Sie Computer, Telefon und Backend vor

Schließen Sie den Vorgang ab, bevor Sie beginnen, und öffnen Sie das Mobile-Repository oder das Monorepo „Alle Plattformen“ in Ihrem Editor. Führen Sie unter Terminal → Neues Terminal im Repository-Stammverzeichnis den folgenden Installationsbefehl aus. Warten Sie, bis es fertig ist. Installieren Sie Expo Go auf Ihrem Telefon, indem Sie die unten verlinkte offizielle Expo-Seite verwenden. Seine Version muss die in apps/mobile/package.json. aufgezeichnete Version Expo SDK unterstützen

Ein Backend ist der Webserver, der Anmeldungen, Arbeitsbereichsdaten und KI-Anfragen verarbeitet. Wenn Ihr Checkout apps/web enthält, führen Sie zunächst das Web-Setup in einem anderen Terminal aus und lassen Sie diesen Server laufen. Schließen Sie das Postgres-Setup ab, bevor Sie die native Anmeldung oder Anmeldung versuchen. Ein rein mobiler Checkout enthält kein apps/web: Verbinden Sie ihn stattdessen mit Ihrem laufenden, separat bereitgestellten Backend. Beim Starten von Expo wird der Bildschirmvorschauserver gestartet, nicht das Backend.

Verbinden Sie Ihr Telefon und Ihren Computer mit demselben WLAN. Trennen Sie einen VPN vorübergehend, wenn er lokale Verbindungen blockiert. Mit localhost eines Telefons ist das Telefon selbst gemeint. Verwenden Sie die private Netzwerkadresse Ihres Computers für ein physisches Telefon oder Android-Gerät. Der iOS-Simulator auf demselben Mac kann http://localhost:3000, verwenden und der Android-Emulator verwendet üblicherweise http://10.0.2.2:3000.

corepack pnpm install

2. Suchen und testen Sie die Backend-Adresse

Führen Sie unter Windows ipconfig in einem neuen PowerShell-Terminal aus, suchen Sie Ihren aktiven WLAN-Adapter und lesen Sie die IPv4-Adresse. Öffnen Sie unter macOS Systemeinstellungen → WLAN → Details → TCP/IP und lesen Sie die IP-Adresse. Öffnen Sie unter Linux Ihre Netzwerkeinstellungen und lesen Sie die IPv4-Adresse. Eine Adresse könnte wie folgt aussehen: 192.168.1.25; Bei Ihnen wird es normalerweise anders sein.

Wenn die Adresse Ihres Computers 192.168.1.25 lautet, öffnen Sie http://192.168.1.25:3000 im Browser des Telefons, während der Webserver läuft. Ersetzen Sie Ihre tatsächliche Adresse. Die Homepage muss geladen werden, bevor Sie fortfahren können. Erlauben Sie die Node-App in privaten Netzwerken, wenn die Windows-Firewall Sie dazu auffordert. Wenn es nicht geladen wird, überprüfen Sie die Adresse, das WLAN, die Firewall und den laufenden Webserver. Ein Expo-Tunnel überträgt nur das Vorschaupaket und macht Ihren separaten API nicht erreichbar.

# Windows PowerShell only:
ipconfig

3. Erstellen Sie die Konfigurationsdatei der mobilen App

Erweitern Sie im Explorer des Editors Apps → Mobil, erstellen Sie eine neue Datei mit dem Namen .env.local und fügen Sie die Konfiguration unten in diese Datei ein. Ersetzen Sie 192.168.1.25 durch die Adresse, die Sie gerade getestet haben, oder verwenden Sie Ihre bereitgestellte HTTPS-Backend-Adresse. Speichern Sie die Datei. Sein vollständiger Pfad ist apps/mobile/.env.local; root .env wird von Expo nicht automatisch gelesen.

Lassen Sie die Kaufeinstellung des Telefons für die erste Vorschau deaktiviert. EXPO_PUBLIC_ bedeutet, dass eine Einstellung in der Telefon-App enthalten ist. Daher dürfen diese Werte nur öffentliche URLs, Schemata und öffentliche Clienteinstellungen enthalten. Fügen Sie hier keine KI-Anbieter-, Datenbank- oder Abrechnungsgeheimnisse ein. Der Webserver verfügt über einen eigenen apps/web/.env.local; Durch das Ändern der Mobile-Datei wird der Server nicht geändert.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off

4. Starten Sie Expo und öffnen Sie die Vorschau

Führen Sie im Repository-Stammverzeichnis den folgenden Befehl aus. Warten Sie auf einen QR-Code und die Metro-Wartemeldung. Halten Sie dieses Terminal und das Backend-Terminal geöffnet. Öffnen Sie auf Android Expo Go und scannen Sie den QR-Code; Verwenden Sie auf dem iPhone die Kamera, scannen Sie den Code und öffnen Sie ihn in Expo Go. Der QR-Code öffnet die Entwicklungs-App, nicht Ihre Backend-Homepage.

Erfolg bedeutet, dass der Anmeldebildschirm der App auf Ihrem Gerät geöffnet wird. Bei deaktivierten Käufen handelt es sich um eine UI-Vorschau. Schließen Sie die Einrichtung der datenbankgestützten Webauthentifizierung ab, bevor Sie die Anmeldung, gespeicherte Arbeitsbereiche oder den Chat testen. Wenn ein installierter Simulator Ihr Ziel ist, drücken Sie a im Expo-Terminal für Android oder i für iOS. Der iOS-Simulator erfordert macOS und Xcode; es kann nicht unter Windows ausgeführt werden.

corepack pnpm --filter @supastack/mobile start

5. Beheben Sie Vorschaufehler und testen Sie echte Abläufe

Wenn Expo Go ein inkompatibles Projekt meldet, vergleichen Sie das unterstützte Projekt SDK mit apps/mobile/package.json und verwenden Sie die kompatible Version von der offiziellen Expo-Seite. Aktualisieren Sie nicht die Abhängigkeitsversionen des Kits, nur um die Meldung zu verwerfen. Wenn ein erforderliches natives Modul nicht verfügbar ist, folgen Sie den Mobile-Builds für einen Entwicklungs-Build, der dieses Modul enthält.

Wenn die Anmeldung aufgrund eines Netzwerkfehlers fehlschlägt, versuchen Sie es zunächst erneut mit dem Backend URL im Browser des Telefons. Wenn URL funktioniert, aber die Anmeldung fehlschlägt, überprüfen Sie das Backend-Terminal und überprüfen Sie Postgres und Migrationen. Bei der lokalen /dashboard-Demositzung werden Sie nicht am Telefon angemeldet. Wenn die Konfiguration veraltet erscheint, drücken Sie Strg + C im Expo-Terminal, führen Sie dann den Neustartbefehl unten aus und öffnen Sie die Vorschau erneut.

Expo Go kann kein echtes StoreKit- oder Play Billing-Kauf-/Wiederherstellungsverhalten nachweisen. Folgen Sie In-App-Käufen und mobilen Builds für einen EAS-Entwicklungs-Build und speichern Sie Testkonten. Erstmalige native Builds und Kontoregistrierung können länger als fünf Minuten dauern. Um diese Vorschau zu stoppen, drücken Sie Strg + C im Expo-Terminal. Stoppen Sie das Backend separat, wenn Sie fertig sind.

corepack pnpm --filter @supastack/mobile start --clear