API Changes
- Accept
AppInteractionAttributioninExecuteAppFunctionRequestI70ad8 b/462092640
Bug Fixes
- Fix
AppFunctionUriGrantcompatibility issue on SDK37 I21110 b/485613578
API Changes
TrackingStateandVpsAvailabilityResulthave moved to theandroidx.xr.arcore package, and the types inandroidx.xr.runtimeare now deprecated. Ic7930 b/480462213- Renamed
Plane.TypetoPlaneType. I8c90c b/482675376 - Renamed
Hand.HandSidetoHandSide. Ica562 b/482675376 - Renamed
Plane.LabeltoPlaneLabel. Ic6b67 b/482675376 - Renamed
Geospatial.SurfacetoGeospatialSurface. I1a8be b/482675376 - Renamed
Geospatial.StatetoGeospatialState. I203fa b/482675376 - Moved
NativeDataAPI toxr:runtime:runtimelibrary. I87954 b/494251500 Session.createandSession.configureare now non-exhaustive and require else clauses in when statements. I9885e b/495805998 b/495805998androidx.xr.runtime.FieldOfViewhas been deprecated. Useandroidx.xr.runtime.math.FieldOfViewinstead. Ia01a0 b/480233045- Changed Orbiter to use either an
OrbiterAnchorPoint + VolumeOffsetor anOrbiterPoseProviderinstead of position, offset, offsetType, alignment, and elevation. Also removed theshouldRenderInNonSpatialparameter. If the developer does not want the orbiter to render in non-spatial they should wrap the orbiter in an if statement and check theSpatialCapabilities. I9fbb3 b/462428503 - Added movable modifiers. These modifiers work well, right now, for
SpatialPanelsandSpatialExternalSurface. Very soon they will also be supported forSpatialGltfModels. However, the intention is to have these supported well for allSubspaceComposables. I9a3cd b/479530787 b/478935063 b/478935063 - Developers are expected to observe the
ArDevice.stateFlow to monitorState.trackingStateand adjust their application's rendering or warnings accordingly based on the tracking fidelity. Ic00f0 b/445466590 - Renamed
HandJointTypeenum values. Ifbc83 b/482670596 - Renamed
FaceConfidenceRegionconstants. Ia62d5 b/482670596 - Renamed
FaceBlendShapeTypeconstants. I33b8b b/482670596 - Added
CreatePoseFromGeospatialPoseErrorInternalandCreateGeospatialPoseFromPoseErrorInternal. I4bcf1 b/482666615 - Renamed
DeviceTrackingMode.LAST_KNOWNtoSPATIAL_LAST_KNOWN(with a deprecated fallback), addedINERTIAL_LAST_KNOWNfor 3DoF tracking, and addedTRACKING_DEGRADEDtoTrackingState. Ie661c b/445466590 - Deprecated
GroupEntity. To have an Entity with only the base Entity functionality, callEntity.createwhich will return and Entity interface. I4c450 b/473867483 - Added
XrLogAPI. SetXrLog.isEnabledtotrueto enable logging in JetpackXR, and useXrLog.Levelto set the log level. I76a1f b/463460895 b/487378441
Bug Fixes
- Add the device tracking state support to the openxr devices. I91485 b/445466590
Bug Fixes
- Handle multi-user environments gracefully when moving files from the benchmark output directory to the additional test output directory. I90da5 b/489358149
Bug Fixes
- Fixed a compilation error "Cannot access class
ListenableFuture" when using CameraX 1.6.0. Ic8cba b/497571473
Bug Fixes
- Fixed an issue in
FlexBoxwhere items would not shrink correctly when exceeding the container bounds. Ia741d b/480797591
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
supportingTextas a trailing lambda forDropdownMenuItem. Instead move it to right after thetrailingIcon. I5694b b/503047115 - Promote
ToggleButtonsto stable. I8a771 b/497876827 - Promote expressive menu APIs. Remove
DropdownMenuItemsince 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
MaterialShapesandLoadingIndicatorpromotions 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
ModalBottomSheetwhereimePaddingwas applied unconditionally, preventing control over IME behavior viacontentWindowInsets. Ied801 b/289824811 - [FAB] Fix crash in
Modifier.animateFloatingActionButtoncaused 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
- Move scaffold order APIs back to experimental I01492 b/489424245
API Changes
- Added an overload to
SideEffectthat accepts key arguments. The new API can be used to fire one-shotSideEffectswithout the need for aLaunchedEffectorDisposableEffectwhoseCoroutineScopeoronDisposeblock are unused. I528b2 b/476108743
API Changes
- Introduces
MeshGradientModifier. 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
mediaQueryandderivedMediaQueryto return a generic type instead of aBoolean, allowing more flexible usage when building adaptive UIs. I93830 b/498698350
API Changes
- Deprecate
BuildCompat.isAtLeastB*. Callers should checkSDK_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) incore-telecomthat 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_CONNECTpermission is denied. Iec271 b/499302063
External Contribution
- Add
TextAttributeCompatas a backwards compatible variant ofTextAttribute. Ib4a46 b/460301602
API Changes
- Make
ReThrowCorruptionHandlerpublic. I137bb b/427722902 - Make tracing lifecycle consistent with system tracing. Ib391b
API Changes
- We have added
ExperimentalGlanceWearApiwhich 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
- Introduce Glimmer Pager API I2d830 b/481670271
- Added
ToggleButtonandIconToggleButtonAPIs I2656b Ib1667 b/481299196 b/481663547
Notable:
- Relax swimming pool length requirement to just when you request distance 2dc7a2e
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
SceneCoreEntityto render glTFs should ensure that they are passingsession.scene.activitySpaceto theparentparameter of theirGltfModel.createcall to ensure that their glTFs will render. - Adding
SpatialGltfModelAPI 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
SceneCoreEntitySizeAdapterfrom class to interface I5a784 b/475292310 - Renamed
SurfaceProtectiontoSpatialExternalSurfaceProtection. UpdatedSpatialExternalSurfacekdocs Ifad0a b/485231082 - Deprecate
currentWindowAdaptiveInfoand introduce V2 of it I40ecf b/424442112 - The
resizablemodifier is now public and applicable to groups (e.g.SpatialRow). I2bcf6 b/348483527 b/489753178 b/479530787 - The
movablemodifier is now public. This modifier work well, right now, forSpatialPanelsandSpatialExternalSurface; however, the intention is to have these supported well for allSubspaceComposables. I9a3cd b/479530787 b/478935063 b/478935063 SpatialEnterTransitionandSpatialExitTransitionmarked as@ImmutableIf1710 b/487757837- The
SpatialGltfModelAPI is marked as restricted for this release pending additional testing. Ibf003 b/466090694 - Renamed
DeviceTrackingMode.LAST_KNOWNtoSPATIAL_LAST_KNOWN(with a deprecated fallback), addedINERTIAL_LAST_KNOWNfor 3DoF tracking, and addedTRACKING_DEGRADEDtoTrackingState. Ie661c b/445466590 - Removing deprecated
SpatialLayoutSpacerI7b36c - Removing deprecated padding API If1886
- Added
floatRangeto bias values. Removed default value forLayoutDirectionI9d74e
Bug Fixes
- Added code samples and KDoc documentation for
SpatialColumn,SpatialRow, andSpatialCurvedRow. Iaf54f b/495777633
API Changes
TrackingStateandVpsAvailabilityResulthave moved to theandroidx.xr.arcore package, and the types inandroidx.xr.runtimeare now deprecated. Ic7930 b/480462213- Renamed
Plane.TypetoPlaneType. I8c90c b/482675376 - Renamed
Plane.LabeltoPlaneLabel. Ic6b67 b/482675376 androidx.xr.runtime.FieldOfViewhas been deprecated. Useandroidx.xr.runtime.math.FieldOfViewinstead. Ia01a0 b/480233045Matrix4.posehas been renamed toMatrix4.toPose(). The pose property is now deprecated. I329b4 b/493383490- Renamed
HandJointTypeenum values. Ifbc83 b/482670596 - Expose
Component.onAttachandonDetachas public API to allow customComponentimplementations. I0ca1f - Adding spatial audio components I39ddd b/489421980 b/436642086 b/436642499
- Remove Entity from
PointSourceParams. Instead the Entity will be used directly withSpatialAudioTrack,SpatialSoundPool, andSpatialMediaPlayerIb3685 b/489421980 b/436634048 - Renamed
DeviceTrackingMode.LAST_KNOWNtoSPATIAL_LAST_KNOWN(with a deprecated fallback), addedINERTIAL_LAST_KNOWNfor 3DoF tracking, and addedTRACKING_DEGRADEDtoTrackingState. Ie661c b/445466590 - Deprecated
GroupEntity. To have an Entity with only the base Entity functionality, callEntity.createwhich will return and Entity interface. I4c450 b/473867483 - Added
XrLogAPI. SetXrLog.isEnabledtotrueto enable logging in JetpackXR, and useXrLog.Levelto set the log level. I76a1f b/463460895 b/487378441
Bug Fixes
Scene.keyEntitynow defaults tomainPanelEntity. I6a3ef
Important changes since 1.7.0:
- Deprecate
androidx.media. Use androidx.media3 instead.
Bug Fixes
- Improved
NavHostto bolster against possibleNullPointerExceptions caused by a race condition with predictive back. Ie36c6 b/500945998
Bug Fixes
- Removed the no-op
NavigationEventHandlerwhen in inspection mode to enable Predictive Back in Android Studio Previews.
Important changes since 3.4.0:
Added
Flow<PagingData>.asItemSnapshotListFlowoperator to convertFlow<PagingData>into aFlow<ItemSnapshotList>. This means loaded data can now be accessed outside of the UI layer, allowing you to combineFlow<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.appendandPager.prependto manually load more data without scrolling.Added extension functions
Pager.refreshandPaging.retryto recover from load errors when usingasItemSnapshotListFlowAPI.
Features
- Add
EnforceCleanRecompositionflag I6e4408. As a step towards supporting recomposition inRemoteCompose, 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 settingisEnforceCleanRecompositionEnabledtofalse.
API Changes
- A testing library for Remote Compose is added. I78746 b/504687418
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
SensorManagerI1fc947 b/498302479 - Fix
TIME_FROMexpressions 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()andsetMultipleConnectionPool()can be used to control the maximum amount of connection Room will open to the database. I9700d b/438041176 b/432820350 - Remove Room's
DatabaseConfigurationfrom 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
onValidateSchemathat 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 optionroom.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
ListenableFuturesupport forSecurityPatchStateandUpdateInfoService. b91f15ae
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
GestureIndicatorsize inAlertDialogsI0c16e b/504912009 - Adjusted
LeftRevealed/RightRevealedanchors ofSwipeToRevealfor out-of-bounds revealed positioning. Id84ff b/498681589 - Add state description to
CheckboxandSwitchIba12e b/485098874 - Fixed a visual bug in
FadingExpandingLabelwhere old text would flash when the number of lines decreased. Ia40c9 b/503709020 - Add default one-handed gesture support to
Material3 AlertDialogI5848e b/479098589 - Built-in visibility logic in one-handed has been removed I8c602 b/502903320
API Changes
- Modifier clickable changed to not accept null value for action parameter.
Action.Emptyshould be used instead. I21be9 b/498881738 - Modifier
clickable(varargs action)was changed toclickable(action). UseCombinedActionfor a list of actions. I8432d b/498881738
API Changes
- Added
CINNAMON_BUNinWearApiVersionHelperfor 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
startUpWebViewAPI and related async startup configuration APIs inProcessGlobalConfigandWebViewStartUpConfighave 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 ofstartUpWebViewhas been deprecated, and users should migrate to the new version, which takes aWebViewOutcomeReceiverto facilitate failure callbacks. - The navigation APIs, including
WebViewCompat\#addNavigationListener,NavigationListener,Navigation, andPagehave been graduated to stable. These APIs let app developers receive callbacks from WebView during the different stages of page navigation through theNavigationListenerinterface. 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. TheNavigationandPageobjects serve as unique identifiers that serve as the link between the different callbacks when multiple WebViews or navigations might be happening concurrently. TheNavigationobject 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 thePageobject provides the specific URL. WebViewCompat\#saveStateextends theWebView\#saveStatemethod 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 withWebView\#restoreState- This version of the library introduces
WebViewOutcomeReceiveras a library-specific implementation ofandroid.os.OutcomeReceiver, which allows this library to provide a similar mechanism for asynchronous callback result handling without a need to depend on highertargetSdkvalues. This class was namedandroidx.webkit.OutcomeReceiverCompatwhile in experimental status but has been renamed to avoid any name clashes. External Contribution: New APIs were introduced to inject persistent
JavaScriptas part of the document loaded event (WebViewCompat#addJavaScriptOnEvent), injectJavaScriptandWebMessageListenersinto isolated worlds to prevent collisions with existing pageJavaScript, and executeJavaScriptas a response to a web message (JavaScriptReplyProxy#executeJavaScript).Experimental APIs added since 1.15.0
Added
WebViewBuilder.applyToAPI for applying builder configurations to pre-constructedWebViews. This lets you use the configuration capabilities of theWebViewBuilderAPI, and the corresponding guarantees that settings won't change, with pre-existingWebViewobjects. This is intended to be used withWebViewinstances created from layout inflation, or with subclasses ofWebView.
Experimental APIs updated since 1.15.0
- The
BackForwardCacheSettingsobject has been changed from a configuration object that is provided throughWebSettingsCompatto a live object that can be obtained by calling WebSettingsCompat#getBackForwardCacheSettings. The object now has setter methods that update the settings directly. The previousBuildernested class has been removed, as hasWebSettingsCompat#setBackForwardCacheSettings.Apps that previously used these methods will experience build errors when upgrading. Profile#setSpeculativeLoadingConfigis deprecated. UseProfile#setMaxPrerenders,PrefetchCache#setMaxPrefetches, andPrefetchCache#setPrefetchTtlSecondsinstead.- Removed
Profile#clearPrefetchAsyncas it was a no-op. - Changed the return type of
StartUpLocation.getStackInformation()fromStringtoThrowableto allow apps to process the information better.
API Changes
TrackingStateandVpsAvailabilityResulthave moved to theandroidx.xr.arcore package, and the types inandroidx.xr.runtimeare now deprecated. Ic7930 b/480462213Session.getNativeData()is now defined thexr:runtime:runtimemodule and provides [nativeFunctionTablePointer] for OpenXR-backed runtimes. Ifa862- Moved
NativeDataAPI toxr:runtime:runtimelibrary. I87954 b/494251500 Session.createandSession.configureare now non-exhaustive and require else clauses in when statements. I9885e b/495805998 b/495805998androidx.xr.runtime.FieldOfViewhas been deprecated. Useandroidx.xr.runtime.math.FieldOfViewinstead. Ia01a0 b/480233045Matrix4.posehas been renamed toMatrix4.toPose(). The pose property is now deprecated. I329b4 b/493383490- Added the
XrServiceAvailabilityAPI If379e b/493558010 - Added the
ExperimentalXrServiceAvailabilityApiannotation Icab49 b/491069725 - Remove the suffix for
@PreviewSpatialApiIf5242 b/491939311 - Renamed
DeviceTrackingMode.LAST_KNOWNtoSPATIAL_LAST_KNOWN(with a deprecated fallback), addedINERTIAL_LAST_KNOWNfor 3DoF tracking, and addedTRACKING_DEGRADEDtoTrackingState. Ie661c b/445466590 - Added
XrLogAPI. SetXrLog.isEnabledtotrueto 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