Architekturübersicht

02 · Plattformspezifische Konfiguration

Core und Treiber sind als Pakete getrennt. Die App fügt nur Core und den Treiber des verwendeten Anbieters als Abhängigkeiten hinzu.

Im Fall von React Native

Web und React Native nutzen denselben Code, den die App schreibt. Auch die Zustandsobjekte und Komponenten sind identisch; Sie müssen nur das ausgewählte MapView austauschen. Der Unterschied liegt darunter. Im Web ruft der Treiber eine JavaScript-Kartenbibliothek in derselben Laufzeitumgebung auf, während React Native über eine Bridge zum nativen SDK von MapConductor gelangt und am Ende die nativen Karten-SDKs rendern.

Die Ebene 3 in der obigen Tabelle ist die Bridge. Im Web ist sie nicht vorhanden, da UI und Rendering in derselben Laufzeitumgebung abgeschlossen werden. In React Native ist sie erforderlich, da beide in unterschiedliche Laufzeitumgebungen aufgeteilt sind. Nur diese Ebene unterscheidet sich je nach Plattform; darüber bleibt alles unverändert.

Die mit React Native nutzbaren Provider sind Google Maps, MapLibre, ArcGIS und HERE – insgesamt vier. Da nur Anbieter mit einem entsprechenden nativen Modul möglich sind, ist die Anzahl geringer als die 13 Provider im Web.

04 · Interne Struktur von Core

Core ist für Elemente wie Marker, Polylines, Polygone, Kreise, Bodenbilder und Rasterebenen so aufgebaut, dass dieselben sieben Rollen wiederholt werden. Wenn man eine versteht, lassen sich die anderen Elemente auf dieselbe Weise nachvollziehen.

Wichtig ist die Position der Grenze. Die Core-Seite (State / Entity / Manager / Controller / Overlay) ist in fast gleichem Code in den 3 Sprachen geschrieben, und für jeden Anbieter müssen nur der Renderer und die Deklaration, dass dieser die Elemente verarbeiten kann, geschrieben werden.

06 · Vom Treiber zu implementierende Dinge

Die Arbeit zur Unterstützung eines neuen Karten-SDK beschränkt sich darauf, von dem abstrakten Renderer für jedes Element zu erben und die 3 Operationen auszufüllen. Das Core-Modell und die Differenzlogik werden nicht berührt.

// Der Treiber erbt vom abstrakten Renderer und füllt nur drei Operationen aus
internal class GoogleMapPolygonOverlayRenderer(
    override val holder: GoogleMapViewHolder,
    override val coroutine: CoroutineScope,
) : AbstractPolygonOverlayRenderer<GoogleMapActualPolygon>() {

    override suspend fun createPolygon(state: PolygonState) = /* map.addPolygon(...) */
    override suspend fun updatePolygonProperties(polygon, current, prev) = /* Nur die Differenz anwenden */
    override suspend fun removePolygon(entity: PolygonEntityInterface<GoogleMapActualPolygon>) =
        entity.polygon.remove()
}

// Dieselbe Form wie in Kotlin: vom abstrakten Renderer erben und drei Operationen ausfüllen
final class MapKitPolygonOverlayRenderer: AbstractPolygonOverlayRenderer<MKPolygon> {

    override func createPolygon(state: PolygonState) async -> MKPolygon? { /* MKPolygon(...) */ }
    override func updatePolygonProperties(polygon, current, prev) async -> MKPolygon? { /* Nur die Differenz anwenden */ }
    override func removePolygon(entity: PolygonEntity<MKPolygon>) async { /* mapView.removeOverlay */ }
}

// Der Controller nutzt die generische Implementierung aus Core unverändert
final class MapKitPolygonController: PolygonController<MKPolygon, MapKitPolygonOverlayRenderer> { }

// Dieselbe Form wie in Kotlin und Swift: vom abstrakten Renderer erben und drei Operationen ausfüllen
export class MapLibrePolygonOverlayRenderer extends AbstractPolygonOverlayRenderer<
    MapLibreMapViewHolder,
    MapLibreActualPolygon
> {

    async createPolygon(state: PolygonState) { /* Das GeoJSON-Feature erzeugen */ }
    async updatePolygonProperties({ current, prev }) { /* Nur die Differenz anwenden */ }
    async removePolygon(entity: PolygonEntity<MapLibreActualPolygon>) { /* Entfernen */ }

    // Nach dem Anwenden der Differenz die Quelle aus den verbliebenen Entities neu schreiben
    override async onPostProcess() { this.layer.draw(this.polygonManager.allEntities()); }
}

// Was ein Treiber beherrscht, wird durch Implementieren der Capable-Interfaces als Typ deklariert
export class MapLibreViewController extends BaseMapViewController
    implements MapViewControllerInterface, MarkerCapable, PolygonCapable, /* … */ { }