garmin_fernausloeser/README.md

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. Git (Versionsverwaltung):
   • Lade "Git für Windows" herunter: 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
   • Installiere es.
3. Android Studio:
   • Lade Android Studio herunter: developer.android.com
   • Installiere es mit den Standard-Einstellungen.
4. Visual Studio Code (VS Code):
   • Lade VS Code herunter: code.visualstudio.com
   • Installiere es.
5. Garmin SDK Manager:
   • Gehe zu Garmin Developer und lade den SDK Manager herunter.
   • Starte ihn, logge dich ein und lade das neueste SDK sowie die Geräte "Forerunner 955" und "Fenix 7s Pro" herunter.

2. Projekt herunterladen (Clonen)

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 "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 (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.
   • Klicke in Android Studio oben auf den grünen "Play"-Button (Run).
   • Erlaube den Zugriff auf die Kamera auf dem Handy!

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...".
   • 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 im Ordner garmin-app.
4. App auf die Uhr laden:
   • 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).
   • 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 / CLI

Voraussetzungen

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:

# Setup ausführen (lädt SDKs lokal) und bauen
chmod +x setup_and_build.sh
./setup_and_build.sh

Manuelle Kompilierung

Android:

cd android-app
./gradlew assembleDebug
# APK: app/build/outputs/apk/debug/app-debug.apk

Garmin:

monkeyc -o bin/app.prg -f monkey.jungle -y developer_key.der -d fenix7spro -w