Resumen de la arquitectura

02 · Configuración por plataforma

Core y los controladores están separados como paquetes. La aplicación solo añade Core y el controlador del proveedor que utiliza como dependencias.

En el caso de React Native

Web y React Native comparten el código que escribe la aplicación. Los objetos de estado y los componentes también son los mismos; solo debe cambiar el MapView que elija. La diferencia está debajo. En Web, el controlador invoca una biblioteca de mapas JavaScript en el mismo entorno de ejecución, mientras que en React Native pasa a través de un puente al SDK nativo de MapConductor y, finalmente, los SDK de mapas nativos realizan el renderizado.

La capa 3 en la tabla de arriba es el puente. En Web no interviene, ya que la interfaz de usuario y el renderizado se completan en el mismo entorno de ejecución. En React Native, como ambos se separan en diferentes entornos de ejecución, se necesita esta capa. Solo esta capa varía según la plataforma; por encima, no hay cambios.

Los proveedores que se pueden usar con React Native son Google Maps, MapLibre, ArcGIS y HERE, en total 4. Como se limitan a aquellos que tienen un módulo correspondiente en el lado nativo, son menos que los 13 proveedores de Web.

04 · Estructura interna de Core

Core está estructurado de manera que repite los mismos 7 roles para cada elemento, como marcadores, polilíneas, polígonos, círculos, imágenes de suelo y capas ráster. Si entiende uno, puede seguir los demás elementos de la misma forma.

Lo importante es la posición del límite. El lado Core (State / Entity / Manager / Controller / Overlay) está escrito en un código casi idéntico en los 3 idiomas, y para cada proveedor solo hay que escribir el Renderer y la declaración de que puede manejar esos elementos.

06 · Cosas que el controlador debe implementar

El trabajo para soportar un nuevo SDK de mapas se limita a heredar del renderizador abstracto para cada elemento y rellenar las 3 operaciones. No se toca el modelo de Core ni la lógica de diferencias.

// El driver hereda del renderizador abstracto y solo implementa tres operaciones
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) = /* Aplica solo la diferencia */
    override suspend fun removePolygon(entity: PolygonEntityInterface<GoogleMapActualPolygon>) =
        entity.polygon.remove()
}

// La misma forma que en Kotlin: hereda del renderizador abstracto e implementa tres operaciones
final class MapKitPolygonOverlayRenderer: AbstractPolygonOverlayRenderer<MKPolygon> {

    override func createPolygon(state: PolygonState) async -> MKPolygon? { /* MKPolygon(...) */ }
    override func updatePolygonProperties(polygon, current, prev) async -> MKPolygon? { /* Aplica solo la diferencia */ }
    override func removePolygon(entity: PolygonEntity<MKPolygon>) async { /* mapView.removeOverlay */ }
}

// El controlador usa la implementación genérica de Core tal cual
final class MapKitPolygonController: PolygonController<MKPolygon, MapKitPolygonOverlayRenderer> { }

// La misma forma que en Kotlin y Swift: hereda del renderizador abstracto e implementa tres operaciones
export class MapLibrePolygonOverlayRenderer extends AbstractPolygonOverlayRenderer<
    MapLibreMapViewHolder,
    MapLibreActualPolygon
> {

    async createPolygon(state: PolygonState) { /* Crea el feature de GeoJSON */ }
    async updatePolygonProperties({ current, prev }) { /* Aplica solo la diferencia */ }
    async removePolygon(entity: PolygonEntity<MapLibreActualPolygon>) { /* Quítalo */ }

    // Tras aplicar la diferencia, reescribe la fuente a partir de las entidades que quedan
    override async onPostProcess() { this.layer.draw(this.polygonManager.allEntities()); }
}

// Declara lo que el driver admite implementando las interfaces Capable
export class MapLibreViewController extends BaseMapViewController
    implements MapViewControllerInterface, MarkerCapable, PolygonCapable, /* … */ { }