Skip to content

Latest commit

 

History

History
82 lines (58 loc) · 3.7 KB

README.md

File metadata and controls

82 lines (58 loc) · 3.7 KB
Raw

Campus Rallye App

Smartphone App für die Campus Rallye im ersten Semester an der DHBW Lörrach.

Basierend auf den Ergebnissen von Studienarbeiten an der DHBW Lörrach durchgeführt am Studienzentrum IT-Management & Informatik.

Setup für Entwickler

Vorbereitungen (Supabase)

Die Daten werden in Supabase gespeichert. Zur Weiterentwicklung und Test der Webanwendung sollte diese mit einer lokalen Supabase-Instanz auf dem eigenen Rechner verknüpft werden. Die Einrichtung einer lokalen Supabase-Instanz wird in der Supabase-Dokumentation beschrieben.

Hier werden die für dieses Projekt benötigten Schritte aufgelistet:

  • Supabase CLI installieren, siehe Supabase-Dokumentation
  • Docker installieren (Docker Desktop)
  • Verzeichnis für die lokale Supabase-Instanz erstellen, z.B. projects/rallye-db
  • Im Terminal in das eben erstellte Verzeichnis wechseln (cd rallye-db)
  • Dort diesen Befehl ausführen: supabase init
  • Supabase starten mit supabase start (Docker-Images werden heruntergeladen)
  • Aktuelles Datenbankschema und Datenbankinhalt vom Projektverantwortlichen anfragen
  • Das Datenbankschema als SQL-Datei speichern unter rallye-db/supabase/migrations/
  • Den Datenbankinhalt als Datei seed.sql speichern unter rallye-db/supabase/
  • Datenbank aus der Schema-SQL-Datei erstellen mit supabase db reset

Wenn alles geklappt hat, dann kann die lokale Supabase-Instanz mit dem Webinterface im Browser verwaltet werden: http://127.0.0.1:54323

Die Supabase-Instanz kann folgendermaßen heruntergefahren werden: supabase stop

Code der Campus Rallye App

Voraussetzungen für die Weiterentwicklung dieses Projekts sind folgende:

  • Node.js ist auf dem Entwicklungsgerät installiert.
  • Die lokale Supabase-Instanz wurde eingerichtet (siehe oben)

  1. Dieses Github-Repository clonen (mit git clone [email protected]:DHBWLoerrach/CampusRallyeApp.git oder einem Git-Client).

  2. In einem Terminal ins Verzeichnis des geclonten Repositories wechseln.

  3. Anschließend müssen mit npm die Abhängigkeiten bzw. npm-Pakete in NodeJS installiert werden: npm install

  4. Zum Schluss muss noch die Konfiguration zu Supabase angepasst werden. Dazu ist zunächst die Datei .env im Projektverzeichnis zu erstellen. In .env müssen zwei Einträge vorgenommen werden:

EXPO_PUBLIC_SUPABASE_URL=http://SERVER:54321
EXPO_PUBLIC_SUPABASE_ANON_KEY=SUPABASE_ANON_KEY

Der Eintrag für EXPO_PUBLIC_SUPABASE_URL muss die IP-Adresse des Servers enthalten. Wird die App auf einem iPhone-Simulator oder Android-Emulator auf dem Rechner ausgeführt, der die Supabase-Instanz bereitstellt, dann kann für SERVER die IP-Adresse von „localhost“ eingesetzt werden:

EXPO_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321

Wird die App auf einem Smartphone ausgeführt, dann ist für SERVER die IP-Adresse des Rechners einzutragen, auf dem die Supabase-Instanz läuft.

Für EXPO_PUBLIC_SUPABASE_ANON_KEY muss der Anon Key der Supbase-Instanz eingefügt werden. Dieser kann im Terminal abgefragt werden (dazu ins Verzeichnis der lokalen Supabase-Instanz wechseln):

supabase status

Nun kann die App getestet und weiterentwickelt werden. Für das aktive Testen muss nun mit npx expo -g der Server gestartet werden. Die App kann in Expo Go App getestet werden (Scan des QR-Codes). Informationen hierzu werden direkt auf der Konsole angezeigt.

Die Anmeldedaten für die Teilnahme an einer Rallye in der App können aus den entsprechenden Tabellen in der Supabase-Instanz in Erfahrung gebracht werden.