New Features
- Version bump to RC and remove legacy aggregation compiler option.
New Features
- Added
StorageDomain.DataStorePreferenceto seed and verify PreferencesDataStoreentries,StorageDomain.CustomDatato run custom device actions, andStorageDomain.ExcludedDatato verify that excluded data is not restored. If127d I6190e - Added
isDeviceProtectedStorageacrossStorageDomaintypes to test Device Protected (DE) storage, and added support forStringSetvalues inStorageDomain.Preference. Ie96be - Added a
restoreOnparameter torunBackupRestoreFlowfor cross-device restore flows,BackupRestoreController.uninstallApp(), andminApiandmaxApibounds on@Device. Ifa0e3 - Added
testApplicationIdand a defaultapplicationIdto@BackupRestoreConfig, and registeredBackupRestoreTestRunnerwithInstrumentationRegistryfor device actions. Ie96be Ifa0e3 - Updated
BackupRestoreExtensionto automatically save device logs when a test fails and report the saved file paths in the failure message (disable viaandroidx.test.backup.device.logs.enabled=false). I7f605
API Changes
- Added
BackupActionResult.dataandBackupActionResult.getOrThrow()to read output payloads from device actions, along withSTORAGE_TYPE_DATASTORE_PREFS,VALUE_TYPE_DOUBLE, andVALUE_TYPE_BYTESonBackupActionValues. I6190e If127d - Removed
BackupDeviceAction.phase,PHASE_POPULATE, andPHASE_VERIFY(remove thephaseoverride from custom actions), as well as theBackupRestoreExtension(AdbSession)constructor. Ie96be I1a349
Bug Fixes
Fixed an
UnsupportedOperationExceptionon API 30 when apps withSYSTEM_ALERT_WINDOWrepeatedly bind camera use cases. I3235c b/575161911Fixed a native thread leak when unbinding
VideoCapture, which left one media framework thread behind per bind. If5730 b/573671138
API Changes
Modifier.bordernow consistently uses the outline size when rendering borders. UseComposeFoundationFlags.isBorderMatchesOutlineBoundsFixEnabledto temporarily disable this if it causes issues. I3e171
Bug Fixes
- Resolve hardcoded pressed shape in
ToggleButtonto use design tokenButtonSmallTokens.PressedContainerShape. Ia60dc b/531792521 - Fixed
RangeSlidernot updating values on tap when thumbs overlap. I91d42 b/352467346 - Fixed floating-point precision loss in discrete
SliderandRangeSliderwhen snapping to integer ticks. I91d42 b/237634010 - Fixed
RangeSliderinside a horizontally scrollable container scrolling the container when dragging a thumb. I91d42 b/415838608
API Changes
- Renamed
remoteBitmaptobitmaponRemoteBasicImageand movedstyleto the final parameter onRemoteBasicTextto match Compose Foundation. I2b57a
Bug Fixes
- Updated androidx.tracing:tracing-wire dependency to 2.0.5. I70e9f
API Changes
- Added a
CoordinatorLayout.Behavior#onRequestChildRectangleOnScreenoverload that provides the request source to Behaviors and updated compileSdk to API 36.1 Ibddfd - Removing obsolete @RequiresApi(21) annotations Ic4792
Bug Fixes
- Moving the default minSdk from API 21 to API 23 Ibdfca b/380448311 b/435705964 b/435705223
Important changes since 1.0.0:
Version 1.1.0 makes migrating to core-telecom even smoother by giving VoIP developers granular rollout control over the underlying platform implementation (ConnectionService vs. transactional APIs), promotes core Call Extensions to stable, introduces new call-logging and network-slicing controls, and further hardens call setup and audio routing across Android SDKs.
New Features & API Changes
- Seamless Migration & Rollout Control (
ConnectionServicevs. Transactional APIs):core-telecomabstracts two underlying Android framework Telecom implementations behind a single unified API surface: theConnectionServiceAPIs and the transactionalTelecomManager#addCallAPIs (used by default on SDK 34+).CallsManager#registerAppWithTelecom(int, int)now includes an optionalbackwardsCompatSdkLevelparameter (defaulting to SDK 33) that letsVoIPapps configure the upper SDK bound (inclusive) that uses theConnectionService-backed implementation. For apps migrating from a direct platformConnectionServiceintegration, this enables a low-risk, phased rollout: you can adoptcore-telecomonce using the familiarConnectionServicebacking across your target SDK range to avoid production regressions, and smoothly ramp up to the modern transactional platform APIs at your own pace—without changing your call management code. Ib9571 - Call Extensions Graduated to Stable: Removed the
@ExperimentalAppActionsopt-in requirement fromCallsManager#addCallWithExtensions,InCallServiceCompat#connectExtensions,LocalCallSilenceExtension,ParticipantExtension, andMeetingSummaryRemote, promoting them to stable APIs for syncing call state with remote surfaces such as Android Auto and Wear OS. I25ab2 - Remote Microphone Mute Control: Extended
LocalCallSilenceExtensionwithupdateCanUserUpdateSilence(Boolean)and an optionalonCanUserUpdateSilencecallback soVoIPapps can dynamically enable or disable microphone mute controls on remote surfaces (for example, when a user joins as a passive viewer, is muted by a meeting moderator, or uses Companion Mode). I55acf Ibb0c2 - Per-Call Call Log Exclusion (
CallAttributesCompat.isLogExcluded): Added an optionalisLogExcludedproperty toCallAttributesCompat, allowingVoIPapps that opt into system call logging to exclude specific calls from being saved to the system call log on Android 16 QPR (Build.VERSION_CODES_FULL.BAKLAVA_1) and higher. Ia2a3a - Opt-Out of Premium Network Slicing: Introduced
CallsManager.CAPABILITY_OPT_OUT_OF_PREMIUM_NETWORKforregisterAppWithTelecom, allowingVoIPapplications to opt out of automatic platform requests for premium network slices during voice and video calls. I2dfdb - Dynamic Call Type Observation & Upgrades: Added
CallControlScope#callTypeFlow()andCallControlScope#requestCallType(int)so apps can observe live audio/video state transitions and dynamically upgrade or downgrade call types mid-session. I51065 DisconnectCause.ERRORSupport with Cross-SDK Fallback: AllowedVoIPapps to disconnect calls withDisconnectCause.ERRORstarting in SDK 38, with automatic Jetpack-layer remapping toDisconnectCause.LOCALon older Android versions so apps do not need version checks. I5a58c
Cross-SDK Audio Routing & Call Setup Reliability
- Faster, Non-Blocking Call Setup: Decoupled starting audio endpoint resolution and Bluetooth stabilization from the synchronous
CallsManager#addCallpath, eliminating a delay of up to 2 seconds before enteringCallControlScope. Ia1e89 - OS
TransactionManagerDeadlock Prevention: Added a transitory call-setup gatekeeper that immediately rejects overlapping or un-debouncedaddCallandaddCallWithExtensionsrequests withCallException(ERROR_CALL_NOT_PERMITTED_AT_PRESENT_TIME), preventing 5-second timeouts and serial queue deadlocks in the platformTransactionManagerwhile preserving full multi-call and call-waiting support. If0ac8 - Cross-SDK Audio vs. Video Routing Mitigations:
- Fixed a platform constant mapping issue across SDK 34–36 where incoming audio-only
VoIPcalls could be misinterpreted by the OS as video calls and erroneously routed to the speakerphone instead of the earpiece, including a Jetpack fallback for missing platform video-state callbacks on SDK 34. I95902 Ic7000 - Fixed video call routing on older Android versions and the
ConnectionServicecompatibility path so incoming or dynamically upgraded video calls reliably default or fall back to speakerphone when no headset is connected. I29fd2 I0fc79 I9f2bd
- Fixed a platform constant mapping issue across SDK 34–36 where incoming audio-only
- Preferred Endpoint, Wired Headset & Bluetooth Preservation:
- Prevented platform call-start defaults from overriding a user's pre-call
preferredStartingCallEndpoint(such as earpiece on video calls) or reverting an intentional early user switch to speakerphone. I38ea6 I9e251 I62871 - Fixed an issue where starting a video call with a connected wired/USB-C headset (
TYPE_WIRED_HEADSET) or a connecting Bluetooth headset would prematurely switch audio to the device speaker. I575a8 I82463 - Added a permissionless fallback heuristic to identify paired wearables/watches for audio routing when
BLUETOOTH_CONNECTis not granted Iec271 I4d218, and removed unsupported A2DP-only media devices fromgetAvailableStartingCallEndpoints()to match platform Telecom voice routing I98b72.
- Prevented platform call-start defaults from overriding a user's pre-call
- ANR, Crash & Extension Lifecycle Hardening:
- Filtered redundant
CallAudioStateandCallEndpointupdates in the legacy compatibility path to prevent main-thread congestion and potential ANRs. Ibd794 - Fixed race conditions and null-pointer crashes across
JetpackConnectionServiceI24306,PreCallEndpointsUpdaterIfad5c I2d722,BluetoothProfileListenerIdbd57 I1901e, and remote extension binder teardown/setup I73a52 I00f82.
- Filtered redundant
API Changes
- Merged public and experimental API files for d,e,f,g-paths I03646 b/278769092
Bug Fixes
- Moving the default
minSdkfrom API 21 to API 23 Ibdfca b/380448311 b/435705964 b/435705223 - 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 I3d340 b/326456246
- Fixed a
ClassCastExceptionorNullPointerExceptionthat could occur inKeyedAppStatesServicewhen processing received application states. I6909a28a
API Changes
- Added
GlanceAdaptiveWidgetReceiverbaseAppWidgetProviderclass as the main entry point for Glance Adaptive widgets. Iddecc - Added
@integer/glance_adaptive_widget_category_all_knownresource for<appwidget-provider>'sandroid:widgetCategorydeclaration, to opt in into all supported Widget surfaces. I4582e
API Changes
- Glance Wear now throws
WearWidgetContentTooLargeExceptionwith actionable guidance when a widget's content is too large to be sent to the host (for example due to large bitmaps inRemoteImage), instead of failing with an obscure Binder error. I9eb1c - Added
WearWidgetConfigExtraswith helper to extract widget configuration parameters and moved constants fromGlanceWearWidgettoWearWidgetConfigExtras. I70561 - Added
GlanceWearProfiles.createWearWidgetsProfile(WearWidgetParams)to create a profile configured with the host-supported operations. I51f28 - Exposed
horizontalPaddingDp,verticalPaddingDp, andcornerRadiusDpinWearWidgetParams. I19925
Additional changes
- Changes to use newly aligned parameter names and order across Remote Compose library.I2e164
- Wear Widgets can now use the
onTouchDown,onTouchUpandonTouchCancelmodifiers on all Wear OS devices that support widgets, not only on devices with the latest widget renderer. Use them to show press feedback, such as a pressed state on a button. I6dce7 - Added the
MODIFIER_TOUCH_DOWN,MODIFIER_TOUCH_UPandMODIFIER_TOUCH_CANCELoperations to the Wear Widgets profile (GlanceWearProfiles), so widgets can useonTouchDown,onTouchUpandonTouchCancelon hosts that support them. Id4a9a
API Changes
- Add experimental Ink APIs for calculating/storing phase offsets for strokes with animated textures I620e6
- Add experimental Ink brush APIs for specifying an animated paint texture If0f10
- Stroke shape (
PartitionedMesh) serialization, to save partially erased strokes or to speed up document load times by saving mesh data I1604f
Bug Fixes
- Fixed handling of concurrent inputs, and improved barrel twist compatibility. I0fc23
Bug Fixes
- Support stylus AXIS_RZ in motion event predictor I04f3a
Changes
compileSdkhas been downgraded from 37 to 36. Version 1.2 depends on Compose1.10which does not requirecompileSdk37.
Bug Fixes
- Fix shared
NavEntrynot rendered on screen when it is popped then pushed again before the pop completes. I6a482
API Changes
- Renamed
ActiontoRemoteActioninremote-creation-composeand updated action factories and touch/click modifiers (clickable,onTouchDown,onTouchUp,onTouchCancel). I19913 - Reordered
RemoteShape.createOutlineandRemoteCornerBasedShape.createOutlineparameters to(size, layoutDirection, density)to match ComposeShape.createOutline. Ifb87a - Decoupled
RemoteColorfrom Compose UIColor:RemoteColornow extendsBaseRemoteState<Int>(ARGB@ColorInt) withInt.rcand@ColorIntfactory overloads; ComposeColorconversions (Color.rc,Color.asRemoteColor(),RemoteColor.asConstantColor()) remain available as extensions. Ib31ea - Added
currentProfileSupportsPathClip()to check whether the current Remote Compose creation profile supports clipping to a path. I3b0ab - Deprecated
rememberMutableRemote*factory functions (rememberMutableRemoteBoolean,rememberMutableRemoteEnum,rememberMutableRemoteFloat,rememberMutableRemoteImageBitmap,rememberMutableRemoteInt, andrememberMutableRemoteString) inremote-creation-composein favor ofremember { MutableRemote*(initialValue) }. Ifb1f8 - Removed
RemoteTypeface.toAndroidTypeface()andRemoteTypeface.Companion.fromAndroidTypeface()fromremote-creation-compose. I8867e - Removed the previously deprecated
RemoteModifier.animationSpecmodifier. I1aea8
Bug Fixes
- Fixed chained
RemoteModifier.drawWithContentmodifiers dropping inner draw blocks (such as component container backgrounds when callers attachdrawWithContent). If7e75
Bug Fixes
- Fixed an issue in
ShellServerwhere random port selection could lead to port collisions and startup failures. I1951b
API Changes
- Integrate material3-ripple in Wear material3 and add support for inset focus rings, introduce
LocalRippleThemeConfigurationandRippleThemeConfigurationto support configuring focus indication, and deprecateRippleConfiguration.rippleAlpha. Ifb63a - Added
LocalTimeSourceto allow overridingTimeText's time source viaCompositionLocalin tests and previews. Ic981a - Added
Modifier.suppressStatusBar()to allow screens and components to suppress the status bar and automatically collapse top status bar insets. Removed the unreleasedStatusBarSuppression()composables; useModifier.suppressStatusBar()instead. I0a0d6
Bug Fixes
Dialognow only uses a full-screen offscreen layer while it is animating or being swiped, reducing GPU memory usage while it is shown and idle. I65baf- Fixed an issue where state written from a background thread while
TransformingLazyColumnwas measuring could be lost. I3ed10 - Fixed a bug in
OneHandedGestureDefaults.scrollDownToNextItemso that the first double pinch gesture always scrolls down, even when the list is at the top and the first item sits below the anchor point.
API Changes
- Aligned
RemoteButton,RemoteCompactButton(including defaultinglabeltonull),RemoteIconButton,RemoteTextButton,RemoteEdgeButton,RemoteCheckboxButton,RemoteRadioButton,RemoteSwitchButton,RemoteTitleCard,RemoteOutlinedCard,RemoteCardDefaults.outlinedCardBorder,RemoteHorizontalPageIndicator,RemoteVerticalPageIndicator, andRemoteTextparameter order, types, and names with Wear Compose Material 3, adoptingRemoteBorderStrokefor button borders andindicatorSize(RemotePageIndicatorDefaults.IndicatorSize) for page indicators. If09ff - Updated action callbacks (
onClick,onCheckedChange,onSelect,onContainerClick, andonSelectionClick) acrossremote-material3components to useRemoteActioninstead ofAction. I19913 - Reordered
RemoteEdgeButtonShape.createOutlineparameters to(size, layoutDirection, density)to matchRemoteShape.createOutlineand ComposeShape.createOutline. Ifb87a - Added
copy()toRemoteProgressIndicatorColorsandRemoteShapes, madecopy()parameters non-nullable across*Colorsand*Shapesclasses, removed@Composablefrom non-theme shape properties on*Defaultsobjects, removed the redundantRemoteEdgeButtonDefaults.shapeproperty (useRemoteEdgeButtonDefaults.shape(buttonSize)), and renamed constants onRemotePageIndicatorDefaultsandRemoteTimeTextDefaultstoPascalCase. Iae170 - Removed
DefaultRemotePageIndicatorStateandRemoteModifier.buttonSizeModifier()from the public API. I3ada2 - Added a required
defaultFontFamilyparameter to theRemoteTypography(Typography)constructor to apply aRemoteFontFamilyto every style. PassRemoteFontFamily.Defaultfor the previous behavior. I34646
Bug Fixes
RemoteButton,RemoteCompactButton,RemoteIconButton, andRemoteTextButtonnow clip their container backgrounds to customRemoteShapeoutlines when the creation profile supports path clipping. I3b0abRemoteTimeTextnow defaults its color toonBackgroundwith luminance 80, matching Wear Compose Material 3TimeText. Ib53fcRemoteSplitCheckboxButtonnow draws the same check mark and check animation asRemoteCheckboxButton. I96f9fRemoteSplitSwitchButtonnow mirrors the switch thumb in right-to-left layouts and draws the same thumb check mark asRemoteSwitchButton. I686ec- Fixed
RemoteButtonDefaults.containerPainterandRemoteCardDefaults.containerPainterignoring alpha anddisabledContainerOpacity, and alignedRemoteIconButtonDefaultscontentColordefaults with Wear Compose Material 3. I9c5fb RemoteCheckboxButton,RemoteSwitchButton, andRemoteRadioButtonnow tint their icon with the icon colors from their colors, which default to the primary color, matching Wear Compose Material 3. I31590- Remote selection buttons and their split variants now animate their container and content colors with the slow effects spec of
RemoteMaterialTheme.motionScheme, matching Wear Compose Material 3, and theRemoteCheckboxButtontick no longer rotates while being unchecked. I822aa RemoteCircularProgressIndicatorandRemoteLinearProgressIndicatornow animate progress changes withRemoteMaterialTheme.motionScheme, matching Wear Compose Material 3, andRemoteCircularProgressIndicatornow coerces progress into0f..1f. The indeterminateRemoteCircularProgressIndicatornow uses the standard easing for its trims. Ief8ea- Aligned default colors in
RemoteButtonDefaults,RemoteCardDefaults.outlinedCardBorderColor,RemoteCheckboxButtonDefaults, andRemotePageIndicatorDefaultswith Wear Compose Material 3. I87510
API Changes
WebContent: Introducing a new API to hold a persistent web engine session state that can safely outlive individual UI views or Activities. I41397WebContentView: Introducing a new specializedWebViewdesigned to integrate withWebContent. I41397DetachedWebContentView: A specializedWebContentViewthatWebContentattaches to when not attached to an Activity. I41397
API Changes
- Fix accidental hidden callback on
NavigationListenerI1cd2e b/576625538 - Added an overload of
WebViewCompat#startUpWebViewthat accepts anExecutoron which to invoke theWebViewOutcomeReceivercallback, allowing applications to handle startup completion on a background thread rather than the main looper. I51748 - Changed
Navigation/Page#snapshotStateto#captureStateand editedNavigationState#didCommitErrorPagejavadoc I0405a Adds
NavigationStateandPageStatewhich are immutable copies ofNavigationandPageat a certain point in time. They are supplied via new callbacks withinNavigationListener, which haveNavigationStateandPageStateas parameters instead ofNavigationandPage. The state objects can also be supplied byNavigation#snapshotStateandPage#snapshotState.Added
NavigationState#getNavigationStartUptimeMilliswhich returns the navigation's start up time in milliseconds.Added
NavigationState#getResponseHeadersandNavigationRedirectParameterswhich is supplied viaonNavigationRedirect(NavigationState,NavigationRedirectParameters)which exposes the HTTP response headers for the Navigation. I9886aAdded support for
Profile#addQuicHintsto take wildcards as URLs (such ashttps://*.example.comor `https://*) Ic6d67 b/442161273Deprecated
WebSettingsCompat.getAttributionRegistrationBehavior,WebSettingsCompat.setAttributionRegistrationBehavior, and related constants asWebViewno longer supports Attribution Reporting in version 152 and later. I3453a b/528282384