May 6, 2026

API Changes

  • TrackingState and VpsAvailabilityResult have moved to the androidx.xr.arcore package, and the types in androidx.xr.runtime are now deprecated. Ic7930 b/480462213
  • Renamed Plane.Type to PlaneType. I8c90c b/482675376
  • Renamed Hand.HandSide to HandSide. Ica562 b/482675376
  • Renamed Plane.Label to PlaneLabel. Ic6b67 b/482675376
  • Renamed Geospatial.Surface to GeospatialSurface. I1a8be b/482675376
  • Renamed Geospatial.Stateto GeospatialState. I203fa b/482675376
  • Moved NativeData API to xr:runtime:runtime library. I87954 b/494251500
  • Session.create and Session.configure are now non-exhaustive and require else clauses in when statements. I9885e b/495805998 b/495805998
  • androidx.xr.runtime.FieldOfView has been deprecated. Use androidx.xr.runtime.math.FieldOfView instead. Ia01a0 b/480233045
  • Changed Orbiter to use either an OrbiterAnchorPoint + VolumeOffset or an OrbiterPoseProvider instead of position, offset, offsetType, alignment, and elevation. Also removed the shouldRenderInNonSpatial parameter. If the developer does not want the orbiter to render in non-spatial they should wrap the orbiter in an if statement and check the SpatialCapabilities. I9fbb3 b/462428503
  • Added movable modifiers. These modifiers work well, right now, for SpatialPanels and SpatialExternalSurface. Very soon they will also be supported for SpatialGltfModels. However, the intention is to have these supported well for all SubspaceComposables. I9a3cd b/479530787 b/478935063 b/478935063
  • Developers are expected to observe the ArDevice.state Flow to monitor State.trackingState and adjust their application's rendering or warnings accordingly based on the tracking fidelity. Ic00f0 b/445466590
  • Renamed HandJointType enum values. Ifbc83 b/482670596
  • Renamed FaceConfidenceRegion constants. Ia62d5 b/482670596
  • Renamed FaceBlendShapeType constants. I33b8b b/482670596
  • Added CreatePoseFromGeospatialPoseErrorInternal and CreateGeospatialPoseFromPoseErrorInternal. I4bcf1 b/482666615
  • Renamed DeviceTrackingMode.LAST_KNOWN to SPATIAL_LAST_KNOWN (with a deprecated fallback), added INERTIAL_LAST_KNOWN for 3DoF tracking, and added TRACKING_DEGRADED to TrackingState. Ie661c b/445466590
  • Deprecated GroupEntity. To have an Entity with only the base Entity functionality, call Entity.create which will return and Entity interface. I4c450 b/473867483
  • Added XrLog API. Set XrLog.isEnabledto true to enable logging in JetpackXR, and use XrLog.Level to set the log level. I76a1f b/463460895 b/487378441

Bug Fixes

New Features

  • Typography now supports a default font family that will be merged with provided text styles if they don't have a font family explicitly set. I2e305 b/500356360

API Changes

  • Removes supportingText as a trailing lambda for DropdownMenuItem. Instead move it to right after the trailingIcon. I5694b b/503047115
  • Promote ToggleButtons to stable. I8a771 b/497876827
  • Promote expressive menu APIs. Remove DropdownMenuItem since it is a deprecated experimental expressive API that was a part of a 1.5.0-alpha. I1d556 b/497885285
  • Graduate FAB and FAB Menu APIs from Experimental Expressive Ie509c b/497892373
  • Promote expressive button APIs. Remove the deprecated experimental API SmallButtonContentPaddingwhich was introduced in a 1.5.0-alpha. Iee31e b/497873833
  • Move scaffold order APIs back to experimental I01492 b/489424245
  • Add another Typography consturctor overload I8b3b3 b/500356360
  • Revert MaterialShapes and LoadingIndicator promotions to stable. I30e69 b/497876695 b/497877850

Bug Fixes

  • Fix bug in slider's implementation that caused padding from the inset focus rings to be applied to the track and thumb when the component is not in focus. I16315 b/506158497
  • Fixed an issue in ModalBottomSheet where imePadding was applied unconditionally, preventing control over IME behavior via contentWindowInsets. Ied801 b/289824811
  • [FAB] Fix crash in Modifier.animateFloatingActionButton caused by density int vs float rounding I2d25f b/489769219
  • Fix focus getting trapped inside the date range picker. Tabbing moves focus in and out the dates, and arrow keys move focus through the dates. I7f3ea b/498332749
  • Revert medium and large buttons changes for precision pointer mode, and dialog's default icon size also for precision pointer mode I58d8c b/496938250 b/500356640
  • Fixed keyboard focus getting trapped in non dialog date picker. Also fixed focus order of dismiss and confirm buttons not following their visual order. Ibbe2e b/500454457

API Changes

  • Added an overload to SideEffect that accepts key arguments. The new API can be used to fire one-shot SideEffects without the need for a LaunchedEffect or DisposableEffect whose CoroutineScope or onDispose block are unused. I528b2 b/476108743

API Changes

  • Introduces MeshGradient Modifier. Ia9a08 b/455752719
  • Removes built-in autofill debug logging callbacks. The same functionality can be achieved by logging from AutofillManager.AutofillCallback. I631c7 b/502279690
  • Support variation settings for downloadable fonts Ic25c7 b/496278020
  • Updated mediaQuery and derivedMediaQuery to return a generic type instead of a Boolean, allowing more flexible usage when building adaptive UIs. I93830 b/498698350

API Changes

  • Deprecate BuildCompat.isAtLeastB*. Callers should check SDK_INT(_FULL) directly instead I09666 b/505015815

Bug Fixes

  • Fixed a test failure in CallSessionTeston Android 17 (SDK 37) by suppressing version-specific bug mitigation tests on unaffected platform versions. I970a7 b/502732317
  • 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) in core-telecom that 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_CONNECT permission is denied. Iec271 b/499302063

External Contribution

  • Add TextAttributeCompat as a backwards compatible variant of TextAttribute. Ib4a46 b/460301602

API Changes

  • We have added ExperimentalGlanceWearApi which will be used for experimental Glance Wear features. Id2f76 b/498179813

Bug Fixes

  • Updated the parser for Wear Widget XML metadata to be aware of widgets during boot.

API Changes

  • The Orbiter API is pending additional changes, we recommend suppressing the deprecation notices for Orbiters and keeping an eye out for Orbiter changes in upcoming releases.
  • Those using SceneCoreEntity to render glTFs should ensure that they are passing session.scene.activitySpace to the parent parameter of their GltfModel.create call to ensure that their glTFs will render.
  • Adding SpatialGltfModel API to allow developers to add Gltfs to their Compose For XR apps. Developers can also query animations and nodes inside their Gltf models. I8b542 b/495422586
  • Changes SceneCoreEntitySizeAdapter from class to interface I5a784 b/475292310
  • Renamed SurfaceProtection to SpatialExternalSurfaceProtection. Updated SpatialExternalSurface kdocs Ifad0a b/485231082
  • Deprecate currentWindowAdaptiveInfo and introduce V2 of it I40ecf b/424442112
  • The resizable modifier is now public and applicable to groups (e.g. SpatialRow). I2bcf6 b/348483527 b/489753178 b/479530787
  • The movable modifier is now public. This modifier work well, right now, for SpatialPanels and SpatialExternalSurface; however, the intention is to have these supported well for all SubspaceComposables. I9a3cd b/479530787 b/478935063 b/478935063
  • SpatialEnterTransition and SpatialExitTransition marked as @Immutable If1710 b/487757837
  • The SpatialGltfModel API is marked as restricted for this release pending additional testing. Ibf003 b/466090694
  • Renamed DeviceTrackingMode.LAST_KNOWN to SPATIAL_LAST_KNOWN (with a deprecated fallback), added INERTIAL_LAST_KNOWN for 3DoF tracking, and added TRACKING_DEGRADED to TrackingState. Ie661c b/445466590
  • Removing deprecated SpatialLayoutSpacer I7b36c
  • Removing deprecated padding API If1886
  • Added floatRange to bias values. Removed default value for LayoutDirection I9d74e

Bug Fixes

  • Added code samples and KDoc documentation for SpatialColumn, SpatialRow, and SpatialCurvedRow. Iaf54f b/495777633

API Changes

  • TrackingState and VpsAvailabilityResult have moved to the androidx.xr.arcore package, and the types in androidx.xr.runtime are now deprecated. Ic7930 b/480462213
  • Renamed Plane.Type to PlaneType. I8c90c b/482675376
  • Renamed Plane.Label to PlaneLabel. Ic6b67 b/482675376
  • androidx.xr.runtime.FieldOfView has been deprecated. Use androidx.xr.runtime.math.FieldOfView instead. Ia01a0 b/480233045
  • Matrix4.pose has been renamed to Matrix4.toPose(). The pose property is now deprecated. I329b4 b/493383490
  • Renamed HandJointType enum values. Ifbc83 b/482670596
  • Expose Component.onAttach and onDetach as public API to allow custom Component implementations. I0ca1f
  • Adding spatial audio components I39ddd b/489421980 b/436642086 b/436642499
  • Remove Entity from PointSourceParams. Instead the Entity will be used directly with SpatialAudioTrack, SpatialSoundPool, and SpatialMediaPlayer Ib3685 b/489421980 b/436634048
  • Renamed DeviceTrackingMode.LAST_KNOWN to SPATIAL_LAST_KNOWN (with a deprecated fallback), added INERTIAL_LAST_KNOWN for 3DoF tracking, and added TRACKING_DEGRADED to TrackingState. Ie661c b/445466590
  • Deprecated GroupEntity. To have an Entity with only the base Entity functionality, call Entity.create which will return and Entity interface. I4c450 b/473867483
  • Added XrLog API. Set XrLog.isEnabled to true to enable logging in JetpackXR, and use XrLog.Level to set the log level. I76a1f b/463460895 b/487378441

Bug Fixes

  • Scene.keyEntity now defaults to mainPanelEntity. I6a3ef

Bug Fixes

  • Removed the no-op NavigationEventHandler when in inspection mode to enable Predictive Back in Android Studio Previews.

Important changes since 3.4.0:

  • Added Flow<PagingData>.asItemSnapshotListFlow operator to convert Flow<PagingData> into a Flow<ItemSnapshotList>. This means loaded data can now be accessed outside of the UI layer, allowing you to combine Flow<ItemSnapshotList> with other data sources, cache and modify paged data locally, or expose paged data as part of a UI state and more.

  • Added extension functions Pager.append and Pager.prepend to manually load more data without scrolling.

  • Added extension functions Pager.refresh and Paging.retry to recover from load errors when using asItemSnapshotListFlow API.

Features

  • Add EnforceCleanRecomposition flag I6e4408. As a step towards supporting recomposition in RemoteCompose, we have prevented anything from writing to the document before the composition has finished. This prevents documents from being partially written during recomposition. If this behavior causes issues with existing code, it can be disabled by setting isEnforceCleanRecompositionEnabled to false.

API Changes

Bug Fixes

  • Fix background clipping when using a RemoteColor (instead of static color) as the background color If70842 b/505116577
  • Support providing an explicit size for bitmaps loaded from URI. Previously the size would be calculated as 1x1, and that pixel would be scaled to the container size Id4fff b/487936996
  • Prevent crash bug on devices that don't have SensorManager I1fc947 b/498302479
  • Fix TIME_FROM expressions not using the provided clock (preventing reliable tests for duration expressions) I5f816 b/501405389

API Changes

  • Add APIs to configure Room's connection pool. The builder functions setSingleConnectionPool() and setMultipleConnectionPool() can be used to control the maximum amount of connection Room will open to the database. I9700d b/438041176 b/432820350
  • Remove Room's DatabaseConfiguration from public API since no other public API referenced the config. I5f1e9 b/438041176

Bug Fixes

  • Restrict Web targets to use a single connection pool to avoid 'database locked' issues that arise with OPFS b/496255935.
  • Attempt to fix (again) a 'Method too large' error that occurs due to Room generating a onValidateSchema that is too large. The function is split based on the amount of statements, but the measuring is not precise. If you still encounter this error you can adjust the amount of statements Room will count towards a split via the annotation processor option room.validationSplitSize. The default value is currently set to 300 statements, therefore use a lower number if the issue is still present b/493708172.

API Changes

  • Added ListenableFuture support for SecurityPatchState and UpdateInfoService. b91f15ae

Bug Fixes

  • Fixed kernel version branch comparison in isDeviceFullyUpdated(). 164b537

API Changes

  • Add a API to obtain a stub tracer that can be used when tracing is disabled. I84c98
  • Make tracing lifecycle consistent with system tracing. Ib391b
  • Counter APIs are now entirely allocation free. I5e73a

Bug Fixes

  • Fixed a keep rule for the Perfetto SDK (tracing-perfetto) which ensures that the Perfetto SDK can be enabled. I1d227
  • Add the ability to trace flush() events. I38014 b/495852704

Bug Fixes

  • Fixed GestureIndicator size in AlertDialogs I0c16e b/504912009
  • Adjusted LeftRevealed/RightRevealed anchors of SwipeToReveal for out-of-bounds revealed positioning. Id84ff b/498681589
  • Add state description to Checkbox and Switch Iba12e b/485098874
  • Fixed a visual bug in FadingExpandingLabel where old text would flash when the number of lines decreased. Ia40c9 b/503709020
  • Add default one-handed gesture support to Material3 AlertDialog I5848e b/479098589
  • Built-in visibility logic in one-handed has been removed I8c602 b/502903320

API Changes

  • Added CINNAMON_BUN in WearApiVersionHelper for API compatibility checks against the SDK 37.

Important changes since 1.15.0:

The 1.16.0 stable release brings multiple APIs out of experimental status, significantly improving stability and developer experience for features like async WebView startup and navigation listening.
The minimum supported SDK (minSdk) for this library has been increased to 24.

  • The startUpWebView API and related async startup configuration APIs in ProcessGlobalConfig and WebViewStartUpConfig have been graduated from experimental to stable. These APIs let applications trigger WebView startup earlier, ensuring portions of the startup run in the background to improve responsiveness. The previous version of startUpWebView has been deprecated, and users should migrate to the new version, which takes a WebViewOutcomeReceiver to facilitate failure callbacks.
  • The navigation APIs, including WebViewCompat\#addNavigationListener, NavigationListener, Navigation, and Page have been graduated to stable. These APIs let app developers receive callbacks from WebView during the different stages of page navigation through the NavigationListener interface. This also includes the option to receive performance metrics from the page, which makes it easier for app developers to measure performance of first-party pages in their apps. The Navigation and Page objects serve as unique identifiers that serve as the link between the different callbacks when multiple WebViews or navigations might be happening concurrently. The Navigation object also provides more information about the specific nature of the ongoing navigation, including how it was started, and whether it succeeded or resulted in an error page, while the Page object provides the specific URL.
  • WebViewCompat\#saveState extends the WebView\#saveState method with more controls that allow developers to specify a maximum size for the state and whether forward history entries should be included. The saved state object is still compatible with WebView\#restoreState
  • This version of the library introduces WebViewOutcomeReceiver as a library-specific implementation of android.os.OutcomeReceiver, which allows this library to provide a similar mechanism for asynchronous callback result handling without a need to depend on higher targetSdk values. This class was named androidx.webkit.OutcomeReceiverCompat while in experimental status but has been renamed to avoid any name clashes.
  • External Contribution: New APIs were introduced to inject persistent JavaScript as part of the document loaded event (WebViewCompat#addJavaScriptOnEvent), inject JavaScript and WebMessageListeners into isolated worlds to prevent collisions with existing page JavaScript, and execute JavaScript as a response to a web message (JavaScriptReplyProxy#executeJavaScript).

    Experimental APIs added since 1.15.0

  • Added WebViewBuilder.applyTo API for applying builder configurations to pre-constructed WebViews. This lets you use the configuration capabilities of the WebViewBuilder API, and the corresponding guarantees that settings won't change, with pre-existing WebView objects. This is intended to be used with WebView instances created from layout inflation, or with subclasses of WebView.

Experimental APIs updated since 1.15.0

  • The BackForwardCacheSettings object has been changed from a configuration object that is provided through WebSettingsCompat to a live object that can be obtained by calling WebSettingsCompat#getBackForwardCacheSettings. The object now has setter methods that update the settings directly. The previous Builder nested class has been removed, as has WebSettingsCompat#setBackForwardCacheSettings. Apps that previously used these methods will experience build errors when upgrading.
  • Profile#setSpeculativeLoadingConfig is deprecated. Use Profile#setMaxPrerenders, PrefetchCache#setMaxPrefetches, and PrefetchCache#setPrefetchTtlSeconds instead.
  • Removed Profile#clearPrefetchAsync as it was a no-op.
  • Changed the return type of StartUpLocation.getStackInformation() from String to Throwable to allow apps to process the information better.

API Changes

  • TrackingState and VpsAvailabilityResult have moved to the androidx.xr.arcore package, and the types in androidx.xr.runtime are now deprecated. Ic7930 b/480462213
  • Session.getNativeData() is now defined the xr:runtime:runtime module and provides [nativeFunctionTablePointer] for OpenXR-backed runtimes. Ifa862
  • Moved NativeData API to xr:runtime:runtime library. I87954 b/494251500
  • Session.create and Session.configure are now non-exhaustive and require else clauses in when statements. I9885e b/495805998 b/495805998
  • androidx.xr.runtime.FieldOfView has been deprecated. Use androidx.xr.runtime.math.FieldOfView instead. Ia01a0 b/480233045
  • Matrix4.pose has been renamed to Matrix4.toPose(). The pose property is now deprecated. I329b4 b/493383490
  • Added the XrServiceAvailability API If379e b/493558010
  • Added the ExperimentalXrServiceAvailabilityApi annotation Icab49 b/491069725
  • Remove the suffix for @PreviewSpatialApi If5242 b/491939311
  • Renamed DeviceTrackingMode.LAST_KNOWN to SPATIAL_LAST_KNOWN (with a deprecated fallback), added INERTIAL_LAST_KNOWN for 3DoF tracking, and added TRACKING_DEGRADED to TrackingState. Ie661c b/445466590
  • Added XrLog API. Set XrLog.isEnabled to true to enable logging in JetpackXR, and use [XrLog.Level] to set the log level. I76a1f b/463460895 b/487378441
  • Adding DISPLAY_CATEGORY_XR_PROJECTED, this constant is used in the Manifest file to indicate the activity is meant for a XR projected display I26d8b