Skip to content

README.md

Latest commit

 

History

History
80 lines (57 loc) · 2.71 KB

README.md

File metadata and controls

80 lines (57 loc) · 2.71 KB

Next Wave - Android

Next Wave ist eine App für Wakesurfer und Foiler, die Bootswellen auf Schweizer Seen verfolgen können. Diese Android-Version wurde mit Kotlin und modernen Android-Entwicklungstechnologien entwickelt.

Funktionen

  • Kartenfunktionen:

    • OpenStreetMap-Integration für detaillierte Wassernavigation
    • Overlay für Schifffahrtsrouten
    • Clustering von Stationen für bessere Übersicht
    • Automatisches Caching der Karten für Offline-Nutzung
    • Optimiert für hellen und dunklen Modus

  • Schiffsdaten und Wellenberechnung:

    • Anzeige von Schiffsdaten
    • Berechnung von Welleneigenschaften (Höhe, Länge, Periode, etc.)
    • Wellenbewertung (1-3 Wellen)

  • API-Integration:

    • Echtzeit-Schiffseinsätze
    • Aktuelle Schiff-Kurs-Zuweisungen

  • Datenschutz:

    • Keine Verfolgung oder Analyse
    • Keine Sammlung persönlicher Daten
    • Standortdaten werden nur für die Anzeige der nächsten Station verwendet

Technologien

  • Kotlin: Moderne, typsichere Programmiersprache für Android
  • Jetpack Compose: Deklaratives UI-Framework für moderne Android-Apps
  • MVVM-Architektur: Klare Trennung von UI, Logik und Daten
  • Coroutines & Flow: Asynchrone Programmierung für reaktive Datenströme
  • OSMDroid: OpenStreetMap-Integration für Android
  • Retrofit & OkHttp: Netzwerkkommunikation mit der Next Wave API
  • Material Design 3: Moderne UI-Komponenten und Theming

Anforderungen

  • Android 8.0 (API Level 26) oder höher
  • Internetverbindung für Echtzeit-Daten
  • Standortzugriff für lokale Funktionen

Installation

  1. Lade die APK von der Releases-Seite herunter
  2. Aktiviere "Installation aus unbekannten Quellen" in den Einstellungen deines Geräts
  3. Öffne die heruntergeladene APK-Datei und installiere die App

Alternativ kannst du das Projekt klonen und in Android Studio öffnen:

git clone https://github.com/yourusername/nextwave-android.git

Entwicklung

Projektstruktur

  • app/src/main/java/com/example/nextwave/
    • data/: Datenmodelle, Repository und API-Dienste
    • ui/: UI-Komponenten und ViewModels
    • MainActivity.kt: Haupteinstiegspunkt der App
    • NextWaveApplication.kt: Anwendungsklasse für globale Konfiguration

Bauen und Ausführen

  1. Öffne das Projekt in Android Studio
  2. Synchronisiere das Projekt mit Gradle
  3. Führe die App auf einem Emulator oder Gerät aus

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die LICENSE Datei für Details.

Danksagungen

  • Basierend auf der iOS-Version von Next Wave
  • Verwendet OSMDroid für Kartenfunktionen
  • Inspiriert von der Schweizer Schifffahrtsgemeinschaft