Die mobile App konfigurieren

Einrichtung und Konfiguration

Gerätebezogene Werte gehören in apps/mobile/.env.local; Expo liest diese Datei, nicht die .env im Repository-Stamm. EXPO_PUBLIC_API_URL ist der Web-Backend-Ursprung, den das Telefon erreicht — derselbe Wert, den du im Telefonbrowser getestet hast. EXPO_PUBLIC_APP_SCHEME ist das native URI-Schema der App; verwende einen Reverse-DNS-Wert wie com.example.app.

app.json verwaltet Produktname, Slug, Version, Bundle-ID und Plugins. app.config.ts leitet das Deep-Link-Schema und die Produktions-Ursprünge aus EXPO_PUBLIC_APP_SCHEME ab; eine Schemaänderung erfordert daher einen nativen Neubau, nicht nur einen Metro-Neustart. Füge auf dem Server jeden Ursprung, den die App nutzt, zu MOBILE_ALLOWED_ORIGINS hinzu; die Übergabe schlägt fehl, wenn beide Seiten nicht übereinstimmen.

Jeder EXPO_PUBLIC_*-Wert wird in die App gebündelt. Halte Anbieterschlüssel auf dem Server und nutze öffentliche Werte nur für Adressen und Schemata.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=com.example.app

Implementierungsablauf

Starte Expo nach einer Änderung an .env.local neu. Führe die Pakettests und die Typprüfung aus und bestätige das aufgelöste Schema mit einem Entwicklungs-Build: Öffne einen Auth-Callback-Link und prüfe, ob er zur App statt zum Browser zurückkehrt. Expo Go kann benutzerdefinierte Schemata deines nativen Builds nicht validieren.

Überprüfung und Fehlerbehebung

Starte Expo nach einer Änderung an .env.local neu und öffne die Vorschau auf dem Zielgerät. Wechsle das Theme, starte die App neu und bestätige, dass die Auswahl bleibt; löse dann einen Deep Link aus und prüfe, dass die App ihn statt des Browsers verarbeitet.