df37d2a47c
- Add SyncProgress.kt: Data class for entire sync lifecycle UI state - Add SyncPhase enum: IDLE, PREPARING, UPLOADING, DOWNLOADING, IMPORTING_MARKDOWN, COMPLETED, ERROR - Rewrite SyncStateManager.kt: SyncProgress (StateFlow) is single source of truth - Remove pre-set phases: CHECKING_SERVER and SAVING cause flickering - UPLOADING phase only set when actual uploads happen - DOWNLOADING phase only set when actual downloads happen - IMPORTING_MARKDOWN phase only set when feature enabled - Add onProgress callback to uploadLocalNotes() with uploadedCount/totalToUpload - Add onProgress callback to downloadRemoteNotes() for actual downloads only - Progress display: x/y for uploads (known total), count for downloads (unknown) - Add SyncProgressBanner.kt: Unified banner (replaces dual system) - Update SyncStatusBanner.kt: Kept for legacy compatibility, only COMPLETED/ERROR - Update MainViewModel.kt: Remove _syncMessage, add syncProgress StateFlow - Update MainScreen.kt: Use only SyncProgressBanner (unified) - Update ComposeMainActivity.kt: Auto-hide COMPLETED (2s), ERROR (4s) via lifecycle - Add strings.xml (DE+EN): sync_phase_* and sync_wifi_only_error - Banner appears instantly on sync button click (PREPARING phase) - Silent auto-sync (onResume) completely silent, errors always shown - No misleading counters when nothing to sync Closes #IMPL_006
Simple Notes - Android App
🚧 Development Setup
Voraussetzungen
- Android Studio Hedgehog (2023.1.1) oder neuer
- JDK 17
- Android SDK 34
- Min SDK 24
Projekt in Android Studio öffnen
# In Android Studio:
# File → New → New Project
# Template: Empty Views Activity
#
# Settings:
# Name: Simple Notes
# Package: com.example.simplenotes
# Save location: /home/liq/gitProjects/simple-notes-sync/android/
# Language: Kotlin
# Minimum SDK: API 24
# Build configuration: Kotlin DSL
Dependencies
Siehe ANDROID_GUIDE.md in project-docs für vollständige build.gradle.kts:
Hauptabhängigkeiten:
- Sardine Android (WebDAV Client)
- Kotlin Coroutines
- Gson (JSON)
- WorkManager (Background Sync)
- Material Design Components
Projektstruktur
android/
└── app/
└── src/
└── main/
├── AndroidManifest.xml
├── java/com/example/simplenotes/
│ ├── MainActivity.kt
│ ├── NoteEditorActivity.kt
│ ├── SettingsActivity.kt
│ ├── models/
│ │ ├── Note.kt
│ │ └── SyncStatus.kt
│ ├── storage/
│ │ └── NotesStorage.kt
│ ├── sync/
│ │ ├── WebDavSyncService.kt
│ │ ├── WifiSyncReceiver.kt
│ │ ├── SyncWorker.kt
│ │ └── ConflictResolver.kt
│ ├── adapters/
│ │ └── NotesAdapter.kt
│ └── utils/
│ ├── DeviceIdGenerator.kt
│ ├── NotificationHelper.kt
│ ├── Extensions.kt
│ └── Constants.kt
└── res/
├── layout/
├── values/
└── drawable/
📖 Development Guide
Vollständige Code-Beispiele und Implementation:
🏗️ Build
# Debug Build
./gradlew assembleDebug
# Release Build
./gradlew assembleRelease
# Install on connected device
./gradlew installDebug
🧪 Testing
# Run unit tests
./gradlew test
# Run instrumented tests
./gradlew connectedAndroidTest
📝 TODO
- Projekt in Android Studio erstellen
- Dependencies einrichten
- Models implementieren (Note.kt, SyncStatus.kt)
- Storage Layer (NotesStorage.kt)
- UI Layouts erstellen
- Activities implementieren
- Sync Service (WebDavSyncService.kt)
- WLAN Detection (WifiSyncReceiver.kt)
- WorkManager Setup (SyncWorker.kt)
- Notifications (NotificationHelper.kt)
- Error Handling
- Testing
Next Step: Projekt in Android Studio erstellen und Code aus ANDROID_GUIDE.md übernehmen.