FitnessDroid/README.md

FitnessDroid

Android-klient för gym-API:t på https://gymapi.brasse-pc.eu/graphql — samma backend som gym-delen i brasse-pc.eu-v2.

• Kräver Android 12 eller nyare (minSdk 31)
• Kotlin + Jetpack Compose + Material 3 (Material You-dynamiska färger)
• GraphQL över OkHttp, tokenlagring i DataStore

Installera appen på telefonen

Ladda ner FitnessDroid.apk från släppsidan (latest byggs om vid varje push till main), öppna filen på telefonen och tillåt installation från okänd källa. Uppdateringar installeras ovanpå — samma signeringsnyckel används av CI och lokala byggen.

Bygga själv

Förutsättningar (Arch/Garuda)

sudo pacman -S jdk17-openjdk android-tools

Android SDK behövs också (platform 35 laddas ner automatiskt av bygget om licensen är accepterad). Peka ut din SDK i local.properties i repo-roten:

sdk.dir=/home/<du>/Android/Sdk

Bygg

git clone https://gitea.brasse-pc.eu/brasse/FitnessDroid.git && cd FitnessDroid
./gradlew :app:assembleRelease            # signerad release-APK
# APK: app/build/outputs/apk/release/app-release.apk

I VS Code: kör build-tasken (Ctrl+Skift+B) — den lägger APK:n i build/FitnessDroid.apk. Tasken installera på telefon (adb) installerar den direkt på en ansluten telefon med USB-felsökning på.

Testa lokalt i Waydroid

Waydroid (x86_64, Android 13) fungerar som emulator på brasse-linux01. Sessionen startas med waydroid session start + waydroid show-full-ui, sedan adb connect 192.168.240.112:5555 (IP:n från waydroid status) — första gången måste Allow USB debugging godkännas i Waydroid-fönstret. Installera med adb install -r app/build/outputs/apk/debug/app-debug.apk; skärmdumpar via adb exec-out screencap -p > fil.png, UI-koordinater via uiautomator dump. Saknar Android nät bortom värden är det Dockers FORWARD-spärr — se infra-Doc hosts/brasse-linux01.md (Waydroid-avsnittet). Testkonto: bb01.

Testa mot API:t

Logga in med ditt vanliga gym-konto (LDAP). API-url:en går att ändra under "Avancerat" på inloggningsskärmen (standard: https://gymapi.brasse-pc.eu/graphql).

Rekordstatus: träning / tävling / räknas ej

Under Statistik → Personbästa finns växeln Alla giltiga · Tävling · Träning. Tryck på ett rekord så öppnas ett ark med vikt, est. 1RM, datum, pass och anteckning, där lyftet kan märkas som Träning, Tävling eller Räknas ej (fusk, felregistrerat, ej godkänt) med en kommentar. Under arket visas topplistan för samma övning × reps ("näst i tur"), så ett bortplockat lyft kan väljas och återställas. Samma ark öppnas när man trycker på ett set i passhistoriken. Kortet Sök i rekorden överst i Personbästa svarar på "hur många reps på X kg?" eller "hur tungt på N reps?" – exakt träff eller närmast under/över, plus en uppskattning via bästa est. 1RM. Stjärnan på ett PB-kort gör övningen till favorit (samma favoriter som övningsväljaren) så att den ligger överst i PB-listan i både app och webb. "Räknas ej" tas ur rekord, 1RM och PB-höjdpunkter på servern (kod: ui/common/LiftStatusSheet.kt, API: setLiftStatus/setSessionSetStatus).

Kräver gym-API:t från 2026-09-06 eller senare (personalBests(mode), pbLookup, pbCandidates, liftDetail, setLiftStatus). Mot ett äldre API faller appen tillbaka på den gamla PB-frågan: rekorden visas fortfarande (favoriter hämtas via favoriteExercises), men lägesväxeln, sökkortet och detaljarket är avstängda och en notis säger att servern behöver uppdateras. Fel vid hämtningen visas under rubriken i stället för att listan tyst blir tom. Schemafel känns igen på HotChocolates "does not exist" (GraphQlException.isSchemaMismatch() i data/GraphQlClient.kt).

Signeringsnyckeln

Nyckeln är inte incheckad (repot är publikt). Lokalt ligger den i signing/fitnessdroid.jks + signing/keystore.properties (gitignorerade); CI får samma nyckel via Actions-secrets KEYSTORE_B64 och KEYSTORE_PASSWORD. Finns ingen nyckel signeras release-bygget med debug-nyckeln så att en färsk klon ändå kan bygga — men den APK:n kan inte uppdatera en installation från släppsidan (annan signatur).

Skapa en ny nyckel (om signing/ saknas):

keytool -genkeypair -keystore signing/fitnessdroid.jks -alias fitnessdroid \
  -keyalg RSA -keysize 2048 -validity 10950 -dname "CN=FitnessDroid, O=brasse-pc.eu"
# och skriv motsvarande signing/keystore.properties (storeFile/storePassword/keyAlias/keyPassword)

CI

.gitea/workflows/release.yaml bygger en signerad APK vid varje push till main och lägger den på den rullande latest-releasen. Bygget körs på runnern brasse-linux01-runner (x86_64, label linux-amd64) — Pi5:n orkar inte APK-bygget. Workflowen är ändå arkitekturvillkorad: på arm64 används en statiskt byggd aapt2 via android.aapt2FromMavenOverride.

Aktiviteter, kcal-mätare & mål

Utöver gympass loggar appen aktiviteter (promenad, löpning, vandring, fäktning/HEMA m.fl. — ~64 typer ur MET-kompendiet) med GPS-livespårning (osmdroid/OSM-karta, fartgrind mot GPS-hopp, accelerometer-rörelsevakt), RPE-slider för tidsbaserade aktiviteter och offline-kö. Hemskärmen visar dagens kalorier (aktivt loggat / telefonens steg via Health Connect / passiv BMR) och mål med progress (kcal, pass, steg, aktiviteter, km — per dag/vecka/månad). Statistiken har en konditionssektion ❤️. Plan & detaljer: doc/activities-plan.md.

Bluetooth-våg

Appen kan hämta vägningar (vikt + muskel/fett/vatten-%) direkt från en BLE-personvåg med openScales drivrutiner (vendrade under app/src/main/java/com/health/openscale/). Koppla vågen under Inställningar → Bluetooth-våg och väg dig från profilen. Först ut: Biltema 84-1002 (PT-727), som är en Exingtech Y1 ("VScale"). Detaljer: doc/openscale-integration.md.

Licens

GPL-3.0 (se LICENSE). Relicensierad från och med BT-vågstödet — openScales drivrutiner är GPL-3.0, vilket kräver att hela appen är det. BLE-biblioteket Blessed-Kotlin är MIT.

Mer om arkitektur och planer: doc/plan.md och wikin.