Files
dmc/app/lib/services/sharing/mission_share_codec.dart
T
Constantin LeueandClaude Sonnet 5 b51c6c16d5 Add mission/drone profile sharing and importing, fix map not fitting to loaded mission
Sharing/Import (Doku 3.5/3.6), analog shareMission()/shareDrone() und den
importMissionInput/importDroneInput-Handlern im HTML-Demonstrator:

- services/sharing/mission_share_codec.dart, drone_share_codec.dart: reine
  Funktionen zum Bauen/Parsen des Export-JSON (appVersion/exportedAt-Umschlag),
  inkl. Erkennung einer abweichenden Hauptversion beim Import - vollstaendig
  unit-getestet ohne Plugin-Abhaengigkeit.
- services/database/waypoint_json_codec.dart: Waypoint-JSON-(De-)Serialisierung
  aus mission_repository.dart herausgezogen, damit Persistenz und Sharing
  exakt dasselbe Dateiformat verwenden statt es zu duplizieren.
- services/sharing/sharing_service.dart: duenne I/O-Schicht - schreibt eine
  temporaere Datei und oeffnet das native Share-Sheet (share_plus), bzw.
  liest eine vom Nutzer per Systemdialog ausgewaehlte JSON-Datei
  (file_picker). Als Klasse mit Instanzmethoden gehalten, damit sie sich in
  Tests durch einen Fake ersetzen laesst.
- ui/widgets/missions_drones_panel.dart: Share-Icon je Zeile, Import-Button
  im Toolbar beider Tabs.

Paket-Versionen bewusst gewaehlt: file_picker 11.0.2/share_plus 11.x wurden
zunaechst wegen einer win32-Konflikt-Aufloesung genutzt, kompilierten auf
diesem Projekt (AGP 9.0.1) aber nicht - file_picker < 12.0.0-beta.1 prueft
nur AGP-Version >= 9 und ueberspringt dann das Anwenden des Kotlin-Android-
Plugins, in der Annahme, AGPs eingebauter Kotlin-Support wuerde das
uebernehmen, was hier zu einem fehlenden compileReleaseKotlin-Task und
"Symbol nicht gefunden" fuehrte. file_picker >=12.0.0-beta.1 respektiert
zusaetzlich die bereits vom Flutter-Template gesetzte Gradle-Property
android.builtInKotlin=false und wendet das Plugin dann korrekt an -
file_picker auf ">=12.0.0-beta.1 <13.0.0" (share_plus zurueck auf ^13.3.0,
beide dann konsistent auf win32 ^6.x) gesetzt, um dies zu nutzen.

Zusaetzlich beim manuellen Durchtesten auf dem Pixel_10a-Emulator einen
zweiten, davon unabhaengigen Bug gefunden und behoben: CurrentMissionMeta-
Notifier.loadMission()/restoreLastSession() aktualisierten zwar Wegpunkte
und Missionsname, bewegten aber nie die Kartenkamera - eine geladene
Mission wurde dadurch mit falscher Kartenausschnitt angezeigt (Name/
Wegpunkte einer Stadt, Karte noch an der zuletzt betrachteten Stelle).
Fix: _fitMapToWaypoints() zentriert nach dem Laden auf die Bounding-Box
der Mission, analog der bereits vorhandenen _onFitPressed()-Logik in
MapSearchControls.

Getestet: 13 neue Unit-Tests fuer die Sharing-Codecs, 4 neue Widget-Tests
mit einem Fake-SharingService (kein echter Platform-Channel-Zugriff in
Tests). Alle 97 Tests sowie flutter analyze bestehen. Manuell auf dem
Pixel_10a-Emulator verifiziert: natives Share-Sheet oeffnet sich mit der
korrekten JSON-Datei, Datei-Import ueber den Systemdialog legt eine neue
Mission bzw. ein neues Drohnenprofil an, Kartensprung beim Laden einer
Mission funktioniert jetzt korrekt fuer sowohl manuelles Laden als auch
den Autosave-Restore beim App-Start.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-28 19:50:19 +02:00

110 lines
3.5 KiB
Dart

import 'dart:convert';
import '../../app_info.dart';
import '../../domain/waypoint/flat_waypoint_list.dart';
import '../database/waypoint_json_codec.dart';
/// Missionsdaten fuer den Export - unabhaengig von der Drift-Zeilenklasse,
/// damit dieser Codec ohne Datenbankzugriff testbar bleibt.
class MissionExportData {
const MissionExportData({
required this.name,
this.placeName,
required this.createdAt,
required this.waypoints,
});
final String name;
final String? placeName;
final DateTime createdAt;
final List<Waypoint> waypoints;
}
/// Baut die Export-Datei fuer eine Mission (Doku 3.6, analog
/// buildMissionExportObject()/shareMission() im HTML-Demonstrator) - ein
/// mit `appVersion`/`exportedAt` umschlossenes JSON-Dokument, damit ein
/// Import spaeter erkennen kann, aus welcher App-Version die Datei stammt.
String buildMissionExportJson(MissionExportData mission) {
final map = {
'appVersion': kAppVersion,
'exportedAt': DateTime.now().toUtc().toIso8601String(),
'mission': {
'name': mission.name,
'placeName': mission.placeName,
'createdAt': mission.createdAt.toUtc().toIso8601String(),
'waypoints': [for (final w in mission.waypoints) waypointToJson(w)],
},
};
return const JsonEncoder.withIndent(' ').convert(map);
}
/// Vorschlagsname fuer die geteilte Datei (Doku 3.6, analog
/// `'mission-' + safeName + '.json'` im HTML-Demonstrator).
String missionExportFilename(String label) {
final safeName = label.replaceAll(RegExp(r'[^a-zA-Z0-9]'), '_');
return 'mission-$safeName.json';
}
class ParsedMissionImport {
const ParsedMissionImport({
required this.name,
this.placeName,
required this.waypoints,
this.versionMismatch,
});
final String name;
final String? placeName;
final List<Waypoint> waypoints;
/// Enthaelt die appVersion der Datei, falls sie sich von [kAppVersion] in
/// der Hauptversionsnummer unterscheidet - sonst null (analog der
/// "Imported from a different app version"-Warnung im HTML-Demonstrator).
final String? versionMismatch;
}
/// Parst eine importierte Missionsdatei - wirft [FormatException] bei
/// ungueltigem JSON oder fehlenden Wegpunkten (Doku 3.6, analog dem
/// `change`-Handler von importMissionInput im HTML-Demonstrator).
ParsedMissionImport parseMissionImportJson(String jsonText) {
final Object? decoded;
try {
decoded = jsonDecode(jsonText);
} on FormatException {
throw const FormatException('Invalid mission file');
}
if (decoded is! Map<String, dynamic>) {
throw const FormatException('Invalid mission file');
}
final missionData = decoded['mission'] ?? decoded;
if (missionData is! Map<String, dynamic>) {
throw const FormatException('Invalid mission file');
}
final waypointsRaw = missionData['waypoints'];
if (waypointsRaw is! List || waypointsRaw.isEmpty) {
throw const FormatException('File has no waypoints');
}
final waypoints = [
for (final w in waypointsRaw) waypointFromJson(w as Map<String, dynamic>),
];
final name = (missionData['name'] as String?) ??
(missionData['placeName'] as String?) ??
'Imported mission';
final placeName =
(missionData['placeName'] as String?) ?? (missionData['name'] as String?);
final appVersion = decoded['appVersion'] as String?;
final mismatch = appVersion != null &&
appVersion.split('.').first != kAppVersion.split('.').first
? appVersion
: null;
return ParsedMissionImport(
name: name,
placeName: placeName,
waypoints: waypoints,
versionMismatch: mismatch,
);
}