May 20, 2025

New Features

  • ComponentActivity and ComponentDialog have been integrated with NavigationEvent 1.0.0-alpha01 via the NavigationEventDispatcherOwner API. You can now retrieve a NavigationEventDispatcher from your ComponentActivity via the navigationEventDispatcher field. Since the OnBackPressedDispatcher has been re-written on top of the new library all previous usages should continue to work correctly. You should use NavigationEventDispatcher and NavigationEventCallback going forward. Ib8eed I6cc44 Ib7724 I9a0f7 b/412597031 b/415028038 b/412596729 b/412597140 b/412596012

New Features

  • AppSearch module enters RC.
  • Adds a new experimental API to accumulate actions for the PutDocumentsRequest#addTakenAction method I7b726
  • Add SearchResult#TextMatchInfo, SearchResult#EmbeddingMatchInfo; restructure SearchResult#MatchInfo for providing match information for embeddings matches I8f78d
  • Introduce ranking functions for list manipulation Ifa4ab

API Changes

  • Support AppSearch annotation processor for blob handle property. I9520b
  • Update AppSearch annotation processor to support quantization. Ie0c85
  • Adds a static getFeatures() method to both PlatformStorage and LocalStorage I5a206

Bug Fixes

  • This library now uses JSpecify nullness annotations, which are type-use. Kotlin developers should use the following compiler arguments to enforce correct usage: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode I91f42 b/326456246

API Changes

  • Added new intent extra for custom tabs I911e0
  • Added Browser and MiminalUi modes to TWADisplayMode I230b5
  • Added capability check API for Ephemeral Browsing I17d42
  • Remove experimental annotation for PendingSession API Id6fe3
  • Added Auth Tab capability check API Ifc029
  • Removed Custom Tab minimize signals experimental annotation If2b44

New Features

All capabilities are temporarily only available on Android Auto. The same API’s will be leveraged across AAOS

  • Added Media category to create custom application, as an alternative to MediaBrowse based ones
  • Added Playback Template which allows to control the top actions during in Media Playback View (only available to Media apps)
  • Added full support for Sectioned Item Template on Android Auto, which allows combinations of sub-sections made of Lists/Grids.
  • Added Extra-Large as an additional size for Grid Items.

API Changes

  • Add an extra size option for Grid items I35b58
  • Adds category and permission for media apps to Car App Library I8e100
  • Added new api for apps to detect whether the CarAppLibrary media category is supported Ic4b08
  • Added OnItemVisibilityChangeListener to Section. I2c2fd
  • Added Mileage#getOdometerKilometers and deprecate Mileage#getOdometerMeters Ic91af

Bug Fixes

  • Fix typo in Javadoc of CarIcon.setTint Iabd72
  • Updated Row.Builder#setNumericDecoration documentation to reflect how 1 action + numeric decoration is not supported; however 0 or 2 actions + numeric decoration is. Ic0b08
  • Added field for badge icon background color for grid items. I2b6ae

Bug Fixes

  • Introduced a fix that prevents calculation of number of items to load for focus search to cause a division by zero. Applied the check to all layouts that use LazyLayoutBeyondBoundsState. 8e6dc8

API Changes

  • Added AnnotatedOutputTransformation that provides a way to add annotations to TextField before rendering. Ibc6f0 b/389978748
  • Introduce LazyLayoutMeasurePolicy and make LazyLayoutMeasureScope stable. I8c5df b/252853717
  • BasicSecureTextField now hoists ScrollState of its internal BasicTextField. I6e576
  • Modifier.onFirstVisible and Modifier.onVisibilityChanged modifiers were introduced, which are high level modifiers built on top of Modifier.onLayoutRectChanged. These modifiers are built specifically to handle a lot of common application requirements such as logging impressions, auto playing videos, etc. These have been built with performance in mind so that they can be used in critical list-based scenarios without risk of sacrificing scroll performance. In addition to these modifier APIs, additional APIs to RelativeLayoutBounds have been added in order to support these use cases, as well as make it easier for developers to easily create similar custom modifiers that suit their use case exactly. I759b8
  • Introduced a detectDragGestures overload that has touch slop and orientation lock control. Iadb0d
  • Introduce Modifier.scrollable2D, Scrollable2DState and companion APIs for state creation. Also introduced common scroll extension functions. Ic61c8 b/214410040
  • Compose 64-bit color values are not directly comparable to Android ColorLongs because the color space IDs are out of order for some color spaces. To convert to and from Android color spaces, two new APIs are added: toColorLong() and fromColorLong(). I36899

Bug Fixes

  • Text copied from multiple Text composables in a SelectionContainer now will have a line separator \n added between text coming from the separate Text composables. I25332 b/285036739

API Changes

  • Added MotionTheme.LocalMotionScheme, composition local. This allows access to the theme motion scheme from CompositionLocalConsumerModifierNodes, with currentValueOf(MotionTheme.LocalMotionScheme). I014b1
  • ColorScheme constructor without Fixed color roles is now deprecated. Please migrate to constructor that includes fixed roles. Iad0ee
  • M3 Text component now supports TextAutoSize. I7f524
  • Add api for constructing split button size variants and add samples. Ice30b

Bug Fixes

  • Fixed an issue where Snackbar and FloatingActionButton were incorrectly positioned when edge-to-edge was enabled. Scaffold now correctly applies horizontal insets to these components. Ib7c30 b/244400727
  • Fix the BottomSheet motion from fully expanded to partially expanded. The BottomSheet now uses the MotionScheme's fast-effect when hiding or collapsing, and default-spatial when expanding. Ifa46f b/416063171
  • ColorScheme constructor without surface container roles has been marked hidden and no longer recommended for use. Ia7237
  • Removed a CircularWavyProgressIndicator Size.minDimension > 0 requirement, which used to throw an exception, to allow more flexibility. Ic9418 b/377531195
  • Hyperlinks in Text(AnnotatedString) now have Material styling by default. I78288 b/339843816
  • Fix an issue where the toShape() function in the RoundedPolygon is caching a Path and causing an issue when multiple createOutline calls are made with different sizes. I4026d

New Features

  • The default pane scaffold directive calculation functions is now supporting L and XL window width size classes.

API Changes

  • Make Modifier.paneExpansionDraggable provide default accessibility semantics and promote relevant APIs to stable. Idb818
  • Support drag-to-resize with levitated panes Idadd3
  • Support scrims for levitated panes I9b091

API Changes

  • Change setDiagnosticStackTraceEnabled to experimental to account for future development of this feature. I11db3

Bug Fixes

  • Fixed the reusing state when a composition was paused and restarted but some previously paused state needed to be recomposed because some state it read changed while the composition was paused. I441d1 b/416209738
  • Completed the pausable composition remember dispatch fix for issue b/404058957 previous fix was incomplete. I1afd4 b/404058957
  • SaveableStateHolder.SaveableStateProvider now provides a LocalSavedStateRegistryOwner to its content via composition. Ia2761 b/413108878
  • androidx.compose.runtime.saveable now depends on androidx.lifecycle.runtime.compose. I53228 b/413108878

Bug Fixes

  • Fixes NPE when dialog is being removed during active event stream on dialog 6a7e7f
  • Fix onLayoutRectChange not updating per throttled timeline when draw-only updates occur. 03b82d

API Changes

  • Flag ComposeUiFlags.isGetFocusedRectReturnEmptyEnabled makes it so that when nothing is focusable in a ComposeView, it sets the rect to an Empty value. This prevents a focus search from choosing the View to focus on. This is especially important for when an IME has a NEXT option where it might try to focus on the ComposeView and requestFocus() fails. Ibd0e2 b/369256395
  • Introduce flag isNestedScrollDispatcherNodeFixEnabled. I0d24a
  • Rename DialogProperties' dialogContentTitle to windowTitle Ibd27b
  • Modifier.onFirstVisible and Modifier.onVisibilityChanged modifiers were introduced, which are high level modifiers built on top of Modifier.onLayoutRectChanged. These modifiers are built specifically to handle a lot of common application requirements such as logging impressions, auto playing videos, etc. These have been built with performance in mind so that they can be used in critical list-based scenarios without risk of sacrificing scroll performance. In addition to these modifier APIs, additional APIs to RelativeLayoutBounds have been added in order to support these use cases, as well as make it easier for developers to easily create similar custom modifiers that suit their use case exactly. I759b8
  • Change setDiagnosticStackTraceEnabled to experimental to account for future development of this feature. I11db3
  • Introduce Modifier.scrollable2D, Scrollable2DState and companion APIs for state creation. Also introduced common scroll extension functions. Ic61c8 b/214410040
  • Compose 64-bit color values are not directly comparable to Android ColorLongs because the color space IDs are out of order for some color spaces. To convert to and from Android color spaces, two new APIs are added: toColorLong() and fromColorLong(). I36899
  • Introduced ViewConfiguration.minimumFlingVelocity to allow lower bound fling velocity control. I11aab

Bug Fixes

  • Fixed an issue with FragmentManager not being in the proper state after pop and replace operations in the same frame that could cause a crash in conjunction with popping the backstack either via popBackStack or the predictive back gesture. I50ad1
  • Fixed a crash caused by using AndroidX Transitions and getting into a case where quick consecutive fragment transactions attempt to cancel an unstarted transition and the AndroidX Transition library does not properly clear the transition state. (see b/414612221). Ib5235

New Features

  • Add a check to warn about usages of configurations.create and configurations.maybeCreate as these cause eager realization of that configuration starting with Gradle 8.14 and thus should be replaced with configurations.register.
  • Add a check to catch usages of internal Kotlin Gradle Plugin APIs
  • Add a check to catch usages of evaluationDependsOn and evaluationDependsOnChildren as it is not safe with Isolated Projects feature.

New Features

Navigation3 is a new navigation library built specifically to handle Jetpack Compose in-app navigation. The androidx.navigation3.runtime artifact provides the building blocks, while the androidx.navigation3.ui artifact provides the UI layer via the NavDisplay API. Developers can provide their own state directly to the NavDisplay composable function, which changes the content based on changes in the developer state.

@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey

val backStack = rememberNavBackStack(Home)

NavDisplay(backStack, entryProvider = entryProvider {
  entry<Home> {
    Column {
      Text(“Home”)
      Button(onClick = { backStack.add(Chat) } ) {
        Text(“Go to Chat”)
      } 
    }
  }
  entry<Chat> { /* My Composable Content */ }
})

For more information, see the Navigation3 guide.

New Features

  • The androidx.navigationevent library provides a KMP-first API for handling system back as well as Predictive Back. The NavigationEventDispatcher serves as a common APIs for registering one or more NavigationEventCallback instances for receiving system back events.
  • This layer sits below the previously released APIs in androidx.activity and aims to be a less opinionated replacement for using the Activity APIs in higher level components or directly using the Android framework OnBackInvokedDispatcher APIs. The androidx.activity APIs have been rewritten on top of the Navigation Event APIs as part of Activity 1.12.0-alpha01.

New Features

  • Added logic to measure obstructions on SandboxedSdkView, which will be sent in SessionObserver.onUiContainerChanged() if SandboxedUiAdapterSignalOptions.OBSTRUCTIONS is included in the associated SessionObserverFactory.signalOptions. Obstructions are reported relative to the view itself.

API Changes

  • Moved SandboxedSdkUi from ui-client into a new ui-client-compose library.
  • Added logic to measure obstructions on UI containers. I34bea

Bug Fixes

  • Fixed SandboxedSdkView.setAlpha(), which now updates the alpha of its content view.

Important changes since 1.1.0

  • Fix small mouse moves turning clicks into drags.
  • Fix an issue where key/position mapping in KeyProvider was lost while entry was not yet recycled.

Bug Fixes

  • Updated baseline profiles for foundation, material & material3 libraries. I53f06
  • Fixed a bug in TransformingLazyColumn, where items resized when the bottom item was removed. Idacab
  • Fixed a bug with TransformingLazyColumn, when the list got stuck at the top or bottom of the list. I49d00
  • OpenOnPhoneDialog under TalkBack should announce the curved text, rather than the icon content description. I4efe8
  • Fixed a bug in SwipeToReveal that would report the wrong anchor in RevealState.currentValue when hasPartiallyRevealedState is set to false. I9c7cf
  • SwipeToReveal undo buttons are now ButtonDefaults.Height by default. I1f6c8
  • BasicSwipeToDismissBox performance has been improved by eliminating use of Canvas for drawing scrims. I68f2c
  • Fixed an accessibility bug in Slider, where the announced percentage did not match the value after updates I91146
  • Fixed a bug on placeholderShimmer implementation. (Iee39b
  • TransformingLazyColumn performance has been improved, by optimizing ScrollProgress calculation by 30%. I4c4cb

Bug Fixes

  • Updated baseline profiles for foundation, material & material3 libraries. I53f06
  • Fixed a bug in TransformingLazyColumn, where items resized when the bottom item was removed. Idacab
  • Fixed a bug with TransformingLazyColumn, when the list got stuck at the top or bottom of the list. I49d00
  • OpenOnPhoneDialog under TalkBack should announce the curved text, rather than the icon content description. I4efe8
  • Fixed a bug in SwipeToReveal that would report the wrong anchor in RevealState.currentValue when hasPartiallyRevealedState is set to false. I9c7cf
  • SwipeToReveal undo buttons are now ButtonDefaults.Height by default. I1f6c8
  • BasicSwipeToDismissBox performance has been improved by eliminating use of Canvas for drawing scrims. I68f2c
  • Fixed an accessibility bug in Slider, where the announced percentage did not match the value after updates I91146
  • Fixed a bug on placeholderShimmer implementation. (Iee39b
  • TransformingLazyColumn performance has been improved, by optimizing ScrollProgress calculation by 30%. I4c4cb

Important changes since 1.3.0

  • Activity Embedding
    • API to customize the launch animations
    • Interactive Divider
    • ActivityStack Pinning
    • Full Screen Dialog Dimming
    • Embedded Activity Window Info Callback
    • Improved ActivityStack Management
    • Launch Activity into a specified ActivityStack
  • WindowMetricsCalculator
    • Improve testability support
  • WindowMetrics
    • Convenience methods to calculate withDp and heightDp
    • Update bounds check to isAtLeast and use lower bounds to support adding new values
  • WindowSizeClass
    • Add way to calculate from WindowMetrics
  • WindowInfoTracker
    • Add API to detect the supported postures on the device