Skip to content

0.27.0 Migration Guide

Jump to bottom
Pablo Guardiola edited this page Jan 17, 2019 · 6 revisions

SEMVER breaks:

  • Maps SDK 7.0 > please see their migration guide here
  • New core location APIs > updated documentation here
  • ☝️ both of these were updated in this PR

Using the new ReplayRouteLocationEngine:

  • ReplayRouteLocationEngine was updated with the new LocationEngine API updates. To use it with MapboxNavigation now:
MapboxNavigation navigation = ...
DirectionsRoute routeToReplay = ...

ReplayRouteLocationEngine replayEngine = new ReplayRouteLocationEngine();
replayEngine.assign(routeToReplay);
      
navigation.setLocationEngine(replayEngine);
navigation.startNavigation(routeToReplay);
  • NavigationView will still replay the given DirectionsRoute with NavigationViewOptions#simulateRoute(true)

PRs:

Using willVoice with NavigationView #1675:

We now pass a SpeechAnnouncement and ask for one in return. This is so you can take advantage of the ssmlAnnouncement field. Previously, with a String, parsing of the SSML was not possible.

Old:

@Override
public String willVoice(SpeechAnnouncement announcement) {
  return "All announcements will be the same.";
}

New:

@Override
public SpeechAnnouncement willVoice(SpeechAnnouncement announcement) {
  return SpeechAnnouncement.builder()
    .announcement("Announcement")
    .ssmlAnnouncement("SSML announcement")
    .build();
}

A few unused methods in RouteUtils were removed. Following you can find which ones:

Clone this wiki locally