Repository navigation
See the 6 → 7 migration guide before upgrading.
Breaking changes
- Remove
MapApp.alland bundled Android provider queries. Supply discovery
lists and app-owned native declarations; bareshow()keeps Apple/Google defaults. - Return metadata-only
AvailableMapfromgetAvailableMaps. Request-bound
SupportedMap.show()no longer accepts extras, its unnamed constructor is
removed, and equality is now identity-based. - Require explicit
show(map: ...)for rawextra; useproviderExtrasfor
discovery or automatic selection. Reject conflicting generated URL parameters. - Copy extras and waypoints into immutable snapshots; request constructors are
no longerconst. - Report unsupported launches as
MapLaunchException, with nullableurl.
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,NaverExtraandBaiduExtra, plus optional Naver/Baidu
constructor attribution. Missing caller options do not block discovery or launch. - Add
MapLaunchException.reasonandissues, provider validation/default hooks,
and custom text-origin parameter names. Platform adapters can identify confirmed
failed handoffs withMapHandoffException.
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; useisInstalled/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