New Features
- Added
MediaCapabilitiesAPI toPickVisualMediaRequestto let applications specify its media capabilities, such as supported HDR Types. Ic3ee7
Bug Fixes
- This library now uses JSpecify nullness annotations, which are type-use. Kotlin developers should use the following compiler argument to enforce correct usage:
-Xjspecify-annotations=strict(this is the default starting with version 2.1.0 of the Kotlin compiler). I32dda b/326456246
API Changes
- Added
TraceProcessorand 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 toTraceProcessor.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
pgreptoybox that now requires-ato 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.killExistingPerfettoRecordingsinstrumentation argument, which can be set tofalseto 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.osCodenameAbbreviatedwill now beRELfor 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
FrameTimingMetricwhen resynced frames occur. I7c6f4 b/394610806 - No longer assume
Choreographer#doFrameis the top of the stack frame on the main thread forFrameTimingQuery. Iee0e0 b/340206285
Bug Fixes
- Fixed child transition incorrectly being marked as interrupted. 3fa2ce
API Changes
TabRowDefaults.tabIndicatorOffsethas been deprecated in favor ofTabIndicatorScope.tabIndicatorOffset. Ib36b3- Fix typo for small content padding in button defaults. I19bfe
TabRowandScrollableTabRoware deprecated in favor of Primary and Secondary variants of each. Primary and Secondary tab rows are more performant and accurate to spec. I918e2- Added
rememberSliderStateandrememberRangeSliderState. I8e384 - Added
shouldAutoSnaptoSliderStateto 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
ExitAlwaysFloatingToolbarScrollBehaviorpublic allowing creation without composition. Ibf31c
Important changes since 1.0.0
ListDetailPaneScaffoldandSupportingPaneScaffoldis now supporting the pane expansion feature - users can drag to change the default pane split of a dual pane layout, developers can also change the pane split at runtime via altering the newly introducedPaneExpansionState.- Default predictive back support is now available with
NavigableListDetailPaneScaffoldandNavigableSupportingPaneScaffold. You can also useThreePaneScaffoldPredictiveBackHandlerto provide predictive back support with your own three pane scaffold implementations. - You can now customize your pane motions during pane switching by providing different
EnterTransitionandExitTransitiontoAnimatedPane.
API Changes
- Introduce
PaneScaffoldScope.preferredHeightmodifier for devs to provide pane preferred heights that will be applied with new adapt strategies we are going to introduce. I957dd b/220960090 - Rename
ComponentOverridetypes toOverride, andComponentOverrideContexttypes toOverrideScope. Id973c - Rename some component override methods. I222b3
API Changes
- Renamed
SnapshotObservermethods onCreating toonPreCreateandonDisposingtoonPreDisposeto 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
AndroidViewis 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
LaunchedEffectto request focus on a text field. b/392539099
New Features
- This is the first release of the
core-i18ncomponent. 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.MessageFormatthat 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, whichandroid.icu.text.MessageFormatdoes 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
GetCredentialRequestwith 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
RestoreCredentialfor 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.
API Changes
- Hide AnimationHandler class visibility. I8072e
Bug Fixes
- This library now uses JSpecify nullness annotations, which are type-use. Kotlin developers should use the following compiler argument to enforce correct usage:
-Xjspecify-annotations=strict(this is the default starting with version 2.1.0 of the Kotlin compiler). I70783 b/326456246
Bug Fixes
- Enable calculation for all aggregation types across all android versions. I8edf
API Changes
- Add
@MainThreadannotation toViewModelProvider.getin all supported KMP platforms. I7e8dd b/397736115 - Rename
SavedState*DelegatestoSavedState*Delegate. I8589b b/399629301
New Features
TopAppBaris spatialized into an Orbiter by default when usingEnableXrComponentOverrides.- Material
AlertDialogis spatialized into aSpatialPanelby default when usingEnableXrComponentOverrides.
API Changes
- Rename
ComponentOverridetypes toOverride, andComponentOverrideContexttypes toOverrideScopeId973c
Bug Fixes
- Fix aliasing and incorrect scrimming on spatialized
NavigationRailandNavigationBar. I9db52
Use the 1.6.0 stable version.
Bug Fixes
- Fix crashes
DelegatingFrameMetricsListener cannot be cast...Id891c b/311218678.
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
CustomAudiencesfor 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, theCustomAudiencepriority 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
ProtectedAudienceAPI.
- 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
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
NullPointerExceptionwhen 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
getcollections inSavedStateReader. I0b641 b/399820614 - Add
encodeDefaultstoSavedStateConfiguration, allowing customizing whether properties with default values should be encoded. I893cc b/395104517 - Add
SnapshotStateMapSerializerto supportmutableStateMapOf. Ie6f19 b/378895074 - Add
SnapshotStateListSerializerto supportmutableStateListOf. I4d888 b/378895074 - Add
getOrNullalternative methods forSavedStateReader.getvariants. These methods will auto-box primitive values. I6228c b/399820614
API Changes
- Remove
getOrElsefromSavedStateReaderin favor ofgetOrNull() ?: else(). I87317 b/399820614 - Remove
inlinemodifier fromSavedStateReaderandSavedStateWritermethods. If2a02 b/399820614 - Remove built-in Android-specific List and Array serializers out of public API Ida293
- Replace
SparseParcelableArraySerializerwithSparseArraySerializerI91de8 - Make all
SavedStateReader.getbehave consistently by throwing when value type doesn't match return type I78c4a b/399317598 - Rename
SavedState*DelegatestoSavedState*Delegate. I8589b b/399629301 - Rename
SavedStateConfigtoSavedStateConfiguration. I043a5 b/399629301
API Changes
- Updated
PagerState, removing the Compose FoundationPagerStateas the base class and addingcurrentPage,currentPageOffsetFractionandpageCountproperties. Updated theGestureInclusioninterface, renaming the method toignoreGestureStart. I4ae07 - Add
requireOffsettoSwipeToDismissBoxStateas the recommended way of getting an offset ofSwipeToDismissBoxState. I21042 - Added
CurvedModifier.semantics, initially supporting content description and traversal index I0b093 - We have added
CurvedModifier.clearAndSetSemanticsto provide a means by which curved semantics can be turned off.CurvedTextcontinues to default the content description to the text, buttimeTextCurvedTextandtimeTextSeparatordo not now announce their contents. I4b568 HorizontalPager’s default handling of swipe gestures has been renamed toPagerDefaults.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
rotaryScrollableapi. Overscroll and nested scroll were added torotaryScrollablefling 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. FoundationSwipeToReveal’s default behavior is now to disallow swiping when the gesture starts from the edge. Material3SwipeToReveal’s default behavior is now to disallow swiping when the gesture starts from the edge, when theSwipeDirectionis set to single direction. I32ef0 - TLC now uses empty contentPadding by default instead of putting first and last items into center. I77ab7
Bug Fixes
API Changes
PagerScaffoldno longer emits aPagercomponent - instead this must be provided via thecontentComposable.AnimatedPageandsnapWithSpringFlingBehaviourare now public and can be used along with Wear FoundationPagerto achieve previous M3PagerScaffoldbehaviour. (See updated samples). Ia4724- Updated
PagerState, removing the Compose FoundationPagerStateas the base class and addingcurrentPage,currentPageOffsetFractionandpageCountproperties. Updated theGestureInclusioninterface, renaming the method toignoreGestureStart. I4ae07 LevelIndicatorsweep angle parameters are now annotated withFloatRange(0, 360)I7e636- We have added
CurvedModifier.clearAndSetSemanticsto provide a means by which curved semantics can be turned off.CurvedTextcontinues to default the content description to the text, buttimeTextCurvedTextandtimeTextSeparatordo 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 toPagerDefaults.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
SurfaceTransformationparameter 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 asTransformingLazyColumn. 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. FoundationSwipeToReveal’s default behavior is now to disallow swiping when the gesture starts from the edge. Material3SwipeToReveal’s default behavior is now to disallow swiping when the gesture starts from the edge, when theSwipeDirectionis set to single direction. I32ef0 - Added
FadingExpandingLabelcomposable, which allows it to fade in text with animation line by line. Ic60fa TransformingLazyColumnnow uses emptycontentPaddingby default instead of putting first and last items into center. I77ab7- Removed
SwipeToReveal’srememberRevealStatefrom 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
ScrollIndicatorandPageIndicatorhas 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
CurvedTextStyleused inConfirmationDialogDefaultsandOpenOnPhoneDialogDefaultshas been updated to useArcLargetypography with size18spand letter spacing1.8sp. Ic9ced Card,ListHeader,RadioButton,CheckboxButton,SwitchButtonno longer constrain the height of its contents by default. Where necessary, useModifier.height(IntrinsicSize.Min)to restore the previous behavior if needed. I80bb8- We have updated the default
TimeTextandScrollIndicatorcolors to include more gray tones, because usingOnBackground(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
TimeTextandScrollIndicatorin 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
SwipeToRevealusingedgeSwipeToDismissmodifier. I02b07 - We have added a heading to
DatePickerandTimePickerunder TalkBack so that the user is informed to scroll to set date/time. Id738d AnimatedTextnow follows the reduce motion setting. Ib6578- The optimisation to use
AppScaffoldfor 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
MaterialScopeto allow for easier usage in developers' functions that are creating components for Material3 tiles. I7df73
API Changes
- Rename api
platformVisibilityStatustoPlatformEventSources.isLayoutVisibleand add a new experimental APIPlatformEventSources.isLayoutUpdatePending. Ie1e04
Bug Fixes
- Margins for
primaryLayoutare 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
ProtoLayoutMaterial3 components. Iff5f3 Typography.NUMERAL_*typographies are no longer tabular/monospace by default. If text is animating, it is highly recommended to addFontSetting.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
ProtoLayoutMaterial3 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 inWebStorageCompatshould be preferred over the existing APIs inandroid.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
setPartitionedCookiesEnabledAPI. This will allow developers to enable and disable partitioned cookies inWebView. Ic506a b/364904765 - Add socket tagging API to
WebViewfor accounting ofWebView's network traffic usingNetworkStatsManager/TrafficStats. This feature will only be available fromWebViewM133. Ica441 b/374932688 - Add experimental
WebViewasync startup API. I94b8a - URL Prefetching in Profile: Introduced a new API in
Profileto allow developers to trigger URL prefetching. Prefetch Clearing: Added an API to clear ongoing prefetches.I42c5c - Deprecate
WebView.startSafeBrowsing. If5626
New Features
- Updates to the
WindowSizeClassAPI. - Updates to Activity Embedding APIs.
New Features
- Initial release of next 1.5.0.