Upgrading from v0.40.x to v1.0.x

Mapbox Navigation SDK for iOS v1.0.0 is the first major version of this SDK since the project started in 2016. To upgrade, follow the installation instructions. Note the new installation steps, including creating a secret Mapbox access token and adding it to a .netrc file.

Version 1.0.0 includes numerous important changes to the public APIs of the MapboxNavigation and MapboxCoreNavigation frameworks as well as their dependencies. There are several backwards-incompatible changes to be aware of as you upgrade, which are discussed below and divided by framework so that you can upgrade different portions of your application at different times.

System requirements

• Minimum Carthage version required to install the SDK (if using Carthage): 0.35
• Minimum Xcode version required to build the SDK: 11.4.1
• Minimum iOS deployment target: 10.0

Upgrading Turf from v0.3.0 to v0.5.0

• CoordinateBounds class was replaced by BoundingBox.
• Polyline is replaced with LineString.
• Review existing Polyline.closestCoordinate(to:) and other LineString.IndexedCoordinate usage as its .distance property now reflects it's description. Previously, Polyline.closestCoordinate(to:) showed distance between provided coordinate and the closest Polyline point. Now, it shows distance from Polyline's first point, as stated in the doc.

Upgrading MapboxDirections from v0.31.0 to v0.33.0

Number of entities was renamed or replaced:

• Tracepoint.alternateCount renamed to Tracepoint.countOfAlternatives.
• MBDefaultWalkingSpeed replaced by CLLocationSpeed.normalWalking
• MBMinimumWalkingSpeed replaced by CLLocationSpeed.minimumWalking
• MBMaximumWalkingSpeed replaced by CLLocationSpeed.maximumWalking
• Route.coordinates replaced by Route.shape
• RouteStep.coordinates replaced by RouteStep.shape
• Route.coordinateCount and RouteStep.coordinateCount properties have been removed, use LineString.coordinates instead.

Other changes:

• TransportType.none, ManeuverType.none, and ManeuverDirection.none are removed. To handle those cases, add catching decoding error.
• Removed the Lane class in favor of storing an array of LaneIndications directly in the Intersection.approachLanes property.
• Removed the ComponentRepresentable protocol, VisualInstructionComponent class, and LaneIndicationComponent class in favor of a VisualInstruction.Component enumeration that contains a VisualInstruction.Component.TextRepresentation and/or VisualInstruction.Component.ImageRepresentation, depending on the type of component.
• The RouteCompletionHandler and MatchCompletionHandler closures’ error argument is now a DirectionsError instead of an NSError. Update callbacks accordingly.
• Classes such as Route, Match, and RouteStep conform to the Codable protocol. If you had your own implementation, remove it.

Upgrading MapboxNavigation from v0.40.0 to v1.0.0

Symbols renamed or replaced:

• The MGLStyle.navigationDayStyleURL and MGLStyle.navigationNightStyleURL properties contain URLs to the Mapbox Navigation Day and Night v5 styles, both of which show traffic congestion lines on all roads by default. The traffic congestion layer is appropriate for a preview map; to tailor the style to turn-by-turn navigation, set MGLMapView.showsTraffic to false.
• Replaced the MGLStyle.navigationPreviewDayStyleURL and MGLStyle.navigationGuidanceDayStyleURL properties with MGLStyle.navigationDayStyleURL, and replaced MGLStyle.navigationPreviewNightStyleURL and MGLStyle.navigationGuidanceNightStyleURL with MGLStyle.navigationNightStyleURL.
• Removed NavigationMapViewDelegate.navigationMapView(_:routeStyleLayerWithIdentifier:source:), NavigationMapViewDelegate.navigationMapView(_:routeCasingStyleLayerWithIdentifier:source:) in favor of four new delegate methods to customize the route styling.
• Removed the NavigationViewControllerDelegate.navigationViewController(_:imageFor:) and NavigationViewControllerDelegate.navigationViewController(_:viewFor:) methods in favor of MGLMapViewDelegate.mapView(_:imageFor:) and MGLMapViewDelegate.mapView(_:viewFor:), respectively.
• Deprecated NavigationMapView.showRoutes(_:, legIndex:) and NavigationMapView.showWaypoints(_:legIndex:) methods. Use NavigationMapView.show(_:, legIndex:) and NavigationMapView.showWaypoints(on:legIndex:) instead.

Other changes:

• The MGLStyle.navigationDayStyleURL and MGLStyle.navigationNightStyleURL properties contain URLs to the Mapbox Navigation Day and Night v5 styles, both of which show traffic congestion lines on all roads by default. The traffic congestion layer is appropriate for a preview map; to tailor the style to turn-by-turn navigation, set MGLMapView.showsTraffic to false.
• Updated FeedbackType enum to reflect new top level feedback categories and introduced new FeedbackSubTypes to support a more granular feedback mechanism.
• Any classes, methods, or properties that were deprecated in v0.40.0 are no longer available. See your project’s build errors for details about replacements.

If you have any questions, please contact Mapbox’s support team.