T12-T14: platform liveness via geolocator; drop flutter_foreground_task

geolocator_android's ForegroundNotificationConfig raises a service with
foregroundServiceType=location and holds a wake lock for as long as the position
stream is subscribed, and the plugin declares that service in its own manifest.
That covers everything the native TrackingService used a foreground service and
a PARTIAL_WAKE_LOCK for, so flutter_foreground_task is gone -- and with it both
deprecation warnings that were recorded under T01.

Known parity gap for T27: geolocator's notification cannot carry actions, so the
native Pause/Resume buttons in the shade are not reproduced.

iOS: UIBackgroundModes plus allowBackgroundLocationUpdates keep the isolate and
the writer timer alive while updates flow. Two settings matter more than they
look -- pauseLocationUpdatesAutomatically is false because CoreLocation does not
reliably restart, and activityType is otherNavigation rather than
automotiveNavigation, which would snap fixes to the road network and silently
falsify the recorded path. Usage strings are specific, not generic.

Android deliberately does not request ACCESS_BACKGROUND_LOCATION: a foreground
service with a visible notification is exactly the supported case, and asking
would trigger the harder "Allow all the time" flow for no benefit.

T14 process-death resume is implemented and called at startup, covered by four
tests including the 111 km crash-gap guard.

Verified by building both platforms and launching on the iOS simulator: Drift
opened, Riverpod resolved, restore found no active trip, controls correct.
lib/main.dart is a harness so the pipeline can be exercised on hardware before
Phase 4 builds screens; T15 replaces it.

Phase 3 done: 145 tests passing, analyze clean.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-15 12:14:37 -05:00
parent 5a7c598610
commit ee3ef74331
10 changed files with 462 additions and 121 deletions

View File

@@ -66,5 +66,25 @@
<string>UIInterfaceOrientationLandscapeLeft</string>
<string>UIInterfaceOrientationLandscapeRight</string>
</array>
<!-- Location usage strings.
Apple Guideline 5.1.1 rejections are most often caused by generic text like
"This app needs location". These say specifically what is collected, why, and
what the user gets for it. -->
<key>NSLocationWhenInUseUsageDescription</key>
<string>Rippr records the GPS track of your ride so you can see your route, speed and distance afterwards. Nothing is recorded until you press Start.</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>Rippr keeps recording your route while your phone is in your pocket or the screen is off, so a ride you started is captured from beginning to end. Recording stops the moment you press Stop.</string>
<!-- Keeps the process, the Dart isolate and the writer timer alive while location
updates are being delivered. Without this the OS suspends the app the moment the
screen locks and the ride simply stops being recorded.
Paired in code with allowBackgroundLocationUpdates and
pauseLocationUpdatesAutomatically = false; see geolocator_location_source.dart. -->
<key>UIBackgroundModes</key>
<array>
<string>location</string>
</array>
</dict>
</plist>