March 12, 2025

New Features

  • Added MediaCapabilities API to PickVisualMediaRequest to let applications specify its media capabilities, such as supported HDR Types. Ic3ee7

API Changes

  • Added TraceProcessor and Session API with closable Handles, for easier usage with custom lifecycles. This is also a step towards enabling easier Coroutine and Java API usage. The extension functions to TraceProcessor.runServer {} are now marked experimental, as they're likely to move, and be made non-experimental in the future. I358b4

Bug Fixes

  • Fixed Benchmark and Baseline Profile capture not working with API 36 due to a change in pgrep toybox that now requires -a to print the full command line. Idc991
  • Filter default tracing config to reduce risk of data loss in traces on newer API levels. I54e8a
  • Added experimental androidx.benchmark.killExistingPerfettoRecordings instrumentation argument, which can be set to false to allow pre existing perfetto trace capture to continue. By default pre existing perfetto trace captures on device are killed to prevent interference. I02a3c
  • The JSON field context.osCodenameAbbreviated will now be REL for released OS versions at and above API 35, as non-numeric code names are no longer supported by the underlying platform. Ib17fd
  • Fixes crash in FrameTimingMetric when resynced frames occur. I7c6f4 b/394610806
  • No longer assume Choreographer#doFrame is the top of the stack frame on the main thread for FrameTimingQuery. Iee0e0 b/340206285

API Changes

  • TabRowDefaults.tabIndicatorOffset has been deprecated in favor of TabIndicatorScope.tabIndicatorOffset. Ib36b3
  • Fix typo for small content padding in button defaults. I19bfe
  • TabRow and ScrollableTabRow are deprecated in favor of Primary and Secondary variants of each. Primary and Secondary tab rows are more performant and accurate to spec. I918e2
  • Added rememberSliderState and rememberRangeSliderState. I8e384
  • Added shouldAutoSnap to SliderState to control the auto-snapping mechanism, disabling it may be useful for custom animations. I07745
  • Scrollable tab row's minimum tab width is now a parameter. Primary and Secondary tab row variants are no longer experimental. If6f15 b/226665301
  • Made the class ExitAlwaysFloatingToolbarScrollBehavior public allowing creation without composition. Ibf31c

Important changes since 1.0.0

API Changes

  • Introduce PaneScaffoldScope.preferredHeight modifier for devs to provide pane preferred heights that will be applied with new adapt strategies we are going to introduce. I957dd b/220960090
  • Rename ComponentOverride types to Override, and ComponentOverrideContext types to OverrideScope. Id973c
  • Rename some component override methods. I222b3

API Changes

  • Renamed SnapshotObserver methods onCreating to onPreCreate and onDisposing to onPreDispose to match API guidelines. The previous methods are deprecated and the new methods default to call the old ones so existing implementations of this interface will continue to work until the methods are removed. These methods will be removed in 1.9.0 alpha in a follow-up CL that will shortly follow this one. They will be removed from 1.8 beta before 1.8 stable. I6d753

Bug Fixes

  • Fixes crash when a focused AndroidView is removed with the soft keyboard active. Ic725a
  • Fixes a few issues in the new focus state handling implementation. b/395895685
  • Fixes an issue blocking Autofill when using LaunchedEffect to request focus on a text field. b/392539099

API Changes

  • Refine insets protection APIs I7050d
  • Adds new key to get character bounds in unmagnified window coordinates. If7a06
  • Add new boolean property to represent if an AccesibilityNodeInfo represents a required field. I4fd2d
  • Backport View.transformMatrixToGlobal to ViewCompat If17e2

New Features

  • This is the first release of the core-i18n component. The component makes it easier to create properly internationalized applications, focusing on two main areas:
    • Date and time formatting functionality following the best current practices, honoring user custom settings, and providing a unifying API that works properly on old and new Android versions.
    • A backport of android.icu.text.MessageFormat that works on older APIs. But still useful on new Android versions because it integrates the date / time formatting mentioned above. That honors the user settings, which android.icu.text.MessageFormat does not do.
    • The component will be the vehicle to backporting new i18n APIs, adding new i18n functionality or fixes, and in general making internationalization easier.

Important changes since 1.3.0

  • Secondary UI experience for credential selection: App developers that call Credential Manager APIs at sign-in moments to present the user with a selector, are now able to use new APIs to associate the same GetCredentialRequest with a given view, such as a username or a password field. Subsequently, when the user focuses on one of these views, the corresponding request will be sent to Credential Manager. The resulting credentials are aggregated across providers and displayed in autofill like secondary UIs, such as keyboard or dropdown suggestions. As such when all APIs are used together, the user is first presented with a selector, and if dismissed and taps on one of the fields mentioned above, is then presented with keyboard/dropdown suggestions.
  • Restore Credentials: The restore credential is used to restore the user's credential from the previous device to a new Android device. By creating a RestoreCredential for the user, the credential will be automatically transferred over to the user's new device if the user selects the app to be transferred from the old device during the setup stage.

New Features

  • TopAppBar is spatialized into an Orbiter by default when using EnableXrComponentOverrides.
  • Material AlertDialog is spatialized into a SpatialPanel by default when using EnableXrComponentOverrides.

API Changes

  • Rename ComponentOverride types to Override, and ComponentOverrideContext types to OverrideScope Id973c

Bug Fixes

  • Fix aliasing and incorrect scrimming on spatialized NavigationRail and NavigationBar. I9db52

Bug Fixes

  • Fixed a regression found in Navigation 2.8.8 that required a deep link to match all of the fields of a deep link request or intent exactly in order to be considered a match. This caused deep links that contained partial field matches and did not have others to no longer work. Ie5e36 b/399826566

Bug Fixes

  • From Navigation 2.8.9: Fixed a regression found in Navigation 2.8.8 that required a deep link to match all of the fields of a deep link request or intent exactly in order to be considered a match. This caused deep links that contained partial field matches and did not have others to no longer work. Ie5e36 b/399826566

External Contribution

  • New common parser function to create a NavUri. Thanks Konstantin Tskhovrebov! If0a6a

Bug Fixes

  • Resolved inconsistent selection menu placement between different Android devices due to scaling differences. Selection menu placement is now consistent across devices.
  • Aligned fast scroller and page indicator position on fragment recreation in scenarios like config change, etc.

New Features

  • Custom Audience Priority: We have added a priority field in the custom audience. This allows buyers to specify a priority value in a CustomAudience. This value would be used to identify custom audiences which should be included in an auction if the set of buyer custom audiences exceed the per-buyer size limits
  • Seller Configuration: This feature allows sellers to define auction parameters to control payload size and auction participants. The seller auction configuration would allow sellers to specify:
    • Allowed buyer list
    • For auctions initiated by the given seller, only the buyers in the allowlist would be able to contribute CustomAudiences for the auction
    • Per-buyer size limit
    • Sellers could specify a per-buyer limit to regulate the data size uploaded by each buyer into the payload being sent to SellerFrontendService. If the buyer exceeds the per-buyer size limit, the CustomAudience priority set in buyer payload configuration would be used to get the data in the expected limits.
    • Max size limit for the payload
    • Different sellers might have different resource allocation and might want to set a max size limit for the per-request auction payload. The max size limit would respect the fixed size buckets set by the ProtectedAudience API.
  • Delayed Custom Audience Updates: This feature enables buyers to schedule deferred updates for Custom Audiences. Each update request allows the caller to schedule a delayed update using the new scheduleCustomAudienceUpdate() API. For each update, the user can specify sets of Custom Audiences to join or leave.

API Changes

  • Add Seller Configuration in GetAdSelectionRequest API Ibb5c7
  • Introduce ScheduleCustomAudienceUpdate API as experimental I6b905

Bug Fixes

  • Fix Auto Migrations incorrectly handling a new column on an FTS table. b/348227770 Ic53f3
  • Fix a room-compiler crash due to a NullPointerException when processing non-JVM sources via KSP. b/396607230 I693c9
  • Fix an issue where Room would not invalidate tables at the end of using the writer connection. b/340606803 I73ef6

New Features

  • Add non-reified method variants for get collections in SavedStateReader. I0b641 b/399820614
  • Add encodeDefaults to SavedStateConfiguration, allowing customizing whether properties with default values should be encoded. I893cc b/395104517
  • Add SnapshotStateMapSerializer to support mutableStateMapOf. Ie6f19 b/378895074
  • Add SnapshotStateListSerializer to support mutableStateListOf. I4d888 b/378895074
  • Add getOrNull alternative methods for SavedStateReader.get variants. These methods will auto-box primitive values. I6228c b/399820614

API Changes

  • Remove getOrElse from SavedStateReader in favor of getOrNull() ?: else(). I87317 b/399820614
  • Remove inline modifier from SavedStateReader and SavedStateWriter methods. If2a02 b/399820614
  • Remove built-in Android-specific List and Array serializers out of public API Ida293
  • Replace SparseParcelableArraySerializer with SparseArraySerializer I91de8
  • Make all SavedStateReader.get behave consistently by throwing when value type doesn't match return type I78c4a b/399317598
  • Rename SavedState*Delegates to SavedState*Delegate. I8589b b/399629301
  • Rename SavedStateConfig to SavedStateConfiguration. I043a5 b/399629301

API Changes

  • Updated PagerState, removing the Compose Foundation PagerState as the base class and adding currentPage, currentPageOffsetFraction and pageCount properties. Updated the GestureInclusion interface, renaming the method to ignoreGestureStart. I4ae07
  • Add requireOffset to SwipeToDismissBoxState as the recommended way of getting an offset of SwipeToDismissBoxState. I21042
  • Added CurvedModifier.semantics, initially supporting content description and traversal index I0b093
  • We have added CurvedModifier.clearAndSetSemantics to provide a means by which curved semantics can be turned off. CurvedText continues to default the content description to the text, but timeTextCurvedText and timeTextSeparator do not now announce their contents. I4b568
  • HorizontalPager’s default handling of swipe gestures has been renamed to PagerDefaults.gestureInclusion. The default behavior is now to only ignore swipe gestures that start on the left edge of the first page, and only then when Talkback is turned off. In other cases, the default behavior is that swipe gestures will not be ignored by the pager, so they will not be available to swipe-to-dismiss handlers. Iee486
  • Added rotary overscroll for rotaryScrollable api. Overscroll and nested scroll were added to rotaryScrollable fling behavior. This change should bring on-par overscroll and nested scroll functionality between touch scroll and rotary scroll. I71926
  • Added support for an edge-swipe zone to SwipeToReveal. Foundation SwipeToReveal’s default behavior is now to disallow swiping when the gesture starts from the edge. Material3 SwipeToReveal’s default behavior is now to disallow swiping when the gesture starts from the edge, when the SwipeDirection is set to single direction. I32ef0
  • TLC now uses empty contentPadding by default instead of putting first and last items into center. I77ab7

Bug Fixes

  • Wear Compose libraries have been updated to the Kotlin 2.0 compiler. I2de79
  • Fixed the curved LetterSpacing sample on foundation. Iebf7c

API Changes

  • PagerScaffold no longer emits a Pager component - instead this must be provided via the content Composable. AnimatedPage and snapWithSpringFlingBehaviour are now public and can be used along with Wear Foundation Pager to achieve previous M3 PagerScaffold behaviour. (See updated samples). Ia4724
  • Updated PagerState, removing the Compose Foundation PagerState as the base class and adding currentPage, currentPageOffsetFraction and pageCount properties. Updated the GestureInclusion interface, renaming the method to ignoreGestureStart. I4ae07
  • LevelIndicator sweep angle parameters are now annotated with FloatRange(0, 360) I7e636
  • We have added CurvedModifier.clearAndSetSemantics to provide a means by which curved semantics can be turned off. CurvedText continues to default the content description to the text, but timeTextCurvedText and timeTextSeparator do not now announce their contents. I4b568
  • Added a background and default content color parameters to AppScaffold. I56652
  • HorizontalPager’s default handling of swipe gestures has been renamed to PagerDefaults.gestureInclusion. The default behavior is now to only ignore swipe gestures that start on the left edge of the first page, and only then when Talkback is turned off. In other cases, the default behavior is that swipe gestures will not be ignored by the pager, so they will not be available to swipe-to-dismiss handlers. Iee486
  • Added a SurfaceTransformation parameter to button, card and list header components, so that they can apply different background and content transformations when used in containers that change items appearance based on their position, such as TransformingLazyColumn. Iabe3f
  • We have updated 'public const val' properties in our Wear Compose Material3 API to 'public val', to avoid the values being inlined. Ib0f32
  • Added support for an edge-swipe zone to SwipeToReveal. Foundation SwipeToReveal’s default behavior is now to disallow swiping when the gesture starts from the edge. Material3 SwipeToReveal’s default behavior is now to disallow swiping when the gesture starts from the edge, when the SwipeDirection is set to single direction. I32ef0
  • Added FadingExpandingLabel composable, which allows it to fade in text with animation line by line. Ic60fa
  • TransformingLazyColumn now uses empty contentPadding by default instead of putting first and last items into center. I77ab7
  • Removed SwipeToReveal’s rememberRevealState from the Wear Compose Material3 library. I8c0e0

Bug Fixes

  • Wear Compose libraries have been updated to the Kotlin 2.0 compiler. I2de79
  • Support for non-round ScrollIndicator and PageIndicator has been removed from Material3. Square screen support is also no longer part of the Wear OS requirements, see the Getting Started guide for more information. I9a852
  • The CurvedTextStyle used in ConfirmationDialogDefaults and OpenOnPhoneDialogDefaults has been updated to use ArcLarge typography with size 18sp and letter spacing 1.8sp. Ic9ced
  • Card, ListHeader, RadioButton, CheckboxButton, SwitchButton no longer constrain the height of its contents by default. Where necessary, use Modifier.height(IntrinsicSize.Min) to restore the previous behavior if needed. I80bb8
  • We have updated the default TimeText and ScrollIndicator colors to include more gray tones, because using OnBackground (white) directly carried too much visual weight when competing with other content on screen like titles. I8b36f
  • We have reduced the timeout for animating the TimeText and ScrollIndicator in scaffold components to 2 seconds. I52021
  • We have updated the motion of Dialog so that the scale of the background of the Dialog is synchronised with swiping to dismiss. I925a9
  • Add demo of M3 SwipeToReveal using edgeSwipeToDismiss modifier. I02b07
  • We have added a heading to DatePicker and TimePicker under TalkBack so that the user is informed to scroll to set date/time. Id738d
  • AnimatedText now follows the reduce motion setting. Ib6578
  • The optimisation to use AppScaffold for display Dialog content has been improved to allow multiple dialogs to be displayed on top of each other I1209c

New Features

  • Add helper for Brush in kotlin Background Modifier. I995de
  • Mandatory Android Context field has been made public in MaterialScope to allow for easier usage in developers' functions that are creating components for Material3 tiles. I7df73

API Changes

  • Rename api platformVisibilityStatus to PlatformEventSources.isLayoutVisible and add a new experimental API PlatformEventSources.isLayoutUpdatePending. Ie1e04

Bug Fixes

  • Margins for primaryLayout are now properly rounded up instead, which can have effect on some layout up to 2dp space less for the main slot. I8f5d3
  • Clarification of default dynamic color theme in ProtoLayout Material3 components. Iff5f3
  • Typography.NUMERAL_* typographies are no longer tabular/monospace by default. If text is animating, it is highly recommended to add FontSetting.tabularNum() setting to it. In all other cases this monospace option is not needed and there will be more available characters by not using it. Id3cd9
  • Clarification of default dynamic color theme in ProtoLayout Material3 components. I9d831

Important changes since 1.12.0

  • Introduce a new experimental API for Url prerendering to allow developers to speculative prerender candidate urls resulting in faster navigations. I0cfe7
  • Introducing a set of new APIs to delete browsing data stored by WebView. The new APIs in WebStorageCompat should be preferred over the existing APIs in android.webkit.WebStorage, as they will guarantee deletion of all local storage, including the network cache and cookies, as well as any installed service workers. If new storage APIs are introduced in the future, then these new methods will be updated to include them in the storage deleted. Iad54f b/382273208
  • Add setPartitionedCookiesEnabled API. This will allow developers to enable and disable partitioned cookies in WebView. Ic506a b/364904765
  • Add socket tagging API to WebView for accounting of WebView's network traffic using NetworkStatsManager/TrafficStats. This feature will only be available from WebView M133. Ica441 b/374932688
  • Add experimental WebView async startup API. I94b8a
  • URL Prefetching in Profile: Introduced a new API in Profile to allow developers to trigger URL prefetching. Prefetch Clearing: Added an API to clear ongoing prefetches.I42c5c
  • Deprecate WebView.startSafeBrowsing. If5626