Yfirlit yfir byggingarlagið

02 · Pakkar eftir vettvangi

Core og reklarnir eru gefnir út sem aðskildir pakkar. Forrit reiðir sig á Core auk rekilsins fyrir þá þjónustuaðila sem það raunverulega notar.

React Native

React á vefnum og React Native deila því sem forritið skrifar — sömu stöðuhlutir, sömu einingar, aðeins MapView-inu skipt út. Þau greinir að fyrir neðan það. Á vefnum kallar rekillinn á JavaScript-kortasafn í sama keyrsluumhverfi; á React Native afhendir hann yfir brú til innbyggða MapConductor-SDK-sins, og innbyggt korta-SDK sér um teiknunina.

Brúin er lag 3 í töflunni að ofan. Á vefnum birtist hún alls ekki: viðmótið og teiknunin eru í einu keyrsluumhverfi. Á React Native eru þau í tveimur, svo eitthvað verður að bera á milli. Það lag er hið eina sem er ólíkt; allt fyrir ofan það er eins.

Fjórir þjónustuaðilar eru í boði á React Native — Google Maps, MapLibre, ArcGIS og HERE. Þeir eru færri en þrettán á vefnum af því hver þeirra þarf samsvarandi einingu innbyggða megin.

04 · Inni í Core

Core endurtekur sömu sjö hlutverkin fyrir hverja gerð einingar — merki, fjöllínu, marghyrning, hring, jarðmynd, rasterlag. Lærðu eitt og þú lest hin á sama hátt.

Það sem skiptir máli er hvar mörkin liggja. Core-hliðin (State / Entity / Manager / Controller / Overlay) er nánast sami kóði á öllum þremur málunum; fyrir hvern þjónustuaðila skrifar þú aðeins teiknarann og yfirlýsinguna um að einingin sé yfirleitt studd.

06 · Hvað rekill útfærir

Að styðja nýtt korta-SDK takmarkast við að erfa óhlutbundna teiknarann fyrir hverja einingu og fylla út þrjár aðgerðir. Líkan Core og mismunarökvísin eru ósnert.

// Rekillinn erfir frá óhlutbundna teiknaranum og fyllir aðeins út þrjár aðgerðir
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) = /* Beita aðeins mismuninum */
    override suspend fun removePolygon(entity: PolygonEntityInterface<GoogleMapActualPolygon>) =
        entity.polygon.remove()
}

// Sama form og í Kotlin: erfa frá óhlutbundna teiknaranum og fylla út þrjár aðgerðir
final class MapKitPolygonOverlayRenderer: AbstractPolygonOverlayRenderer<MKPolygon> {

    override func createPolygon(state: PolygonState) async -> MKPolygon? { /* MKPolygon(...) */ }
    override func updatePolygonProperties(polygon, current, prev) async -> MKPolygon? { /* Beita aðeins mismuninum */ }
    override func removePolygon(entity: PolygonEntity<MKPolygon>) async { /* mapView.removeOverlay */ }
}

// Stýringin notar almennu útfærsluna úr Core óbreytta
final class MapKitPolygonController: PolygonController<MKPolygon, MapKitPolygonOverlayRenderer> { }

// Sama form og í Kotlin og Swift: erfa frá óhlutbundna teiknaranum og fylla út þrjár aðgerðir
export class MapLibrePolygonOverlayRenderer extends AbstractPolygonOverlayRenderer<
    MapLibreMapViewHolder,
    MapLibreActualPolygon
> {

    async createPolygon(state: PolygonState) { /* Búa til GeoJSON-feature-ið */ }
    async updatePolygonProperties({ current, prev }) { /* Beita aðeins mismuninum */ }
    async removePolygon(entity: PolygonEntity<MapLibreActualPolygon>) { /* Fjarlægja það */ }

    // Eftir að mismuninum er beitt, skrifa upprunann aftur út frá þeim entity-um sem eftir standa
    override async onPostProcess() { this.layer.draw(this.polygonManager.allEntities()); }
}

// Lýstu því sem rekill ræður við með því að útfæra Capable-viðmótin
export class MapLibreViewController extends BaseMapViewController
    implements MapViewControllerInterface, MarkerCapable, PolygonCapable, /* … */ { }