v11.6.0-beta.1

11.6.0-beta.1 July 19, 2024

Breaking changes ⚠️

• [compose] Remove StyleImage constructor with BitmapImage, use rememberStyleImage composable function to build it instead.
• [compose] Move layer properties within *Layer composable functions to *LayerState classes, use the convenient method *Layer(sourceState, layerId, init) with trailing lambda for easier migration (see migration example).
• [compose] Move onClick listener from last parameter to the second last parameter of Annotation and AnnotationGroup composable functions.
• [compose] Move properties within *Annotation and *AnnotationGroup composable functions to the new *AnnotationState and *AnnotationGroupState classes, use the convenient method *Annotation(point, onClick, init) and *AnnotationGroup(annotations, annotationConfig, onClick, init) with trailing lambda for easier migration (see migration example).
• [compose] Replace color int and color string property types in *Annotation with compose Color type.
• [compose] Replace PointAnnotation.iconImageBitmap and PointAnnotation.iconImage with PointAnnotationState.iconImage with IconImage type, IconImage can be constructed with either a image id String or a Bitmap, and introduced rememberIconImage to build and remember a bitmap from Painter or from a drawable resource id.
• [compose] Introduce StandardStyleConfigurationState class to hold the configurations of MapboxStandardStyle, and move lightPreset config from MapboxStandardStyle to StandardStyleConfigurationState; consider using overload method MapboxStandardStyle with trailing init lambda for easier migration.
• Experimental CustomRasterSourceOptions.Builder now accepts CustomRasterSourceClient containing CustomRasterSourceTileStatusChangedCallback instead of CustomRasterSourceTileStatusChangedCallback interface directly.

Features ✨ and improvements 🏁

• [compose] Promote Compose Extension to stable.
• [compose] Mark MapState, MapViewportState, TerrainState, light states and source states as Stable as they are internally backed by MutableState.
• [compose] Add more config options including showPlaceLabels, showRoadLabels, showPointOfInterestLabels, showTransitLabels and font to StandardStyleConfigurationState.
• [compose] Introduce StyleImage constructor with Image type, and add rememberStyleImage composable functions to create and remember StyleImage.
• [compose] Add extension function to *AnnotationOptions to handle compose Color, use it in *AnnotationGroup composable functions for convenience.
• [compose] Add style transition parameter in GenericStyle, MapStyle and MapboxStandardStyle.
• Modify awaitCameraForCoordinates extension function to use MapCameraManagerDelegate as receiver type.
• Modify queryRenderedFeatures and querySourceFeatures extension functions to use MapFeatureQueryDelegate as receiver type.
• Introduce asynchronous overloaded method ViewAnnotationManager.cameraForAnnotations better covering some corner cases.
• Make use of asynchronous MapboxMap.cameraForCoordinates in Mapbox overlay plugin better covering some corner cases.
• Mark synchronous methods MapboxMap.cameraForCoordinates and ViewAnnotationManager.cameraForAnnotations with @MapboxDelicateApi. Consider using asynchronous overloaded methods instead.
• Deprecate MapboxMap.getDebug()/MapboxMap.setDebug() in favour of MapView.debugOptions taking new enhanced enum MapViewDebugOptions as an argument.
• Introduce MapViewDebugOptions.CAMERA and MapViewDebugOptions.PADDING debug options to track current camera state and visualize camera paddings.
• Expose experimental ClipLayer to remove 3D data (fill extrusions, landmarks, instanced trees) and symbols.
• Enable r8 optimisations for all the Mapbox extensions and plugins in consumer proguard file, the optimisation will apply when minify is enabled in app's build settings.
• Align default displacement for Android and Google location providers.
• Enable direct rendering into CustomRasterSource tiles.
• Introduce a new allowZElevate option in ViewAnnotationOptions. When set to true, the annotation will be positioned on the rooftops of buildings, including both fill extrusions and models.

Bug fixes 🐞

• [compose] Fix minZoom/maxZoom not working for layers.
• [compose] Fix java.lang.UnsupportedOperationException when setting textWritingMode and textVariableAnchor.
• Fix compass view ignoring enabled option when it is set in updateSettings().
• Fix background locations not received when unregistering other providers.
• Improve linePattern precision.
• Fix local glyph rasterization to ensure the correct Typeface is used.
• Fix CustomRasterSource rendering when camera shows antimeridian or multiple world copies.

Known issues

• ClipLayer.clipLayerTypes could not be updated with a layer setter. Layer has to be re-added to update it. This is expected to be fixed in v11.6.0-rc.1.

Dependencies

• Update gl-native to v11.6.0-beta.1 and common to v24.6.0-beta.1.