Mapbox GL v5.2.0 Release Notes

Release Date: 2019-07-24 // almost 3 years ago
  • ๐Ÿš€ Changes since Mapbox Maps SDK for iOS v5.1.1:


    • โž• Added methods to clear the ambient cache, change the size of the ambient cache, and to delete and revalidate the database that contains the ambient cache and offline packs (#14978):
      • -[MGLOfflineStorage clearAmbientCacheWithCompletionHandler:]
      • -[MGLOfflineStorage invalidateAmbientCacheWithCompletionHandler:]
      • -[MGLOfflineStorage setMaximumAmbientCacheSize:withCompletionHandler:]
      • -[MGLOfflineStorage resetDatabaseWithCompletionHandler:]
      • -[MGLOfflineStorage invalidatePack:withCompletionHandler:]
    • ๐Ÿ›  Fixed a crash during network access. (#15113)

    Offline maps

    • ๐ŸŽ Ideographic glyphs from Chinese, Japanese, and Korean are no longer downloaded by default as part of offline packs; they are instead rendered on-device, saving bandwidth and storage while improving performance. (#14176)
    • ๐Ÿ›  Fixed an issue where offline regions could report the wrong number of tiles. (#14958)

    ๐Ÿ’… Styles and rendering

    • ๐Ÿ’… The MGLIdeographicFontFamilyName Info.plist key now also accepts an array of font family names, to customize font fallback behavior. It can also be set to a Boolean value of NO to force the SDK to typeset CJK characters in a remote font specified by MGLSymbolStyleLayer.textFontNames. (#14862)
    • 0๏ธโƒฃ Hiragana and katakana are now included in the range of CJK glyphs that are rendered locally by default. (#15009)
    • ๐Ÿ›  Fixed a map update bug caused by the render tiles and the render passes becoming unsynchronized. (#15092)
    • โž• Added the -[MGLMapViewDelegate mapView:shouldRemoveStyleImage:] method for optimizing style image caching. (#14769)
    • ๐Ÿ›  Fixed style change transition regression caused by delayed setting of the updated layer properties. (#15016)
    • ๐Ÿ›  Fixed an issue where layers with fill extrusions would be incorrectly rendered above other layers. (#15065)
    • ๐Ÿ‘Œ Improved feature querying performance. (#14930)
    • ๐Ÿ›  Fixed a custom geometry source bug caused by using the outdated tiles after style update #15112

    ๐Ÿ‘‰ User interaction

    • ๐Ÿ›  Fixed an issue where annotations could not be selected. (#15130)
    • ๐Ÿ›  Fixed a bug where using the pinch gesture could result in an incorrect map center coordinate. (#15097)
    • ๐Ÿ›  Fixed an issue where the two-finger tilt gesture would continue after lifting one finger. (#14969)


    • โœ‚ Removed previously deprecated methods and properties that had been marked unavailable. (#15000)
    • The downloaded zip file of this framework no longer contains a local podspec. (#15027)

    Other changes

    • โž• Added variants of several animated MGLMapView methods that accept completion handlers (#14381):
      • -[MGLMapView setVisibleCoordinateBounds:edgePadding:animated:completionHandler:]
      • -[MGLMapView setContentInset:animated:completionHandler:]
      • -[MGLMapView setUserTrackingMode:animated:completionHandler:]
      • -[MGLMapView setTargetCoordinate:animated:completionHandler:]
      • -[MGLMapView showAnnotations:edgePadding:animated:completionHandler:]
      • -[MGLMapView selectAnnotation:animated:completionHandler:]
    • ๐Ÿ—„ Deprecated variants of the above methods without completion handlers. (#14959)
    • โž• Added MGLMapView.compassView.compassVisibility and MGLOrnamentVisibility to allow configuration of compass visibility behavior. (#15055)
    • ๐Ÿ“š Updated "map ID" to the more accurate term "tileset ID" in documentation; updated "style's Map ID" to the more accurate term "style URL". (#15116)

    ๐Ÿ“š Documentation is available online or as part of the download.