Major features of 1.0.0:
- Version bump to Stable
API Changes
- The
statestore-datastoreartifact is had added support for the following platforms:desktop,linux,mac,ios,tvos,watchos,js, andwasmJs. In order to enable this, instead of using reflection,PersistToDataStoreis now generic in the persisted value type and requires the key to provide the name it is stored under and itsKSerializer. I4cd8e I03124 b/579492485
API Changes
AppState Transformhas added support forSavedStateContainerthat enables the use ofrememberSaveableinside of the@Composablelambda. The ensures that all of the state inside the transform is not saved across configuration changes and process death. Ia66eaAppState Transformnow provides aRunnableTransformScopethat provides a publicrunfunction to kick off the scope while the defaultTransformScopeinterface can continue to be used forlaunchTransformwith the assumption that the scope is already running. Ia1f0d
Bug Fixes
- Fixed
unpersistAnchor()to throwAnchorInvalidUuidExceptioninstead ofIllegalStateExceptionwhen an unknown UUID is provided. Ib046b - Added validation to ensure
imageBufferis a directByteBufferinSpatialAnnotationTrackingOptions. Ieb507 - Set tracking state to
STOPPEDfor stopped spatial annotations and correctly handled cleanup. Ib685a - Fixed anchor
TrackingStateupdates withinArCoreTestRule. I766b9
Bug Fixes
Add support for toggling categories when enabling in-process tracing from benchmarks for a target process.
PerfettoTraceRulenow supports enabling optional categories for in-process tracing. These categories are used by theTraceDriverinstance in the target process. I663ed b/565040771Fixed thermal throttle logic to reset main thread deadlines after the cooldown sleep completes to avoid premature time limit errors. Ibb2f02
Swapped restricted API surface labels in metalava configuration to correctly align with atomic and non-atomic group definitions. I0c563c b/582384448
Updated
PerfettoCaptureto wait for target process exit usingam force-stopto ensure process stability during benchmarks. If8a631Buffered file streams in
PerfettoOutputto reduce total write counts and prevent file system exhaustion and timeouts. I1c828cUpdated AndroidX test library dependencies and fixed javadoc warning configurations to maintain build stability. Ia7e3ff
Transitioned build environment to JDK 25 and added necessary workarounds for compatibility, including JSpecify annotation removals and native access flags. I88704c b/559834169 b/445484245
Ensured target packages are killed after in-process tracing is enabled when the process was not previously alive to maintain consistent cold-start tracing states. Icef99b b/568496084
Bug Fixes
- Fixed an issue where a completed or disposed
rememberAuthenticationLauncherorAuthenticationResultLauncherre-subscribed onON_STARTand intercepted results from subsequent authentication requests. I49420 b/555875039 - Fixed an issue where R8 stripped
FingerprintManager.AuthenticationCallbackmethods on API < 28 when apps compiled withcompileSdk = 37. I2c7e0 b/516212633
Important changes since 1.6.0:
API Changes
- Transformation Mode Support: Added the
TransformationModeproperty toTransformationInfoto support apps using theOpenGLpipeline inEMBEDDEDmode. - Focus State Tracking: Added
FocusStateandFocusMeteringStateconstants to the generic viewfinder core. Note: These constants were primarily introduced to support the new tap-to-focus and gesture capabilities in the higher-levelCameraXViewfinderAPI, but they are exposed in the core modules for developers building custom viewfinder integrations who wish to model camera focus states.
Bug Fixes - Transformations Mirroring: Fixed a critical bug in the mirroring logic within Transformations. This ensures that surface-to-viewfinder matrix calculations correctly mirror the preview when using front-facing cameras or inverted setups.
Important changes since 1.6.0:
1. Stabilized Camera2Interop (V2) & Kotlin DSL Builders
- Camera2Interop V2 (Stable, No Opt-In Required): Redesigned
Camera2Interopand removed the@ExperimentalCamera2Interoprequirement on the new V2 APIs, providing type-safe, scope-specific configurator factory methods (Camera2Interop.forUseCase(),forImageCapture(),forSessionConfig(), andforCameraControl()) paired withsetInterop()onPreview.Builder,ImageCapture.Builder,ImageAnalysis.Builder,VideoCapture.Builder, andSessionConfig.Builder, plusCameraControl.applyInteropAsync().- Added Kotlin DSL
camera2Interop { ... }extension blocks forpreview,imageCapture,imageAnalysis,videoCapture, andSessionConfig.Builder/sessionConfig, as well asCameraControl.applyCamera2Interop()(suspend) andCameraControl.applyCamera2InteropAsync(). - Exposed granular interop scopes (
UseCaseCamera2Interop,ImageCaptureCamera2Interop,SessionConfigCamera2Interop, andCameraControlCamera2Interop) providing structured access toOutputConfigurationsettings (streamUseCase,mirrorMode,dynamicRangeProfile,physicalCameraId,sensorPixelModesUsed,surfaceGroupId,timestampBase),SessionConfigurationsettings (sessionType,colorSpace,sessionParameter,sessionStateCallback), still capture options, andCameraCaptureSession/CameraDevicestate callbacks. - Added helper methods and Kotlin extensions to retrieve Camera2 metadata and selectors directly:
Camera2Interop.getCameraId(CameraInfo)(CameraInfo.cameraId),Camera2Interop.getCameraCharacteristics(CameraInfo)(CameraInfo.cameraCharacteristics),Camera2Interop.getCameraSelectorFromCameraId(String)(String.toCameraSelector()), andCamera2Interop.getCameraFilterFromCameraId(String). - Deprecated legacy Camera2Interop V1 classes (
Camera2Interop.Extender,Camera2CameraControl,Camera2CameraInfo, andCaptureRequestOptions).
- Added Kotlin DSL
- CameraX Kotlin DSL Builders: Added top-level Kotlin DSL factory functions for creating use cases and session configurations:
preview { ... },imageCapture { ... },imageAnalysis { ... },videoCapture(videoOutput) { ... },sessionConfig(useCases) { ... },highSpeedVideoSessionConfig(videoCapture) { ... }, andextensionSessionConfig(mode, extensionsManager) { ... }.
2. Compose Viewfinder Gesture, Screen Flash & Transformation Enhancements
- Built-in Gestures, Screen Flash & Stream State in
CameraXViewfinder:CameraXViewfinderincamera-composenow provides out-of-the-box support for pinch-to-zoom (isPinchToZoomEnabled,onZoomRatioChanged), tap-to-focus (isTapToFocusEnabled,onTapToFocus,autoCancelDurationMillis), screen flash (onScreenFlashReady), stream state monitoring (onStreamStateChangedwith newly publicPreview.STREAM_STATE_IDLEandPreview.STREAM_STATE_STREAMING), and surface release callbacks (onRelease). FocusState&TransformationMode: ExposedFocusState(INACTIVE,STARTED,FOCUSED,NOT_FOCUSED,FAILED) inviewfinder-coreto monitor tap-to-focus results, and addedTransformationMode(DEFERRED,PRE_APPLIED) toTransformationInfoto ensure accurate viewfinder transformations inEMBEDDEDmode when CameraX's OpenGL pipeline is active.
3. Video Capture & Audio Recording Enhancements
- QHD (2K) Video Recording: Added
Quality.QHD(2560×1440) andGroupableFeatures.QHD_RECORDINGfor 2K video capture and Feature Group queries. - Video & Audio Codec (MIME Type) Control: Introduced APIs for granular control over encoding formats:
- Discover device-supported formats via experimental (
@ExperimentalMimeTypeApi)Recorder.getSupportedVideoMimeTypes()andRecorder.getSupportedAudioMimeTypes(). - Configure and inspect preferred formats via stable
Recorder.Builder.setVideoMimeType(String),Recorder.Builder.setAudioMimeType(String),Recorder.getVideoMimeType(), andRecorder.getAudioMimeType(). - Query codec-specific camera capabilities (such as supported qualities and dynamic ranges) via stable
Recorder.getVideoCapabilities(CameraInfo, String).
- Discover device-supported formats via experimental (
- Audio Channel Count & Bitrate Configuration: Added
Recorder.Builder.setTargetAudioChannelCount(int)andRecorder.Builder.setTargetAudioEncodingBitRate(int)(along withRecorder.getTargetAudioChannelCount()andRecorder.getTargetAudioEncodingBitRate()) for explicit control over audio recording channels and bitrate. - Stabilized & Dynamic Mirror Mode: Stabilized
Preview.Builder.setMirrorMode(int)(removing@ExperimentalMirrorMode) and addedPreview.setMirrorMode(int),Preview.getMirrorMode(), andVideoCapture.setMirrorMode(int)to allow updating mirror mode dynamically.
4. Dynamic Concurrent Camera Composition & Visual Styling
- Dynamic Composition Updates & Z-Order: Added
ConcurrentCamera.setCompositionSettings(List<CompositionSettings>)to dynamically update Picture-in-Picture or split-screen layouts after binding to a lifecycle, and addedCompositionSettings.Builder.setZOrder(int)andCompositionSettings.getZOrder()to control the rendering layer order of overlapping camera streams. - Frame Borders & Rounded Corners: Added
setRoundedCornerRatio(float),setBorderWidthRatio(float), andsetBorderColor(int)onCompositionSettings.Builder(along withgetRoundedCornerRatio(),getBorderWidthRatio(), andgetBorderColor()onCompositionSettings) to style concurrent camera frames with normalized rounded corners and colored borders.
5. GPU-Accelerated ImageAnalysis & Common Image Abstractions
PRIVATEFormat &HardwareBufferAccess: ExposedImageAnalysis.OUTPUT_IMAGE_FORMAT_PRIVATE,ImageAnalysis.getImageAnalysisCapabilities(CameraInfo).isOutputFormatSupported(int), andImageProxy.getHardwareBuffer()as public APIs, enabling zero-copy GPU-basedImageAnalysispipelines.ImageWrapper&camera-commonAbstractions: Introducedandroidx.camera:camera-commonandandroidx.camera:camera-common-testing, providing common wrappers (ImageWrapper,ImagePlanewith non-nullableByteBufferbuffer,CameraCharacteristicsWrapper,CaptureRequestWrapper,CaptureResultWrapper) and test fakes (FakeImage,FakeCameraCharacteristics, etc.).ImageProxyandImageProxy.PlaneProxynow implementImageWrapperandImagePlane.
6. Scene Detection, 3A Control, Physical Camera Binding & Auto-Rotation
- Night Mode Indicator: Added
CameraInfo.isNightModeIndicatorSupported(),CameraInfo.getNightModeIndicator(), andNightModeIndicator(UNKNOWN,NOT_RECOMMENDED,RECOMMENDED) to detect low-light scene conditions during standard capture sessions. - 3A Locking Mode in
FocusMeteringAction: AddedFocusMeteringAction.Builder.setLockingMode(int)andFocusMeteringAction.getLockingMode()to support locking AE/AWB (FLAG_AE,FLAG_AWB) or updating 3A metering regions without locking focus (FLAG_AF), allowing the camera to remain in continuous autofocus (CAF) mode while updating the focus area. - Physical Camera Selection & Binding: Added support for obtaining a
CameraSelectorfor physical cameras fromCameraInfo.getPhysicalCameraInfos()and bindingUseCasesdirectly to physical cameras. QueryingCameraProvider.getCameraInfo()with a physicalCameraSelectornow returns the physicalCameraInforather than the logicalCameraInfo. - Automatic Sensor-Based Rotation (
isAutoRotationEnabled): AddedsetAutoRotationEnabled(boolean)/isAutoRotationEnabledtoSessionConfig.Builder,HighSpeedVideoSessionConfig.Builder,ExtensionSessionConfig.Builder, andCameraControllerto automatically update target output rotation from device sensors or disable the built-in rotation listener when needed. - Low Light Boost & Torch/Flash Interoperability: Low Light Boost and Torch now follow a "last setting wins" policy where enabling one automatically disables the other instead of rejecting the request. In addition, flash can now fire during
ImageCapturewhile Low Light Boost is active. - Custom
SessionConfiginCameraController: ExposedCameraController.setSessionConfig(SessionConfig, CameraSelector)to support binding customSessionConfiginstances withCameraController. - Extensions API Deprecation: Deprecated
ExtensionsManager.getExtensionEnabledCameraSelector()in favor ofExtensionSessionConfig.
Important changes since 1.12.0:
- Deferred Transitions Stable: Promoted deferred transition APIs out of experimental. This includes
DeferredTransitionState,rememberDeferredTransition,DeferredAnimatedContent,DeferredAnimatedVisibility, andTransformScope. Ib6430 I7bb7e CapturedAnimatedVisibility: IntroducedCapturedAnimatedVisibility. Disposes child composition immediately when hidden, and animates exit transitions by rendering the last captured frame on aGraphicsLayer. I6c5b3- Graduated Stable APIs: Promoted
createChildTransition,Transition.Crossfade,veilOut, andunveilInto stable APIs.EnterTransition.withhas been removed; usetogetherWithinstead. I38f66 Ied832 I9e3a3 - Transition Configurations: Made
EnterExitTransitionConfigpublic onEnterTransitionandExitTransition. External libraries can now inspectEnterTransitionandExitTransitionconfigurations to build custom transition support. Idd5a4 b/330152398 DeferredTargetAnimation.value: Exposed the current animated value as a public property onDeferredTargetAnimation. Ie4f6e b/434659224- Seekable Transition Crash Fix: Fixed an issue in
SeekableTransitionStatewhere zero-duration or interrupted transitions could calculateNaNfractions and throw anIllegalArgumentException. I8f3a9 b/555294641
API Changes
- Added
ExperimentalAnimationCoreApiandComposeAnimationCoreFlags.isSeekableTransitionStateStartAfterLayoutEnabledto guard startingSeekableTransitionState.animateToafter the target state has composed and completed layout. I034e3 b/553804644 - Migrate Compose animation specs (
FloatSpringSpec,FloatExponentialDecaySpec,KeyframesSpec,KeyframesWithSplineSpec, andSplineBasedFloatDecayAnimationSpec) to nanosecond precision, guarded byComposeAnimationCoreFlags.isNanosecondAnimationSpecEnabled. Ib9545 - Added
SharedTransitionScope.DeferredTransitionBehavior(FollowContainer,Static,SeekToTarget),SharedContentConfig.deferredTransitionBehavior, andMutableContentTransform.sharedElementProgressto support seeking shared elements toward their target bounds during the deferred phase of aDeferredTransition. DeprecatedpermitTransformDuringDeferredTransition. I2fac2 - Added
InterruptionAwareAnimationSpecto allow pairing aFiniteAnimationSpecwith a custominterruptionSpec(or itself) when aTransition,animate*AsState, orAnimatable.animateToanimation is interrupted mid-flight. If85e8 - Allow constructing
MutableContentTransformfrom twoMutableTransforminstances via constructor. I4054e - Made
SharedTransitionDefaults.EnterTransition,ExitTransition, andResizeModepublic. AddedAnimatedContentDefaultswithContentTransform,SizeTransform, andSizeAnimationSpec. Id912e
Bug Fixes
- Fixed an issue where
SeekableTransitionState.animateToskipped initial animation frames when the target content had an expensive first composition or layout pass. I383c6 b/553804644 compileSdkfor Compose UI and the Compose libraries that build against it (Animation, Foundation, Material 3, UI Test, UI Tooling, UIViewBindingand Navigation3 UI) updated to 37.2. This will require transitively updatingcompileSdkfor all apps and libraries using them. I2859d- When a
MutableContentTransformorMutableTransformis provided during a deferred transition phase, transform properties that are not manually set now default to their resting values instead of the transition's initial values. Ia79c4 - Shared elements sought via
MutableContentTransform.sharedElementProgressnow transfer their progress velocity to the bounds animation upon handoff. I462c0 Modifier.sharedElementnow renders the incoming target element (pendingTargetState) during the deferred phase of aDeferredTransitionwhile keeping its bounds anchored to the outgoing state until the transition commits. If60c7- Fixed an issue where shared elements nested under
Modifier.animateEnterExitlostMutableContentTransformplacement transformations on handoff from a deferred transition phase. Icdcd7 b/572520922
Important changes since 1.12.0:
Please see the release blog for 1.13 for a full list of new features in this release.
API Changes
- Removed
ComposeFoundationFlags.isLinkMinimumTouchTargetSizeZeroEnabled. Ib9226 b/572883859 - Added
ComposeFoundationFlags.isLinkPerformanceOptimizationEnabledto control performance optimizations forLinkAnnotationinBasicText. The flag is off by default. I8ac26 b/572883859 - Added new overloads of
BasicTextthat accept astyleProvider(TextStyleScope.() -> Unit) lambda for dynamic styling, allowing dynamic style attributes to skip recomposition. I88e20 - Removed
ComposeFoundationFlags.isLinkMinimumTouchTargetSizeZeroEnabled. I046d5 b/572883859 - Added
ComposeFoundationFlags.isLinkPerformanceOptimizationEnabledto control performance optimizations forLinkAnnotationinBasicText. I64a0f b/572883859 - Added an
onTextChangedcallback toTextFieldStateandrememberTextFieldState. It is called with the new text after each change to the text. Iaabf5 b/552879150 - Removed the feature flag ComposeFoundationFlags.isAbsorbNonGestureNestedScrollInPagerFixEnabled I0a387
Modifier.borderuses a more efficient implementation for rendering generic shapes (such as polygon shapes) on API 28 and above. This causes minor antialiasing differences that may require updating screenshot tests. To temporarily disable this, useComposeFoundationFlags.isBorderUsesGraphicsLayerForGenericShapesEnabledI3b917- Added
rememberStyleResolver()that should be used instead of remembering aStyleResolver()instance directy to ensure that the same style resolver is used even if thestyleandstyleStateused are modified. This prevents animations from being cancel because style style lambda instance was replaced. I946b0 - Added
TextContextMenuKeys.LookUpKeyto support the new 'Look Up' context menu item. I088ca - Added DrawAnnotation for custom drawing behind and over AnnotatedString text ranges. I928bf
- Exposed
crossAxisCellCountonLazyGridItemScopeto provide the number of cross-axis cells (columns in vertical grids or rows in horizontal grids) to item content. I89f78 b/183187002 - The
styleable()modifier API has been replaced by thestyleResolvermodifier based API. Allstyleable()modifiers and associated types (such asStyleandStyleScope) have been deprecated. I54677 - Fixed an issue in BasicSecureTextField where multi-codepoint emojis in the input text were obfuscated or revealed as multiple characters instead of a single glyph. I91e44
- Added
multiTouchSwipeWithVelocitytoTouchInjectionScopeto allow testing multi-touch gestures with a specific end velocity. If0966 - Adds
BorderRenderer, an API that enables drawing borders identical to Modifier.border within any draw scope, such as within aDrawModifierNode. This enables advanced border rendering and efficient animations alongside other drawing operations / transformations. See the samples for more information. I2d259 b/548628030 Modifier.bordernow consistently uses the outline size when rendering borders. UseComposeFoundationFlags.isBorderMatchesOutlineBoundsFixEnabledto temporarily disable this if it causes issues. I3e171- Removes experimental feature flag
ComposeUiFlags.isTrackpadPanHoverFixEnabled. I3aa5b - Added
ComposeFoundationFlags.isNewBorderImplementationEnabled- this flag will be used to disable the new border rendering implementation insideModifier.border. If you run into issues and need to disable this flag, please file a bug. I98e90 - Added
isLazyLayoutItemAnimationEnterExitTransitionsEnabledcompose flag. When enabled, lazy layout item animations use a state-based enter and exit transition model instead of boolean-based fade tracking. Ibde5d - Removed
AndroidComposeFoundationFlags.isOverscrollPixelRoundingEnabledflag I0e3e0 - Fixes an edge case bug with rendering certain rounded rectangle outlines in
Modifier.border.ComposeFoundationFlags.isRoundedRectangleBorderRenderingFixEnabledcan be used to disable this change if it causes issues. I19141
Bug Fixes
- Improved composition and node overhead of
LinkAnnotationinBasicTextby consolidating per-link modifiers into a singleTextLinkNode. I1e93b b/572883859 - Improved composition performance of
LinkAnnotationinBasicTextby avoiding unnecessary coroutine andMutableInteractionSourceallocations when stateful link styles are not used. Ib036d b/572883859 - Fixed a bug where simultaneous stateful styles on multiple
LinkAnnotationsinBasicTextoverwrote each other, and improved styling performance from O(N^2) to O(N). I07a27 b/572883859 - Improved drawing and hit-testing performance of single-line
LinkAnnotationsinBasicTextby bypassing unnecessary path clipping. I70379 b/572883859 - Improved measurement performance of single-line
LinkAnnotationsinBasicTextby avoidingPathallocations. I9ec65 b/572883859 - Fixed a crash in Robolectric tests when a text field shows its magnifier, e.g. after two quick clicks on it. I65095
- Improved composition performance of
LinkAnnotationinBasicTextby avoiding unnecessary coroutine andMutableInteractionSourceallocations when stateful link styles are not used. Ia784d b/572883859 - Fixed a bug where simultaneous stateful styles on multiple
LinkAnnotationsinBasicTextoverwrote each other, and improved styling performance from O(N^2) to O(N). I4f28e b/572883859 - Improved drawing and hit-testing performance of single-line
LinkAnnotationsinBasicTextby bypassing unnecessary path clipping. Ib7f63 b/572883859 - Improved measurement performance of single-line
LinkAnnotationsinBasicTextby avoidingPathallocations. I4312c b/572883859 - Fixed an issue where active but stationary trackpad gestures could cause unnecessary frame requests (high CPU usage). I1e879
- Updated accessibility node text and text layout results to reflect active text translations (
SemanticsProperties.TextSubstitution) whenSemanticsProperties.IsShowingTextSubstitutionis true. I006ef - Fixed an issue in
LazyGridwhere changing item spans dynamically via state could cause anIllegalStateExceptionor item placement errors. I680b9 b/398125797 - Fixed an issue where changing only
isNonScrollCachingEnabledon aLazyLayoutCacheWindowhad no effect because the windows were considered equal. I16d57 - Fixed long screenshots that show content twice when a scrolling node sits inside
pullRefreshor a nested scroll parent. I2500f - Fixed
Modifier.animateItem()animating items off screen when a lazy layout withreverseLayout = trueis resized. I68af6 b/548989579 GridTrackSize.FlexandGridTrackSize.MinMaxnow throwIllegalArgumentExceptionwhen given a non-finiteFrweight. I70728Modifier.bordernow supports rendering generic / polygon shapes with a runtime shader, when using the new border implementation. I128caModifier.bordernow uses a new more performant implementation. You can disable this usingComposeFoundationFlags.isNewBorderImplementationEnabled. If you run into issues and need to disable this flag, please file a bug. I4c3b3
External Contribution
- Fixed bring-into-view scroll animations that never finished when the
BringIntoViewSpectarget fell between pixels, such as when focusing a text field in a scrollable container on Android TV. Ida7b9 b/568935367 - Fixed the text selection toolbar remaining visible when the selection no longer has a valid content area. I92563
- Allow reversed (end < start) selection when made via a mouse gesture in a
TextField(TextFieldState). Previously it would be automatically made "normal" (start < end). I42559 - Fixed
AndroidExternalSurfacecallbacks after reuse in reusable content. I8b56c b/554586999
API Changes
- Added
HorizontalSharedAxisNavigationTransitionsandFadeThroughNavigationTransitionsfor Material 3 shared axis and fade through transitions, including predictive back. I0a37a I36fb9 I4b9e6 I62437 - Marked
SliderStateandRangeSliderStateas@Stable. I8fda7 - Deprecated the
TextFieldandOutlinedTextFieldoverloads that takevalue/onValueChange, plusTextFieldDefaults.DecorationBoxandOutlinedTextFieldDefaults.DecorationBox. Use theTextFieldStateoverloads anddecoratorAPIs instead. Idb68b b/554049628
Bug Fixes
Slider and RangeSlider
- Fixed a
TalkBackfreeze when aSliderupdates automatically (for example, during video playback). I8fda7 - Fixed precision loss when a discrete
SliderorRangeSlidersnaps to integer ticks. I0f2ac b/237634010 - Fixed
RangeSlidernot updating on tap when its thumbs overlap. I8287e b/352467346 - Fixed dragging a
RangeSliderthumb scrolling the parent when the slider is inside a horizontally scrollable container. I855c0 b/415838608
Text fields
- Focusing a
TextFieldorOutlinedTextFieldno longer recomposes its container, and the outlined border no longer recomposes on every frame while it animates. Id915b OutlinedTextFieldDefaults.tonalColorsnow uses a transparent container color. I79be4
Pickers
- Fixed the
TimePickerclock face selector not updating after you toggle AM/PM or the state changes. I99955 b/513496734 - Fixed AM/PM text clipping at large font scales in
TimePickerandTimeInput. I73bda - Fixed the
DatePickeryear dropdown icon ignoringnavigationContentColor. I4eb6a b/489897727
Progress and loading indicators
LinearWavyProgressIndicatorandCircularWavyProgressIndicatornow show an indeterminate indicator while progress isn't a finite number (such asFloat.NaN), then animate to determinate progress once it is. I4c631LoadingIndicatornow shares its shape morphs across instances, which speeds up composition.PullToRefreshDefaults.LoadingIndicatorno longer composes when it's hidden at rest. Ic81df b/574346694- Fixed
PullToRefreshDefaults.LoadingIndicatordrawing an empty container on the first frame of a pull. Ia87cf - Fixed
PullToRefreshBoxhiding its indicator afteronRefreshstarts a refresh when you use a customPullToRefreshState. I7537d
ScrollField
- Reduced the gap between items to 16dp and lowered
ScrollFieldDefaults.ScrollFieldHeightfrom 200dp to 120dp. I80382 - Items no longer show a ripple or hover background, and the focus indicator no longer draws outside the rounded shape. I08e48 Ief60e
Other components
- Fixed short
ModalBottomSheets needing two back presses to close. WithPartiallyExpandedenabled, the sheet now rests at half its content height (no more than half the screen). To remove that anchor in code, useenabledValues. This change is behindComposeMaterial3Flags.isBottomSheetPartiallyExpandedDeterministicEnabled. I395d4 b/521534697 FloatingActionButtonMenunow composes its items the first time it expands, and expanding or collapsing does less layout work. I16131- Fixed a crash in
ButtonGroupwhen it overflows at a fixed width (for example,Modifier.fillMaxWidth()). I5a448 b/572113567 ToggleButtonnow gets its pressed shape fromButtonSmallTokens.PressedContainerShapeinstead of a hardcoded value. Ia60dc b/531792521- Fixed
DropdownMenuItemcutting offtrailingContentwhen the text is long or the font is scaled up. Iae4c8 - Fixed an extra recomposition the first time
BottomAppBar,FloatingToolbarand other components compose while an accessibility service is on. Ic461a - Fixed inset focus rings not drawing the inner stroke on generic or path-based shapes. I6a430
Dependency Updates
material3now depends onandroidx.graphics:graphics-shapes:1.1.0. I52c5c b/574346694material3now depends onandroidx.compose.foundation:foundation:1.14.0-alpha01. Id915b
Important changes since 1.4.0:
Library change announcements
- New
material3-rippleartifact and Inset Focus Rings: Added the dedicatedandroidx.compose.material3:material3-rippleartifact as a modern replacement formaterial-rippleI1b3a3.
This library adds support for rendering focus states using visual inset focus rings instead of opacity layers. Within material3, this integrates seamlessly via LocalRippleThemeConfiguration I0551a. Standalone design systems can also depend directly on androidx.compose.material3:material3-ripple.
Behavior Changes
SliderandRangeSliderstateful migration & source-breaking parameter change:- Stateless overloads of
SliderandRangeSliderare deprecated in favor of stateful overloads takingSliderStateandRangeSliderStateIf8995. - Source breaking change:
onValueChangeis now a required parameter, and its position in the parameter list has changed.SliderandRangeSlidernow handleonValueChangeandonValueChangeFinisheddirectly in the composable layer rather than passing them throughSliderStateI959ac. - In
RangeSliderState,activeRangeStartandactiveRangeEndhave been renamed tostartValueandendValueIf8995.
Migration Example:
// Before (Stateless) var value by remember { mutableFloatStateOf(0.5f) } Slider(value = value, onValueChange = { value = it }) // After (Stateful) val state = remember { SliderState(value = 0.5f) } Slider(state = state, onValueChange = { /* optional side effects */ })- Stateless overloads of
SecureTextFieldDefault Obfuscation Mode: UpdatedSecureTextFieldandOutlinedSecureTextFieldto default toTextObfuscationMode.Systemrather thanTextObfuscationMode.RevealLastTypedI76c7e.BottomSheetDeterministic Anchor Resolution:ModalBottomSheetandBottomSheetScaffoldno longer automatically remove thePartiallyExpandedanchor based on layout height heuristics (Ia4167. Developers explicitly control anchors viarememberBottomSheetState. Sheets also now respectMaterialTheme.motionSchemeduring nested scrolling and dragging I5fe22.Navigation Item High-Contrast Label Color: Horizontal
NavigationItemlabels (e.g. inWideNavigationRail) now calculate color viaselectedTextColorStartIconPositionto matchselectedIconColorunder high-contrast themes I85855 b/490910896. To revert, setselectedTextColorStartIconPosition = MaterialTheme.colorScheme.secondary.Checkbox Sizing & Alignment: Checkbox box size and indicator marks have been recalibrated to strictly align with the Material 3 specification I97baf b/457504316. Flag
ComposeMaterial3Flags.isCheckboxStylingFixEnabledis provided to assist testing and rollout.TopAppBarDefaultsScroll Behaviors:pinnedScrollBehaviorandenterAlwaysScrollBehavioroverloads now takeScrollableState(LazyListState,ScrollState) to resolve reversed layout directions and initially scrolled offsets Idef9d I9d5c2. ParameterisAtTopis renamed toisAtStartIf7323.Single Theme Composition Local:
MaterialThemewas refactored internally to consolidate theme values into a single composition local (MaterialTheme.LocalMaterialTheme.current) Idee2e. DeprecatedLocalMotionSchemein favor ofMaterialTheme.motionSchemeI4b61d.
New Material Design 3 Components
- Expressive Buttons & Button Groups:
ToggleButton,ElevatedToggleButton,FilledTonalToggleButton, andOutlinedToggleButton: Toggle buttons featuring expressive shape morphing,ButtonSize, and icon slots Iab484.SplitButton: Expressive split button combining a primary action button and a trailing menu/dropdown trigger, replacingSplitButtonLayoutIc9840.ButtonGroup: Container for grouped buttons supporting adaptive width squishing viaModifier.animateWidth(compressionLimit = ...)and overflow indicators I8ef39 I6e67c.
- Expressive Text Fields:
TextFieldandOutlinedTextFieldexpressive styling options featuringTextFieldDefaults.roundedShape,tonalColors(), andTextFieldLabelPosition.Inside/Cutoutlabel placement Id9185 I40f62.
- Expressive Chips:
FilterChip,ElevatedFilterChip, andInputChipwith shape-morphing selection animations, custom content padding, andhorizontalArrangementsupport I84717 Ida874.
- Expressive Menus & Submenus:
SelectableDropdownMenuItemandCheckableDropdownMenuItem: Expressive menu items supporting radio and checkbox selection semantics, supporting text, and vibrant colors I160ca I89e4b.DropdownMenuPopupPositionProvider: Enables anchor-relative popup positioning for nested cascading submenus Ic1ace.
- Expressive Time Pickers & Pickers:
VibrantTimePickerDialog: Expressive time picker dialog supporting both dial and uncontained scroll/input modes Iea5aa I2b3b6.- Scrollable
TimePickervariant andScrollField: Wheel/scroll picker variant for rapid numeric selection with full keyboard and screen reader accessibility I46f6b Iab612.
- Sheets and Scrims:
- Wavy Progress Indicators:
WavyLinearProgressIndicatorandWavyCircularProgressIndicator: Expressive wavy paths for determinate and indeterminate loading indications Id72a3.
- Loading Indicators (Experimental):
LoadingIndicatorandContainedLoadingIndicator: Expressive loading indicators that morph smoothly across a sequence ofRoundedPolygonshapes in both determinate (progress) and indeterminate modes, customizable viaLoadingIndicatorDefaults(and supported as a pull-to-refresh indicator viaPullToRefreshDefaults.LoadingIndicator).
- Material Shapes (Experimental):
MaterialShapes: Provides 35 predefined, normalized Material Design 3 shapes asRoundedPolygons (includingCircle,Square,Slanted,Arch,Oval,Pill,Sunny,Cookie4Sided–Cookie12Sided,Clover4Leaf,Clover8Leaf,Burst,SoftBurst,Flower,Puffy, andHeart), along withtoShapeandtoPathextensions to convertRoundedPolygonandMorphinstances into ComposeShapeandPathobjects.
- Toolbars & List Items:
FloatingToolbarandHorizontalFloatingToolbar: Expressive floating toolbars with built-in overflow handling I5a4d8 I6a6f8.- Expressive and Segmented
ListItem: Interactive and non-interactive list item variants with rounded container segmenting I54057 I2836a. - Added support for
verticalAlignmentin interactiveListItem, allowing custom alignment of content Id69ec6. - Added
InteractiveListItemdocumentation and performed renames of internal components toListItemfor improved developer ergonomics Ib70923.
- Enabled customizing list items vertical alignment via
InteractiveListItemDefaults.verticalAlignment()Id69ec6. - Search Variants:
AppBarWithSearch(Experimental): Seamless integration of top app bar navigation with a search field I213a5.ExpandedDockedSearchBarWithGapandExpandedFullScreenContainedSearchBar: Expansion variants for tablet and large-screen search experiences Idb7f8 Ie472d.
Enhancements to existing Material Design 3 components
- Accessibility & Keyboard Navigation: Overhauled keyboard navigation and focus traversal across
DatePickers (grid, year selector),TimePickers (dial numbers, AM/PM buttons),Sliders,Scaffolds, andNavigationDrawers Ibba27 I77194. - Theming & Styling: Graduated the Expressive theming (
MaterialTheme.expressiveLightColorScheme,MaterialTheme.materialExpressTheme) (I40eab, bringing expressive design tokens, shapes, and color configurations across components. - Typography: Added constructor overloads to
Typographythat accept adefaultFontFamily, propagating the font family to all unset styles in the type scale (I2e305, - Text: Added
Textcomposable overloads taking aColorProducerlambda to animate or update text color during the draw phase without triggering recomposition (I9ff25, - Carousels:
- Tooltips:
Stable APIs
All components and APIs listed under New Material Design 3 Components are stable in 1.5.0, except those listed under Remaining experimental APIs below.
The following previously experimental APIs are also now stable:
BottomAppBarand associated methods I42c61TopAppBarScrollBehaviorand top app bar variants (TopAppBar,MediumFlexibleTopAppBar,LargeTopAppBar,TwoRowsTopAppBar) Ieb2d1 Iea5aaSearchBarStateand slot-basedSearchBarcomposables Ia3793- Core
SliderandRangeSliderAPIs I5efb3 - Multi-browse and uncontained
CarouselAPIs I7a558 LocalRippleThemeConfigurationandRippleThemeConfigurationIde5d0BasicAlertDialogIf157c
Remaining experimental APIs
These APIs are new in 1.5.0 but remain experimental and may change in future releases:
- Loading indicators:
LoadingIndicator,ContainedLoadingIndicator,LoadingIndicatorDefaults, andPullToRefreshDefaults.LoadingIndicator - Material shapes:
MaterialShapesand thetoShape/toPathextensions AppBarWithSearchandAppBarWithSearchColors- Carousel parallax / multi-aspect support:
Modifier.carouselParallaxScrollEffect - Standalone static
BottomSheet
Performance improvements
DatePickermonth navigation now resolves in a single frame by evaluating navigation availability directly from the displayed month index I08db7.- Reduced recompositions when updating text colors using the new
ColorProduceroverload onTextI9ff25. - Optimized
BasicTextFieldminimum dimension layout calculations I70ade.
API Changes
- Migrated
RemoteBasicImageandRemoteBasicTextto useRemote*types (RemoteContentScale,RemoteTextOverflow, etc.) instead of Compose UI types.
Important changes since 1.12.0:
ComputedState API
We've introduced a new computedStateOf { } API that can be used as an alternative to derivedStateOf.
Like DerivedState, ComputedState is an implementation of State whose value is backed by a calculation that may read other states. The value will invalidate when the result of the calculation changes, not when one of the referenced states changes.
The primary difference between ComputedState and DerivedState is that DerivedState caches the result of its calculation and ComputedState executes the calculation on-demand each time the value is read. For many calculations, this caching is more expensive than computing the value on-demand. Therefore, we recommend using ComputedState instead of DerivedState when your calculation doesn't benefit from caching. Good candidates for calculations that don't benefit from caching are ones that don't rely on object identity of its result, don't allocate large objects, don't read many states, aren't read many times in a single frame, and don't perform a complex algorithm.
As a general rule of thumb, we recommend using ComputedState instead of DerivedState for most usages and if it's unclear whether caching would be beneficial.
Updates to the Experimental SlotTable
The LinkComposer remains opt-in as of Compose 1.13, and includes fixes for several issues reported since Compose 1.12. We continue to recommend testing your app against the new implementation of the SlotTable and reporting any issues you run into.
Note that in runtime version 1.13.0-alpha01, the proguard syntax for enabling the LinkComposer in minified builds has changed. See the feature flag documentation and previous release notes for more information.
API Changes
- Parent snapshots are now advanced when a nested snapshot is taken. When snapshot writes are made to the same state object in both snapshots, the parent snapshot's writes will now appear to be after writes in the child, and will appear in the final snapshot when applied. This behavior can be disabled via the flag
ComposeRuntimeFlags.advanceParentSnapshotsWhenTakingNestedSnapshot. I30263 b/573222121 - Added the
Snapshot.readOnly { }API I5feef MutableVectorandmutableVectorOfare deprecated. Useandroidx.collection.MutableObjectListandmutableObjectListOfinstead. If0dd8- Removed the
watchosArm32target, which Kotlin 2.5 no longer supports. Ic048d
Bug Fixes
- Fixed
SnapshotStateObserverstill notifying a cleared scope when its first observation nested an observation of the same scope. Ie7789 - Fixed an issue in the
GapComposerandLinkComposerthat could cause a crash when nodes are modified around the end of an inlined node's group boundary I173fe b/569219194 - Fixed an issue where a
CompositionLocalcould be read incorrectly if placed after aMovableContentinstance that is removed from composition. I8100a b/574059467 - Fixed an issue in the
LinkTablethat could recompose content out of order when keyed items are inserted and removed in the same frame I4acc7 - Updated androidx.tracing:tracing-wire dependency to 2.0.5. I70e9f
- Documented that
scheduleFrameEndCallbackthrowsCancellationExceptionwhen theRecomposershuts down. Iae38a b/568852322 - Fixed an issue where disposing a parent
MutableSnapshotwhile a nested snapshot remained active could prematurely unpin state records and cause subsequent reads of modified states to throw anIllegalStateException. If2887 b/573733481 - Fixed a race condition in
derivedStateOfwhere concurrent state updates could cause reading a derived state to throw a spuriousIllegalStateException. I3861b b/574107950 - Fixed a memory leak in
LinkComposerwhere skipped conditional invalidations and invalidated scopes removed by ancestor recomposition were retained in the composer's invalidations map. Idffd0 - Fixed a bug where applying a
NestedMutableSnapshotwith merged state records could leak an open snapshot ID and read unmerged state in the parent snapshot. I544a7 b/570652672 - Fixed a bug in
SnapshotIdSet.andNotwhere sets sharing abelowBoundarray retained cleared snapshot IDs. Ie881e b/570534659
External Contribution
- Fixed an issue where a state change applied while a
PausedCompositionwas composing its initial content on another thread was not reflected when the composition was applied. I52618
Important changes since 1.12.0:
Please see the release blog for 1.13 for a full list of new features in this release.
API Changes
- Fixed an issue where
AndroidView(andAndroidFragment) jittered and oscillated during nested scrolling when a parent Compose container (such asScaffoldwith a collapsingTopAppBar,ModalBottomSheet, or dynamic padding/offset) moved or resized the hostedView. This fix is gated byAndroidComposeUiFlags.isNestedScrollInteropMeasureAndLayoutEnabled. I57434 - Added new overloads of
BasicTextthat accept astyleProvider(TextStyleScope.() -> Unit) lambda for dynamic styling, allowing dynamic style attributes to skip recomposition. I88e20 - Added
Modifier.illuminate,IlluminationScope, andModifier.lightAnchorto apply lighting effects to composables and anchor light positions to layout coordinates. If829a - Adds
Light(DirectionalLight,SpotLightandPointLight),SurfaceMaterial,SurfaceGeometrySpec. I8fd41 - Added
DrawAnnotationfor custom drawing behind and overAnnotatedStringtext ranges. I928bf - Added
computedMediaQueryAPI, which offers better performance overderivedMediaQueryfor calculations that don't benefit from caching.derivedMediaQueryis now deprecated. Idacbf - Added
LayoutModifierNode.invalidateRulers()to forceRulervalues provided by a node to be recalculated when they depend on non-snapshot state. Ia02a8 b/422509162 - The
styleable()modifier API has been replaced by thestyleResolvermodifier based API. Allstyleable()modifiers and associated types (such asStyleandStyleScope) have been deprecated. I54677 MutableVectorandmutableVectorOfare deprecated. Useandroidx.collection.MutableObjectListandmutableObjectListOfinstead. If0dd8Added
TextLayoutResult.getBoundingBoxesForRangeandTextLayoutResult.fillPathForRangeto query coalesced per-line bounding boxes and merged rounded highlight paths for a character range. Ic134a b/329052205Fixed an issue where
AndroidView(andAndroidFragment) dropped nested scroll and fling deltas when the root hostedViewwas a containerViewGroup(such asFrameLayout,FragmentContainerView, orCoordinatorLayout) withisNestedScrollingEnabled == falsewrapping a nested scrolling child (such asRecyclerView). To disable View-to-Compose nested scrolling, callViewCompat.setNestedScrollingEnabled(view, false)on the nested scrolling childViewitself. This fix is gated byAndroidComposeUiFlags.isNestedScrollInteropViewHolderFixEnabled. I74782Add missing pixel 10, 9a and 11 pro fold devices If7aa5
Added
multiTouchSwipeWithVelocitytoTouchInjectionScopeto allow testing multi-touch gestures with a specific end velocity. If0966Material 3
TextFieldandOutlinedTextFieldoverloads that acceptvalue, onValueChangeparameters, along withTextFieldDefaults.DecorationBoxandOutlinedTextFieldDefaults.DecorationBox, are deprecated in favor of theTextFieldStateoverloads anddecoratorAPIs. Idb68b b/554049628
Feature Flag removals
- Removed
AndroidComposeUiFlags.isAccessibilityPerformanceEnabled. I2a70e b/529420099 - Removed
ComposeUiFlags.isMinimalistLocalsEnabled. Ibc870 b/523295932 - Removed the feature flag
ComposeUiFlags.isClippedTouchBoundsOcclusionFixEnabledId9e0a - Removed the temporary feature flag
AndroidComposeUiFlags.isDelayedWindowInsetsRulersEnabled. I722b7 - Removed
ComposeUiFlags.isTrackpadPinchReinterpretationEnabled. I39fef - Removed
ComposeUiTestFlagsand the temporaryComposeUiTestFlags.isMainThreadTestSynchronizationEnabledForDeviceTestsflag. Main-thread synchronization in Compose device tests is now permanently enabled. I765e9 - Removed the feature flag
AndroidComposeUiFlags.isPropagateHideFromAccessibilityToMergingChildrenEnabledIef6fa - Removes experimental feature flag
ComposeUiFlags.isTrackpadPanHoverFixEnabled. I3aa5b - Removed the feature flag
AndroidComposeUiFlags.isTraversalGroupSortingEnabledI18b92
Bug Fixes
- Map
HintTextsemantics toViewStructure.setHintin Autofill. If6bcc - Fixed a crash in Robolectric tests when a text field shows its magnifier, e.g. after two quick clicks on it. I65095
- Fixed an unnecessary remeasurement when reading an alignment line during measurement and placing the child with a non-zero offset. I363ab b/435377724
- Updated accessibility node text and text layout results to reflect active text translations (
SemanticsProperties.TextSubstitution) whenSemanticsProperties.IsShowingTextSubstitutionis true. I006ef - Fixed screen reader focus resets in
LazyRow,LazyColumn, andLazyGridby setting pixelscrollDeltaXandscrollDeltaYonTYPE_VIEW_SCROLLEDevents. I463bc b/330744631 - Fixed a long screenshot crash on Android 12 when a captured frame is read before it presents. I0f9ec
- Fixed an issue where indirect pointer events and cancellations were not dispatched to multiple delegated
IndirectPointerInputModifierNodes or toIndirectPointerInputModifierNodes chained after a focus target in the same modifier chain. I0f15a - Updated
SemanticsProperties.PaneTitleexception message andpaneTitleKDoc to clarify that a pane cannot be a descendant of a clickable or semantics-merging node. I250f2 b/575553356
External Contribution
onVisibilityChangedandonFirstVisibleno longer report content as visible while it is outside of the window, when itsComposeViewisn't at the window's origin, such as in aRecyclerView. Ibb2b6 b/577830524- Allow reversed (end < start) selection when made via a mouse gesture in a
TextField(TextFieldState). Previously it would be automatically made "normal" (start < end). I42559
API Changes
- Add a utility method to get serial executors.
API Changes
- Added
ViewCompat.getSupplementalDescriptionandViewCompat.setSupplementalDescriptionto specify supplemental descriptions forViewinstances that complement existing text or content descriptions, and to work around a platform issue on API 36 and 37 whereView.setSupplementalDescriptionwas not propagated toAccessibilityNodeInfo. Iae481 - Added
CallAttributesCompat.contactUriandCallAttributesCompat.isGroupCallto allow specifying a Contacts Provider orVoIPcontact directory URI and indicating whether a call is a group call. Iddc59 - Added preview
AccessibilityNodeInfoCompat.PublicationInfoCompatfor describing digital publication elements, such as chapters, footnotes, and glossary entries, to accessibility services. I39c87 - Added preview
MATH_TAG_ANNOTATION,MATH_TAG_ANNOTATION_XML,MATH_TAG_ERROR,MATH_TAG_PHANTOM,MATH_TAG_SEMANTICS, andMATH_TAG_SPACEconstants toAccessibilityNodeInfoCompat.MathInfoCompat. Idcbb8 - Remove
NotificationCompat.ProjectedExtender#resetActions(). Ief3fc - Add
FontRequest.BuilderandfontProviderSystemCertsattribute to font-family XML to verify system font providers. I2630b - Added
flush,notifyViewAppeared, andnotifyViewDisappearedmethods toContentCaptureSessionCompatinandroidx.core:core. I50526 ContentPipCallbackmethods are renamed toonInit,onPrepare,onAttachandonFinish;onFinishnow takes aFinishReason. AddedonError(Throwable), which is called instead ofonFinishwhen entering picture-in-picture fails. I14b44- Rename
NotificationCompat.ProjectedExtender#hasActions()toshouldUseExtenderActions()and addresetActions()to reset projected actions back to the default unset state. Ic2baf - Add
NotificationCompat.ProjectedExtender#hasActions()to distinguish between unset projected actions and explicitly cleared actions. Ic47a8 - Added action management methods (
addAction,addActions,clearActions,getActions) toNotificationCompat.ProjectedExtenderto support notification actions on projected devices. Ia28c7 - Added reified extension methods on Bundle for the
BundleCompatmethods supportingParcelableandSerializable. Ib5bbf b/506684521 - Added
isPortrait(Context, int)andisLandscape(Context, int)helper methods toScreenOrientation. Ieb543 - Renamed
ScreenOrientationCompattoScreenOrientation. Ibfd04 - Added
ScreenOrientationCompatto resolve 4-way screen orientation constants from rotation angles. I1b29e - Add
disablePipOnAppSwitchtoContentPipExtIe5bad - Added
any,all, andnonepredicate extension functions toSparseArray,SparseBooleanArray,SparseIntArray, andSparseLongArray. I99a75 - Added
getOrPutextension functions toSparseArray,SparseBooleanArray,SparseIntArray, andSparseLongArray. I0bc45 - Added
sparseArrayOf,sparseBooleanArrayOf,sparseIntArrayOf, andsparseLongArrayOfbuilder functions. I23d5e - Introduced a fallback
PiPsolution inandroidx.core.pipto maintain Picture-in-Picture functionality during navigation gestures (like quick switch) where nativePiPmay be suppressed. If289a BasicPictureInPictureandVideoPlaybackPictureInPictureclasses now require an Executor in their constructors. A new commit() method has been introduced and must be called to apply parameter changes. Ib9150- Added preview
getOffsetType()andBuilderAPIs toAccessibilityNodeInfoCompat.SelectionPositionCompatto support multi-node selection boundaries. Iddacd - Introduced
@PreviewAccessibilityApiopt-in annotation for pre-release accessibility features. I80cbf - Add new APIs to get and set math info Ib5ad3
Bug Fixes
compileSdkfor Compose UI and the Compose libraries that build against it (Animation, Foundation, Material 3, UI Test, UI Tooling, UIViewBindingand Navigation3 UI) updated to 37.2. This will require transitively updatingcompileSdkfor all apps and libraries using them. I2859d- Fixed an issue on legacy (non-transactional) calls where
availableEndpointscould remain empty when Telecom delays or withholdsonCallAudioStateChanged. Ib46b0 - Restored the
FingerprintManagerCompatimplementation that was made a no-op in core 1.18.0. That change causedandroidx.biometric1.1.0 and other callers to report no fingerprint hardware and fail fingerprint authentication on API 29 and lower.isHardwareDetected(),hasEnrolledFingerprints()andauthenticate()now delegate to the platformFingerprintManageragain. Id8c84 b/543076354 AccessibilityNodeInfoCompat.MathInfoCompatset withAccessibilityNodeInfoCompat.setStructuredDataInfois now available to accessibility services throughAccessibilityNodeInfoCompat.getStructuredDataInfobelow API 37, where it's stored in the node's extras. If7e95- Normalized
DisconnectCause.UNKNOWNtoDisconnectCause.LOCALand handled platform call aborts withDisconnectCause.CANCELEDinonDisconnectso that platform-initiated disconnects report consistent causes across API levels. I3049f - Hardening the
ContentPipExtfallbackPiPsolution. Id276b - Fixed an issue where video calls on a Bluetooth headset could unexpectedly switch to speakerphone during transient audio route updates. Ie435a
- Bump core-telecom to 1.1.0-rc01. Iba053
- Added
@RotationIntDefto restrict rotation values inScreenOrientation. I03bf0 - Fixed an issue where video calls started with a preferred audio endpoint (such as the phone earpiece) would erroneously revert to the device speaker shortly after connecting. I38ea6
- Fixed an issue where video calls would incorrectly route audio to the device speaker instead of a connected wired headset on call start. I575a8
- Fixed an issue where manipulating
WindowInsetsCompatcould sometimes cause anIllegalArgumentExceptionduring screen rotation on Android 11 devices. I68aaf b/284078031 - Allow
VoIPapps to disconnect withDisconnectCause.ERRORstarting in SDK 38, with automatic remapping to LOCAL on older platform versions. I5a58c - Bump core-telecom to 1.1.0-beta01. I5b514
- Callback
onFinishContentPipifenterPipfails I04b77 - Fixed an issue where
CallsManager#addCallcould delayCallControlScopeentry by up to 2 seconds while waiting for starting audio endpoint resolution and Bluetooth stabilization. Ia1e89 - Fixed a race condition where invoking
CallsManager#addCallorCallsManager#addCallWithExtensionswhile another call setup is in progress could lead to deadlocks or silent failures in the OSTransactionManager. Overlapping call setups are now immediately rejected withCallException(ERROR_CALL_NOT_PERMITTED_AT_PRESENT_TIME). If0ac8 - Fix video calls route to earpiece instead of speaker bug when using the backwards compat path on sdk=34+ I9f2bd
- Fixed an issue where incoming audio-only
VoIPcalls were incorrectly treated as video calls by the platform, causing them to route to the speakerphone instead of the earpiece I95902 - Catch exception in
setPictureInPictureParamsIbfeb2 - Fixed a bug in Core-Telecom where an intentional user switch to speakerphone during call initialization would be incorrectly reverted to the earpiece. I9e251
- Fixed an issue where redundant audio state updates in core-telecom could lead to main thread congestion and potential ANRs. Ibd794
- Fix NPE in
BlueoothProfileListener#onServiceConnectedIdbd57
External Contribution
- Added
ObjectsCompat.requireNonNullElseandObjectsCompat.requireNonNullElseGet, backportingjava.util.ObjectsAPI 30 methods down tominSdk23. I6e564
- Ensure Exif IFD tags are written in ascending order by tag ID.
- Make the date formatters inside
ExifInterfacethread-safe. - Stop adding an incorrect
NULterminator to Exif tags of typeUNDEFINED.
API Changes
- Added
GlanceAdaptiveWidgetManager.setConfigurationResultto glance-adaptive-appwidget. Id3751 - Added
GlanceAdaptiveWidgetManagerto glance-adaptive as an entry point for managing Glance Adaptive widgets. I9d4f2 - Added
GlanceSurface,AppWidgetSurface,WidgetInstanceInfo, andGlanceAdaptiveTemplateinterface to glance-adaptive. I8c3e1
Additional changes
- Updated the default squircle widget preview container specs I4bef6:
- Height updated to 64dp (small) and 124dp (large)
- Corner Radius updated to 32dp
- Safe inner padding updated to 10dp
- Added Lint check to ensure Wear widget configuration activities include the required
PROVIDER_CONFIGcategory in their<intent-filter>. Id30a6
API Changes
- Add Ink
InProgressShapesViewmethod overloads for unfinished strokes from a specific device I9c945 - Support multiple input devices simultaneously in Ink authoring module I41ee5
- Add linux-aarch64 JVM support I752e5 I1216b
Bug Fixes
- Clamp stroke shape durations to be non-negative and monotonic I752e5 b/552666754
- Change
CanvasInProgressStrokesRenderHelperV33requested frame rate to 720F. I752e5 - Update
ink-authoringandink-authoring-composedependency oninput-motionpredictionIb84ef
API Changes
- Added
createSharedSandboxAsync,createDedicatedSandboxAsync, andisSharedmethods toJavaScriptSandbox. These APIs allow apps and libraries to create multiple concurrentJavaScriptSandboxes, using either a shared process for resource conservation or a dedicated process for increased stability and security. I3fc6a
API Changes
- Remove deprecated Orbiter APIs, use the Orbiter API accepting an
OrbiterPositioninstead. Ib5043
Bug Fixes
- Restore original scale when
SubspaceModifier.scaleis removed I55b74 - Reset a composable with the movable and anchorable modifiers when updating or removing the modifier Iaee5b
- Fixed a bug where scale modifier was not being applied properly to a
SpatialModelI130b2 - Fixed an issue where the system movable was not being reset when updated or removed. I2cb89
- Restore original alpha when
SubspaceModifier.alphais removed Id4902 - Update resizable
minimumSizedefault to a 150.dp width/height, as it could be difficult to re-enlarge panels if they apparoach a zero size (old default). I183a6 - Fixes resizable behavior when
maintainAspectRatio = true, and aminimumSizeand/ormaximumSizeare set. The resizable will now hit its size cap once a min/max on either axis has been hit, rather than breaking aspect ratio to hit the min/max of both axis. I89793 - Add constraints to clamp
SpatialPaneland other panel-like Composables to a safe rendering size. The default max size for the resizable modifier is updated to this size. This max is dynamically calculated, but is substantially larger than the recommended content box size. Larger resizable sizes can still be explicitly specified for layout groups andSpatialExternalSurfacebut clamping will still apply for anySpatialPanelchildren they may have. If408a - Fixed an issue where
isSystemMoveOngoingremainedtruewhen aMovableComponentwas disabled mid-drag, preventing subsequent layout pose updates. ResetisSystemMoveOngoing,previousPose, andpreviousScaleindisableComponent(). I090f25
New Features
- Added support for resizable geometry interactions to
GltfEntityandMeshEntitycomponents. Id57fa - Added support for dynamically updating the looping state of
GltfAnimationduring playback. Ib0dd7
API Changes
- Added
PointSourceParams.Builderwith directivity, spread angle, andDistanceAttenuationmodels for 3D spatial audio point sources. Ib3737 - The
GltfAnimation.setLoop()API is no longer marked as experimental as it can now toggle the looping behavior while the animation is playing. I6da98 I67be6
Bug Fixes
ResizableComponentcan now be attached to aGltfModelEntityto let the user scale the model. I5c3e4AnchorSpacenow transitions toAnchorSpace.State.ERRORwhen anchor token export or binding fails. I91169- Synchronized
PanelEntityresizing by using transaction callbacks to eliminate visual flickering during scaling. I8f803 - Fixed corner radius clamping issue when resizing quad
SurfaceEntityshapes by ensuring values remain within bounds. I74283
Bug Fixes
- The
currentStateFlowproperty ofLifecycleRegistrynow returns the same instance with each invocation, rather than creating a new instance each time. I1ae01 b/579057749
API Changes
- Migrate
LocalLifecycleOwnerto usecompositionLocalWithHostDefaultOfandLifecycleOwnerHostDefaultKeydetaching it from being directly retrieved as part of the view tree outside of Android. I7c265
Bug Fixes
- From Lifecycle 2.11.1: The
currentStateFlowproperty ofLifecycleRegistrynow returns the same instance with each invocation, rather than creating a new instance each time. I1ae01 b/579057749
API Changes
- Renamed
OrbiterAlignmenttoOrbiterPositionand added support for configuring independent horizontal and vertical edge alignments on Orbiter corner alignment subclasses. DeprecatedOrbiterEdgeOffsetTypein favor ofEdgeAlignment. Ib2fbc - Prefix Material XR components with
SpatialI0e645 - Remove
EnableXrComponentOverridesI09652 - Remove Component Override APIs for
NavigationSuiteScaffoldIe6340 - Remove Component Override APIs for
ThreePaneScaffoldI9ceb5 - Remove
AnimatedSpatialVisibilityand associated usages I1dffa - Deprecated
FloatingToolbarScrollBehavior.floatingScrollBehaviorextension function in favor ofval floatingScrollBehaviorModifier: Modifierproperty. Ifbbec - Update Material to use new Orbiter API and
OrbiterEdgeOffsetTypeAPI Ifa085 - Remove
ComponentOverrideAPIs I3784b - Introduced a new Orbiter API variant using
SpatialAlignment,DpVolumeOffset, andOrbiterOffsetTypefor true 3D spatial placement using continuous layout biases. The previousOrbiterAnchorPoint-based variant has been deprecated Ibdcb5 - Make Animation/Transition Apis experimental I07d98
- Update resizable modifier to use a
ResizePolicyinstead of two modifiers I7fb0f - Added movable overload with
movePolicyparam and deprecatetransformingMovableandmovableIc88c1 - Deprecated
ResizePolicyand the old resizable modifier, replacing it with a newSubspaceModifier.resizableoverload andSubspaceModifier.transformingResizable. I9e4bc
Bug Fixes
Important changes since 1.8.0:
New Features and API Changes
- Minimum SDK Bump: The default minimum SDK requirement is now 24.
- Device Suggestions: Introduced the
setDeviceSuggestionsAPI, allowing you to provide device suggestions for dynamic routes. - Media Transfer Status: Introduced the
isMediaTransferEnabledmethod inMediaRouterto allow checking the media transfer status programmatically. - Routing Controller API: Added an API to fetch the routing controller ID directly from a selected route.
- Selection Triggers: Added an
onSelectedRouteoverload that explicitly indicates the selection trigger. - Simplified Media Transfer: Enabling media transfer no longer requires a dedicated manifest tag.
Bug Fixes and Improvements
- UI Polish: Converted
MediaRouteExpandCollapseButtonand various other UI assets to use vector drawables instead of PNGs for better scaling and performance. - Accessibility: Added the
buttonaccessibility role to items inMediaRouteChooserDialogso screen readers properly announce route entries as buttons. - Security & Crash Prevention: Fixed a potential crash (
NullPointerExceptionandClassCastException) caused by receiving malformed parcels inMediaRouteDescriptor. - Screen-off Scanning: Prevented third-party apps from inappropriately requesting screen-off scanning via
MediaRouteDiscoveryRequest. - Routing Reliability: Fixed several bugs that could cause incorrect route selection or inconsistent default route states when providers change or media transfer is toggled.
Bug Fixes
- Fix shared
NavEntrynot rendering on the incoming scene when a navigation interrupts a pop. I6a482 b/573660083
New Features
Dynamic feature modules, a.k.a. Play Feature Delivery, is now integrated to Navigation 3 via androidx.navigation3:navigation3-dynamic-features library.
DynamicFeatureNavEntryDecoratortakes in aSplitInstallManagerto install a dynamic feature module upon first navigation to the module. To use, callrememberDynamicFeatureNavEntryDecoratorand pass into theNavDisplay. Then pass inDynamicFeatureNavEntryDecorator.entryProvideras theentryProvider, and invokedynamicFeatureModule()inside the provider to register the module.Idfc15 b/520494172val dynamicFeatureDecorator = rememberDynamicFeatureNavEntryDecorator<NavKey>( splitInstallManager = rememberSplitInstallManager(), defaultLoadingContent = { LoadingIndicator() } ) NavDisplay( ... entryDecorators = listOf( rememberSaveableStateHolderNavEntryDecorator(), dynamicFeatureDecorator, ), entryProvider = dynamicFeatureDecorator.entryProvider { entry<HomeKey> { ... } dynamicFeatureModule( initialKey = PremiumKey, moduleName = "premium", entryProviderClassName = "com.example.premium.PremiumModuleEntryProvider", loadingContent = { state -> when (state.status()) { SplitInstallSessionStatus.FAILED -> Text("Failure") SplitInstallSessionStatus.REQUIRES_USER_CONFIRMATION -> { // Call SplitInstallManager::startConfirmationDialogForResult } else -> Text("Loading premium feature...") } }, ) }, )DynamicFeatureModuleEntryProviderprovidesNavEntriesof the dynamic feature module after the module has been installed. In the module, extend theDynamicFeatureModuleEntryProviderclass to create anEntryProviderthat will be resolved at runtime via Java reflect. The provider can be registered withNavDisplayby passing its fully qualified name into thedynamicFeatureModuleinvocation.Idfc15 b/520494172// Defined in the `:premium` dynamic feature module. // Resolved in the `:main` app module by reflection in runtime when // the installation of the dynamic feature module is completed. class PremiumModuleEntryProvider : DynamicFeatureModuleEntryProvider<NavKey> { override fun EntryProviderScope<NavKey>.buildEntries() { entry<PremiumKey> { Text("PremiumScreen") } entry<PremiumSubKey> { Text("SubScreen") } } }The initial
NavKeythat is used for navigating to the module can be defined in the main module or a common module.NavKeysfor additional sub-screens inside the dynamic feature module can be defined within the module. Idfc15 b/520494172// Initial nav key for the `:premium` dynamic feature module. // Defined in the `:main` app module, but can also be accessed from // the dynamic feature module. @Serializable data object PremiumKey : NavKey // An internal sub nav key for the `:premium` dynamic feature module. // Defined in the `:premium` app module, cannot be accessed by other modules. @Serializable internal data object PremiumSubKey : NavKey
API Changes
- Made
EntryProviderScopeopen andEntryProviderScope.build()public to allow extending the entry provider DSL scope. I6a66d b/520494172 - Added
SharedTransitionScope.DeferredTransitionBehavior(FollowContainer,Static,SeekToTarget),SharedContentConfig.deferredTransitionBehavior, andMutableContentTransform.sharedElementProgressto support seeking shared elements toward their target bounds during the deferred phase of aDeferredTransition. DeprecatedpermitTransformDuringDeferredTransition. I2fac2 - Removed the
watchosArm32target, which Kotlin 2.5 no longer supports. Ic048d
Bug Fixes
- Fixed
ConcurrentModificationExceptionfrom callingNavBackStack.toList()on a background thread while mutating the back stack on the Main thread.NavBackStacknow has a customtoList()that delegates to the internalSnapshotStateList'sthread-safetoList(). Id9bb7 b/576097101
API Changes
- Added
ItemSnapshotListextensions for Lazy foundations. You can now callItemSnapshotList#itemKeyandItemSnapshotList#itemContentTypeto auto generateitemKeyandcontentTypefor Lazy foundation. I73455 b/560754841
External Contribution
- Thank you Kamal for adding the
ItemSnapshotListextensions.
New Features
- Enabled Kotlin Multiplatform (
jvmAndAndroidMain) support in:compose:remote:remote-creation-compose, decoupling core creation APIs from Android and Compose UI types so remote documents can be authored and tested on JVM targets as well as Android.
API Changes
- Promoted
RemoteContentScale,RemoteTextOverflow,RemoteCompositingStrategy,RemotePathFillType,RemotePaintingStyle,RemoteStrokeCap,RemoteStrokeJoin,RemoteBlendMode,RemoteLayoutDirection,RemoteFontVariation.Settings, and Remote text styling types to public API, and decoupledRemotePaint,RemoteShape,RemoteStateScope,RemoteTextStyle,RemoteCreationDisplayInfo,RemoteImageVector.Builder,RemotePainter,RemoteRenderEffect,RemoteBlurEffect, andRemoteFontFamilyfrom Compose UI and Android types. - Decoupled
RemoteImageBitmapfrom Compose UIImageBitmap. I1dfb9 - Decoupled
RemoteTextUnitfrom Compose UITextUnit. Id9ba1 - Extracted core remote state AST expressions into
:compose:remote:remote-creation-expression. I41115 - Extracted Compose Runtime composables and Android formatters from
RemoteState, removed deprecatedrememberMutableRemote*composables, and exposedRemoteEnum.enumEntries. I76417 - Exposed
RemoteDrawScopedrawing (drawImage,drawText), transformation (rotate,translate,scale,withTransform,RemoteDrawTransform), and clipping (clipRect,clipOutline,RemoteDrawTransform.clipOutline) APIs. I2c823 - Replaced
RemoteTextMeasurer.measureandRemoteTextLayoutResultwithmeasureSingleLine(RemoteSingleLineTextBounds),measureFontMetrics(RemoteFontMetrics),measurePaintBounds(RemotePaintBounds), andmeasureMonospaceWidth. I9022f - Replaced public
RemoteStateandMutableRemoteStateconstructors andCompanion.invokefactories with top-level factory functions (RemoteFloat,MutableRemoteFloat,RemoteInt,MutableRemoteInt,RemoteLong,MutableRemoteLong,RemoteBoolean,MutableRemoteBoolean,RemoteString,MutableRemoteString,RemoteColor,RemoteDp,RemoteTextUnit,RemoteEnum,MutableRemoteEnum, andRemoteImageBitmap). Iff2f6 - Added public
RemoteState.Domain(namespace: String?)constructor,RemoteState.Domain.None, andDomain.prefixed(name: String)to support custom and unprefixed named-state namespaces alongsideRemoteState.Domain.UserandRemoteState.Domain.System. Ibef77 - Exposed
positionInParentandpositionInRoot(RemoteOffset) onRemoteComponent, and movedRemoteOffsetto:compose:remote:remote-creation-expression. I67998 - Promoted
RemoteTileModeand linear gradient shaders to public API. I1464b - Promoted
RemoteRoleto public API and updatedRemoteModifier.clickableandRemoteSemanticsPropertyReceiver.roleto useRemoteRoleinstead ofandroidx.compose.ui.semantics.Role. Iace42 - Added
RemoteFontVariation.weight,width,slant,opticalSizing, andgradefactory functions. Ib8198 - Added
RemoteAction.Nonefor representing a no-opRemoteAction. I18ce6 - Added
RemoteComponentin:compose:remote:remote-creation-expressionalong with@Composable remoteComponent()andRemoteStateScope.remoteComponent()in:compose:remote:remote-creation-composefor dynamic component measurements, and replacedRemoteFloatContextlambda overloads (createNamedRemoteFloatExpression,MutableRemoteFloat, andrememberNamedRemoteFloat) withRemoteFloat-accepting overloads. Icb1c5 - Marked
remote-creation-composecomposables and remote slot lambdas with@RemoteComposable, added@Immutableand@Stableannotations to remote value, shape, alignment, arrangement, and style types, and added@RemoteLayoutScopeMarkertoRemoteRowScopeandRemoteColumnScope. I2d4f0 - Restricted internal writer and core declarations (
RemotePath,RemoteDocument,RemoteWriterEvents.storePendingIntent) from the public Remote Compose API surface and exposedExperimentalRemoteCreationComposeApipublicly. I459cb - Renamed public types in
remote-creation-compose(RemoteCapturedDocument,RemoteWriterEvents,RemoteGraphicsLayerScope,RemoteRenderEffect,RemoteBlurEffect,RemoteSemanticsProperties,RemoteSemanticsPropertyKey,RemoteSemanticsPropertyReceiver) to include theRemoteprefix. Ia2573 - Renamed
pendingIntentActiontorememberPendingIntentAction(with dynamic String extras), the@ComposablecreateCreationDisplayInfooverload torememberRemoteCreationDisplayInfo,RemoteEasing.Cubic/Splinetocubic/spline,valueChangetovalueChangeAction,createProfiletoProfile,RemoteColortweentolerp, and theactionparameter ofRemoteModifier.clickabletoonClick; addedhostAction(id, metadata)and theRemoteBooleanoverload ofhostAction. I16acd
Bug Fixes
- Long press, double click and touch cancel handlers now receive coordinates adjusted for preceding padding modifiers, matching click and touch down/up/drag. I1fe01
API Changes
- Support
@DaoReturnTypeConverterson individual DAO functions and@Querygetter properties. Ieff22 b/578894940 - Removed the
watchosArm32target, which Kotlin 2.5 no longer supports. Ic048d
Bug Fixes
- Fixed an issue where collection query parameters with a custom
@ColumnTypeConverterwere expanded into multiple parameters instead of converted as a single value insideCOALESCEexpressions. I58968 @Dao-scoped@DaoReturnTypeConvertersnow take priority over@Database-scoped converters. I30cb9 b/578894940- Fixed an issue in KSP where non-constant annotation arguments (such as
@ColumnInfo.defaultValue) were silently ignored, which exported incomplete schemas and caused misleading auto-migration errors. I50746 b/558464759 - Fixed an issue where using Kotlin value classes with
@MapColumnin multimap queries could emit falseequals()/hashCode()warnings or fail to map the specified column. I91d6b b/535696696 - Support an optional
Map<String, Any?>parameter in read@DaoReturnTypeConverterfunctions to access DAO query arguments. I05586 b/492164283
API Changes
- Migrate
LocalSavedStateRegistryOwnerto usecompositionLocalWithHostDefaultOfandSavedStateRegistryOwnerHostDefaultKeydetaching it from being directly retrieved as part of the view tree outside of Android. I6768f
Changes
- Removed the
watchosArm32target, which Kotlin 2.5 no longer supports. Ic048d
Bug Fixes
Perfettochanged the underlying protos being used from theCallStacktype toInlineCallStack. For more information refer to the changelog. I22453Add support for toggling categories when enabling in-process tracing from benchmarks for a target process.
PerfettoTraceRulenow supports enabling optional categories for in-process tracing. These categories are used by theTraceDriverinstance in the target process. I663ed b/565040771
Bug Fixes
- Fixed an issue where
Modifier.oneHandedGesturecalledonGestureAvailableagain whenever the caller recomposed, resulting in repeated gesture indicator hints. The indicator hint is now only shown on the initial composition. I0b514
API Changes
- Added
DurationPicker, a new component for Wear Compose Material 3 which allows users to select a duration (as opposed to the existingTimePickerwhich should be used only to select a time). Also added aPickerGroupScope.PickerGroupItemoverload with agradientColorparameter.TimePickerType.MinutesSecondshas been deprecated, andDurationPickershould be used withDurationPickerType.MinutesSecondsinstead. I4bc8c - Renamed
Modifier.curveToEdgetoModifier.drawCurvedToEdgeand addedDrawCurvedToEdgeDefaultsfor recommended sweep angles. Ic2e07 - Added
AlertDialogDefaults.EdgeButtonandAlertDialogDefaults.ConfirmButtonoverloads with a newgestureVisibilityThresholdparameter, used to configure how much of the button must be visible before the associated one-handed gesture is enabled. SettinggestureVisibilityThresholdto zero turns the gesture off on that button. I39d87 - Rotary and fling snapping of
TransformingLazyColumnnow step through tall items in several snaps instead of skipping to their center in a single snap. By default, an item taller than the band around the center of a round screen in which it is fully visible is split into equal segments, each with its own snap point. The newModifier.snapSegmentThresholdinTransformingLazyColumnItemScopecustomizes how an item is split, or keeps it whole if the threshold >=measuredHeight. With a snap offset, a slow release now snaps the item nearest to the snap line rather than to the center, and a fling faster than 400dp/s always moves on to the next snap point in its direction. Rotary input before a snap scrolls the list linearly, and turning against a running snap cancels it. Ic5e66 - Added a
scrollFractionparameter toOneHandedGestureDefaults.scrollDown()to configure how far each gesture scrolls as a fraction of the viewport height. I2973d
Bug Fixes
compileSdkfor Compose UI and all Compose libraries that build against it (including Wear Compose libraries) have been updated to 37.2. This will require transitively updatingcompileSdkfor all apps and libraries using them. I2859d- Custom accessibility actions added via
Modifier.semanticsonSplitCheckboxButton,SplitSwitchButton, andSplitRadioButton(for example when used withSwipeToReveal) are now propagated to the focusable primary clickable container Row, so thatTalkBackannounces available actions. Ibfebe - Fixed a crash in
ButtonGroupwhenexpansionWidthexceeds a neighbor's width, or when either spacing or content padding exceeds the group's available width. Id3bdf - Wear Compose Material 3 Dialog now supports predictive back gestures from API 36 onwards, providing haptic feedback at the dismiss threshold and matching Navigation 3 exit transitions. Id4c7c
- Fixed a memory leak where the last revealed
SwipeToRevealitem kept its removed screen in memory. Ied8b5 - Fixed an issue where
ButtonGroupScopemodifiers (weight,minWidth,animateWidth) never compared equal, causing unnecessary node updates and remeasurement on recomposition. I5e95d - Fixed an issue where
Modifier.oneHandedGesturecalledonGestureAvailableagain whenever the caller recomposed, resulting in repeated gesture indicator hints. The indicator hint is now only shown on the initial composition. I0b514 - Ensure
onSwipePrimaryActionis triggered on full swipe inSwipeToRevealIa01ba - Fixed an issue where circular screen paddings, transformation specs, and component dimensions in Wear Compose Material 3 shrunk when the Wear OS Global Status Bar reduced
Configuration.screenHeightDp. Wear Compose Material3 now uses thescreenWidthDp(rather thanscreenHeightDp) as the screen size, which does not shrink. I34567 - Improved
AlertDialogperformance by avoiding double composition when content fits on the screen. Note thatAlertDialogslots (icon,title, andtext) are now measured with unbounded maximum height when content fits on the screen (matching the scrollable case), soModifier.fillMaxSize()andModifier.fillMaxHeight()applied inside those slots will no longer expand vertically. I8963d - Fixed a one-frame flash of the system status bar when
AppScaffoldenters composition. Ic0e83 - Fixed an
IllegalStateExceptioncrash inSwipeToRevealwhen subcomposed inside aLookaheadScope(such as inside aTransformingLazyColumn). I12b5b
API Changes
- Exposed
RemoteIconToggleButton,RemoteIconToggleButtonDefaults,RemoteIconToggleButtonColors,RemoteIconToggleButtonShapes,RemoteTextToggleButton,RemoteTextToggleButtonDefaults,RemoteTextToggleButtonColors, andRemoteTextToggleButtonShapesas public APIs in Wear Material 3 Remote Compose. Ib93ab - Replaced the
shapeparameter onRemoteIconButtonandRemoteTextButtonwithshapes(RemoteIconButtonShapesandRemoteTextButtonShapes) and addedanimatedShapes()defaults to animate button corners on press, matching Wear Compose Material3. I6fa6b - Added a
backgroundColorparameter toRemoteTimeText, defaulting toRemoteTimeTextDefaults.backgroundColor, which draws an arc behind the text like Wear Compose Material 3TimeText. I165f1 - Added
@IntRange(from = 0)toRemotePageIndicatorState.pageCountandrememberRemotePageIndicatorState. I420f2 - Added
RemoteTextButtonDefaults.filledTonalTextButtonColors()for filled tonal text buttons. Ie43cd - Add press width animation support (
expansionWidthandRemoteButtonGroupScope.animateWidth()) toRemoteButtonGroupin Wear Remote Compose Material 3. Ie2909 - Updated
RemoteShapeoverrides to useRemoteLayoutDirection.
Bug Fixes
- Fixed
RemoteCircularProgressIndicatorso full-circle indicators (startAngle == endAngle) close the gap seamlessly atprogress = 1f, and sub-gap indicator and track sweeps scale smoothly down to0without leaving stray round endcap dots atprogress = 0for1f. I8158e - Fixed
RemoteIconButtonoverriding custom size modifiers. Ibf940 - Coerce negative
sweepAngleandstrokeWidthvalues to0in Remote Compose progress indicators and document clockwise arc direction. I1243b
API Changes
- Added experimental
configureIsolatedSitesandcanConfigureIsolatedSitesmethods onProfile, which can be used to separate more trusted or first-party sites into a separate renderer process from the default renderer used for all other sites. This can be used to establish an additional security boundary. I3ba24
Bug Fixes
- Prioritized active and most recent
VirtualDeviceobjects inProjectedContext.getProjectedDeviceId()to prevent selecting stale device entries. I6ca071 - Caught
IllegalArgumentExceptioninProjectedContext.createProjectedDeviceContext()and wrapped it in anIllegalStateExceptionto better handle scenarios where the projected device is no longer valid. I4e451b