April 9, 2025

Important changes since 1.0.0

  • Allows configuring a AsyncLayoutFactory when initializing AsyncLayoutInflater. For AppCompat context, this can be provided through AsyncAppCompatFactory which initializes AppCompat views correctly.
  • The inflate API accepts an executor on which OnInflateFinishedListener callback can be triggered.

API Changes

  • Changed TraceProcessor's argument timeout: Duration to timeoutMs long for Java caller usability. I9fbb5
  • Mark TraceProcessor constructor as internal. Callers should use TraceProcessor.startServer or TraceProcessor.runServer. Ia8c5b

Bug Fixes

  • When killing the application with MacrobenchmarkScope.killProcess, validate the kill command results to prevent silent failure, and timeout error. I84555

Dependency Updates

  • This library now targets Kotlin 2.0 language level and requires KGP 2.0.0 or newer. Idb6b5

New Features

API Changes

  • Added overloads for CustomTabsClient#createPendingAuthTabSession. I71c3a
  • Updated Auth Tab APIs Iaf9b1
  • The TrustedWebActivityIntent now includes Launch Handler API client mode that allows a browser to use this API. Ifc95c
  • The TrustedWebActivityIntent now includes URIs of files opened via the app's registered intent filters, and grants the browser read-write permissions to those files. I2134a
  • TrustedWebActivityIntent now includes the originally launched URL in its extras, adding context for the browser when used by Protocol Handlers. I3759a
  • Added a new API to enable/disable the close button for Custom Tabs. I35acd
  • Added close button icon customization support to Auth Tab Iaf877

Bug Fixes

  • ListItem corrects its intrinsic height calculation, now reserving the appropriate amount of space in Layout.
  • Remove excess NavigationBarItem label padding, correctly aligning with spec.
  • Corrects TabRow Layout in RTL mode.

API Changes

  • Removed android specific parameters from ModalBottomSheetProperties Iab97f b/362539765
  • Introduce overloading functions for drag handle size defaults I0ed0d
  • Add new NavigationSuiteScaffold and NavigationSuiteScaffoldLayout functions to support new layout types and add support for an optional primary action content. Ib262a b/353144478
  • Deprecate Modifier.weight with fill parameter in ButtonGroup. Adding a version without fill. Id32bb
  • Rename xSmall- and xLarge- IconButton component defaults to spell out extra. Ib6e0f
  • Add new NavigationSuite, NavigationSuiteItem and NavigationSuiteColors functions to support new layout types. I203d6
  • Add new NavigationSuiteTypes and add new navigationSuiteType function that include those layout choices If68f9

Bug Fixes

  • ColorScheme.contentColorFor now maps surfaceDim to onSurface. I8891a
  • Updated DateInputTextField implementation to address an issue where the input field did not reflect programmatically set date. I6c8d1 b/401143451
  • Fixed the talkback focus order for the navigation rail and wide navigation rail I6cf6f b/407048224

The component makes it easier to create properly internationalized applications, focusing on two main areas:

  • Date and time formatting functionality following the best current practices, honoring user custom settings, and providing a unifying API that works properly on old and new Android versions.
  • A backport of android.icu.text.MessageFormat that works on older APIs. But still useful on new Android versions because it integrates the date / time formatting mentioned above. That honors the user settings, which android.icu.text.MessageFormat does not do.

The component will be the vehicle to backporting new i18n APIs, adding new i18n functionality or fixes, and in general making internationalization easier.

New Features

New experimental API call extensions. The new experimental extensions added in this release are:

  • Support for a Meeting Summary Remote Extension, allowing a remote surface to receive meeting summary information (current speaker and participant count) from the connected VoIP application. 7cf095f
  • Support for a Call Icon Extension that allows a VoIP app to send an Icon Uri to a remote InCallService (auto, watch face, etc.). The Icon can be updated throughout the call and can have the same URI value. 8e1813e

Important changes since 1.0.0

  • Removed dependency on androidx.legacy library and dropped support for legacy Space class in GridLayout. Developers should be using the platform version of Space (android.widget.Space) class instead of the androidx.legacy version.

New Features

  • Added experimental Personal Health Record (PHR) APIs for reading and writing medical data, based on the Fast Healthcare Interoperability Resources (FHIR®) format. PHR APIs include:
    • A FEATURE_PERSONAL_HEALTH_RECORD constant to check if PHR is available through the feature availability API.
    • APIs for applications writing medical data sources and records.
    • APIs for applications reading medical data sources and records based on user-granted permissions.
  • Added experimental Mindfulness Session Record APIs I51c13, including:
    • APIs for applications writing mindfulness session data.
    • APIs for applications reading mindfulness session data based on user-granted permissions.

Bug Fixes

  • For Android U and higher, Jetpack's validation for ElevationGainedRecord, FloorsClimbedRecord, HeartRateVariabilityRmssdRecord, HeightRecord, HydrationRecord, LeanBodyMassRecord, NutritionRecord, OxygenSaturationRecord, RespiratoryRateRecord,RestingHeartRateRecord, StepsRecord, TotalCaloriesBurnedRecord, Vo2MaxRecord, WeightRecord, and WheelchairPushesRecord values has been replaced with the platform's validation. I0f40d

New Features

  • Introduces new experimental APIs for custom BrushFamily objects, enabling new brushes like Pencil and Laser Pointer. The API allows for loading brushes defined by this proto. I8809a

API Changes

  • Lifecycle ViewModel Compose now uses the same Kotlin Multiplatform setup as Compose Runtime 1.7.1 and higher - the -desktop artifacts are now removed and -jvmStubs and -linuxx64Stubs artifacts have been added. None of these targets are meant to be used, they are placeholders to help Jetbrains Compose efforts. I5cb14 b/406592090

Dependency Updates

  • This library now targets Kotlin 2.0 language level and requires KGP 2.0.0 or newer. Idb6b5
  • Lifecycle ViewModel Compose now depends on Compose 1.7.8. I5cb14 b/406592090

API Changes

  • The common API of parseStringAsNavUri has been changed to a NavUri factory function that takes a String. I4db6e b/403616316

Dependency Updates

  • This library now targets Kotlin 2.0 language level and requires KGP 2.0.0 or newer. Idb6b5

Bug Fixes

  • This library now uses JSpecify nullness annotations, which are type-use. Kotlin developers should use the following compiler argument to enforce correct usage: -Xjspecify-annotations=strict (this is the default starting with version 2.1.0 of the Kotlin compiler). If585e b/326456246
  • Removed manual outlining of access to new platform APIs since this happens automatically via API modeling when using R8 with AGP 7.3 or later (e.g. R8 version 3.3) and for all builds when using AGP 8.1 or later (e.g. D8 version 8.1). Clients who are not using AGP are advised to update to D8 version 8.1 or later. See this article for more details. If6b4c b/345472586

Important changes since 2.6.0

  • Kotlin Multiplatform (KMP) Support: In this release, Room has been refactored to become a Kotlin Multiplatform (KMP) library. Current supported platforms are Android, iOS, JVM (Desktop), native Mac and native Linux. For more information on how to get started using Room KMP, please refer to the official Room KMP documentation. As part of the KMP support, Room can also be configured with an SQLiteDriver, for information on how to migrate an existing app to the driver APIs and to Room KMP, see the migration documentation.
  • Kotlin Code Generation on KSP has been turned ON by default if processing is done via KSP. For KAPT or Java only projects, Room will still generate Java sources.
  • Kotlin 2.0 and KSP2: Room now targets Kotlin language 2.0 and will require projects to also compile with Kotlin 2.0 and equivalent or higher language version. Support for KSP2 is also added and is recommended when using Room with Kotlin 2.0 or higher.

Important changes since 2.4.0

  • Kotlin Multi-Platform (KMP) Support: With the release of Room KMP version 2.7.0 the SQLite APIs that enable Room to be KMP have also been updated. The package andriodx.sqlite contains three interfaces that define low-level SQLite APIs: SQLiteDriver, SQLiteConnection and SQLiteStatement. The artifact androidx.sqlite:sqlite-framework offers implementation of the interfaces for Android and iOS natively, while androidx.sqlite:sqlite-bundled offers an implementation that uses SQLite compiled from source (also known as “bundled SQLite”). For more information about the SQLite Driver API refer to the official SQLite KMP documentation.

API Changes

  • Fixed a crash in PreviewChannelHelper.getAllChannels(). I5041f

Bug Fixes

  • This library now uses JSpecify nullness annotations, which are type-use. Kotlin developers should use the following compiler argument to enforce correct usage: -Xjspecify-annotations=strict (this is the default starting with version 2.1.0 of the Kotlin compiler). I4fcdf b/326456246

External Contribution

  • Removed RestrictTo(LIBRARY) annotation from TvContractCompact.PreviewProgramColumns interface for public access of aspect ratio. Id610a b/138150076
  • Removed RestrictTo(LIBRARY) annotation from PreviewProgram.PROJECTION and WatchNextProgram.PROJECTION for making them public I04256 b/138150076

API Changes

  • Projects released with Kotlin 2.0 require KGP 2.0.0 or newer to be consumed Idb6b5
  • Added targetPage property to PagerState I4de8b

Bug Fixes

  • Prevent unnecessary recomposition during predictive back. Iecd6d
  • Fixed ScrollInfoProvider’s isScrollable property to return the current value. Icbfb8

API Changes

  • Replaced ButtonDefaults.imageBackgroundButtonColors with ImageButton, ButtonDefaults.imageButtonColors, ButtonDefaults.containerPainter and ButtonDefaults.disabledContainerPainter. And similar changes for Card. The painters are removed from ButtonColors and CardColors. I8c6a1
  • Updated placeholders to simplify the API. We now provide two Modifiers, Modifier.placeholderShimmer to apply a shimmer effect at the component level, and Modifier.placeholder to apply a mask on top of unloaded content Iaee7a

Bug Fixes

  • Integrated overscroll into the ScrollIndicator. Icfb7f
  • Address blank backgrounds and missing dialogs when launching material3 dialogs. Ice597
  • Fixed issues in FadingExpandingLabel when text spans multiple lines. I04eb7
  • Updated padding between primary and secondary labels on buttons. I99b7b
  • ArcLarge has been reduced from 20sp to 18sp, and letter spacings on ArcLarge and ArcSmall have been updated. ConfirmationDialog/OpenOnPhoneDialog now use the default ArcLarge instead of overriding it to 18sp. Id39a8

Dependency Updates

  • This library now targets Kotlin 2.0 language level and requires KGP 2.0.0 or newer. Idb6b5

New Features

The 1.3.0-beta01 release of Wear ProtoLayout indicates that this release of the library is feature complete and the API is locked (except where marked as experimental). Wear ProtoLayout 1.3 includes the following new functionalities and APIs:

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

New Features

The 1.5.0-beta01 release of Wear Tiles indicates that this release of the library is feature complete and the API is locked (except where marked as experimental). Wear Tiles 1.5 includes the following new functionalities and APIs:

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

New Features

  • Introducing the PaymentRequest API for invoking Android native payment apps through org.chromium.intent.action.PAY intent. PaymentRequest is disabled by default and WebView host apps can call WebSettingsCompat.setPaymentRequestEnabled(settings, true) to enable it. In addition, PaymentRequest requires a <queries> tag in AndroidManifest.xml. See documentation for setPaymentRequestEnabled() for more information. I3304e b/404920055
  • Introducing Experimental Navigation Callbacks. This release introduces experimental APIs for enhanced web navigation tracking and management within WebView. These APIs provide detailed information about navigation events. Key Features:
    • WebNavigationClient Interface: Introduces a new interface, WebNavigationClient, with callbacks for navigation events:
    • onNavigationStarted(Navigation navigation): Notifies when a navigation begins.
    • onNavigationRedirected(Navigation navigation): Notifies when a navigation is redirected.
    • onNavigationCompleted(Navigation navigation): Notifies when a navigation completes.
    • Navigation Interface: Provides detailed information about a navigation, including: URL, page initiation status, same-document status, reload status, history status, back/forward status, commit status, error page status, status code, and session restore status. The Navigation object serves as a unique identifier for each navigation, allowing developers to correlate related navigation events.
    • Page class: Introduces the Page class, which serves as a key for page-associated data. I351a6
  • Introduce a new experimental API to toggle the behaviour of caching provider objects. I14636

API Changes

  • Updated the PROFILE_URL_PREFETCH feature value in WebViewFeature. I606fd
  • Adds WebViewCompat#saveState, akin to WebView#saveState, but allows restricting the size of the returned state and deciding whether or not to save forward history entries. Iea7d6
  • Add maxPrerenders config to SpeculativeLoadingConfig API I67245