Important changes
- This library now targets Kotlin 2.0 language level and requires KGP 2.0.0 or newer Idb6b5
Important changes since 1.0.0
- Allows configuring a
AsyncLayoutFactorywhen initializingAsyncLayoutInflater. For AppCompat context, this can be provided throughAsyncAppCompatFactorywhich initializes AppCompat views correctly. - The
inflateAPI accepts an executor on whichOnInflateFinishedListenercallback can be triggered.
API Changes
- Changed
TraceProcessor's argument timeout: Duration to timeoutMs long for Java caller usability. I9fbb5 - Mark
TraceProcessorconstructor as internal. Callers should useTraceProcessor.startServerorTraceProcessor.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
- Added support for multiple Progressive Web App APIs, such as Launch Handler, Protocol Handler and File Handler
API Changes
- Added overloads for
CustomTabsClient#createPendingAuthTabSession. I71c3a - Updated Auth Tab APIs Iaf9b1
- The
TrustedWebActivityIntentnow includes Launch Handler API client mode that allows a browser to use this API. Ifc95c - The
TrustedWebActivityIntentnow includes URIs of files opened via the app's registered intent filters, and grants the browser read-write permissions to those files. I2134a TrustedWebActivityIntentnow 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
ListItemcorrects its intrinsic height calculation, now reserving the appropriate amount of space in Layout.- Remove excess
NavigationBarItemlabel padding, correctly aligning with spec. - Corrects
TabRowLayout in RTL mode.
API Changes
- Removed android specific parameters from
ModalBottomSheetPropertiesIab97f b/362539765 - Introduce overloading functions for drag handle size defaults I0ed0d
- Add new
NavigationSuiteScaffoldandNavigationSuiteScaffoldLayoutfunctions to support new layout types and add support for an optional primary action content. Ib262a b/353144478 - Deprecate
Modifier.weightwith fill parameter inButtonGroup. Adding a version without fill. Id32bb - Rename
xSmall-andxLarge-IconButton component defaults to spell outextra. Ib6e0f - Add new
NavigationSuite,NavigationSuiteItemandNavigationSuiteColorsfunctions to support new layout types. I203d6 - Add new
NavigationSuiteTypesand add newnavigationSuiteTypefunction that include those layout choices If68f9
Bug Fixes
ColorScheme.contentColorFornow mapssurfaceDimtoonSurface. I8891a- Updated
DateInputTextFieldimplementation 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
Bug Fixes
- Disables some focus interop fixes that caused a regression. b9d998 b/369256395 b/378570682 b/376142752 b388590015/ b/389994198 b/391378895
Important changes since 1.15.0
- 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). Iaf3e1 b/326456246
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.MessageFormatthat 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, whichandroid.icu.text.MessageFormatdoes 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
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). b/326456246 - Fix documentation issues in documentfile b/337250687
API Changes
DynamicAnimationlibrary is now stable.
Important changes since 1.0.0
- Removed dependency on
androidx.legacylibrary and dropped support for legacySpaceclass in GridLayout. Developers should be using the platform version ofSpace(android.widget.Space) class instead of theandroidx.legacyversion.
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_RECORDconstant 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.
- A
- 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, andWheelchairPushesRecordvalues has been replaced with the platform's validation. I0f40d
New Features
- Introduces new experimental APIs for custom
BrushFamilyobjects, enabling new brushes like Pencil and Laser Pointer. The API allows for loading brushes defined by this proto. I8809a
API Changes
Lifecycle ViewModel Composenow uses the same Kotlin Multiplatform setup as Compose Runtime 1.7.1 and higher - the-desktopartifacts are now removed and-jvmStubsand-linuxx64Stubsartifacts 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 Composenow depends on Compose 1.7.8. I5cb14 b/406592090
API Changes
- The common API of
parseStringAsNavUrihas been changed to aNavUrifactory 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
API Changes
- Deprecated
ViewCompat.LAYOUT_DIRECTION_APIs I51710 b/317055535
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). I03b80 b/326456246
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.
Dependency Updates
- This library now targets Kotlin 2.0 language level and requires KGP 2.0.0 or newer. Idb6b5
API Changes
- Deprecated all APIs in favour of existing platform APIs and direct use of Android Keystore.
Important changes since 2.4.0
- Kotlin Multi-Platform (KMP) Support: With the release of Room KMP version 2.7.0 the
SQLiteAPIs that enable Room to be KMP have also been updated. The packageandriodx.sqlitecontains three interfaces that define low-levelSQLiteAPIs:SQLiteDriver,SQLiteConnectionandSQLiteStatement. The artifactandroidx.sqlite:sqlite-frameworkoffers implementation of the interfaces for Android and iOS natively, whileandroidx.sqlite:sqlite-bundledoffers an implementation that uses SQLite compiled from source (also known as “bundled SQLite”). For more information about theSQLiteDriver 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 fromTvContractCompact.PreviewProgramColumnsinterface for public access of aspect ratio. Id610a b/138150076 - Removed
RestrictTo(LIBRARY)annotation fromPreviewProgram.PROJECTIONandWatchNextProgram.PROJECTIONfor making them public I04256 b/138150076
API Changes
- Replaced
ButtonDefaults.imageBackgroundButtonColorswithImageButton,ButtonDefaults.imageButtonColors,ButtonDefaults.containerPainterandButtonDefaults.disabledContainerPainter. And similar changes for Card. The painters are removed fromButtonColorsandCardColors. I8c6a1 - Updated placeholders to simplify the API. We now provide two Modifiers,
Modifier.placeholderShimmerto apply a shimmer effect at the component level, andModifier.placeholderto 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
FadingExpandingLabelwhen text spans multiple lines. I04eb7 - Updated padding between primary and secondary labels on buttons. I99b7b
ArcLargehas been reduced from20spto18sp, and letter spacings onArcLargeandArcSmallhave been updated.ConfirmationDialog/OpenOnPhoneDialognow use the defaultArcLargeinstead of overriding it to18sp. 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-material3library 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
MaterialScopefor taking care of all opinionated defaults and easier customizationiconEdgeButton,textEdgeButtoniconButton,textButton,button,imageButton,avatarButton,compactButtontitleCard,appCard,graphicDataCard,iconDataCard,textDataCardcircularProgressIndicator,segmentedCircularProgressIndicatorprimaryLayout,buttonGroup- All components work across any SDK levels and ProtoLayout Renderer version, supplying sensible fallbacks where applicable
- This includes Kotlin-only,
- More Kotlin-friendly, Compose-like APIs for base ProtoLayout elements
LayoutModifierwith ability to add the most of modifiers as chained functions (padding,contentDescription(includingclearSemantics),background,clip,opacityetc.), convertible to the existingModifiersobjectLayoutColorsandLayoutStringas types with easier support for using dynamic fields and constraintstextandfontStyle- better map support for
StateBuilder, includingDynamicDataMapand factory methods such asintAppDataKeyfor easier creation ofAppDataKeyobjects
- 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
Brushthat can be used inBackgroundmodifiers for elements such asBox,Spacer, etc. … - Allow dynamic color values in
ColorStopused 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-expressionto 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
DashedArcLinewith improved set of features so that line can have dashes, as opposed to the existingArcLine ArcSpacersupport for setting its length in DP dimension instead of degrees- Added roundness
FontSettingaxis 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
TileServiceforonEnterEventandonLeaveEventare deprecated and won’t work from SDK 36+ for Apps targeting API 36 or more
- The existing APIs in
- 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
PaymentRequestAPI for invoking Android native payment apps throughorg.chromium.intent.action.PAYintent.PaymentRequestis disabled by default and WebView host apps can callWebSettingsCompat.setPaymentRequestEnabled(settings, true)to enable it. In addition,PaymentRequestrequires a<queries>tag inAndroidManifest.xml. See documentation forsetPaymentRequestEnabled()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:WebNavigationClientInterface: 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.NavigationInterface: 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. TheNavigationobject serves as a unique identifier for each navigation, allowing developers to correlate related navigation events.Pageclass: Introduces thePageclass, 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_PREFETCHfeature value inWebViewFeature. I606fd - Adds
WebViewCompat#saveState, akin toWebView#saveState, but allows restricting the size of the returned state and deciding whether or not to save forward history entries. Iea7d6 - Add
maxPrerendersconfig toSpeculativeLoadingConfigAPI I67245