Befehle, Dateien und Konfiguration

Ein Befehl geht in das Terminal

Ein Terminal ist das Fenster, in dem Sie Anweisungen für Ihren Computer eingeben. Öffnen Sie in Visual Studio Code zunächst Ihren Supastack-Ordner über Datei → Ordner öffnen und wählen Sie dann Terminal → Neues Terminal. Das neue Terminal startet in diesem Ordner. Unter Windows wählen Sie PowerShell über das Menü neben der +-Taste des Terminals. Verwenden Sie macOS/Linux-Blöcke in einem macOS- oder Linux-Terminal.

Fügen Sie jeweils nur den Inhalt eines Befehlsblocks ein und drücken Sie die Eingabetaste. Fügen Sie nicht die umgebenden Markdown-Backticks, eine Eingabeaufforderung wie PS C:\... oder eine Beispielausgabe ein. Zeilen, die mit # beginnen, sind Erläuterungen; Sie führen nichts aus. Warten Sie, bis jeder Installationsbefehl abgeschlossen ist, bevor Sie den nächsten Befehl eingeben. Ein Serverbefehl wird weiter ausgeführt und gibt erst dann eine neue Eingabeaufforderung zurück, wenn Sie ihn stoppen.

Überprüfen Sie, welchen Ordner das Terminal verwendet

Repository-Root bezeichnet den Supastack-Ordner der obersten Ebene, der package.json, pnpm-workspace.yaml, Apps und Pakete enthält. Sofern in einem Schritt nichts anderes angegeben ist, führen Sie die Befehle dort aus. Der folgende Befehl druckt den aktuellen Ordner; In der Dateiliste sollte „package.json“ angezeigt werden. Unter Windows funktionieren PowerShell pwd und ls auch.

Wenn die Auflistung nur den Inhalt von apps/mobile zeigt, geben Sie cd ../.. ein und drücken Sie die Eingabetaste, um zum Stammverzeichnis zurückzukehren. Wenn Ihr Basisordner angezeigt wird, geben Sie cd gefolgt von einem Leerzeichen und dem vollständigen Pfad zu Ihrem Klon ein — in Anführungszeichen, wenn er Leerzeichen enthält. Es ist meist einfacher, den Projektordner im Editor zu öffnen und ein neues Terminal zu erstellen.

pwd
ls

Die Konfiguration erfolgt in einer Datei, nicht im Terminal

Ein Block wie AI_PROVIDER=fake ist Konfigurationstext. Öffnen Sie die benannte .env-Datei im Editor, suchen Sie die Zeile, die mit AI_PROVIDER= beginnt, ersetzen Sie ihren Wert und speichern Sie mit Strg + S (Befehl + S unter macOS). Jede Einstellung belegt eine Zeile im KEY=value-Format. Fügen Sie keine Markdown-Backticks hinzu. Vermeiden Sie doppelte Kopien desselben Schlüssels in einer Datei.

Verwenden Sie apps/mobile/.env.local für Expo und die Stamm-.env für Datenbank-Migrationsbefehle. Expo lädt die Stamm-.env nicht automatisch. Das Web-Backend liest seine eigene apps/web/.env.local; bei einem reinen Mobile-Checkout gehört diese Datei zum separaten Backend-Repository, nicht zu diesem. Wenn sich die Backend-Adresse ändert, aktualisieren Sie EXPO_PUBLIC_API_URL in apps/mobile/.env.local und starten Sie Expo neu. Belassen Sie die Beispieldatei als Referenz unverändert.

Dateien, deren Namen mit einem Punkt beginnen, sind möglicherweise in Ihrem Dateimanager ausgeblendet. Der Explorer des Herausgebers zeigt sie an. Stellen Sie sicher, dass der Dateiname genau .env.local und nicht .env.local.txt lautet. Diese lokalen Dateien können Passwörter enthalten und sind von Git ausgeschlossen; Laden Sie sie nicht hoch und fügen Sie ihren Inhalt nicht in Support-Nachrichten ein.

• Finden Sie die Bedeutung jeder Einstellung

Halten Sie den Server am Laufen. Verwenden Sie ein anderes Terminal für Befehle

Der Expo-Entwicklungsserver liefert Ihre Bildschirme während der Arbeit an ein Telefon oder einen Simulator. Lassen Sie sein Terminal geöffnet, wenn ein Tutorial das Scannen des QR-Codes verlangt. Ein Serverbefehl läuft weiter und gibt keine neue Eingabeaufforderung zurück, bis Sie ihn stoppen.

Um einen anderen Befehl auszuführen, während der Server aktiv ist, wählen Sie im Editor Terminal → Neues Terminal. Das neue Terminal ist ein separates Fenster im selben Projekt. Um den Server zu stoppen, wählen Sie sein Terminal aus und drücken Sie einmal Strg + C. Wenn Sie unter Windows gefragt werden, ob Sie den Batch-Job beenden möchten, geben Sie „Y“ ein und drücken Sie die Eingabetaste. Warten Sie auf die normale Eingabeaufforderung, bevor Sie den Vorgang erneut starten.

Stoppen Sie Expo nach dem Bearbeiten von Expo-Einstellungen mit Strg + C und führen Sie dann den folgenden Befehl aus, um es neu zu starten und das zwischengespeicherte Bundle zu löschen. Das Speichern einer Quelldatei aktualisiert die Vorschau normalerweise automatisch, aber Umgebungsänderungen erfordern den Neustart.

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

Lesen Sie einen Fehler und bitten Sie um nützliche Hilfe

Wenn eine Installation einen roten Fehlertext zurückgibt, stoppen Sie bei diesem Schritt. Lesen Sie den ersten Fehler, anstatt die App weiter zu starten. Befehl nicht gefunden bedeutet normalerweise, dass ein Werkzeug fehlt; Kein package.json bedeutet normalerweise, dass es sich um den falschen Ordner handelt. ECONNREFUSED bedeutet normalerweise, dass ein erforderlicher Server oder eine erforderliche Datenbank nicht ausgeführt wird. EADDRINUSE bedeutet, dass ein anderer Prozess den Port bereits verwendet.

Wenn Sie um Hilfe bitten, geben Sie Ihr Betriebssystem, die Anleitung URL und die Schrittnummer, den genauen Befehl, den Sie eingegeben haben, und die erste Fehlermeldung an. Entfernen Sie Passwörter, API Schlüssel, Token und den Passwortteil jeder Datenbank URL. Senden Sie Ihre .env-Dateien nicht. Ein Screenshot des Fehlers kann hilfreich sein, kopierbarer Text ist jedoch einfacher zu diagnostizieren.

• Beheben Sie einen bestimmten Setup-Fehler