Files
Calendarr-Android/claude.md
Guido Schmit a015a45265 chore: get Android project building (toolchain, deps, manifest, launcher icon)
- Fix dependency versions (Retrofit 2.11, OkHttp 4.12, Compose BOM)
- Add Material Components for the app theme
- Add --add-exports/--add-opens for kapt on JDK 21
- Remove deprecated manifest package attr; add INTERNET permission
- Add adaptive launcher icon

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-05-31 11:44:48 +02:00

1.9 KiB
Raw Blame History

Calendarr Android

Projektübersicht

Android-App für den Calendarr-Server. Funktionsgleich mit der iOS-App (Swift, liegt unter ../Calendarr iOS/). Der Server-Code liegt unter ../Calendarr server/.

⚠️ WICHTIG: Read-Only Ordner

Die folgenden Ordner dienen NUR zur Referenz. NIEMALS Dateien darin verändern, löschen oder erstellen:

  • ../Calendarr iOS/ → READ ONLY nur zur Analyse der Features und API-Nutzung
  • ../Calendarr server/ → READ ONLY nur zur Analyse der API-Endpunkte und Datenmodelle

Alle Änderungen und neue Dateien kommen ausschliesslich in ../Calendarr Android/.

Server

  • Basis-URL (Prod): https://cal.scarriffle.com
  • Auth: Erst Server-URL eingeben, dann Benutzername + Passwort
  • Credentials werden auf Android im EncryptedSharedPreferences gespeichert (Äquivalent zu Apple Keychain)

Tech Stack

  • Sprache: Kotlin
  • UI: Jetpack Compose + Material 3
  • Architektur: MVVM
  • Netzwerk: Retrofit + OkHttp
  • Lokale Speicherung: EncryptedSharedPreferences (Credentials), Room (Cache)
  • Async: Coroutines + Flow
  • DI: Hilt

Projektstruktur

  • ../Calendarr iOS/ → READ ONLY Swift-App als Referenz
  • ../Calendarr server/ → READ ONLY Server als Referenz
  • ../Calendarr Android/ → dieses Projekt, hier wird gebaut

Git

Build

  • Debug APK: ./gradlew assembleDebug
  • Release APK: ./gradlew assembleRelease
  • Tests: ./gradlew test

Konventionen

  • Kein XML für Layouts ausschliesslich Jetpack Compose
  • ViewModels dürfen keine Android-Framework-Klassen direkt referenzieren
  • StateFlow für UI-State, keine LiveData
  • Alle Strings in res/values/strings.xml
  • Vor jedem Push: ./gradlew build muss fehlerfrei durchlaufen