Files
garmin_fernausloeser/README.md

79 lines
3.8 KiB
Markdown

# Foto Companion & Garmin Remote
Ein Fernauslöser-System für Samsung Galaxy Smartphones und Garmin Smartwatches (Forerunner 955, Fenix 7s Pro) mit Live-Vorschau.
## Repository
`https://git.klenzel.net/admin/garmin_fernausloeser`
---
## 🖥️ Anleitung für Windows (Schritt-für-Schritt)
Diese Anleitung ist für Nutzer gedacht, die das Projekt auf einem Windows-PC kompilieren und installieren möchten.
### 1. Vorbereitungen installieren
Bevor es losgeht, installiere bitte folgende Programme:
1. **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:**
* Lade Android Studio herunter: [developer.android.com](https://developer.android.com/studio)
* Installiere es mit den Standard-Einstellungen.
3. **Visual Studio Code (VS Code):**
* Lade VS Code herunter: [code.visualstudio.com](https://code.visualstudio.com/)
* Installiere es.
4. **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.
### 2. Android App einrichten (Das Handy-Programm)
1. **Projekt öffnen:**
* 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).
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).
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!
### 3. 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.
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`.
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`.
* 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!
---
## 🐧 Anleitung für Linux / Experten
### Struktur
* `android-app/`: Android Quellcode (Kotlin, CameraX, Compose).
* `garmin-app/`: Connect IQ Quellcode (Monkey C).
### Voraussetzungen
... (siehe bisherige Anleitung unten)