diff --git a/README.md b/README.md index 5936f1c..fce95d5 100644 --- a/README.md +++ b/README.md @@ -14,65 +14,96 @@ Diese Anleitung ist für Nutzer gedacht, die das Projekt auf einem Windows-PC ko ### 1. Vorbereitungen installieren Bevor es losgeht, installiere bitte folgende Programme: -1. **Java JDK 17:** +1. **Git (Versionsverwaltung):** + * Lade "Git für Windows" herunter: [git-scm.com/download/win](https://git-scm.com/download/win) + * Installiere es (einfach immer "Weiter" klicken). +2. **Java JDK 17:** * Lade das "JDK 17" für Windows (x64 Installer) herunter: [Oracle Java Downloads](https://www.oracle.com/java/technologies/downloads/#java17) - * Führe die `.exe` aus und klicke dich durch ("Weiter", "Weiter"...). -2. **Android Studio:** + * Installiere es. +3. **Android Studio:** * Lade Android Studio herunter: [developer.android.com](https://developer.android.com/studio) * Installiere es mit den Standard-Einstellungen. -3. **Visual Studio Code (VS Code):** +4. **Visual Studio Code (VS Code):** * Lade VS Code herunter: [code.visualstudio.com](https://code.visualstudio.com/) * Installiere es. -4. **Garmin SDK Manager:** +5. **Garmin SDK Manager:** * Gehe zu [Garmin Developer](https://developer.garmin.com/connect-iq/sdk-manager/) und lade den SDK Manager herunter. - * Starte ihn, logge dich ein (oder erstelle einen Account) und lade das neueste SDK sowie die Geräte "Forerunner 955" und "Fenix 7s Pro" herunter. + * Starte ihn, logge dich ein und lade das neueste SDK sowie die Geräte "Forerunner 955" und "Fenix 7s Pro" herunter. -### 2. Android App einrichten (Das Handy-Programm) +### 2. Projekt herunterladen (Clonen) -1. **Projekt öffnen:** +Anstatt ZIP-Dateien herunterzuladen, nutzen wir Git direkt in Android Studio, um alles sauber zu bekommen. + +### 3. Android App einrichten (Das Handy-Programm) + +1. **Projekt in Android Studio laden:** * Starte Android Studio. - * Klicke auf "Open" und wähle den Ordner `android-app` aus diesem Projekt aus. - * Warte kurz, bis Android Studio alles geladen hat (unten rechts läuft ein Balken). + * Klicke auf **"Get from VCS"** (oder "Get from Version Control"). + * Gib bei URL ein: `https://git.klenzel.net/admin/garmin_fernausloeser.git` + * Klicke auf "Clone". + * Das Projekt wird nun heruntergeladen und geöffnet. 2. **Connect IQ Bibliothek hinzufügen:** * Lade das **"Connect IQ Mobile SDK"** von der Garmin-Webseite herunter. * Entpacke die ZIP-Datei. * Suche darin die Datei `connectiq.jar` (manchmal in einem Unterordner). - * Kopiere diese Datei in deinen Projektordner nach: `android-app/app/libs/` (wenn der Ordner `libs` fehlt, erstelle ihn einfach). + * Kopiere diese Datei in deinen Projektordner (im Windows Explorer) nach: `garmin_fernausloeser/android-app/app/libs/` (wenn der Ordner `libs` fehlt, erstelle ihn). 3. **App installieren:** * Schalte auf deinem Samsung Handy den **Entwicklermodus** an (Einstellungen -> Telefoninfo -> Softwareinformationen -> 7x auf "Buildnummer" tippen). * Aktiviere **USB-Debugging** in den Entwickleroptionen. * Verbinde das Handy per USB mit dem PC. - * In Android Studio: Wähle oben dein Handy aus und klicke auf den grünen **"Play"**-Button (Run). - * Die App sollte nun auf dem Handy starten. Erlaube den Zugriff auf die Kamera! + * Klicke in Android Studio oben auf den grünen **"Play"**-Button (Run). + * Erlaube den Zugriff auf die Kamera auf dem Handy! -### 3. Garmin App einrichten (Das Uhr-Programm) +### 4. Garmin App einrichten (Das Uhr-Programm) 1. **VS Code einrichten:** * Starte Visual Studio Code. * Klicke links auf das "Puzzle"-Symbol (Extensions). * Suche nach **"Monkey C"** (von Garmin) und installiere es. 2. **Projekt öffnen:** - * Gehe in VS Code auf "Datei" -> "Ordner öffnen..." und wähle den Ordner `garmin-app` aus. + * Gehe in VS Code auf "Datei" -> "Ordner öffnen...". + * Wähle den Unterordner `garmin-app` aus dem Verzeichnis, das Android Studio gerade heruntergeladen hat (`garmin_fernausloeser/garmin-app`). 3. **Entwickler-Schlüssel erstellen:** * Drücke `Strg + Umschalt + P`. * Tippe ein: `Connect IQ: Generate Developer Key`. - * Speichere die Datei einfach im Ordner `garmin-app` als `developer_key.der`. + * Speichere die Datei im Ordner `garmin-app`. 4. **App auf die Uhr laden:** - * Verbinde deine Garmin Uhr per USB-Kabel mit dem PC. - * Drücke in VS Code wieder `Strg + Umschalt + P`. + * Verbinde deine Garmin Uhr per USB-Kabel. + * Drücke `Strg + Umschalt + P`. * Tippe ein: `Connect IQ: Build for Device`. * Wähle deine Uhr aus (z.B. `fenix7spro`). - * Es entsteht eine Datei im Ordner `bin/` (z.B. `foto_companion.prg`). - * Kopiere diese `.prg` Datei im Windows Explorer auf das Laufwerk deiner Uhr in den Ordner: `GARMIN/APPS/`. - * Ziehe das Kabel ab. Die App ist nun auf der Uhr installiert! + * Die erstellte Datei (`foto_companion.prg`) liegt nun im Ordner `bin/`. + * Kopiere sie im Explorer in den Uhr-Ordner: `GARMIN/APPS/`. --- -## 🐧 Anleitung für Linux / Experten - -### Struktur -* `android-app/`: Android Quellcode (Kotlin, CameraX, Compose). -* `garmin-app/`: Connect IQ Quellcode (Monkey C). +## 🐧 Anleitung für Linux / CLI ### Voraussetzungen -... (siehe bisherige Anleitung unten) +1. **Java 17 (JDK):** `sudo apt install openjdk-17-jdk` +2. **Android SDK Command Line Tools** +3. **Garmin Connect IQ SDK** (Entpackt und `bin/` im PATH) +4. **Connect IQ Mobile SDK** (`connectiq.jar` in `android-app/app/libs/`) + +### Build Skript +Für Linux-Nutzer liegt ein automatisches Build-Skript bei: + +```bash +# Setup ausführen (lädt SDKs lokal) und bauen +chmod +x setup_and_build.sh +./setup_and_build.sh +``` + +### Manuelle Kompilierung + +**Android:** +```bash +cd android-app +./gradlew assembleDebug +# APK: app/build/outputs/apk/debug/app-debug.apk +``` + +**Garmin:** +```bash +monkeyc -o bin/app.prg -f monkey.jungle -y developer_key.der -d fenix7spro -w +``` \ No newline at end of file