New Features
- Added support for Sectioned Item Template, allowing for more complex list and grid layouts.
- Enhanced Media Playback support.
- Added support for
IMAGE_TYPE_MEDIUMinRowImageType. - Added Intent Action
ACTION_MEDIA_SHOW_PLAYBACK_VIEWto launch media playback screens.
API Changes
- Added support for
IMAGE_TYPE_MEDIUMinRowImageTypeI76108 - Add Intent Action
ACTION_MEDIA_SHOW_PLAYBACK_VIEW. When this action is sent to an Activity that supports it, it indicates that the application should launch its playback screen, or a relevant screen otherwise If29db b/455949944
Bug Fixes
- Change default behavior of upcoming
SectionedItemTemplateto save scroll state across template refreshes and back actions I6c9cc b/461256656
Important changes since 1.10.0:
androidx.compose.animation:animation-*:1.11.0is released. This stable release consolidates improvements and fixes from the 1.11.0 development cycle, focusing on shared element stability, threading reliability, and new developer tooling.
New Features
- Visual Debugging for Lookahead: Introduced a new set of visual debugging capabilities that allows visualizations of information related to shared elements and
Modifier.animatedBounds. Such information includes: target bounds, the trajectory of the bounds animation, number of matches found, whether the transition is active, etc.
API Changes
- Added new APIs
LookaheadAnimationVisualDebugging,CustomizedLookaheadAnimationVisualDebugging, andLookaheadAnimationVisualDebugConfigto help debug animated bounds and shared element animations. Id5575 b/390011686 b/466169919
Bug Fixes
- Thread Safety:
SeekableTransitionStatenow properly handles off-thread state changes. Previously, if the state was modified off the UI thread usingSnapshot.withMutableSnapshot(), the transition incorrectly tried to handle the update off of the UI thread. 0aba38 - Performance: Improved performance of
sharedElementsmap access. 93f57d - State Reporting: Fixed
isTransitionActiveso that it only reports true when there are active animations from matched shared elements. d3426a b/474385510 - Stability: Required shared transition root to be placed before querying bounds 77d59c and ensured positions for
sharedElementsare only acquired ifSharedTransitionLayoutis attached. I2a035 - Interruption Handling: Fixed the corner case interruption handling when a child exit animation finishes while the parent transition is still running in
AnimatedContent. ad9b4f - Validation: Validated duration in
InfiniteRepeatableSpecto prevent 0-duration cycles. 151b6d - Customization: Respect
visibilityThresholdin customAnimationSpecforanimateFloatAsState. 3a1cdc
Bug Fixes
- Updated Compose
compileSdkto API 37. This means that a minimum AGP version of 9.2.0 is required when using Compose. Id45cd b/413674743 - End the
SeekableTransitionStateanimation before composition 1bf9dc b/410055849
API Changes
- A new flag
isBasicTextFieldHeighInLinesOptimizationEnabledwas added to enable optimisation in calculating text field's height in the number of min/max lines. If should be on by default. If you find any regressions in the text field layout and disabling this flag fixes it, please file a bug to Compose team to investigate. Idffae b/486871837 b/487546327 - Fix
textfieldselection while editing text during gesture. I6fd98 b/490509264 - Added
colorFiltersupport toStyleScopein Compose Foundation. I553a0 - Added
textMotiontoStyleScope. Id8523 b/482301609 - Adds additional
KeyboardTypeoptions to complete the set of supported keyboard options on Android, including date, time, datetime, signed decimal, and more. I3713e b/202353328 - Remove flag
isNestedDraggablesTouchConflictFixEnabledI79e52 b/485966180 - Remove flag
isDelayPressesUsingGestureConsumptionEnabledI533dd b/485966702 - Remove flag
isBringIntoViewRltBouncyBehaviorInPagerFixEnabledas it's been released in a stable version. I73fb2 b/485967682 - Remove flag
isCacheWindowRefillFixEnabledas it's been released in a stable version. Ic7505 b/485967875 - Removes
ComposeFoundationFlags#isNonSuspendingPointerInputInCombinedClickableEnabledI1f76c b/485966320 b/477836055 - Added overloads for
contentPaddingandexternalPaddinginStyleScopethat acceptPaddingValues. I3a6ce b/493154098 - Changed the
VelocityTrackerto use the implementation provided by the Android Framework (configurable withAndroidComposeUiFlags.isFrameworkVelocityTrackerEnabled). Ibc7e2 b/359962905
Bug Fixes
- Changed how animations and properties are tracked to avoid overlapping animations for the same property. I4921f
- Fixed the bug that context menu will crash when the
TextField(or selectable text) is in a Dialog. I21461 b/441759435 - Updated Compose
compileSdkto API 37. This means that a minimum AGP version of 9.2.0 is required when using Compose. Id45cd b/413674743 - Fixed an issue in Grid where keyboard focus and accessibility traversal followed the item composition order rather than the visual Z-shaped placement order. I122a8 b/494096503
- Fixed a bug where the text selection toolbar would incorrectly hide when the start and end handles aligned horizontally (e.g. selecting across multiple lines ending on an empty line). I391d2 b/497724722
- Fixed an issue in
FlexBoxwhere items would not shrink correctly when exceeding the container bounds. Ia741d b/480797591 - Bugfix for
foregroundColornot being correctly invalidated. I74abe b/493245886 - Fixes stale insets for the case where the inset listener for Compose is detached and reattached. I1e905 b/491346046 b/486084139
- When a user moves the cursor outside the scrollable area, the cursor is now scrolled into the visible space. If694c b/266094055
API Changes
- Changed the
VelocityTrackerto use the implementation provided by the Android Framework (configurable withAndroidComposeUiFlags.isFrameworkVelocityTrackerEnabled). Ibc7e2 b/359962905
Bug Fixes
- Updated Compose
compileSdkto API 37. This means that a minimum AGP version of 9.2.0 is required when using Compose. Id45cd b/413674743
New Features
- Add
FilterChip,ElevatedFilterChip, andInputChipoverloads with shape morphing. Add new shape, spacing, and color defaults for these overloads. I84717 b/442678355 - Adds inset focus ring support via an opt-in API, using the new
LocalRippleThemeConfigurationcomposition local. I0551a b/282184440.
API Changes
- Renamed
rememberWithGapSearchBarStatetorememberSearchBarWithGapState. I5f54b b/498697243 RippleThemeConfigurationandLocalRippleThemeConfigurationAPIs are graduated to stable, adding the ability to configure ripples to be drawn with an inset focus ring appearance, instead of the opacity-based focus indication. APIs using the material-ripple configuration APIs are deprecated. Ide5d0 b/485893129- Promote
WavyProgressIndicatorapis Id72a3 b/497877853 - Promote
materialExpressTheme,expressiveLightColorSchemeI40eab b/497876844 BottomSheetcomposable has been moved toBottomSheet.ktIf7e33 b/500091309- Add
Material3ExpressiveApiannotation that doesn't requireOptIn. Ib9f2e b/499994043 - Adds
DropdownMenuPopupPositionProviderstoDropdownMenuPopup, so developers can now configure the position of the menu is placed relative to the anchor. This allows for submenu support within Dropdown Menus. You can now create cascading submenus using new anchor-relative positionings. Pass these new positioning options intorememberDropdownMenuPopupPositionProviderto configure your menu. For a complete implementation, refer to the catalog menu sample. Ic1ace b/476161294
Bug Fixes
- Update material3 components to support inset focus ring indications I88006 b/498610244 b/467984300 b/498281359
- Resolved an issue in
TimePickersamples whereTalkBackfocus moved, allowing invalid time entry I51690 b/498364606
Important changes since 1.10.0:
New Experimental SlotTable
- We've rewritten the
SlotTable, which is the internal data structure used by the Compose Runtime to track your composition hierarchy, determine the changes caused by a recomposition, and store remembered values. This rewrite is focused on improving recomposition performance and does so primarily by using substantially fewer memory copy operations than the gap bufferSlotTable. Certain changes to your composition hierarchy, like reordering a long list of items, can recompose over twice as fast compared to the formerSlotTable. Most other operations are on the order of 10% faster to recompose under the newSlotTableimplementation. TheSlotTableimplementation used by the runtime affects all Composable methods and requires no recompilation. Using the newSlotTableis an app-wide change, including for dependencies. - This
SlotTableimplementation is still experimental and currently disabled by default. It can be enabled by settingComposeRuntimeFlags.isLinkBufferComposerEnabledtotrue. In release builds with minification enabled, this value is assumed to be false in the default proguard-rules.pro file supplied with the runtime. To enable the newSlotTablein production, this assumption needs to be changed to true in the application'sproguard-rules.profile. See the documentation onComposeRuntimeFlags.isLinkBufferComposerEnabledfor more information.
Host-default composition locals
- Added
compositionLocalWithHostDefaultOfwhich allows defining CompositionLocals that fallback to the hosting environment (e.g. AndroidViewtags) for their default values.
More efficient snapshotFlow observation with SnapshotFlowManager
- Introduced
SnapshotFlowManagerAPI for more efficient observations ofsnapshotFlow. Reusing the sameSnapshotFlowManagerfor multiplesnapshotFlowinstances registers fewer snapshot apply observers, processing state updates faster.
Bug Fixes
- Fixed an issue in the LinkTable that can cause invalid node operations. I491c3
- Updated Compose compileSdk to API 37. This means that a minimum AGP version of 9.2.0 is required when using Compose. Id45cd b/413674743
- Fixed a caching issue in the LinkTable where content insertions that trigger resizes could lead to stale values being read, which could cause CompositionLocals to not be resolved. I8016c
- Fixed a bug that was causing
T.writableRecordto throw unnecessaryIllegalStateExceptions Ia778f b/440975176
API Changes
- Removes feature flag
ComposeUiFlags.isIndirectPointerNavigationGestureDetectorEnabledI82be3 b/455601135 - Made
mediaQueryan inline function Ie9457 b/498698350 ComposeViewContexthas moved out of the experimental stage and theExperimentalComposeViewContextApiannotation was removed I32ecaComposeView.disableWindowInsetsRulers()is now not experimental Ia81a5- Added
hasPendingWork()API to allow passively checking if the Compose UI currently has pending work without triggering a wait or advancing the clock. This is useful for manual clock tests to determine when animations or other background work have finished. Ic54e3 - Removed the feature flag
AndroidComposeUiFlags.isForceChildLayoutAfterMeasurementEnabledI7fd25 b/491111451 - Removed feature flag
AndroidComposeUiFlags.isSharedFontEnabledI2cebe b/479898293 - Adds additional
KeyboardTypeoptions to complete the set of supported keyboard options on Android, including date, time, datetime, signed decimal, and more. I3713e b/202353328 - Removed the
AndroidComposeUiFlags.isSharedHapticsEnabledflag I6a1d4 b/479895628 - Removed the
AndroidComposeUiFlags.isSharedClipboardManagerEnabledflag I41e3c b/479895130 - Removed
AndroidComposeUiFlags.isSharedViewConfigurationEnabledflag I6d3aa b/479890645 - Removed the feature flag
AndroidComposeUiFlags.isSharedDrawingEnabled. I27912 b/479849019 - Removed the feature flag
AndroidComposeUiFlags.isSharedAccessibilityManagerEnabledI6b726 b/479845566 - Remove
AndroidComposeUiFlags.isSharedWindowInfoEnabledflag Ife9a9 b/479837249 - Remove the
AndroidComposeUiFlags.isSharedComposeViewContextEnabledflag. Ic522a b/479834257 - Add variation settings to customize downloadable variable fonts Ifdc93 b/223262013
- Add variation settings to customize downloadable variable fonts I390af b/223262013
- Remove flag
isTraversableDelegatesFixEnabledIa7dfe b/485962494 - Introduced
runWhenIdleand its suspending variantawaitAndRunWhenIdleonComposeTestRuleandComposeUiTestto improve test performance and state stability. These APIs synchronize the UI once, then execute a block of code without the overhead of repeated synchronizations for each operation. This results in significantly faster and less flaky test execution, especially for tests that sample many properties, such as in animation testing. Iabf66 b/490270394 - Adds
LayerOutsetstoGraphicsLayer&Modifier.graphicsLayerwhich can be used to increase the visual bounds of the layer beyond its measured size. This can be used to avoid the implicitclipToBoundsbehavior when the layer is promoted to an Offscreen buffer. Ic1189 - Disabled logging autofill input events by default. They are now enabled by calling
ComposeView.setAutofillDebugEnabled. I5b430 b/487947860 - Changed the VelocityTracker to use the implementation provided by the Android Framework (configurable with
AndroidComposeUiFlags.isFrameworkVelocityTrackerEnabled). Ibc7e2 b/359962905 - When
AndroidComposeUiFlags.isForceChildLayoutAfterMeasurementEnabledis true, child Views will always have layout called after measurement during a layout pass. Compose doesn't always layout a child after measurement, but Views require it for proper state management. Ib4fe9 b/430974758 - Adding
isVirtualtoLayoutInfoI3e5cd b/494243978 - Cleaned up the
isGraphicsLayerShapeSemanticsEnabledflag. I44be0 b/455600081 - Added a new Font API to use downloadable without a manual step of adding font certificates to the codebase. I30b86 b/479454159
- Added
onRootWithViewInteractionto scope Compose semantic searches to specific Android Views . This simplifies testing hybrid UIs, such asRecyclerViews, without requiring unique test tags in production code . Ic02c4 b/175226753
Bug Fixes
- The
captureToImage()API now allows you to capture a popup or dialog together with its anchor in a single bitmap. I9b83a b/443137545 - Updated Compose
compileSdkto API 37. This means that a minimum AGP version of 9.2.0 is required when using Compose. Id45cd b/413674743 - Setting
ContentDataType.Nonein semantics now prevents autofill events from being sent by Compose. This should prevent initialization costs associated with requesting autofill services. I8fbda b/487947860
Bug Fixes
- Fixed an issue on Android 14-16 where audio calls might unexpectedly route to speaker on the call start Ic7000 b/491932378
- Fixed a crash (
IllegalStateException) incore-telecomthat could occur if the Telecom framework or a remote service dispatched connection events multiple times during extension setup. I00f82 b/476724351 - Telecom will now use a fallback heuristic to identify wearable devices for audio routing decisions when the
BLUETOOTH_CONNECTpermission is denied. Iec271 b/499302063
API Changes
- Support large credential payloads for
getCredentialAPI
New Features
- Added support for Origin Private File System (OPFS) in DataStore for web platforms. This implementation introduces
WebOpfsStorageand includes architectural support for asynchronous file I/O, cross-tab notifications using theBroadcastChannelAPI, and distributed locking via the nativeWeb Locks APIfor exclusive write access. Id7f5807 b/316376114
API Changes
- Introduced
WebLocalStorageandWebSessionStorageAPIs for explicit storage type management in Web environments. I35fa259b b/316376114
Bug Fixes
- Added
<queries>tag to the manifest ofglance:wear:wearlibrary to make sure thePackageManagerqueries the correct services for push updates. I192787
Other
- Reverted "Updates Compose compileSdk to 37" I6007 which also applies to glance-wear, so the compileSdk requirement is no longer 37 in this release.
API Changes
glimmer-google-fontsis released - add this dependency and usecreateGoogleSansFlexTypographyto create aTypographyinstance with the recommended Google Sans Flex configuration. ThisTypographyinstance can be provided as normal throughGlimmerTheme. Iec9e4 b/458447191
API Changes
- Matchmaking APIs: Introduced new methods to help users discover and connect compatible data sources that can provide the health data your app needs.
checkIfMatchmakingIsPossible: A suspend function to verify if there are any matching applications or devices available to show before launching the flow.createMatchmakingIntent: Generates an Intent to launch a flow where users can discover and grant write permissions to apps and devices capable of providing the health record types your app reads.
API Changes
- Simplify the
rememberHiltViewModelFactoryAPI by removing theViewModelStoreOwnerparameter. Use thedelegateFactory parameterto provide custom factory logic when necessary. I3611a - Introduce
rememberHiltViewModelFactory()to allow manual creation of Hilt-injected ViewModels. This is particularly useful when providing a default factory to therememberViewModelStoreOwnerAPI. If7517
Bug Fixes
- Updated Compose
compileSdkto API 37. This means that a minimum AGP version of 9.2.0 is required when using Compose. Id45cd b/413674743
API Changes
- Expose an overload of
BrushFamily.decodethat specifies max version compatibility I1c7bc - Graduate
BrushFamilyserialization API from experimental Idd16e
Bug Fixes
- Fix flicker when using
InProgressStrokesView.maskPathon certain devices I1c7bc b/496920044
API Changes
- Split
rememberViewModelStoreOwnerandrememberViewModelStoreProviderinto separate functions for with-key and without-key use cases. Ifd154 b/500802788
Bug Fixes
- Updated Compose
compileSdkto API 37. This means that a minimum AGP version of 9.2.0 is required when using Compose. Id45cd b/413674743
Bug Fixes
- Improved
NavHostto bolster against possibleNullPointerExceptions caused by a race condition with predictive back. Ie36c6 b/500945998
Bug Fixes
- Updated Compose
compileSdkto API 37. This means that a minimum AGP version of 9.2.0 is required when using Compose. Id45cd b/413674743
External Contribution
Bug Fixes
- Accessing
LocalNavAnimatedContentScopefrom anOverlayScenewill no longer cause anIllegalStateExceptionasOverlayScenesare now provided with a no-opLocalAnimatedContentScope. I2f00c b/486067688
API Changes
- Rename
onBacktoonBackCompletedand addonBackCancelledto NavigationBackHandler to support handling cancelled back gestures. I92741 - Add
NavigationBackHandlerto simplify handling back gestures and predictive back when usingSceneState. This allows developers to more easily create custom UI components that support standard back navigation and predictive gestures without manually calculating back stack deltas. I6a055 - Add
rememberNavigationEventStateto simplify connectingSceneStatewith predictive back handling. Iae49c
New Features
- Added a
ResultEventBusAPI to allow for passing results between NavEntries with theLocalResultEventBusprovided by the newResultEventBusNavEntryDecorator. Passed in results can be assessed as a state withResultEventBus#conflateAsStateor as a flow of results withResultEffect.
No changes
- There are no notable changes from version
3.5.0-beta01.
API Changes
- The PDF library's read and rendering features have been backported to support android devices down to
minSdk = 28andsdk-extension < 13extends compatibility to an additional 2 billion active Android devices I808f8 - Added SelectionBoundary-based
getSelectionBoundsAPI toPdfDocument. Ida6ea
Bug Fixes
- Handled
RemoteExceptioninternally inPageBitmapSource.close()I2c59e
API Changes
- Modifier clickable changed to not accept null value for action parameter. Action.Empty should be used instead. I21be9 b/498881738
- Padding modifier parameters were changed from left/right to start/end. Id781c b/500760020
- Modifier
onTouchDown(varargs action)andonTouchUp(varargs action)were changed toonTouchDown/onTouchUp(action). UseCombinedActionfor a list of actions. I8af9d b/498881738 - Modifier
clickable(varargs action)was changed toclickable(action). UseCombinedActionfor a list of actions. I8432d b/498881738
Bug Fixes
- Fix
MatrixExpression.writeId3c52
API Changes
- Updated
UpdateInfoto expose a strongly-typedSecurityPatchLevelobject instead of a rawString. This provides better API ergonomics while maintaining safe IPC compatibility across different library versions. I0736d
Bug Fixes
- Refactored the client-side IPC logic in
SecurityPatchStateto use Kotlin coroutines instead of raw Java threads. This introduces a bounded thread pool bulkhead to safely handle deadlocked remote providers and prevents unbounded thread explosions. Iaa398
API Changes
- Updated
UpdateInfoto expose a strongly-typedSecurityPatchLevelobject instead of a rawString. This provides better API ergonomics while maintaining safe IPC compatibility across different library versions. I0736d
New Features
- Added Composable functions to support vertical text layout, aligning with Google's Compose-first initiative.
API Changes
- Introduced
:text:text-vertical-composelibrary artifact. I939e4 - Added
lineCountproperty toVerticalTextLayoutclass. I93884 b/502088091
Bug Fixes
- Updated KDoc documentation for clarity and accuracy. I71c8f b/449184326
API Changes
- Unrestrict
File.createPerfettoFile()so others can safely create sinks. When ablock()throws an exception intrace/traceCoroutinecreate aninstantevent for the exception with the metadata representing the corresponding stack trace elements. I682e5 b/501536851 b/437166283 - Add a
setCounter(...)overload that takes a JavaLongtype. Ic0469 b/356082604 - Tracing 2.0 now uses
Longfor platform specificThreadidentifiers. I67277
Bug Fixes
- Improve documentation for
AttributeEntry.reset(). I5d3a1 b/496079439
- There are no changes since
androidx.webkit:webkit:1.16.0-beta01.
API Changes
- Add APIs for engagement state control. I98a09 b/489793703
- Renamed
transferActivityToWindowAreatotransferToWindowAreato be clearer about the behavior when triggering the feature. This also removes the session based behavior for this method as it's an operation that outlives the process that requests it. Ie7d6f b/271644150 b/273807246 b/272064992 b/473870239 - Add safe method to get
WindowMetricsI2adf8 b/449386176 - Update methods in WM extensions for engagement mode for clarity. I219a4 b/454438323
- Add helper methods to construct
WindowSizeClassSetsin a grid form. I4d623 b/444174274 - Add API to get engagement mode. I9fef2 b/423990404
- Add callback-based listeners directly to
WindowLayoutInfoand deprecateWindowInfoTrackerCallbackAdapter. I1ff17 b/423990404 - Deprecate
WindowLayoutInfoconstructor in Extensions. I6ab65 b/423990404 - Add extensions support for reporting engagement mode. I66211 b/423990404
Bug Fixes
- Updated Compose
compileSdkto API 37. This means that a minimum AGP version of 9.2.0 is required when using Compose. Id45cd b/413674743