CocktailShaker App

English Readme

Ein Projekt für die Veranstaltung Content Verwertungsmodelle und ihre Umsetzung in mobilen Systemen unter Dr. Jürgen Nützel.

Für den Rahmen der App war vorgegeben:

• eine Native oder Hybride App für mobile Endgeräte
• mindestens ein Sensor des Endgeräts muss verwendet werden (Kamera, Geolocation,...)
• die App muss sich mit einem Server verbinden (keine offline App)

Warnung

Das Projekt ist nicht kommerziell. Es ist lediglich ein Projekt während einer universitären Veranstaltung. Alle Informationen, Ressourcen oder Markennamen, die im Text vorkommen oder auf den Fotos zu sehen sind, werden nur zu Informations- und Demonstrationszwecken bereitgestellt. Jegliche Art von direktem oder indirektem Marketing wird nicht angenommen. Die Autoren des Projekts warnen vor den Schäden, die Alkohol anrichtet, und übernehmen keine Verantwortung für ein Ergebnis der Verwendung der eingestellten Inhalte. Alle Cocktailrezepte dienen nur zur Information. Bei der Erstellung dieses Projekts wurden keine Food-Blogger, Barkeeper oder Programmierer geschädigt.

Quellen und Bibliotheken

• die (CocktailDB)[https://www.thecocktaildb.com/] API; der eigene API Schlüssel kann in der App gespeichert werden
• Cocktails der International Bartenders Association (Teijo)
• Gläser
• Bibliothek für Apps Ionic
• JS Framework Vue
• Kompabilität für mobile Systeme Capacitor

Lokal weiterentwickeln

1. Installiere NodeJS in der aktuellen LTS Version (>=14.15)
2. Installiere die Ionic CLI ionic global: npm install -g ionic
3. Klone das Repository git clone https://github.com/wieerwill/cocktailshaker-app.git
4. In den neuen Ordner wechseln cd cocktailshaker-app
5. Pakete mit npm install installieren
6. den Entwicklungsserver mit ionic serve starten
7. Folge dem Link in der Konsole um die App im Browser oder Smartphone zu betrachten

Deploy

Um alles für eine Produktionsfertige App bereitzustellen führe diesen Befehl aus:

npm run build

Das wird alle Dateien im dist/ Ordner erstellen und updaten

Build general

1. bei jedem Build Prozess müssen die Capacitor Ordner aktualisiert werden: ionic cap copy
2. nach Updates oder großen Änderungen des Codes (neues Plugin) muss Capacitor synchronisiert werden: ionic cap sync

• Android build
  1. Du benötigst die Android SDK.
     • der einfachste Weg auf einem Mac ist homebrew: brew install android-sdk
     • auf Linux kann man den Paketmanager nutzen: sudo apt-get install android-sdk or via
     • Flatpak or
     • Snap
  2. die App im Android Studio öffnen ionic cap open android
  3. Um die App zu veröffentlichen benötigst musst du diese signieren. Für lokale Tests ist eine Beispieldatei unter

     cp android/signing/keystore.properties.example
     

  4. Möglicherweise musst du den Wert von storeFile für deine Platform anpassen

     storeFile=~/.android/debug.keystore
     

• iOS build in XCode öffnen ionic cap open ios

Lizenz

Das Projekt läuft unter der MIT Lizenz.