Skip to content

v7.0.0

Latest

Choose a tag to compare

@mattermoran mattermoran released this 16 Oct 13:57

See the 6 → 7 migration guide before upgrading.

Breaking changes

  • Remove MapApp.all and bundled Android provider queries. Supply discovery
    lists and app-owned native declarations; bare show() keeps Apple/Google defaults.
  • Return metadata-only AvailableMap from getAvailableMaps. Request-bound
    SupportedMap.show() no longer accepts extras, its unnamed constructor is
    removed, and equality is now identity-based.
  • Require explicit show(map: ...) for raw extra; use providerExtras for
    discovery or automatic selection. Reject conflicting generated URL parameters.
  • Copy extras and waypoints into immutable snapshots; request constructors are
    no longer const.
  • Report unsupported launches as MapLaunchException, with nullable url.
    Retry only confirmed failed handoffs; blocked or unknown outcomes stop retries.
  • Reject unsupported origins, modes, markers and stops rather than dropping them.
    See provider restrictions.
  • Enforce Google's 2,048-character HTTPS limit and waypoint limits: nine stops
    for Android package-targeted or desktop launches, three for mobile unpinned
    HTTPS. Never truncate routes.
  • Reject non-finite coordinates and blank searches.
  • Correct the declared Flutter minimum from 3.3 to 3.41, matching Dart 3.11.

Added

  • Add providerExtras, NaverExtra and BaiduExtra, plus optional Naver/Baidu
    constructor attribution. Missing caller options do not block discovery or launch.
  • Add MapLaunchException.reason and issues, provider validation/default hooks,
    and custom text-origin parameter names. Platform adapters can identify confirmed
    failed handoffs with MapHandoffException.

Fixed

  • Use the same prepared options for discovery and launch, including custom maps.
  • Try Apple then Google on iOS, Google then Apple elsewhere, without waiting for
    detection. Explicit selection never changes provider. Android browser fallbacks
    remove the package target.
  • Preserve URL bytes when appending extras and avoid duplicate parameters.
  • Correct route and marker URLs for Amap, HERE, Kakao, MAPS.ME, Mapy, Mappls,
    OsmAnd and Neshan, including spaces and plus signs in MAPS.ME labels.
  • Preserve Google Maps text origins in iOS URLs. Select HTTPS for universal-only
    extras, validate their companion fields, and omit unsupported marker zoom.
  • Preserve the empty origin slot in Yandex Maps route URLs so the first waypoint
    is not serialized as the origin (#228).
    Current-location routing with waypoints still needs native-app verification.
  • Fix CoPilot marker coordinates, blank Naver marker names, and Petal mode/label
    encoding. Preserve Baidu caller descriptions and named origins.
  • Correct Air Navigation Pro and Magic Earth App Store links and icon lookup IDs.
  • Restore Android build compatibility with Flutter 3.41 / AGP 8 while retaining
    AGP 9 support (#227).
  • Prevent shell expansion of Windows URLs and report blocked browser popups.
  • Bundle the iOS privacy manifest through CocoaPods and Swift Package Manager.
  • Fix example validation, stale results and error recovery. Allow optional
    origins and provider-default travel modes.

Deprecated

  • Deprecate opensNatively/opensInBrowser; use isInstalled/hasUniversalLink
    as availability hints, not guarantees of which app will open.

Tooling and documentation

  • Update development and example tooling to Flutter 3.47.6 / Dart 3.13.5,
    AGP 9.1.0, Kotlin 2.4.0 and Gradle 9.3.1. Set example deployment targets to
    iOS 15 / macOS 12 and retain CI coverage for Flutter 3.41 / AGP 8.
  • Add provider references with source links, supported
    parameters and limitations, including research on requested apps from
    #111 (not new integrations).
  • Fix cached icon fetching and ImageMagick support outside macOS.

Full Changelog: v6.0.0...v7.0.0