MapLibreParticleLab/platform/ios/MapLibre.docc/GettingStarted.md

Getting Started

Setting up an Xcode project that uses MapLibre Native for iOS.

Create a new iOS project

Create a new (SwiftUI) iOS project with Xcode. Go to File > New > Project....

Add MapLibre Native as a dependency

MapLibre Native for iOS is available on Cocoapods and on the Swift Package Index (for use with the Swift Package Manager). However, for this guide we will add the MapLibre Native as a package dependency directly.

In Xcode, right click your project and select "Add Package Dependencies...":

Paste the following URL and click Add Package:

https://github.com/maplibre/maplibre-gl-native-distribution

Note: The maplibre-gl-native-distributon repository only exists for distributing the iOS package of MapLibre Native. To report issues and ask questions, use the maplibre-native repository.

Verify you can import MapLibre in your app:

import MapLibre

To use MapLibre with SwiftUI we need to create a wrapper for the UIKit view that MapLibre provides (using UIViewRepresentable. The simplest way to implement this protocol is as follows:

struct SimpleMapView: UIViewRepresentable {
    func makeUIView(context _: Context) -> MLNMapView {
        let mapView = MLNMapView()
        return mapView
    }

    func updateUIView(_: MLNMapView, context _: Context) {}
}

You can use this view directly in a SwiftUI View hierarcy, for example:

struct MyApp: App {

    var body: some Scene {
        WindowGroup {
            MapLibreMapView().edgesIgnoringSafeArea(.all)
        }
    }
}

When running your app in the simulator you should be greeted with the default Demotiles style: