June 4, 2025

Bug Fixes

  • AppCompat has been updated to use Activity 1.8.0 to allow it to use the initializeViewTreeOwners() API from ComponentActivity to ensure that it always has the correct ViewTreeOwners set. This fixes an incompatibility between AppCompatActivity and NavigationEvent and libraries that build on top of it such as Navigation 3. I96919 b/419208471

New Features

  • Support Android 16 API(s).
  • Better support for parameterized AppFunctionSerializable(s) at compile time.

API Changes

  • Introduced AppFunctionSchemaDefinition API, enabling agents to define their own predefined function schemas.

Bug Fixes

  • Error handling for missing runtime enabled state of AppFunctions.
  • Minor bugfix in observeAppFunctions API to observe changes in AppFunctionComponentMetadata.
  • Additional error logs.

Important changes since AutoFill 1.2.0

  • Adds autofill hint constants for wallet valuables types.

API Changes

  • Added a BaselineProfileConfig.Builder to make it easier to call BaselineProfileRule.collectWithResults() for Java developers. I94905

New Features

  • With the update to 1.5.0-beta01, the FeatureCombinationQuery artifacts have been moved to their own library group. This change is necessary to improve the modularity and maintainability of the CameraX library.

API Changes

  • SessionConfigurationCompat and SessionParametersCompat have been renamed to SessionConfigurationLegacy and SessionParametersLegacy respectively to better reflect their function in supporting older APIs only.
  • Similarly, the method name/signature of CameraDeviceSetupCompat.#isSessionConfigurationSupported(SessionConfigurationCompat) has been changed to CameraDeviceSetupCompat.#isSessionConfigurationSupportedLegacy(SessionConfigurationLegacy)

API Changes

  • PrefetchScheduler and customisation have been deprecated in favor of the internal implementation that does all the work automatically. I3a9a6 b/420551535
  • Updated Scrollable2DState to use an offset in the canScroll method instead of an angle. I28694 b/417268474
  • Replaced addAnnotation in AnnotatedOutputTransformation with addStyle. I91c6f b/417991824
  • Stabilized LazyLayout. If5db4
  • Stabilized an empty constructor for LazyLayoutPrefetchState and it's scheduling method schedulePrecomposition and schedulePrecompositionAndPremeasure. I4362f b/252853717
  • Introduced ProcessTextKey on Android used for context menu items that's added for PROCESS_TEXT intent actions. If0ac4
  • Make context menu APIs public. Exposed Modifier.addTextContextMenuComponents and Modifier.filterTextContextMenuComponents to add and remove items in context menu. And also made the following elementary APIs public so that one can build a customized context menu:
    • TextContextMenuProvider
    • TextContextMenuDataProvider
    • TextContextMenuData
    • TextContextMenuComponent
    • LocalTextContextMenuDropdownProvider
    • LocalTextContextMenuToolbarProvider I1b7b0
  • Make LazyLayoutItemProvider stable Icce09 b/261565751
  • Introduced android smart selection features that can be enable/disabled via ComposeFoundationFlags.isSmartSelectionEnabled. It also exposed a static compositionLocal LocalTextClassifierCoroutineContext that can be used to specify the CoroutineContext in which the TextClassification job is launched. I1dbaa b/139321320

API Changes

  • SnapshotStateSet now implements Parcelable on Android, it is now supported to be used as part rememberSaveable { ... }. I755dd b/378623803
  • SnapshotStateList now implements Parcelable on Android, it is now supported to be used as part rememberSaveable { ... }. Id18be b/378623803
  • movableContentOf() is now marked with @RememberInComposition annotation, which allows lint to catch incorrect usages I2738d
  • Updated experimental composition observers API to allow for more comprehensive observation of recomposition causes I32b6a

Bug Fixes

  • Fixed an ordering issue with the dispatching of onForgotton that could, for example, cause the onDispose of disposable effects to execute in the wrong order. Ic1c91 b/417450712
  • Fix for for reusing state handling in pausable composition Ife96e b/404058957
  • Minor bug fix to make mutable collection detection compatible for both K1 and K2 Ie4878
  • Minor bug fix to make annotation lookup on overridden property accessors compatible for both K1 and K2 I9900d

External Contribution

  • Fixed a bug affecting Molecule users where using RecompositionMode.Immediate could cause missed recompositions. I9f3a9 b/419527812
  • Exposed PausableComposition isApplied and isCancelled getters which allow for checking the state of the PausableComposition. I994aa

API Changes

  • Added modifier APIs for customizable shadows. I2058d b/160665122
  • Add a SemanticsModifierNode.isImportantForBounds property that determines whether the node should be taken into account when computing bounds. The property is true by default and can be set to false to indicate that the node should not be taken into account for bounds. I7ebec
  • Add a SemanticsPropertyKey factory function for declaring Android-specific semantics properties that are made available as accessibility extras exposed via AccessibilityNodeInfo.getExtras. I2ed51
  • Removed usages of ComposeUiFlags.isRemoveFocusedViewFixEnabled and deprecated the flag. I50328
  • Introduce new customizable shadow framework. This includes DropShadowPainter and InnerShadowPainter as well as the DropShadow/InnerShadow dependencies. Shadow infrastructure is shared such that the same generated shadows can be shared at multiple callsites without having to re-generate the shadows n-times. I24f7a b/160665122
  • Introduce CompositeShader and CompositeShaderBrush which creates a composited result between two shaders. Also add ShaderBrush#transform to set a transformation matrix for the shader. I2621a b/160665122

Bug Fixes

  • Fixed a bug in NestedScrollInteropConnection where fling methods were being in the wrong order with respect to views. I56ad4
  • Previously, dialogs that drew full screen were not drawing within the display cutout region. This bug is fixed so that dialogs with decorFitsSystemWindows = false and usePlatformDefaultWidth = false can take the display cutout region. I9e975
  • Fixed a bug where TalkBack’s green focus indicator was not drawn after being turned on while the Compose app is in the background. Ifd12a

New Features

  • Emoji 16.0 data updates Ifc878
  • Adding “emoji” suffix to the content description

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 Id07e7 b/326456246

Bug Fixes

  • Fixed an issue where FragmentManager would crash while trying to save the state of Fragments that were added with setMaxLifecycle(Lifecycle.State.INITIALIZED). These fragments, since they never when through onCreate(), no longer have any state saved or onSaveInstanceState() called. I6e37a

Important changes since MediaRouter 1.7.0

  • Add new API to support connecting (and disconnecting) to routes without affecting the route selection.
  • Add new API that allows providers to take parameters when creating a controller.
  • Add new API for listening for changes in the list of bound MediaRouteProviderService clients.
  • New API to support stream expansion with route connection.
  • Update onRouteDisconnected callback with both disconnected and requested routes.

API Changes

  • Replace NavigationEventDispatcher's secondary constructor with default arguments. I716a0
  • Remove priority property from NavigationEventCallback. Pass priority to NavigationEventDispatcher.addCallback() instead. I13cae

Bug Fixes

  • Fixed a ConcurrentModificationException that could occur when NavigationEventCallback.remove() was called due to simultaneously modifying the internal list of closeables. b/420919815

New Features

  • The initial alpha release of androidx implementations of the Embedded PhotoPicker that enable both View based and Compose based applications to easily integrate with the Embedded Photopicker service.

API Changes

  • Added EmbeddedPhotopicker composable for as an entrypoint for compose based applications.
    • rememberEmbeddedPhotoPickerState can be used (recommended) or applications can implement their own state management with the EmbeddedPhotoPickerState interface.
  • Added EmbeddedPhotopickerView as an entrypoint for view based applications.
    • EmbeddedPhotoPickerStateChangeListener can be used to receive related callbacks to state inside the PhotoPicker.
  • Added TestEmbeddedPhotoPickerProvider to allow apps to test flows that rely on the Embedded Photopicker.

API Changes

  • OpenOnPhoneDialog now announces only the message text under TalkBack, and skips the icon semantics. The OpenOnPhoneDialogDefaults have been updated to remove the iconContentDescription and the contentDescription parameter from icon(). Also, ConfirmationDialogDefaults now has modifier parameters on SuccessIcon and FailureIcon composables. Id2ae2

Bug Fixes

  • Changed the order in which we apply the effect of SurfaceTransformation parameters. Before, the transformations applied to Wear Material3 components were done as follows: background painter, container transformation, content transformation. Now, the first 2 are inverted, and we apply any passed in modifier between them, so it is affected by container transformations. This fixes cases like using a placeholder shimmer effect with elements in a TLC using the transformation parameter. I786cf
  • RevealState.Saver was added to be used to restore the state of SwipeToReveal when activity or process is recreated. rememberRevealState function now uses this Saver by default. Ie0ecb
  • SwipeToReveal primary and secondary actions buttons should default to ButtonDefault.Height (fixed bug where these were filling the maximum height for taller buttons). Ibfba1
  • Changed SwipeToReveal to reset the last component interacted with, when the swipe right gesture is performed. Ia8450
  • SwipeToReveal was changed to settle on the Revealing state when the end position of the swipe is in between the revealing and revealed anchors, and is closer to the Revealing anchor. If4458
  • Now ButtonGroup's content is properly inverted in a RTL layout Ib378d
  • AnimatedText now supports RTL text direction I4533c
  • TransformingLazyColumn now resizes items correctly when the bottom item is removed Idacab
  • TransformingLazyColumn now makes just one measuring pass, which improves performance by reducing frame times. I501a1

API Changes

  • OpenOnPhoneDialog now announces only the message text under TalkBack, and skips the icon semantics. The OpenOnPhoneDialogDefaults have been updated to remove the iconContentDescription and the contentDescription parameter from icon(). Also, ConfirmationDialogDefaults now has modifier parameters on SuccessIcon and FailureIcon composables. Id2ae2

Bug Fixes

  • Changed the order in which we apply the effect of SurfaceTransformation parameters. Before, the transformations applied to Wear Material3 components were done as follows: background painter, container transformation, content transformation. Now, the first 2 are inverted, and we apply any passed in modifier between them, so it is affected by container transformations. This fixes cases like using a placeholder shimmer effect with elements in a TLC using the transformation parameter. I786cf
  • RevealState.Saver was added to be used to restore the state of SwipeToReveal when activity or process is recreated. rememberRevealState function now uses this Saver by default. Ie0ecb
  • SwipeToReveal primary and secondary actions buttons should default to ButtonDefault.Height (fixed bug where these were filling the maximum height for taller buttons). Ibfba1
  • Changed SwipeToReveal to reset the last component interacted with, when the swipe right gesture is performed. Ia8450
  • SwipeToReveal was changed to settle on the Revealing state when the end position of the swipe is in between the revealing and revealed anchors, and is closer to the Revealing anchor. If4458
  • Now ButtonGroup's content is properly inverted in a RTL layout Ib378d
  • AnimatedText now supports RTL text direction I4533c
  • TransformingLazyColumn now resizes items correctly when the bottom item is removed Idacab
  • TransformingLazyColumn now makes just one measuring pass, which improves performance by reducing frame times. I501a1

Important changes since 1.2.0

  • Material 3 design comes to the watch, with components and layouts that are optimized for the round display and scale appropriately from small to large screen sizes
    • This includes Kotlin-only, protolayout-material3 library with more Compose-like APIs for the following components and features:
    • Dynamic color theme coming from the system and watch face with the latest Material3 theme for colors, shapes and typography
    • MaterialScope for taking care of all opinionated defaults and easier customization
    • iconEdgeButton, textEdgeButton
    • iconButton, textButton, button, imageButton, avatarButton, compactButton
    • titleCard, appCard, graphicDataCard, iconDataCard, textDataCard
    • circularProgressIndicator, segmentedCircularProgressIndicator
    • primaryLayout, buttonGroup
    • All components work across any SDK levels and ProtoLayout Renderer version, supplying sensible fallbacks where applicable
  • More Kotlin-friendly, Compose-like APIs for base ProtoLayout elements
    • LayoutModifier with ability to add the most of modifiers as chained functions (padding, contentDescription (including clearSemantics), background, clip, opacity etc.), convertible to the existing Modifiers object
    • LayoutColors and LayoutString as types with easier support for using dynamic fields and constraints
    • text and fontStyle
    • better map support for StateBuilder, including DynamicDataMap and factory methods such as intAppDataKey for easier creation of AppDataKey objects
  • Lottie animations support including option to set different triggers on when animation should start, for example when layout is loaded or when layout becomes visible
    • Improved gradient support:
    • Linear gradient API as part of Brush that can be used in Background modifiers for elements such as Box, Spacer, etc. …
    • Allow dynamic color values in ColorStop used for linear and sweep gradient
    • Existing Sweep Gradient in arc objects now supports dynamic colors and start and end angles
  • Platform data binding in protolayout-expression to receive information anytime that layout’s visibility is changed, which for example can be use to hide certain parts of the layout while tile is being swiped to
  • Testing library - protolayout-testing - has been added to support easier Unit test coverage for any ProtoLayout elements
  • New element DashedArcLine with improved set of features so that line can have dashes, as opposed to the existing ArcLine
  • ArcSpacer support for setting its length in DP dimension instead of degrees
  • Added roundness FontSetting axis applicable to some fonts

Important changes since 1.4.0

  • Added new API TileService.onRecentInteractionEvents() for processing interaction tile events (Enter / Leave) in batches.
    • The existing APIs in TileService for onEnterEvent and onLeaveEvent are deprecated and won’t work from SDK 36+ for Apps targeting API 36 or more
  • Critical bug fix for any clients targeting SDK higher than 34 and requesting a tile update on API 34 that would cause a SecurityException.
  • Starting from Wear 6 (SDK level 36+), all Tiles will be displayed in a system font that is defined by each device.

Important changes since 1.13.0

  • Introducing the PaymentRequest API for invoking Android native payment apps through org.chromium.intent.action.PAY intent. PaymentRequest is disabled by default and WebView host apps can call WebSettingsCompat.setPaymentRequestEnabled(settings, true) to enable it. In addition, PaymentRequest requires a <queries> tag in AndroidManifest.xml. See documentation for setPaymentRequestEnabled() for more information.
  • Introducing the experimental Navigation API for enhanced web navigation tracking and management within WebView. These APIs provide detailed information about navigation events. Get started by calling WebViewCompat.setNavigationClient with an implementation of the new WebNaviagationClient interface to get detailed information about page navigation. For more information about the navigation lifecycle, please see the Life of a Navigation Presentation.