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

Voraussetzungen für das erfolgreiche Weiterentwickeln und lokale Testen dieses Projekts sind folgende:

• NodeJs ist auf dem Entwicklungsgerät installiert.
• Es ist ein Quelltext-Editor installiert.
• Ein Supabase Projekt wurde angelegt mit der entsprechenden Tabellenstruktur oder es besteht Zugriff auf das vorher verwendete Projekt.

1. Dieses Github-Repository clonen (mit git clone git@github.com: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. Dies ist aktuell irrelevant, weil die MapView vorübergehend deaktiviert wurde Nun muss noch die app.json Datei angepasst werden. Hier müssen nun die Google Maps Konfigurationen unter android und ios angepasst werden. Um die Nutzung von Google Maps zu ermöglichen, müssen die Maps SDKs jeweils für Android und iOS aktiviert werden und ein API Key erstellt werden. Eine Anleitung hierzu findet sich in der Expo Dokumentation zur Verwendung der MapView: https://docs.expo.dev/versions/latest/sdk/map-view/ (Hinweis: Verwende den Link in der Dokumentation unter “Create API Key” zum Erstellen des Keys. Bei anderen Vorgehensweisen wird sonst nach einem Rechnungskonto gefragt (trotz kostenloser Nutzung der API Keys). In Absprache mit den Verantwortlichen der DHBW kann hier natürlich auch ein von der DHBW gestelltes Mailkonto und auch ein Rechnungskonto verwendet werden. Für die Angabe des Package Namen bzw. Bundle Identifier muss dieser erst zur Verfügung stehen. Dies ist nach dem ersten Start eines Builds möglich (https://docs.expo.dev/build/setup/). Es genügt, den ersten Build zu starten und anschließend wieder abzubrechen. Der Package Name bzw. Bundle Identifier sollte nun in der app.json zu sehen sein.) Der API Key wird dann wie in der Dokumentation beschrieben an der entsprechenden Stelle in der app.json eingefügt (neben der config stehen natürlich noch weitere Konfigurationen unter android und ios):

   "android": {"config":{"googleMaps": {"apiKey":"YOUR_API_KEY"} } },
   "ios": {"config":{"googleMaps": {"apiKey":"YOUR_API_KEY"} } },
   

5. 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=SUPABASE_URL
EXPO_PUBLIC_SUPABASE_ANON_KEY=SUPABASE_ANON_KEY

Dort müssen nun die URL der Supabase-DB und der Anon Key eingefügt werden. Diese sind in den Einstellungen des Supabase Projekts in den API Einstellungen zu finden.

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.