New Features
The Jetpack Compose Agent-to-UI (A2UI) renderer provides an implementation of the A2UI protocol, enabling AI agents to generate rich, interactive user interfaces that render native Compose components—without executing arbitrary code. This library performs protocol message parsing, schema validation, and provides foundational APIs for building UI renderers.
API Changes
- Added
acceptsUnresolvedArgumentstoA2uiFunctionDefinitionandgetFunctionDefinitiontoA2uiExecutionContextto allow functions likerequiredto execute when data bindings cannot be resolved. I74d9f b/547851648 - Added
A2uiFunctionArgParser.getEpochMillisArgand updatedformatDateto support ISO 8601 date-time strings and epoch timestamps. Id04ec - Added
A2uiClientCapabilitiesandclientCapabilitiestoA2uiCoreMessageProcessorto support A2UI capabilities advertisement. Ia3316 b/532000711 - Add
A2uiMessageParser,A2uiJsonMessageParserandA2uiJsonReaderI52762 b/537133532 - Add
createBasicCatalogFunctionsI1f003 b/527907617 - Add
A2uiFormatStringFunction. Add support for component-level caching for functions throughA2uiExecutionContextId4da7 b/527907617 - Added
A2uiExecutionContextinterface and its implementationA2uiCoreExecutionContext. Added method for payload evaluation inA2uiSurfaceModel. I7957c b/531999707 - Add
A2uiCoreDynamicResolverinterface Ic84f8 b/531999707 - Added A2UI's basic catalog functions except for
FormatStringIed352 b/527907617 - Created interfaces for
A2uiCoreCatalog,A2uiCoreComponentDefinition,A2uiFunctionDefinitionandA2uiFunctionI9916d b/527821290 - Initialize an artifact for the runtime layer of the Compose A2UI renderer. I8be68 b/524122705
- rename a2ui module to a2ui-core Ia286d
Bug Fixes
- Updated
A2uiMessageFormatterdocumentation to clarify argument mismatch behavior. I2efad
New Features
The Jetpack Compose Agent-to-UI (A2UI) renderer provides an implementation of the A2UI protocol, enabling AI agents to generate rich, interactive user interfaces that render native Compose components—without executing arbitrary code. This library maps the A2UI protocol messages to Compose primitives while providing fine-grained reactivity based on the Compose Snapshot state system. The library also provides APIs for creating custom components and catalogs.
API Changes
- Updated
A2uiBasicCatalogV1.CatalogIdfrom.../v0_9_1/...to.../v0_9/...to align with the canonical A2UI protocol specification. Idcc20 - Update the order of components in
A2uiBasicCatalogVto exactly match the basic catalog specification. I23093 b/547851648 - Added
ChecksPropertyto all relevant component interfaces underA2uiBasicCatalogV1and made the property value available via a parameter passed toTypedContentof each component. I9f393 b/547851648 - Added
A2uiBasicCatalogV1.ChoicePickerandMaterialA2uiBasicCatalogV1Defaults.choicePicker. I875a6 b/547851648 - Added
A2uiBasicCatalogV1.ModalandMaterialA2uiBasicCatalogV1Defaults.modal. Icd553 b/547851648 - Renamed properties in
A2uiBasicCatalogV1to follow the pascal-case naming style. I91512 b/547851648 - Added
AccessibilityPropertyto all component interfaces underA2uiBasicCatalogV1and made the property value available via a parameter passed toTypedContentof each component. I76b80 b/547851648 - Added
A2uiBasicCatalogV1.TextFieldandMaterialA2uiBasicCatalogV1Defaults.textField. Ifdaec b/547851648 - Added
A2uiBasicCatalogV1.VideoandMaterialA2uiBasicCatalogV1Defaults.video. I8595c b/547851648 - Added
A2uiBasicCatalogV1.AudioPlayerandMaterialA2uiBasicCatalogV1Defaults.audioPlayer. Ida509 b/547851648 - Added support for
formatand conditionalif-thenschema keywords ina2ui-modelanda2ui-engine, and updatedA2uiBasicCatalogV1.DateTimeInputmin and max property schemas. I556d5 b/553193771 - Added
A2uiBasicCatalogV1.SliderandMaterialA2uiBasicCatalogV1Defaults.slider. Ieb72d b/547851648 - Added
A2uiBasicCatalogV1.CheckBoxandMaterialA2uiBasicCatalogV1Defaults.checkBox. I84525 b/547851648 - Added
A2uiBasicCatalogV1.DividerandMaterialA2uiBasicCatalogV1Defaults.divider. I91208 b/547851648 - Added
A2uiBasicCatalogV1.TabsandMaterialA2uiBasicCatalogV1Defaults.tabs. Ic33d3 b/547851648 - Added
A2uiBasicCatalogV1.ListandMaterialA2uiBasicCatalogV1Defaults.list. I89f73 b/547851648 - Added
A2uiBasicCatalogV1.IconandMaterialA2uiBasicCatalogV1Defaults.icon. I65524 b/547851648 - Added
ProvideActionInterceptorfor intercepting actions of child components. I6ae69 b/552486965 - Added support for advertising inline catalog schemas in
A2uiClientCapabilitiesandA2uiCoreCatalog. I973cf b/537714970 - Added
A2uiBasicCatalogV1.ImageandMaterialA2uiBasicCatalogV1Defaults.image. I673b3 b/547851648 - Added
A2uiBasicCatalogV1.ButtonandMaterialA2uiBasicCatalogV1Defaults.button. I5215f b/547851648 - Added
A2uiBasicCatalogV1.Row/A2uiBasicCatalogV1.ColumnandMaterialA2uiBasicCatalogV1Defaults.row/MaterialA2uiBasicCatalogV1Defaults.column. Ibcbe7 b/547851648 - Added
defaultparameters to the enum, number, and booleanA2uiPropertytypes. Id509e b/547851648 - Added
A2uiBasicCatalogV1.CardandMaterialA2uiBasicCatalogV1Defaults.card. Icf604 b/547851648 - Added
isAdditionalPropertiesAllowedandadditionalPropertiesSchemaparameters toA2uiProperty.nestedandA2uiProperty.nestedList. I72836 b/547815898 - Added
minItemsandmaxItemsparameters to the listA2uiPropertytypes. I716d3 b/547798330 - Added
A2uiProperty.enum,A2uiProperty.custom, andA2uiProperty.dynamicCustomproperty types. I0647d b/545522395 - Replace
A2uiCoreSurfaceModelwithA2uiSurfaceModelinobserveA2uiComponentStateto ensure that the public APIs inandroidx.a2ui.compose.runtimedon't expose types fromandroidx.a2ui.engine. Ic45e2 b/544705890 - Added
A2uiTestSurfacecomposable to mount and test A2UI surfaces and components in isolation. I03c8a b/527415570 A2uiSchemanow support keywords within each subclass instead of dedicated subclasses foroneOf,allOf,anyOf,not,const,defaultandenum. I6a6f8- Added testing APIs for the Compose A2UI renderer. I59c9f b/527415570
- Added
A2uiReadinessEvaluatorand related APIs. Ib37d3 b/527415547 b/524122705 - Added
A2uiComponentCollection,A2uiFunctionCollection, andA2uiCoreComponentDefinitionCollection, and updated the catalog APIs to use the new collections. I96438 b/527415547 - Added an
A2uiMessageParserfactory function. I8596a b/524122705 - Added the
A2uiRuntimeCatalogmarker interface, and APIs inandroidx.a2ui.compose.uifor defining components and catalogs. Ibea7a b/527415547 b/524122705 - Moved
androidx.compose.runtime:runtime-a2uitoandroidx.a2ui.compose:compose-runtime. Ifc7cf b/524122705
Bug Fixes
androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. Id18ea b/556807521compileSdkfor Compose libraries updated to 37.1. This will require transitively updatingcompileSdkfor all apps and libraries using Compose. I05b0f- Updated default
Columnhorizontal alignment toAlignment.StartinA2UI Basic Catalog V1. Ia1c6db - Updated default
Rowvertical alignment toAlignment.TopinA2UI Basic Catalog V1. If0bca4
API Changes
- Use
WindowCompat#enableEdgeToEdge(Window)instead ofEdgeToEdge#enable()Ibff3e - Material 2 text field overloads that accept
value, onValueChangeparameters are deprecated. Please migrate to the overload that usesTextFieldStateto hoist its state. I6b841 b/556234973
Bug Fixes
androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. I99bfd b/556807521ComponentActivitynewdefaultViewModelArgsnow supports direct boot configuration as well. I10a08
Important changes since 1.10.0:
- Allow
@WorkerThreadannotation to be used from Kotlin Multiplatform common sourcesets. - Allow
@DoNotInlineannotation to be applied to fields - Update keep rules to allow shrinking items annotated with
@DoNotInline
API Changes
- Requires
AppFunctionData#serializecaller to provide metadata. I61eca - Adds inline reified
getHandleAppFunctionRequestAdapterin addition to the existingClass-based overload. Ic1b4e - Removes
AppFunctionContextandAppFunctionConfigurationI9dd8f - Adds
activityIdtoExecuteAppFunctionRequestI6ac86 - Adds
registerAppFunction,registerAppFunctions,RegisterAppFunctionRequest, andCallbackAppFunctionas@ExperimentalAppFunctionsApi. Idb2ca - Adds
scopeinAppFunctionMetadataandAppFunctionSearchSpecI4344c - Adds
AppFunctionUriValueConstraintas a public API. I75070 - Update
AppFunctionPackageMetadataconstructor I096f7
Features of Initial Release
Initial release of the Automated Backup and Restore Testing framework for Android. This library provides an automated, end-to-end way to test that user data and account credentials safely survive device upgrades and cloud restores. Instead of relying on manual testing, developers can automate the full lifecycle: seeding app state, backing it up according to your configured rules (dataExtractionRules and fullBackupContent), wiping the app, and verifying post-restore data integrity. The framework provides two artifacts: androidx.test.backup:backup-host (which runs on the host computer to orchestrate backup, wipe, and restore passes over ADB) and androidx.test.backup:backup (which runs on the device to populate and verify app data).
BackupRestoreController: The primary host-side interface used to control backup, wipe, restore, and verification workflows for a test device. Provides convenience pipelines such asrunBackupRestoreFlowas well as fine-grained operations (performBackup,performRestore,clearAppData,fetchDeviceLogs, andrunOnDevice). Supports both Kotlin coroutines and JavaListenableFutureasynchronous execution.BackupRestoreExtension: A JUnit 5 Jupiter extension that resolves and injectsBackupRestoreControllerparameters into test methods. Manages standalone or shared ADB sessions, automatically installs tested and test APKs, dismisses device lockscreens and keyguards to unlock credential-protected storage, and enforces test sandbox isolation.BackupRestoreTestRunner: An on-deviceInstrumentationtest runner executing inside the application sandbox. Dynamically resolves and executes requestedBackupDeviceActionimplementations dispatched by host orchestrators and safely redirects large JSON result payloads to disk to prevent Binder transaction buffer limits.BackupDeviceAction: The contract for custom device-side actions executing directly within the target application sandbox during data seeding (PHASE_POPULATE) or post-restore validation (PHASE_VERIFY).StorageDomain: Strongly typed descriptors (Preference,Database,TextFile, andBinaryFile) used alongside prebuilt action helpers (PopulateStorageActionandAssertStorageAction) to automatically seed and assertSharedPreferences, SQLite databases, and raw files across both Credential Protected (CE) and Device Protected (DE) storage contexts without boilerplate.BackupTransportMode: Specifies the platform backup transport topology to simulate during test passes, includingDEVICE_TO_DEVICE(physical device migration via USB or Wi-Fi Direct),CLOUD_ENCRYPTED(cloud backup with client-side end-to-end encryption),CLOUD_UNENCRYPTED(standard cloud backup), andLOCAL(offline local filesystem backup).@Deviceand@Isolation: Host annotations for selecting connected devices matching specific serials, API levels, or multi-device roles, and configuring sandbox isolation policies between test runs (IsolationPolicy.AUTOMATICvs.IsolationPolicy.MANUAL).
API Changes
- Source breaking change:
onValueChangeis now a required parameter inSliderandRangeSliderand its order in the parameter list has changed
Bug Fixes
DatePickernow resolves in 1 frame by computing month navigation availability directly from the displayed month index. I08db7TimeInputnow internally uses the newTextFieldStatetext field APIs. Ia7492 b/353692863DateInputnow internally uses the newTextFieldStatetext field APIs. I5ad3d b/353692863SliderandRangeSlidernow handleonValueChangeandonValueChangeFinisheddirectly in their implementations instead of passing them intoSliderStateandRangeSliderState. I959ac
New Features
The Jetpack Compose Agent-to-UI (A2UI) renderer provides an implementation of the A2UI protocol, enabling AI agents to generate rich, interactive user interfaces that render native Compose components—without executing arbitrary code. This library provides a ready-to-use implementation of the standard A2UI Basic Catalog specification, built using Material Design 3 components.
API Changes
- Update the order of components in
A2uiBasicCatalogVto exactly match the basic catalog specification. I23093 b/547851648 - Added
ChecksPropertyto all relevant component interfaces underA2uiBasicCatalogV1and made the property value available via a parameter passed toTypedContentof each component. I9f393 b/547851648 - Added
A2uiBasicCatalogV1.ChoicePickerandMaterialA2uiBasicCatalogV1Defaults.choicePicker. I875a6 b/547851648 - Added
A2uiBasicCatalogV1.ModalandMaterialA2uiBasicCatalogV1Defaults.modal. Icd553 b/547851648 - Added
AccessibilityPropertyto all component interfaces underA2uiBasicCatalogV1and made the property value available via a parameter passed toTypedContentof each component. I76b80 b/547851648 - Added
A2uiBasicCatalogV1.TextFieldandMaterialA2uiBasicCatalogV1Defaults.textField. Ifdaec b/547851648 - Added
A2uiBasicCatalogV1.VideoandMaterialA2uiBasicCatalogV1Defaults.video. I8595c b/547851648 - Added
A2uiBasicCatalogV1.AudioPlayerandMaterialA2uiBasicCatalogV1Defaults.audioPlayer. Ida509 b/547851648 - Added
A2uiBasicCatalogV1.SliderandMaterialA2uiBasicCatalogV1Defaults.slider. Ieb72d b/547851648 - Added
A2uiBasicCatalogV1.CheckBoxandMaterialA2uiBasicCatalogV1Defaults.checkBox. I84525 b/547851648 - Added
A2uiBasicCatalogV1.DividerandMaterialA2uiBasicCatalogV1Defaults.divider. I91208 b/547851648 - Added
A2uiBasicCatalogV1.TabsandMaterialA2uiBasicCatalogV1Defaults.tabs. Ic33d3 b/547851648 - Added
A2uiBasicCatalogV1.ListandMaterialA2uiBasicCatalogV1Defaults.list. I89f73 b/547851648 - Added
A2uiBasicCatalogV1.IconandMaterialA2uiBasicCatalogV1Defaults.icon. I65524 b/547851648 - Added
A2uiBasicCatalogV1.ImageandMaterialA2uiBasicCatalogV1Defaults.image. I673b3 b/547851648 - Added
A2uiBasicCatalogV1.ButtonandMaterialA2uiBasicCatalogV1Defaults.button. I5215f b/547851648 - Added
A2uiBasicCatalogV1.Row/A2uiBasicCatalogV1.ColumnandMaterialA2uiBasicCatalogV1Defaults.row/MaterialA2uiBasicCatalogV1Defaults.column. Ibcbe7 b/547851648 - Added
MaterialImageComponentto support rendering images in the A2UI catalog. Test:MaterialImageComponentTestinto androidx-main - Added
MaterialImageComponentto support rendering images in the A2UI catalog. I868fe - Added
A2uiBasicCatalogV1.CardandMaterialA2uiBasicCatalogV1Defaults.card. Icf604 b/547851648 - Deprecated stateless
SliderandRangeSlideroverloads in favor of their stateful versions. RenamedactiveRangeStartandactiveRangeEndinRangeSliderStatetostartValueandendValue, deprecating older unpromoted and experimental Slider APIs withDeprecationLevel.HIDDEN. If8995 - Added
A2uiSurfacecomposable andA2uiSurfaceDefaultsfor rendering A2UI surfaces. I6e276 b/544713825 - Added
A2uiTestSurfacecomposable to mount and test A2UI surfaces and components in isolation. I03c8a b/527415570
Bug Fixes
compileSdkfor Compose libraries updated to 37.1. This will require transitively updatingcompileSdkfor all apps and libraries using Compose. I05b0f
Bug Fixes
androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. Ic4c56 b/556807521
Important changes since 1.6.0:
- Disabled
EmojiCompatby default. On Android 15 and above,EmojiCompatis disabled by default. - Performance improvements. Text scanning is 4-6x faster and startup allocations are down 99.6%.
minSdkis now 24.
EmojiCompat is off by default on Android 15+
On API 35 and above the system has universal coverage with Updatable System Fonts, so for most apps EmojiCompat is not doing anything.
The new API is EmojiCompat.Config.setUseAfterUpdatableSystemFonts(boolean) to configure this behavior, and it defaults to false. When it's off, EmojiCompat is disabled on Android 15+ and your app draws emoji with the system font installed via Updatable System Fonts.
There is no API to detect that EmojiCompat is disabled, and to be clear even when setUseAfterUpdatableSystemFonts is false getLoadState() still returns LOAD_STATE_SUCCEEDED.
Re-enabling on Android 15+ with new flag
EmojiCompat.init(
FontRequestEmojiCompatConfig(context, fontRequest)
.setUseAfterUpdatableSystemFonts(true)
)
Text scanning is faster
Text parsing and startup allocations:
| p50 | 1.6.0 | 1.7.0 |
|---|---|---|
pureLatin | 16.43 µs | 2.66 µs |
latinWithOneSimpleEmoji | 12.13 µs | 2.43 µs |
latinWithOneComplexEmoji | 13.42 µs | 3.11 µs |
Startup allocations are down 99.6%. Total memory usage is also down.
When setUseAfterUpdatableSystemFonts is false (the default) on Android 15+, EmojiCompat costs empty method calls and holds no emoji metadata in memory.
minSdk is 24
minSdk is now 24.
API Changes
- Added
ImageVector.toRemoteImageVector()andRemoteImageVector.vectorResource(@DrawableRes id: Int)to convert Compose UIImageVectorand drawable vector resources toRemoteImageVector. Ia8383
Internal development to enable building template-first RemoteCompose Widgets for multiple surfaces across Android ecosystem. Public APIs to come.
Internal test changes only.
Important changes since 1.0.0:
New Features
- Debounced Goals: Added support for debounced goals, allowing conditions to require a sustained threshold over a specified duration before triggering.
- Exercise Events: Added an event-driven framework for discrete exercise occurrences, including golf swing classification (
GolfShotEvent). - Running Dynamics: Added data types and aggregate statistics for stride length, ground contact time, vertical oscillation, and vertical ratio.
- Swimming Lap Tracking: Added cumulative swimming lap count aggregation support (
SWIMMING_LAP_COUNT_TOTAL).
API Changes
- Change Brush color shift to operate in Oklab color space, which better preserves perceived lightness in hue shifts. Renamed
SATURATIONandLUMINOSITYshift Brush Target APIs toCHROMAandLIGHTNESSaccordingly. I0ed42
Bug Fixes
androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. I99bfd b/556807521
- Remove direct kotlin-stdlib dependency.
- Fix bug in
JavaScriptSandbox.isSupported()returning incorrect result.
API Changes
- Removed deprecated
DragPolicy. UseSubspaceModifier.movable()instead. I108d4 - Removed the deprecated
ResizePolicyand its usages inSpatialPanelandSpatialExternalSurface. Remove a deprecatedSubspaceModifier.resizablefunction. Use the newSubspaceModifier.resizablewith a newResizePolicyinstead. I59e6b - Added
isPitchUpdateEnabledparameter to allow enabling or disabling pitch tracking independently. Ie9e86 - Removed nullability of
pitchLimitsand renamedPitchLimits.UNCONSTRAINEDtoPitchLimits.FullRange. I0154f ExposedDropdownMenuis now an extension function onExposedDropdownMenuBoxScopeinstead of a member. You may need to update your code with a new import. Ie8a65- Removed deprecated
SurfaceProtectionclass. UseSpatialExternalSurfaceProtectioninstead. Iab2c6 - The Orbiter function that takes an
OrbiterPoseProviderhas been deprecated in favor of the one that usesSpatialAlignment. I4d12b SpatialActivityPanelnow requires aSpatialActivityPanelController(instantiated usingrememberSpatialActivityPanelController) to launch and manage embedded activities. Id25c6- Removed the
upDirectionparameter fromrotateToLookAtUserand added rotation constraints parameters (isYawUpdateEnabledandpitchLimits). I1370a
Bug Fixes
- Fixed various
InteractionPolicyissues. A crash occurred if an input event occurred right as the Composable or child (for instance an Orbiter) initiated a disposal sequence. Also fixes an issue where a child would receive hover events. Ifc477 - Reduced panel size in
RotateToLookAtUserActivityto prevent clipping on smaller FOV devices. I8d672
Known Issues
- There is an issue with Compose XR panels where creating many panels in a single Activity may cause some corruption on what is being viewed even after the panels are destroyed.
API Changes
- Adds Glimmer
AlertDialogI01019 - Libraries now target Kotlin 2.2 and require kotlinc 2.2 I82396 b/498369605
- add
LeadingImageCardandTrailingImageCardIcdf91 - Add
ImageCardAPI and removeheaderparam fromCardandActionCardI81f62 - Added
IconMarkercomponents used for anchoring to real-world objects. I958d6
Bug Fixes
androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. I99bfd b/556807521
Bug Fixes
- Fixed a
NullPointerExceptioninRegisteredMediaRouteProviderwhen receiving unsolicited dynamic route controller responses or null descriptor bundles from route providers. I94579
Dependency Updates
- Updated
androidx.lifecycledependencies to version 2.10.0. I4505a9f9a
1.2.0 is now stable!
Important changes since 1.1.0
Result API
- This new API allows passing results between
NavEntriesusing theResultEventBusprovided byLocalResultEventBusandResultEventBusNavEntryDecorator. - Added
rememberResultEventBusto support hoisting aResultEventBusoutsideResultEventBusNavEntryDecoratorand passing it torememberResultEventBusNavEntryDecorator. - Passed-in results can be accessed as state with
ResultEventBus#conflateAsStateor collected as a flow of results withResultEffect.
Deep Link API
Navigation3 now supports Kotlin Multiplatform (KMP) deep links in androidx.navigation3.runtime.deeplink via DeepLinkRequest, DeepLinkUri, and DeepLinkMatcher.
DeepLinkRequestandRequestExtras: Represents a deep link request created from aDeepLinkUri, a URI string, or an AndroidIntent. Additional request metadata can be attached using the type-safeRequestExtrascontainer built with therequestExtrasDSL andRequestExtrasKey<T>.DeepLinkMatcher: Represents a deep link that can be matched with aDeepLinkRequest. Each matcher instance is associated with the navigation key that supports this deep link. A navigation key can be associated with multiple matchers. CallingDeepLinkMatcher.matchwill return aMatchResultthat contains the associated navigation key if match succeeds. There are two defaultDeepLinkMatcherimplementations:UriDeepLinkMatcherfor matching deep links based onUri, andStaticKeyDeepLinkMatcherfor matching deep links with onlyDeepLinkMatcher.Filterthat match by a Boolean.BackStackMatcher: ADeepLinkMatcherto construct a synthetic back stack upon a successful deep link match.BackStackMatchercan be created via theDeepLinkMatcher.withBackStackextension function.
Predictive Back Handling
- Added
NavigationBackHandlerandrememberNavigationEventStateto simplify connectingSceneStatewith predictive back handling (onBackCompletedandonBackCancelled). This allows custom UI components to support standard back navigation and predictive back gestures without manually calculating back stack deltas. - Improved predictive back transitions, including support for predictive back gestures triggered mid-flight during forward animations.
Other Changes
NavEntry.contentKeynow defaults to a composite ofkey.toString()andkey::class.toString(), preventing key collisions betweendata objectkeys that share the same simple name across different interfaces.EntryProvidernow prioritizes matching based on key instances over key types.- Added a lint check to ensure
Sceneimplementations are eitherdata classes or implementequalsandhashCode.
Bug Fixes
- Fixed predictive back animation handoff in
NavDisplayby migrating toDeferredAnimatedContentand resolving transition handoff issues. I145eaedd b/430807423DeferredAnimatedContentusesDeferredTransitionto separate transitions into a deferred phase (viadefer), which applies manual transformations during a swipe gesture, and an automatic phase (viaanimateTo), which runs the transition when the swipe is committed.
Known Issues
- Shared elements are rendered in the outgoing scene during transitions instead of the incoming scene. b/582354988
- Shared elements don't seek during the deferred (gesture) phase.
Dependency Updates
androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. I99bfd b/556807521
API Changes
- Expose
animateRemoteFloatAsState,animateRemoteDpAsState,RemoteAnimationSpec,RemoteModifier.sharedElement,RemoteModifier.sharedBounds, andRemoteModifier.animateEnterExitas public APIs I382ec - Added
relative*Tonaming aliases andquadraticTo/cubicTooverloads toRemotePathScope. I4ebca - Added shape helpers (
addRect,addOval,addCircle,addRoundRect,addArc,addPath) andRemoteOffset/RemoteSizeoverloads toRemotePathScope. I14972 - Add
arcTowithforceMoveTosupport toRemotePathScope. Ib5cf0
Bug Fixes
- Fixed an issue where
CollapsibleColumnLayoutandCollapsibleRowLayoutminIntrinsicWidth/Height exceeded exact constraints when children were present. Ic2a6f - Added a new
EventActionOperationthat allows users to specify custom event handlers. I161bc - Fixed named
RemoteDpexpressions mis-scaling by display density. I78bf5 androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. I99bfd b/556807521- Added Brush styling, alpha, winding (
PathFillType), and procedural drawing support toRemoteVectorPainterandRemoteImageVector. I7e69e - Added support for Animated Vector Drawables (AVD) in Remote Compose with injectable progress and default continuous animation. Ic0223
- Fixed performance regression when recording padding and offset modifiers with
RemoteDp. Id8bc9 b/555795653
Bug Fixes
androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. I99bfd b/556807521
Important Changes
- We have added test cases to ensure backward compatibility down to API 24 (Android 7.0), and the results have been highly positive!
- The libraries now target Kotlin 2.2 and require kotlinc 2.2 I82396 b/498369605
- The vertical text libraries now compile against SDK 37. Apps that use them must compile against SDK 37 and use AGP 9.1.0 or later. I0f757 b/562182206
Bug Fixes
EmphasisSpan.positionnow moves the emphasis mark.AnnotationPosition.Beforeputs the mark above horizontal text and right of vertical text.AnnotationPosition.Afterputs it on the opposite side. Ic9bfd b/559972132- Fixed the emphasis mark scale in horizontal text layout. The reserved line height no longer assumes an unscaled mark. I6d7fe b/562254557
- Fixed the backport for vertical text advances. The backport ignored the requested offset on API levels less than 34. I8877a b/495457561
- Fixed horizontal ruby text reserving too much vertical space on API levels below 28, which could leave a line taller than necessary. Iceb60 b/561323466
- The tests for vertical ruby and text orientation now run on all supported API levels. If07d4 b/495457561
androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. I7264b b/556807521- Fixed
RubySpan.positionbeing ignored in horizontal text layout.AnnotationPosition.Afternow correctly renders ruby text below the base text. Iaffa1 b/559972124 b/561323466 - Fixed
RubySpan.positionbeing ignored in vertical text layout.AnnotationPosition.Afternow correctly renders ruby text on the left side of the base text. I0be1c b/495457561 - Upgrade Compose dependencies to 1.11.4 I9ef07 b/536925341
Important changes since 1.6.0:
- Introduced new API for one-handed gestures, consisting of gesture handlers for primary action (double-pinch) and dismiss action (wrist-turn) as well as animated indicators for clicking/scrolling/paging that show when the gestures are available.
- Added
PinnableContainersupport toTransformingLazyColumn, for holding an item in memory instead of disposing when the item is scrolled out of the viewport. TransformingLazyColumnnow has support for animating items as they move out of the viewport, allowing them to smoothly slide off-screen instead of fading out.- Added
firstLayoutItemProvidertoTransformingLazyColumnas an optional customization for the first layout item. When specified, the provider defines the item and its edge used as the initial placement reference, which is useful for controlling the direction of content-shifting when items are dynamically updated. - Improvements to
SwipeToRevealto support nested scroll, fast flings, a second haptic at the partial reveal state andactionContentSpacingfor the distance between the main content and the action buttons. - Introduced
@FrequentlyChangingValueand@RememberInCompositionannotations that provide lint warnings to prevent performance issues caused by reading high-frequency state updates or failing to remember objects during composition.
Bug Fixes
androidx.lifecycle:lifecycle-runtimedependency was updated to 2.10.0. This version is required for bundled lifecycle runtime lint checks to run with AGP version 9.5.0-alpha04 or later. If8e16
API Changes
- Added
ImageVector.toRemoteImageVector()andRemoteImageVector.vectorResource(@DrawableRes id: Int)to convert Compose UIImageVectorand drawable vector resources toRemoteImageVector. Ia8383 - Expose
RemoteSplitSwitchButton,RemoteSplitSwitchButtonDefaults, andRemoteSplitSwitchButtonColorsas public APIs in Wear Material 3 Remote Compose. Ic9b7f - Expose
RemoteSplitRadioButton,RemoteSplitRadioButtonDefaults, andRemoteSplitRadioButtonColorsas public APIs in Wear Material 3 Remote Compose. I4d0c2 - Expose
RemoteSplitCheckboxButton,RemoteSplitCheckboxButtonDefaults, andRemoteSplitCheckboxButtonColorsas public APIs in Wear Material 3 Remote Compose. Iffdef - Expose
RemoteSwitchButton,RemoteSwitchButtonDefaults, andRemoteSwitchButtonColorsas public APIs in Wear Material 3 Remote Compose. I0155b - Expose
RemoteRadioButton,RemoteRadioButtonDefaults, andRemoteRadioButtonColorsas public APIs in Wear Material 3 Remote Compose. I513ce - Expose
RemoteCheckboxButton,RemoteCheckboxButtonDefaults, andRemoteCheckboxButtonColorsas public APIs in Wear Material 3 Remote Compose. If5c8a - Add
filledIconButtonColors,filledTonalIconButtonColors,filledVariantIconButtonColors, andoutlinedIconButtonColorstoRemoteIconButtonDefaultsin Wear Material 3 Remote Compose, and updateiconButtonColorsandtextButtonColorsparameter defaults to null. Ib0b0e - Add
containerPaintersupport toRemoteCardandRemoteTitleCardin Wear Material 3 Remote Compose. I4f1bc
Bug Fixes
- Fixed
RemoteEdgeButtontext spilling outside button arc shape on long labels. I2eb3d
API Changes
- Added
WEAR_CINNAMON_BUN_1andWEAR_CINNAMON_BUN_2constants for new Wear OS versions to theWearApiVersionHelper. Ifec88
- Added
startRemoteActivityAttemptUnlockandstartPhoneActivityWithUnlocktoRemoteActivityHelper, allowing Wear OS applications to start an activity on the connected phone after unlocking the phone, subject to user enrolling in feature and platform capability.startRemoteActivityAttemptUnlockcan fall back to existingstartRemoteActivitywhen feature is not available.
Bug Fixes
- Removed Kotlin from the
webkitlibrary to unblock apps that have issues with kotlinc.
Important changes since 2.11.0:
- The
minSdkhas been updated from API 23 to API 24 - A new artifact,
androidx.work:work-analytics, adds experimental Work Metrics APIs for inspecting the execution history of your work.WorkMetricsInfoRepositoryrecords aWorkMetricsInfoper work event timestamps, worker duration, total cumulative runtime, and run attempts breakdowns. Metrics can be read via configurable queries or observed as aFlowof finished work. These APIs require opting in to@ExperimentalWorkMetricsApi. - New experimental event listener APIs let you observe
WorkManager's execution and scheduling directly.Configuration.Buildernow accepts a listener for worker execution events (start, finish, stop, and uncaught exceptions) and a listener for scheduling events (enqueue, unblock, update, cancellation, and failed prerequisites). These are the building blocks thatwork-analyticsitself is built on.
API Changes
- Added
ProjectedActivityCompat.setActivityAsInputReceiverandclearActivityAsInputReceiverto allow apps to specify exactly which component should be relaunched and receive input focus when system-initiated focus shifts occur on displayless devices. Id21e5