Add Live Activity and watchOS support for mapping sessions

.github/workflows/ci.yml

@@ -23,5 +23,4 @@ jobs:
       - run: dart run build_runner build --delete-conflicting-outputs
       - run: dart format --output=none --set-exit-if-changed .
       - run: flutter analyze
-      #- run: flutter test
-      # no tests yet, fails without ./test directory
+      - run: flutter test

docs/LIVE_ACTIVITIES.md

@@ -0,0 +1,29 @@
+# iOS Live Activities
+
+MeshMapper starts one read-only Live Activity while an automatic wardriving session or manual ping cycle is active. It mirrors the same state used by the in-app controls.
+
+## Displayed information
+
+- Current mode and phase (`Sending`, `Listening`, `Next ping`, `Cooldown`, GPS/zone/reconnect states)
+- System-rendered countdowns based on absolute timer deadlines
+- The strongest repeaters from the current or latest completed cycle, sorted by SNR
+- TX/RX counters, upload queue, zone, connection state, and stale-update warnings
+- Lock Screen, Dynamic Island, and an iOS 18 small-family layout suitable for CarPlay on supported systems
+
+## Architecture
+
+- Dart builds a compact `LiveActivitySnapshot` from `AppStateProvider`.
+- `LiveActivityService` deduplicates and throttles noncritical updates before sending them over `meshmapper/live_activity`.
+- `LiveActivityManager` creates, updates, deduplicates, and ends the native ActivityKit activity.
+- `MeshMapperLiveActivityExtension` renders the snapshot using SwiftUI and WidgetKit.
+
+No push server or App Group is required. The Live Activity does not replace the existing BLE/location background execution; it only presents its state.
+
+## Platform requirements
+
+- Live Activity: iOS 16.2 or later
+- Small supplemental activity family: iOS 18 or later
+- CarPlay presentation of Live Activities: iOS 26 or later
+- A physical iPhone is recommended for final background, Dynamic Island, and CarPlay validation
+
+The main Runner target keeps its existing deployment target. Unsupported devices skip ActivityKit creation.

ios/Flutter/LiveActivity.xcconfig

@@ -0,0 +1 @@
+#include "Generated.xcconfig"

ios/MeshMapperLiveActivity/Info.plist

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDisplayName</key>
+	<string>MeshMapper</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>XPC!</string>
+	<key>CFBundleShortVersionString</key>
+	<string>$(FLUTTER_BUILD_NAME)</string>
+	<key>CFBundleVersion</key>
+	<string>$(FLUTTER_BUILD_NUMBER)</string>
+	<key>NSSupportsLiveActivities</key>
+	<true/>
+	<key>NSExtension</key>
+	<dict>
+		<key>NSExtensionPointIdentifier</key>
+		<string>com.apple.widgetkit-extension</string>
+	</dict>
+</dict>
+</plist>