Add MapActivity to track what MapView is being used for. (#81)

* Use self.init instead of setting member variables directly.

- This way if the initializer should change, it will be a little more obvious for this client when re-building.

* Add MapActivity to track what MapView is being used for.

- Typically in an application, there is one MNMapView. When using CarPlay, there are two. This helps debugging the scenario so that two views can be distinguished from each other when debugging.
- It sets the `UIView.tag` property of the `MLNMapView` to the enum's rawValue. It also exists in its enumerated type elsewhere.

Depends upon #80

---------

Co-authored-by: Ian Wagner <[email protected]>

Author: bolsinga

Sources/MapLibreSwiftUI/MLNMapViewController.swift

@@ -7,12 +7,15 @@ public protocol MapViewHostViewController: UIViewController {
 }
 
 public final class MLNMapViewController: UIViewController, MapViewHostViewController {
+    var activity: MapActivity = .standard
+
     @MainActor
     public var mapView: MLNMapView {
         view as! MLNMapView
     }
 
     override public func loadView() {
         view = MLNMapView(frame: .zero)
+        view.tag = activity.rawValue
     }
 }

Sources/MapLibreSwiftUI/MapView.swift

@@ -3,6 +3,14 @@ import MapLibre
 import MapLibreSwiftDSL
 import SwiftUI
 
+/// Identifies the activity this ``MapView`` is being used for. Useful for debugging purposes.
+public enum MapActivity: Int {
+    /// Navigation in a standard window. Default.
+    case standard = 0
+    /// Navigation in a CarPlay template.
+    case carplay = 2025
+}
+
 public struct MapView<T: MapViewHostViewController>: UIViewControllerRepresentable {
     public typealias UIViewControllerType = T
     var cameraDisabled: Bool = false
@@ -33,18 +41,22 @@ public struct MapView<T: MapViewHostViewController>: UIViewControllerRepresentab
 
     var clusteredLayers: [ClusterLayer]?
 
+    let activity: MapActivity
+
     public init(
         makeViewController: @autoclosure @escaping () -> T,
         styleURL: URL,
         camera: Binding<MapViewCamera> = .constant(.default()),
         locationManager: MLNLocationManager? = nil,
+        activity: MapActivity = .standard,
         @MapViewContentBuilder _ makeMapContent: () -> [StyleLayerDefinition] = { [] }
     ) {
         self.makeViewController = makeViewController
         styleSource = .url(styleURL)
         _camera = camera
         userLayers = makeMapContent()
         self.locationManager = locationManager
+        self.activity = activity
     }
 
     public func makeCoordinator() -> MapViewCoordinator<T> {
@@ -138,13 +150,19 @@ public extension MapView where T == MLNMapViewController {
         styleURL: URL,
         camera: Binding<MapViewCamera> = .constant(.default()),
         locationManager: MLNLocationManager? = nil,
+        activity: MapActivity = .standard,
         @MapViewContentBuilder _ makeMapContent: () -> [StyleLayerDefinition] = { [] }
     ) {
         self.init(
-            makeViewController: MLNMapViewController(),
+            makeViewController: {
+                let vc = MLNMapViewController()
+                vc.activity = activity
+                return vc
+            }(),
             styleURL: styleURL,
             camera: camera,
             locationManager: locationManager,
+            activity: activity,
             makeMapContent
         )
     }