bollwerkadmin/bollwerk
1
0
Fork 0
Code Issues 12 Pull requests Projects Releases Packages Wiki Activity Actions

Self-Update App: Update-Dialog, Installation & App-Start-Integration #85

New issue
Closed
opened 2026-05-17 00:22:56 +00:00 by jreinemann-euris · 0 comments
jreinemann-euris commented 2026-05-17 00:22:56 +00:00 (Migrated from github.com)
Copy link

Feature: App – Update-Dialog, Installation & App-Start-Integration

Part of: #69
Depends on: Server-Ticket (Version-Endpoint) und App-Data-Layer-Ticket (UpdateRepository, CheckForUpdateUseCase)

Ziel

Die App zeigt beim Start einen nicht-blockierenden Banner wenn ein Update verfügbar ist. Der Nutzer kann die APK herunterladen und den Android-Installer starten.

Scope

  • REQUEST_INSTALL_PACKAGES-Permission im AndroidManifest
  • FileProvider-Pfad für cache/update/ in file_paths.xml ergänzen
  • UpdateViewModel: State-Management für Update-Check, Download-Progress, Installation
  • UpdateBanner (Composable): Nicht-blockierender Banner mit "Jetzt aktualisieren"-Button
  • Download-Progress-Anzeige (LinearProgressIndicator im Banner)
  • Intent(Intent.ACTION_VIEW) mit FileProvider-URI und application/vnd.android.package-archive MIME-Type
  • Integration in MainScreen: Update-Check beim App-Start, Banner über dem Content
  • Prüfung nur wenn Server-URL konfiguriert ist (opt-in)

Technische Hinweise

  • Bestehende MainActivity nutzt lifecycleScope für Seed, ähnlich für Update-Check möglich
  • FileProvider-Authority: de.krisenvorrat.app.fileprovider (bereits konfiguriert)
  • file_paths.xml existiert bereits mit exports/ und camera/ – update/ ergänzen
  • Android 8+ erfordert REQUEST_INSTALL_PACKAGES und einmalige User-Bestätigung
  • Intent.FLAG_GRANT_READ_URI_PERMISSION setzen für FileProvider-URI
  • ACTION_VIEW statt ACTION_INSTALL_PACKAGE (deprecated seit API 29)

Akzeptanzkriterien

  • App zeigt nach Start einen nicht-blockierenden Banner wenn Update verfügbar
  • Banner zeigt Versionsnummer des verfügbaren Updates
  • "Jetzt aktualisieren" startet Download mit Fortschrittsanzeige
  • Nach Download wird der Android-Installer geöffnet
  • Kein Update-Check wenn keine Server-URL konfiguriert ist
  • Banner kann vom Nutzer geschlossen/ignoriert werden
  • Tests für UpdateViewModel (Update verfügbar, kein Update, Fehler, Download-Fortschritt)
## Feature: App – Update-Dialog, Installation & App-Start-Integration Part of: #69 Depends on: Server-Ticket (Version-Endpoint) und App-Data-Layer-Ticket (UpdateRepository, CheckForUpdateUseCase) ### Ziel Die App zeigt beim Start einen nicht-blockierenden Banner wenn ein Update verfügbar ist. Der Nutzer kann die APK herunterladen und den Android-Installer starten. ### Scope - `REQUEST_INSTALL_PACKAGES`-Permission im AndroidManifest - FileProvider-Pfad für `cache/update/` in `file_paths.xml` ergänzen - `UpdateViewModel`: State-Management für Update-Check, Download-Progress, Installation - `UpdateBanner` (Composable): Nicht-blockierender Banner mit "Jetzt aktualisieren"-Button - Download-Progress-Anzeige (LinearProgressIndicator im Banner) - `Intent(Intent.ACTION_VIEW)` mit FileProvider-URI und `application/vnd.android.package-archive` MIME-Type - Integration in `MainScreen`: Update-Check beim App-Start, Banner über dem Content - Prüfung nur wenn Server-URL konfiguriert ist (opt-in) ### Technische Hinweise - Bestehende `MainActivity` nutzt `lifecycleScope` für Seed, ähnlich für Update-Check möglich - FileProvider-Authority: `de.krisenvorrat.app.fileprovider` (bereits konfiguriert) - `file_paths.xml` existiert bereits mit `exports/` und `camera/` – `update/` ergänzen - Android 8+ erfordert `REQUEST_INSTALL_PACKAGES` und einmalige User-Bestätigung - `Intent.FLAG_GRANT_READ_URI_PERMISSION` setzen für FileProvider-URI - `ACTION_VIEW` statt `ACTION_INSTALL_PACKAGE` (deprecated seit API 29) ### Akzeptanzkriterien - [ ] App zeigt nach Start einen nicht-blockierenden Banner wenn Update verfügbar - [ ] Banner zeigt Versionsnummer des verfügbaren Updates - [ ] "Jetzt aktualisieren" startet Download mit Fortschrittsanzeige - [ ] Nach Download wird der Android-Installer geöffnet - [ ] Kein Update-Check wenn keine Server-URL konfiguriert ist - [ ] Banner kann vom Nutzer geschlossen/ignoriert werden - [ ] Tests für UpdateViewModel (Update verfügbar, kein Update, Fehler, Download-Fortschritt)
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels   
block-planning

   
bug

Something isn't working

  
documentation

Improvements or additions to documentation

  
duplicate

This issue or pull request already exists

  
enhancement

New feature or request

  
feature

   
good first issue

Good for newcomers

  
help wanted

Extra attention is needed

  
infrastructure

   
invalid

This doesn't seem right

  
planning

   
priority:high

   
priority:low

   
question

Further information is requested

  
refactoring

   
status:backlog

Im Backlog

  
status:done

Abgeschlossen

  
status:in-progress

Aktuell in Bearbeitung

  
status:todo

Naechstes Todo-Ticket

  
tech-decision

   
test

   
wontfix

This will not be worked on

No labels
block-planning
bug
documentation
duplicate
enhancement
feature
good first issue
help wanted
infrastructure
invalid
planning
priority:high
priority:low
question
refactoring
status:backlog
status:done
status:in-progress
status:todo
tech-decision
test
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: bollwerkadmin/bollwerk#85
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?