Require installing a new release before use

[SamiPr0]

What changes for the user

When a newer release exists, PoolTrack no longer shows a dismissible dialog. The whole app is replaced by an "Update required" screen until the update is installed:

State	Screen	Way out
Update known	"Update required", version, size and release notes	Update only, no "Later"
Downloading	progress	Cancel returns to "Update required" (still blocked)
Downloaded	"Ready to install", or how to allow installs	Install
Failed	the error	Retry only, no "Close"

It shows before sign-in too, so nobody can use the app on an old version.

Rules

• Re-check on resume: besides app start, the app checks again when it comes back to the foreground, at most every 15 minutes (RECHECK_INTERVAL_MILLIS). Leaving the app open in the background doesn't dodge an update. It's spaced out to stay far below GitHub's 60 requests/hour limit for unauthenticated calls.
• Offline stays usable: if the check can't reach GitHub, nothing is known, so the app stays usable. The pass must stay reachable at the pool entrance even without signal.

Code

• UpdateDialog becomes UpdateRequiredScreen, a full screen in place of an AlertDialog. PoolTrackApp returns it instead of the rest of the app while UpdateUiState isn't None.
• UpdateViewModel:
  • onDismiss is removed;
  • onCancelDownload goes back to Available;
  • onResume re-checks when usable and the last check is old enough;
  • an injectable now clock for tests.

Tests

• UpdateRequiredScreenTest, 13 tests: no "Later"/"Close", Cancel only while downloading, Retry only on failure, full flow with the view model.
• UpdateViewModelTest, 19 tests: cancel keeps the update required; re-check before, at and after the interval; no re-check while blocked; a re-check that finds nothing keeps the app usable.
• MainActivityTest:
  • app blocked (no nav bars) when an update exists;
  • blocked before sign-in too;
  • usable when no update is known.
• ./gradlew ktfmtCheck check: BUILD SUCCESSFUL.

Shipping it

Phones on 1.1.1 still have the old dismissible dialog, so they'll see the release that contains this as a normal "Update available". From that version on, updates are mandatory. To release: bump appVersionName (e.g. 1.2.0), merge, tag.

🤖 Generated with Claude Code