Core

Code Sample

API Reference
androidx.core.animation
androidx.core.app
androidx.core.content
androidx.core.role
androidx.core.view
(See the refdocs for all core packages)

Target the latest platform features and APIs while also supporting older devices.

This table lists all the artifacts in the androidx.core group.

Artifact	Stable Release	Release Candidate	Beta Release	Alpha Release
core	1.15.0	-	-	-
core-animation	1.0.0	-	-	-
core-google-shortcuts	1.1.0	-	-	1.2.0-alpha01
core-performance	1.0.0	-	-	-
core-remoteviews	1.1.0	-	-	-
core-role	1.0.0	1.1.0-rc01	-	-
core-splashscreen	1.0.1	1.1.0-rc01	-	1.2.0-alpha02

This library was last updated on: October 30, 2024

Declaring dependencies

To add a dependency on Core, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

Groovy

dependencies {
    def core_version = "1.15.0"

    // Java language implementation
    implementation "androidx.core:core:$core_version"
    // Kotlin
    implementation "androidx.core:core-ktx:$core_version"

    // To use RoleManagerCompat
    implementation "androidx.core:core-role:1.0.0"

    // To use the Animator APIs
    implementation "androidx.core:core-animation:1.0.0"
    // To test the Animator APIs
    androidTestImplementation "androidx.core:core-animation-testing:1.0.0"

    // Optional - To enable APIs that query the performance characteristics of GMS devices.
    implementation "androidx.core:core-performance:1.0.0"

    // Optional - to use ShortcutManagerCompat to donate shortcuts to be used by Google
    implementation "androidx.core:core-google-shortcuts:1.1.0"

    // Optional - to support backwards compatibility of RemoteViews
    implementation "androidx.core:core-remoteviews:1.1.0"

    // Optional - APIs for SplashScreen, including compatibility helpers on devices prior Android 12
    implementation "androidx.core:core-splashscreen:1.2.0-alpha02"
}

Kotlin

dependencies {
    val core_version = "1.15.0"

    // Java language implementation
    implementation("androidx.core:core:$core_version")
    // Kotlin
    implementation("androidx.core:core-ktx:$core_version")

    // To use RoleManagerCompat
    implementation("androidx.core:core-role:1.0.0")

    // To use the Animator APIs
    implementation("androidx.core:core-animation:1.0.0")
    // To test the Animator APIs
    androidTestImplementation("androidx.core:core-animation-testing:1.0.0")

    // Optional - To enable APIs that query the performance characteristics of GMS devices.
    implementation("androidx.core:core-performance:1.0.0")

    // Optional - to use ShortcutManagerCompat to donate shortcuts to be used by Google
    implementation("androidx.core:core-google-shortcuts:1.1.0")

    // Optional - to support backwards compatibility of RemoteViews
    implementation("androidx.core:core-remoteviews:1.1.0")

    // Optional - APIs for SplashScreen, including compatibility helpers on devices prior Android 12
    implementation("androidx.core:core-splashscreen:1.2.0-alpha02")
}

For more information about dependencies, see Add Build Dependencies.

Feedback

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

Core-i18n Core-location-altitude Version 1.0.

Version 1.0.0-alpha03

October 16, 2024

androidx.core:core-location-altitude:1.0.0-alpha03, androidx.core:core-location-altitude-external-protobuf:1.0.0-alpha03, and androidx.core:core-location-altitude-proto:1.0.0-alpha03 are released. Version 1.0.0-alpha03 contains these commits.

Security fix

As of this change, androidx compiles against protobuf 4.28.2 in order to address CVE-2024-7254. Upgrade your dependency on androidx.core:core-location-altitude-protoand androidx.core:core-location-altitude-external-protobuf to 1.1.0-alpha03 to address the vulnerability risk.

Bug Fixes

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. (Ieb9ae, b/345472586)

Version 1.0.0-alpha02

June 12, 2024

androidx.core:core-location-altitude:1.0.0-alpha02, androidx.core:core-location-altitude-external-protobuf:1.0.0-alpha02, and androidx.core:core-location-altitude-proto:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits.

Bug Fixes

Fixes proguard failure caused by the repackaging of proto libraries.

External Contribution

Bug fix above provided by [email protected]

Version 1.0.0-alpha01

July 26, 2023

androidx.core:core-i18n:1.0.0-alpha01 and androidx.core:core-location-altitude:1.0.0-alpha01 are released. Version 1.0.0-alpha01 contains these commits.

New Features

Added AltitudeConverterCompat class with a single static method addMslAltitudeToLocation(Context, Location) (I11168).

Core-telecom Version 1.0.

Version 1.0.0-alpha03

April 17, 2024

androidx.core:core-telecom:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

Bug Fixes

Refactor of JetpackConnectionService to correct an issue which occurs on SDK 33 and below when the address passed in is empty. The refactored JetpackConnectionService is also resilient to unexpected NULL values from Telecom platform APIs.
Improvements to addCall/CallControlScope API documentation.
Test reliability improvements.

Version 1.0.0-alpha02

October 4, 2023

androidx.core:core-telecom:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

API Changes

Revamped the API signatures for methods that returned boolean to indicate success/failure to instead return a result class that clearly indicates why an operation succeeded or failed.
Moved the CallControlCallback methods as lambda args to addCall to remove the need to explicitly provide a callback in the call scope.

Bug Fixes

Fixed a bug in the ConnectionService compatibility layer which would have resulted in no call audio when running against pre-U SDKs.
Improve API documentation.

Version 1.0.0-alpha01

May 10, 2023

androidx.core:core-telecom:1.0.0-alpha01 is released. This version is developed in an internal branch and should be used with Android 14 Beta 2.

New Features

Introduces the CallsManager API which VoIP apps can use for integrating with the Telecom framework on a device. Calls notified to the platform benefit from foreground execution priority, visibility on Bluetooth, wearable and automotive devices, and simplified audio routing.

The CallsManager API wraps the legacy ConnectionService API for devices running older versions of Android.

Core and Core-ktx Version 1.15

Version 1.15.0

October 30, 2024

androidx.core:core:1.15.0, androidx.core:core-ktx:1.15.0, and androidx.core:core-testing:1.15.0 are released. Version 1.15.0 contains these commits.

Important changes since 1.14.0

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. (Ieb9ae, b/345472586)
Various updates to compatibility classes for parity with Android 15 SDK.

Version 1.15.0-rc01

October 16, 2024

androidx.core:core:1.15.0-rc01, androidx.core:core-ktx:1.15.0-rc01, and androidx.core:core-testing:1.15.0-rc01 are released. Version 1.15.0-rc01 contains no changes since the previous release.

Version 1.15.0-beta01

October 2, 2024

androidx.core:core:1.15.0-beta01, androidx.core:core-ktx:1.15.0-beta01, and androidx.core:core-testing:1.15.0-beta01 are released. Version 1.15.0-beta01 contains these commits.

API Changes

Added itemCount and importantForAccessibilityItemCount fields to CollectionInfoCompat. (Ibaf34)

Bug Fixes

Fix documentation issues in androidx.core.os.Profiling (I2542f)

Version 1.15.0-alpha02

August 21, 2024

androidx.core:core:1.15.0-alpha02, androidx.core:core-ktx:1.15.0-alpha02, and androidx.core:core-testing:1.15.0-alpha02 are released. Version 1.15.0-alpha02 contains these commits.

Important changes

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. (Ieb9ae, b/345472586)

API Changes

Added fallbackQuery XML attribute to downloadable font definitions, allowing character-level fallback with downloadable fonts. (Idd544)
Adds helper APIs for using ProfilingManager (If2292)
Add compat method for ActivityOptions.setPendingIntentBackgroundActivityStartMode (I3ba1f, b/349617674)
Added DisplayCutoutCompat.getCutoutPath (I58778, b/279635904)
Reverts deprecation of ParcelCompat.writeBoolean and delegates to the platform API on API level 29 and above. (I9d243, b/313834577)
Create FontsContractCompat.requestFonts that takes executors (I03016, b/302377512)
Reverts deprecation of LocationCompat.isMock and delegates to the platform API on API level 31 and above. (I55940, b/313834577)
Notifications can now be tagged as voicemail. (I068ab)

Version 1.15.0-alpha01

June 12, 2024

androidx.core:core:1.15.0-alpha01, androidx.core:core-ktx:1.15.0-alpha01, and androidx.core:core-testing:1.15.0-alpha01 are released. This version is developed in an internal branch and is compatible with Android 15 Beta 3 (android-35).

API Changes

Various updates to compatibility classes for parity with Android 15 SDK.

Core and Core-ktx Version 1.14

Version 1.14.0-alpha01

May 1, 2024

androidx.core:core:1.14.0-alpha01, androidx.core:core-ktx:1.14.0-alpha01, and androidx.core:core-testing:1.14.0-alpha01 are released. Version 1.14.0-alpha01 contains these commits.

New Features

Move to 21 as the default minSdkVersion of androidx libraries (I6ec7f)

API Changes

Deprecate additional obsolete compat methods. (Ie4470, b/313834577)
Deprecated obsolete compat methods. (I01d90, b/313834577)
Updated isAtLeastV() to return true for finalized V SDK. (I6339a)

Core and Core-ktx Version 1.13

Version 1.13.1

May 1, 2024

androidx.core:core:1.13.1, androidx.core:core-ktx:1.13.1, and androidx.core:core-testing:1.13.1 are released. Version 1.13.1 contains these commits.

Bug Fixes

Fix issue where when handwriting toolbar is shown, a finger tap can't switch to the regular keyboard (I7f843, b/332769437)

Version 1.13.0

April 17, 2024

androidx.core:core:1.13.0, androidx.core:core-ktx:1.13.0, and androidx.core:core-testing:1.13.0 are released. Version 1.13.0 contains these commits.

Important changes since 1.12.0

The library’s minSdkVersion has been raised to 19. Many compatibility APIs have been marked deprecated since they were only needed prior to API level 19.
Several classes have been rewritten in Kotlin to provide better interoperability with Kotlin consumers while preserving Java compatibility.
Removed FingerprintManagerCompat, which is a no-op starting in Android V and should not be used on earlier platforms. Clients should migrate to BiometricPrompt immediately.
Added PathParser, which can create a Path instance from SVG path strings.

Version 1.13.0-rc01

April 3, 2024

androidx.core:core:1.13.0-rc01, androidx.core:core-ktx:1.13.0-rc01, and androidx.core:core-testing:1.13.0-rc01 are released. Version 1.13.0-rc01 contains these commits.

Bug Fixes

Fix retrieving initial system bar appearance on API 30+ (I18596, b/219993701)

Version 1.13.0-beta01

March 20, 2024

androidx.core:core:1.13.0-beta01, androidx.core:core-ktx:1.13.0-beta01, and androidx.core:core-testing:1.13.0-beta01 are released. Version 1.13.0-beta01 contains these commits.

API Changes

PathParser is now final, interpolatePathDataNodes now throws an exception for incompatible arguments instead of returning a boolean, and nodesToPath now belongs to PathParser rather than PathParser.PathDataNode. (I20d62)
FingerprintManagerCompat has been soft-removed prior to its removal from the Android V platform SDK. The implementation will be replaced with a no-op in the near future, and developers should migrate away from this class immediately. (I7ca1b)
The Pool interface and its subclasses, SimplePool and SynchronizedPool are now written in Kotlin. The generic type of objects being stored in the Pool must now be non-null. (I08afe)

External Contribution

GestureDetectorCompat is now deprecated as GestureDetector is guaranteed to be available in the platform at the library’s minimum SDK version. Thanks to Jake Wharton for the contribution. (Icc4cd)
MarginLayoutParamsCompat is now deprecated as MarginLayoutParams is guaranteed to be available in the platform as the library’s minimum SDK version. Thanks to Jake Wharton for the contribution. (I4e0c3)

Version 1.13.0-alpha05

February 7, 2024

androidx.core:core:1.13.0-alpha05, androidx.core:core-ktx:1.13.0-alpha05, and androidx.core:core-testing:1.13.0-alpha05 are released. Version 1.13.0-alpha05 contains these commits.

External Contribution

Thanks to Matthew Zavislak for updating the ContextCompat.registerReceiver documentation for correctness. (8fd733)

Version 1.13.0-alpha04

January 24, 2024

androidx.core:core:1.13.0-alpha04, androidx.core:core-ktx:1.13.0-alpha04, and androidx.core:core-testing:1.13.0-alpha04 are released. Version 1.13.0-alpha04 contains these commits.

New Features

Added AlarmManagerCompat.canScheduleExactAlarms API (I62e95, b/315440583)

Kotlin Conversions

The androidx.core.util.Consumer class has been rewritten in Kotlin and now enforce that the generic type T now matches the nullability of what the accept() method receives. (Ie21e0)
androidx.core.util.Supplier has been converted to Kotlin, ensuring that the nullability of the type returned by get() matches the nullability of the generic type. (I21e9c)
androidx.core.util.Function has been rewritten in Kotlin, ensuring that the nullability of the input and outputs of the function match the generic types used. (I09dd7)

External Contribution

Thanks to Kamal Faraj for adding the AlarmManagerCompat.canScheduleExactAlarms API (I62e95, b/315440583)

Version 1.13.0-alpha03

January 10, 2024

androidx.core:core:1.13.0-alpha03, androidx.core:core-ktx:1.13.0-alpha03, and androidx.core:core-testing:1.13.0-alpha03 are released. Version 1.13.0-alpha03 contains these commits.

API Changes

Deprecated ListViewCompat, use ListView directly. (Iacce6, b/318353933)
Deprecated ViewCompat.LAYOUT_DIRECTION_ APIs. (I51710, b/317055535)
Deprecated obsolete compat methods in ViewCompat. (I0bfc2, b/313834577)

Version 1.13.0-alpha02

November 29, 2023

androidx.core:core:1.13.0-alpha02, androidx.core:core-ktx:1.13.0-alpha02, and androidx.core:core-testing:1.13.0-alpha02 are released. Version 1.13.0-alpha02 contains these commits.

New Features

Adds the OnUserLeaveHintProvider interface to allow any component to receive onUserLeaveHint events necessary for implementing picture-in-picture. This is implemented by ComponentActivity in Activity 1.9.0-alpha01. (I54892)

API Changes

Deprecated androidx.core.os.CancellationSignal. Usages should be replaced with the platform-provided android.os.CancellationSignal. (Id45f6, b/309499026, b/309054079)
The OnMultiWindowModeChangedProvider, OnNewIntentProvider, OnPictureInPictureModeChangedProvider, OnConfigurationChangedProvider, and OnTrimMemoryProvider interfaces have been converted to Kotlin to ensure that the generic parameters on the Consumer that their listener methods take have the correct nullability (they are all non-null). (Ib6237)
The MultiWindowModeChangedInfo and PictureInPictureModeChangedInfo classes that are sent to the Consumer added to their respective Provider interfaces are now written in Kotlin. (Ie08e2)

Dependency Update

Core now depends on Lifecycle 2.6.2. (I2d94c)

Version 1.13.0-alpha01

October 18, 2023

androidx.core:core:1.13.0-alpha01, androidx.core:core-ktx:1.13.0-alpha01, and androidx.core:core-testing:1.13.0-alpha01 are released. Version 1.13.0-alpha01 contains these commits.

API Changes

Make PathParser public. The class can create a Path instance from SVG path strings. (Ic7af2, b/302376846)
Added compat method for Context.createAttributionContext. (I61dcf, Ibe187)
Marks NotificationCompatSideChannelService as deprecated. (I18fd9)
New API for differential motion fling. (I46b0d, Ia9f68)
Additional compat APIs for VelocityTracker to track platform SDK. (I32753)

Bug Fixes

Override equals and hashCode methods in Person. (I610a5)

Core and Core-ktx Version 1.12

Version 1.12.0

September 6, 2023

androidx.core:core:1.12.0, androidx.core:core-ktx:1.12.0, and androidx.core:core-testing:1.12.0 are released. Version 1.12.0 contains these commits.

Important changes since 1.11.0

Many compat methods added for SDK 34 parity with TextView, AccessibilityNodeInfo, etc.
New LocalePreferences APIs to help developers to easily access locale data or user's locale preferences.
Deprecated app.BundleCompat in favor of os.BundleCompat.
Deprecated BuildCompat.isAtLeastU(). Use SDK_INT >= 34 instead.

Version 1.12.0-rc01

August 9, 2023

androidx.core:core:1.12.0-rc01, androidx.core:core-ktx:1.12.0-rc01, and androidx.core:core-testing:1.12.0-rc01 are released with no major changes. Version 1.12.0-rc01 contains these commits.

Version 1.12.0-beta01

July 26, 2023

androidx.core:core:1.12.0-beta01, androidx.core:core-ktx:1.12.0-beta01, and androidx.core:core-testing:1.12.0-beta01 are released. Version 1.12.0-beta01 contains these commits.

API Changes

Added setLineHeight(unit, lineHeight) to TextViewcompat classes (Ia9fa9)
Added TypedValueCompat.getUnitFromComplexDimension() from Android 14 (I958e8)
Added setLineHeight(unit, lineHeight) to TextView compat classes (Ib2ee1)
Backport miscellaneous Accessibility APIs (Ic65ba)
Backport API 34 AccessibilityNodeInfo methods (I44182)
Graduate stable SDK checks out of experimental (Ia9b35)
Backport AccessiiblityWindowInfo 34 APIs (I96a5d)
Deprecated BuildCompat.isAtLeastU(). Use SDK_INT >= 34 instead. (I4f8e7, b/289269026)
Removed usages of experimental isAtLeastU() API (Ie9117, b/289269026)
Migrated BuildCompat to Kotlin for enhanced Deprecated tag (I56775, b/289269026)
Added setLineHeight(unit, lineHeight) to TextView compat classes (I15716)
New accessibilityDataSensitive compat property. (I0c6e0)
PendingIntentCompat.getActivity and getService may return null when FLAG_NO_CREATE is specified. (Iffdf0, b/289696515)
Updated API files to annotate compatibility suppression (I8e87a, b/287516207)
Added PendingIntentCompat.send() (Iaf707)
Adds compat versions of Location.removeVerticalAccuracy(), Location.removeSpeedAccuracy(), and Location.removeBearingAccuracy(). (I5b640)

Bug Fixes

Made a view important for accessibility if the view has an accessibility delegate. (If2b54)

Version 1.12.0-alpha05

June 7, 2023

androidx.core:core:1.12.0-alpha05, androidx.core:core-ktx:1.12.0-alpha05, and androidx.core:core-testing:1.12.0-alpha05 are released. This version is developed in an internal branch.

Bug Fixes

Updated the documentation on the ColorUtils classes for generating a color from the Material 3 Hue, Chroma, and Tone (M3HCT) parameters. (I32979, I21c8c)
Fix deprecation replaceWith for android.os.Trace (I730f9)

Version 1.12.0-alpha04

May 10, 2023

androidx.core:core:1.12.0-alpha04, androidx.core:core-ktx:1.12.0-alpha04, and androidx.core:core-testing:1.12.0-alpha04 are released. This was released from an internal branch.

Version 1.12.0-alpha03

April 12, 2023

androidx.core:core:1.12.0-alpha03, androidx.core:core-ktx:1.12.0-alpha03, and androidx.core:core-testing:1.12.0-alpha03 are released. This was released from an internal branch.

API Changes

Unhides NotificationCompat.TvExtender (aosp/01c67677e9310b2cf4c536d7e951e117d6cce64a)
Added public methods to access M3HCT parameters and turn M3HCT values into ARGB (aosp/06810598aa94bee731bbe0d277933b8b9614934e)
Added NotificationManager.getCurrentInterruptionFilter (aosp/b0c6940639e35371d212a7ebd7dbf01c14fc7710)
Added getCurrentInterruptionFilter to NotifManagerCompat (aosp/516143e05f824ff49bde3c0c97344a2924867d30)
Deprecated app.BundleCompat in favor of os.BundleCompat (aosp/bf6169fe9ee1113065d0cf380bd2e09f31ce0a40)
Added TestConsumer so developers can record values in a test. (aosp/f75a4913940e710842168c832a7f57c2dcae4fdf)
Added TestConsumer so developers can record values in a test.(aosp/67ad4e2c6488772b7c9a061ee6ca01bba23649f7)

Bug Fixes

Fixed a bug where unregisterGnssMeasurementsCallback() does not work properly below Android R. (aosp/c5a97c4ee956f87d229ec892f2b8849f392e956c)

Version 1.12.0-alpha01

March 8, 2023

androidx.core:core:1.12.0-alpha01 and androidx.core:core-ktx:1.12.0-alpha01 are released. Version 1.12.0-alpha01 contains these commits.

New Features

Provides APIs to help developers to easily access user's preference or the locale data in ICU. The accessible locale data includes hour cycle, calendar type, temperature unit, and first day of week.

API Changes

Added new APIs LocalePreferences to help developers to easily access locale data or user's locale preferences.

Core and Core-ktx Version 1.11

Version 1.11.0-beta02

June 7, 2023

androidx.core:core:1.11.0-beta02, androidx.core:core-ktx:1.11.0-beta02, and androidx.core:core-testing:1.11.0-beta02 are released. Version 1.11.0-beta02 contains these commits.

Bug Fixes

Updated the documentation on the ColorUtils classes for generating a color from the Material 3 Hue, Chroma, and Tone (M3HCT) parameters. (I32979, I21c8c)
Fix deprecation replaceWith for android.os.Trace (I730f9)

Version 1.11.0-beta01

May 24, 2023

androidx.core:core:1.11.0-beta01, androidx.core:core-ktx:1.11.0-beta01, and androidx.core:core-testing:1.11.0-beta01 are released. Version 1.11.0-beta01 contains these commits.

API Changes

Add ViewCompat support to method performHapticFeedback (Ib02c6)
Change getDisplay to #getDisplayOrDefault (I96ff9)
Add ContextCompat#getDisplay(Context) (I7011f, b/178183326)
Add ContextCompat#getContextForLanguage(Context) for getting per-app locales in non-Activity context (I58e75, b/243457462)

Bug Fixes

Clarify CollectionInfoCompat docs, especially isHierarchical (I14f6c)

Version 1.11.0-alpha04

May 10, 2023

androidx.core:core:1.11.0-alpha04, androidx.core:core-ktx:1.11.0-alpha04, and androidx.core:core-testing:1.11.0-alpha04 are released. Version 1.11.0-alpha04 contains these commits.

API Changes

Added LinkMovementMethodCompat that fixes link touch handling (Ia632c)
PendingIntent.getBroadcast() is now correctly marked @Nullable (Ifff96, b/277630907)

Bug Fixes

Fixed Context leak in DisplayManagerCompat (I3409b, b/279625765)
Added a SoftwareKeyboardControllerCompat to provide direct methods to show and hide the software keyboard given a View. This backports workarounds for known issues when using the WindowInsetsController APIs on some API levels, and is the extraction of the backing implementation for WindowInsetsControllerCompat.show and hide for the IME inset types. (Idd0a3)

Version 1.11.0-alpha03

April 19, 2023

androidx.core:core:1.11.0-alpha03, androidx.core:core-ktx:1.11.0-alpha03, and androidx.core:core-testing:1.11.0-alpha03 are released. Version 1.11.0-alpha03 contains these commits.

API Changes

Update BuildCompat in preparation for Android 14 Beta 2 (Idc1b1, b/276491001)
Unhides NotificationCompat.TvExtender (Ibe13a)
Add public methods to access M3HCT parameters and turn M3HCT values into ARGB (Id7e9d)

Version 1.11.0-alpha02

April 5, 2023

androidx.core:core:1.11.0-alpha02, androidx.core:core-ktx:1.11.0-alpha02, and androidx.core:core-testing:1.11.0-alpha02 are released. Version 1.11.0-alpha02 contains these commits.

API Changes

Adds getCurrentInterruptionFilter to NotifManagerCompat (I8ec95, b/243183646)
Deprecate app.BundleCompat in favor of os.BundleCompat (Idc3a2, b/274577000)
Add TestConsumer so developers can record values in a test. (I937c1)

Bug Fixes

Fix a bug where unregisterGnssMeasurementsCallback() does not work properly below Android R. (Id1999)

Version 1.11.0-alpha01

March 22, 2023

androidx.core:core:1.11.0-alpha01 and androidx.core:core-ktx:1.11.0-alpha01 are released. Version 1.11.0-alpha01 contains these commits.

API Changes

In Android U, the ContentProvider API of getType requires that the caller hold the correct read permission. FileProvider now provides a default getTypeAnonymous implementation, which is the unrestricted version. (I4773f)
Added compat classes for content capture APIs (I09366)
Added NotifCompat.Builder.setLargeIcon(Icon) (Ic0a5b)
Adds a batch notification API to NotificationManagerCompat. Users are encouraged to use this API when posting multiple notifications. (I2cd7f)
Added registerGnssMeasurementsCallback() with Executor support on pre-R platforms (I579f8)

Core and Core-ktx Version 1.10

Version 1.10.1

May 10, 2023

androidx.core:core:1.10.1 and androidx.core:core-ktx:1.10.1 are released. Version 1.10.1 contains these commits.

External Contribution

Fix BadParcelableException being thrown for result being null b/277434277, b/278118318 contributed by Mygod Studio

Version 1.10.0

April 5, 2023

androidx.core:core:1.10.0 and androidx.core:core-ktx:1.10.0 are released. Version 1.10.0 contains these commits.

Important changes since 1.9.0

Deprecated recycling of accessibility objects. We've found performance changes to be negligible for even the oldest supported OS versions. (I0a961)
Added BuildCompat constants for SDK extension versions. (I6084c)
See release notes for pre-release versions of 1.10.0 for new APIs and bug fixes.

Version 1.10.0-rc01

March 8, 2023

androidx.core:core:1.10.0-rc01 and androidx.core:core-ktx:1.10.0-rc01 are released with no changes from the previous beta.

Version 1.10.0-beta01

February 22, 2023

androidx.core:core:1.10.0-beta01 and androidx.core:core-ktx:1.10.0-beta01 are released. Version 1.10.0-beta01 contains these commits.

API Changes

The AccessibilityNodeInfoCompat APIs of set/getMinMillisBetweteenContentChanges have been renamed to set/getMinDurationBetweenContentChanges and now take a long for their duration. (f46689)
Added NotificationCompat.bigLargeIcon(Icon) (I60855)

Bug Fixes

Fix docs regarding default value of NotificationCompat.Builder.setShowWhen() (ba52a2)
Fix typo in AccelerateInterpolator / DecelerateInterpolator docs (2173505)
Fix typo in ShortcutInfoCompat docs (44075f)
Fix up, down, spacebar and key variation keyboard actions with NestedScrollView and CoordinatorLayout (bdd72e)

Version 1.10.0-alpha02

January 25, 2023

androidx.core:core:1.10.0-alpha02 and androidx.core:core-ktx:1.10.0-alpha02 are released. Version 1.10.0-alpha02 contains these commits.

API Changes

Added BuildCompat constant for AD_SERVICES extension version (I51d98)
Add BEHAVIOR_DEFAULT to WindowInsetsControllerCompat. BEHAVIOR_SHOW_BARS_BY_SWIPE and BEHAVIOR_SHOW_BARS_BY_TOUCH are deprecated. (I17b61)

Version 1.10.0-alpha01

January 11, 2023

androidx.core:core:1.10.0-alpha01 and androidx.core:core-ktx:1.10.0-alpha01 are released. Version 1.10.0-alpha01 contains these commits.

API Changes

Adds CallStyle to NotificationCompat (Id9a53, b/199294989)
Added BuildCompat constants for SDK extension versions (I6084c)
Add APIs for setting initial focus on accessibility node. (Id199a)
Add new APIs for content change rate limiting (If4ea0)
Adds compatibility methods for new APIs introduced in Android 13 for Parcels, Bundles, and Intents. Some ParcelCompat method signatures have been updated, and may require a source change on upgrade to confirm to the new signature. (I57e94, b/242048899)
Deprecating recycling of accessibility objects. We've found performance changes to be negligible in even the oldest supported versions. (I0a961)
Updated return type nullability of deprecated-hidden functions (Ibf7b0)
Added times/div operator overloads for Point and PointF (I8e557, b/261574780)

Bug Fixes

Add to AccessibilityEvent#TYPE_ANNOUNCEMENT with suggestion to avoid using it. (I818bf)
Specify lists should have 1 row or 1 column for accessibility (Ia1223)

Core and Core-ktx Version 1.9.0

Version 1.9.0

September 7, 2022

androidx.core:core:1.9.0 and androidx.core:core-ktx:1.9.0 are released. Version 1.9.0 contains these commits.

Important changes since 1.8.0

Updated to improve compatibility with Android 13, including nullability changes and parity with framework APIs
Added IntentSanitizer to sanitize unsafe intents before launching them. (Ib0be5)
Adds support for BigPictureStyle using Icon (Ice26d)
Added @RequiresPermission to APIs that require granting the POST_NOTIFICATIONS permission on SDK 33 and above. (Ie542e)
Improved parity between Android 13 accessibility framework APIs and compat APIs (I93c97, I5a074, Iedf82)

Version 1.9.0-rc01

August 24, 2022

androidx.core:core:1.9.0-rc01 and androidx.core:core-ktx:1.9.0-rc01 are released. Version 1.9.0-rc01 contains these commits.

Bug Fixes

IntentSanitizer.sanitizeByFiltering no longer writes to the log when filtering (69b3b55)

Version 1.9.0-beta01

August 10, 2022

androidx.core:core:1.9.0-beta01 is released. Version 1.9.0-beta01 contains these commits.

API Changes

Added compatibility for ACTION_SHOW_TEXT_SUGGESTIONS and is/setTextSelectable (Iedf82)
Added IntentSanitizer to sanitize unsafe intents before launching them. (Ib0be5)
Adds support for BigPictureStyle using Icon (Ice26d, b/215583339)
Updated nullability annotations (I34cce, b/236498052, b/236498029, b/236497996, b/236497942, b/236497884, b/236497726)
Added LocationManagerCompat.registerGnssMeasurementsCallback to work around Android R bugs. (Ie0f6f)

Bug Fixes

Added @RequiresPermission to APIs that require granting the POST_NOTIFICATIONS permission on SDK 33 and above. (Ie542e, b/238790278)
Adding support for API introduced in T." into androidx-platform-dev" ()
Adding support for API introduced in T. (I358f1)
TypefaceCompate.create(..., weight, italic) will fallback to platform Typeface.create when compat impl cannot resolve on API 14-20 (I1ee34, b/145311058)
Added accessibility framework constants previously absent from androidx." into androidx-main am: d5747be010" (I5a074)
Added accessibility framework constants previously absent from androidx. (I93c97)

External Contribution

Backported Typeface#create(Typeface, int, boolean) which allows creating typeface with specific weight from a font family (I342dc)

Version 1.9.0-alpha05

June 15, 2022

androidx.core:core:1.9.0-alpha05 and androidx.core:core-ktx:1.9.0-alpha05 are released. Version 1.9.0-alpha05 was developed in a private pre-release branch and has no public commits.

API Changes

Nullability updates to align with finalized API surface in Tiramisu Beta 3 SDK
minCompileSdk is now 33 to align with Tiramisu Beta 3 SDK

Version 1.9.0-alpha04

May 18, 2022

androidx.core:core:1.9.0-alpha04 and androidx.core:core-ktx:1.9.0-alpha04 are released. Version 1.9.0-alpha04 is built against a pre-release Android SDK and does not have a publicly-available commit history.

Bug Fixes

Revert deprecation of BuildCompat.isAtLeastT() and accompanying SDK_INT checks

Version 1.9.0-alpha03

April 27, 2022

androidx.core:core:1.9.0-alpha03 and androidx.core:core-ktx:1.9.0-alpha03 are released. Version 1.9.0-alpha04 contains all commits from 1.8.0-beta01, but has been built against Android 13 Beta 1.

This version requires Android 13 Beta 1 to compile and is not guaranteed to be runtime-compatible with future developer previews.

Version 1.9.0-alpha02

March 23, 2022

androidx.core:core:1.9.0-alpha02 and androidx.core:core-ktx:1.9.0-alpha02 are released. Version 1.9.0-alpha02 contains all commits from 1.8.0-alpha06, but has been built against Tiramisu DP2.

Version 1.9.0-alpha01

February 23, 2022

androidx.core:core:1.9.0-alpha01 and androidx.core:core-ktx:1.9.0-alpha01 are released. Version 1.9.0-alpha01 was built from an internal branch and does not have publicly-visible commits.

This version requires Android Tiramisu DP1 to compile and is not guaranteed to be runtime-compatible with future developer previews.

New Features

Compatible with Android Tiramisu DP1.

Core and Core-ktx Version 1.8.0

Version 1.8.0

June 1, 2022

androidx.core:core:1.8.0 and androidx.core:core-ktx:1.8.0 are released. Version 1.8.0 contains these commits.

Important changes since 1.7.0

Significant clean-up of nullability annotations to improve Kotlin usability
Platform parity improvements to ShortcutInfoCompat, NotificationCompat, and more
New interfaces to allow components to receive picture-in-picture and multi-window mode change events, implemented by ComponentActivity in Activity library
Improvements to MenuProvider callback methods, including onPrepareMenu and onMenuClosed
Fixed issue where FileProvider would fail with IllegalArgumentException on certain devices
Fixed issue where TypefaceCompat applied incorrect typeface weight on API 29+ (b/194553426) thanks to contribution from RikkaW

Version 1.8.0-rc02

May 18, 2022

androidx.core:core:1.8.0-rc02 and androidx.core:core-ktx:1.8.0-rc02 are released. Version 1.8.0-rc02 contains these commits.

Bug Fixes

Cast OnSharedElementsReadyListener to fully-qualified platform class to prevent ClassCastException (0029fed)

Version 1.8.0-rc01

May 11, 2022

androidx.core:core:1.8.0-rc01 and androidx.core:core-ktx:1.8.0-rc01 are released. Version 1.8.0-rc01 contains these commits.

API Changes

Added BuildCompat check for next pre-release cycle (If5a8f, b/229859122)
Updated BuildCompat.isAtLeastT() for finalized SDK_INT value. (Iffae0)

Version 1.8.0-beta01

April 20, 2022

androidx.core:core:1.8.0-beta01 and androidx.core:core-ktx:1.8.0-beta01 are released with no changes since 1.8.0-alpha07. Version 1.8.0-beta01 contains these commits.

Version 1.8.0-alpha07

April 6, 2022

androidx.core:core:1.8.0-alpha07 and androidx.core:core-ktx:1.8.0-alpha07 are released. Version 1.8.0-alpha07 contains these commits.

Bug Fixes

TypefaceCompat will now respect both requested and loaded style information on API 29+. This is a behavior change when the loaded fonts are not FontWeight.Normal or FontWeight.Bold, as the actual loaded weight and style will be used. (#212, b/194553426)

External Contribution

Thanks RikkaW for ensuring we correctly apply Typeface weight in TypefaceCompat on API 29+. #212

Version 1.8.0-alpha06

March 23, 2022

androidx.core:core:1.8.0-alpha06 is released. Version 1.8.0-alpha06 contains these commits.

API Changes

The MenuProvider interface now includes the onPrepareMenu() callback, which is called when a menu is dynamically modified and should be shown. (Ie85f9)
The MenuProvider interface now includes the onMenuClosed() method to be used whenever a menu should be closed. (If5a16)
Updated IconCompat#getResId to have the proper resource annotation type to match the corresponding method in the framework in Icon#getResId (I49700)
Reverted previous change of relying solely on a View for WindowInsetsControllerCompat, and again require a Window which is required for managing some window flags. Deprecated ViewCompat.getWindowInsetsController in favor of WindowCompat.getInsetsController to ensure that the correct Window is used (such as if the View is in a dialog). (I660ae, b/219572936)
Updated nullability in core and appcompat to match Tiramisu DP2 (I0cbb7)
Adds a method to BitmapCompat for smoother downscaling of bitmaps. (Ib706c)
Added nullability annotations to ActivityCompat.requestDragAndDropPermissions (I0f2b0, b/206113378)
Added a work-around to FileProvider for OEMs stripping meta-data from manifests. (I82f63)

Bug Fixes

Consider parent visibility changes for a11y pane visibility status for <P (I8e04f)

Version 1.8.0-alpha05

February 23, 2022

androidx.core:core:1.8.0-alpha05 and androidx.core:core-ktx:1.8.0-alpha05 are released. Version 1.8.0-alpha05 contains these commits.

API Changes

Updated nullability for androidx.core.os classes (If18cd, b/206113622)
Updated nullability for androidx.core.app classes (I657eb, b/206113302)
Updated nullability for androidx.core.text classes (I08329, b/206113384)
Added ExtraData functions to AccessibilityNodeInfoCompat (If2fc7, b/137789185)
Added zero-arg overload for bundleOf() to avoid an invisible array allocation when creating an empty bundle (If7089)
Added Continuation<T>.asFoo() adapters to create callbacks for writing suspend wrappers for Android APIs that accept common/generic callback types (I6615e)
Added nullable Drawable.toBitmapOrNull method to avoid exceptions (I2342a)

Version 1.8.0-alpha04

February 9, 2022

androidx.core:core:1.8.0-alpha04 and androidx.core:core-ktx:1.8.0-alpha04 are released. Version 1.8.0-alpha04 contains these commits.

API Changes

Adds the OnPictureInPictureModeChangedProvider interface to allow any component to receive picture-in-picture mode change events. This is implemented by ComponentActivity in Activity 1.5.0-alpha02. (I9f567)
Adds the OnMultiWindowModeChangedProvider interface to allow any component to receive multi-window mode change events. This is implemented by ComponentActivity in Activity 1.5.0-alpha02. (I62d91)
Cleaned up nullability for a subset of androidx.core APIs. (Ia0e2f, b/206113818)

Version 1.8.0-alpha03

January 26, 2022

androidx.core:core:1.8.0-alpha03 and androidx.core:core-ktx:1.8.0-alpha03 are released. Version 1.8.0-alpha03 contains these commits.

API Changes

Converted WindowInsetsControllerCompat to depend on a View instead of a Window or the platform WindowInsetsController. This improves behavior with Dialogs, showing the IME, and ensures the non-deprecated creation methods workaround (b/180881870). (I29264, b/207401542, b/210121779)
Cleaned up nullability for a subset of androidx.core APIs. (Ib2583, b/206113818)
Fixed nullability of performAccessibilityAction params (Ibbafe)
Added method for working around ColorStateList issues resulting from Theme-keyed caching and Theme.applyStyle (I9188b, b/207739887)
Update shortcut visibility api for better readability (Ia58df)
Added zero-arg overload for persistableBundleOf() to avoid an unnecessary array allocation when creating an empty PersistableBundle (Icd7a4)

Version 1.8.0-alpha02

December 15, 2021

androidx.core:core:1.8.0-alpha02 and androidx.core:core-ktx:1.8.0-alpha02 are released. Version 1.8.0-alpha02 contains these commits.

API Changes

Adds experimental BuildCompat methods for future SDKs (Iafd82, b/207528937)
Add utility methods to convert document into shortcut and vice versa. (Id512c)
Update visibility api for shortcut for better readability (I86dec)
Adds the OnNewIntentProvider, OnConfigurationChangedProvider, and onTrimMemoryProvider interfaces that can be used to denote that your custom activity can dispatch these events to any component that adds a listener. (If1f8b, If623b, Ia9295)

Version 1.8.0-alpha01

December 1, 2021

androidx.core:core:1.8.0-alpha01 and androidx.core:core-ktx:1.8.0-alpha01 are released. Version 1.8.0-alpha01 contains these commits.

API Changes

Significant clean-up of nullability annotations
Added a new API ShortcutInfoCompat.Builder#setHiddenFromLauncher to determine whether the shortcut should be hidden from the launcher. (Ia2a71)
Add NotificationCompat.Action#setAuthenticationRequired (Ieeafa, b/202172887)
Add NotificationCompat.BigPictureStyle.setContentDescription (I3b483)
Added extension function Map<String, Any?>.toPersistableBundle() (I82c86)

Bug Fixes

Adjusts the scroll distance for accessibility action (If74ae)
Removed hardcoded language code in Javadocs (Ie5d68)

Core and Core-ktx Version 1.7

Version 1.7.0

October 27, 2021

androidx.core:core:1.7.0 and androidx.core:core-ktx:1.7.0 are released. Version 1.7.0 contains these commits.

Important changes since 1.6.0

Adds support for interacting with SDK 30 and later’s permission revocation and app hibernation features, with backporting down to SDK 23 on supported devices. See IntentCompat.createManageUnusedAppRestrictionsIntent for more information.
Adds support for composing menu support in components, see MenuProvider for more information.

Version 1.7.0-rc01

October 13, 2021

androidx.core:core:1.7.0-rc01 and androidx.core:core-ktx:1.7.0-rc01 are released. Version 1.7.0-rc01 contains these commits.

Version 1.7.0-beta02

September 29, 2021

androidx.core:core:1.7.0-beta02 and androidx.core:core-ktx:1.7.0-beta02 released. Version 1.7.0-beta02 contains these commits.

Bug Fixes

MenuHostHelper will now properly remove all LifecycleObservers when a MenuProvider is removed prior to the Lifecycle being DESTROYED. (Ibe2e1, b/199788262)
Update the descriptions of the Unused App Restrictions Constants to be clearer for developers (I2858e)

Version 1.7.0-beta01

September 15, 2021

androidx.core:core:1.7.0-beta01 and androidx.core:core-ktx:1.7.0-beta01 are released. Version 1.7.0-beta01 contains these commits.

API Changes

LocationRequestCompat.toProvider can now return null (Ib5a09)

Version 1.7.0-alpha02

September 1, 2021

androidx.core:core:1.7.0-alpha02 and androidx.core:core-ktx:1.7.0-alpha02 are released. Version 1.7.0-alpha02 contains these commits.

New Features

Streamlining and unification of how lifecycle-aware menus are managed, see MenuProvider for more details.

API Changes

Added MenuHost interface for components that manage MenuProviders. (I83f23)
Added MenuProvider interface that can be used to indicate that a component is supplying menu items. (If8a40)
Added MenuHostHelper to simplify implementing MenuHost in a component. (I74f4a)
Added LocationRequestCompat.toLocationRequest() for converting to platform class. (I71e75)
Added DocumentsContractCompat class for parity with platform APIs. (Ia9e91)
Added NotificationCompat.BigPictureStyle.showBigPictureWhenCollapsed(boolean) for parity with platform APIs. (I8cd88)
Fixed an issue where checkSelfPermission from PermissionChecker would show mic/cam indicators. (I572a9)
Added explicit threading annotation for setImportantForAccessibility. (I990fa)
Updated getUnusedAppRestrictionsStatus to conform to API guidelines. (I28a18)
Completed functionality for getUnusedAppRestrictionsStatus. (I7c2d6)
Added support to LocationCompat for vertical accuracy, speed accuracy, and bearing accuracy. (I1d3e9)
Added math compat functions to MathUtils. (Idb590)
Integrated OnReceiveContentListenerinto compat APIs. (Ic6914, b/173814913)
Added ActivityCompat#isLaunchedFromBubble for platform parity. (I6961a)
Added LocationRequest and LocationManager.hasProvider() for platform parity. (I4f3e4)

Bug Fixes

Removed the use of lambdas in PackageManagerCompat to avoid LambdaDesugaring bug. (I36c87)

Version 1.7.0-alpha01

June 30, 2021

androidx.core:core:1.7.0-alpha01 and androidx.core:core-ktx:1.7.0-alpha01 are released. Version 1.7.0-alpha01 contains these commits.

API Changes

Added an API to configure an InputConnection to use View.performReceiveContent to handle IME calls to InputConnection.commitContent. (I3a2ad)
Combined two APIs' functionality into one (I261df)
Modified two APIs' functionality for use with unused app restriction features (e.g. permission revocation, app hibernation) (Ic1616)
Added three APIs for use with unused app restriction features (e.g. permission revocation, app hibernation) (I606d7)
Added nullability annotations to several Compat classes (I2802a, b/188452327, b/189962089)
Added three APIs for use with unused app restriction features (e.g. permission revocation, app hibernation) (Icafee)
Addressed missing nullability annotation issues in ViewCompat (Ic346e, b/188453571)

Core Remote Views Version 1.1

Version 1.1.0

June 12, 2024

androidx.core:core-remoteviews:1.1.0 is released. Version 1.1.0 contains these commits.

Important changes since 1.0.0

Core RemoteViews moves to 1.1.0 stable.

Version 1.1.0-rc01

May 14, 2024

androidx.core:core-remoteviews:1.1.0-rc01 is released. Version 1.1.0-rc01 contains these commits.

New Features

Move RemoteViews 1.1.0 to Release Candidate.

Bug Fixes

Move to 21 as the default minSdkVersion of androidx libraries. (I6ec7f)

Version 1.1.0-beta02

April 17, 2024

androidx.core:core-remoteviews:1.1.0-beta02 is released. No major changes since the last release.

Version 1.1.0-beta01

April 3, 2024

androidx.core:core-remoteviews:1.1.0-beta01 is released. Version 1.1.0-beta01 contains these commits.

Version 1.1.0-alpha01

February 7, 2024

androidx.core:core-remoteviews:1.1.0-alpha01 is released. Version 1.1.0-alpha01 contains these commits.

New Features

Version bump to match dependency versions.

Core Remote Views Version 1.0

Version 1.0.0

September 6, 2023

androidx.core:core-remoteviews:1.0.0 is released. Version 1.0.0 contains these commits.

Major features of 1.0.0

Move core-remoteviews to stable version 1.0.0

Version 1.0.0-beta04

May 10, 2023

androidx.core:core-remoteviews:1.0.0-beta04 is released. Version 1.0.0-beta04 contains these commits.

Bug Fixes

Fixes ArrayOutOfBoundsException being thrown in corner cases in compat library.

Version 1.0.0-beta03

October 5, 2022

androidx.core:core-remoteviews:1.0.0-beta03 is released. Version 1.0.0-beta03 contains these commits.

New Features

No new features were added.

Version 1.0.0-beta02

August 10, 2022

androidx.core:core-remoteviews:1.0.0-beta02 is released. Version 1.0.0-beta02 contains these commits.

Bug Fixes

Version fix

Version 1.0.0-beta01

June 29, 2022

androidx.core:core-remoteviews:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

New Features

Moves Core-RemoteViews to beta.

Version 1.0.0-alpha03

February 23, 2022

androidx.core:core-remoteviews:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

Bug Fixes

Fix for infrastructure.

Version 1.0.0-alpha02

January 26, 2022

androidx.core:core-remoteviews:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

Version 1.0.0-alpha01

December 15, 2021

androidx.core:core-remoteviews:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

New Features

Backport of the new RemoteViews.setRemoteAdapter API.
Kotlin Extension functions to avoid reflection when calling RemoteViews methods.
Library with helper functions for working with App Widget sizing APIs.

Core Performance Version 1.0

Version 1.0.0

January 10, 2024

androidx.core:core-performance:1.0.0, androidx.core:core-performance-play-services:1.0.0, and androidx.core:core-performance-testing:1.0.0 are released. Version 1.0.0 contains these commits.

Major features of 1.0.0

Core Performance - Provides a reliable mechanism for developers to identify the device’s level of performance at runtime to help optimize an app’s user experience accordingly.
Core Performance Play Services - Google-specific implementation providing up-to-date media performance class information for tested devices and OS versions.
Core Performance Testing - Test doubles for Core Performance.

Bug Fixes

Fixed a crash when initializing PlayServicesDevicePerformance found in version 1.0.0-beta2. (b/318803680)

Version 1.0.0-rc01

December 13, 2023

androidx.core:core-performance:1.0.0-rc01, androidx.core:core-performance-play-services:1.0.0-rc01, and androidx.core:core-performance-testing:1.0.0-rc01 are released. Version 1.0.0-rc01 contains these commits.

New Features

Core Performance - Updated library implementation. (DevicePerformance generic implementation).
Core Performance Play Services - Initial library implementation. (Google specific DevicePerformance implementation).
Core Performance Testing - Initial library implementation. (contains test doubles for Core Performance).

API Changes

Initial RC release of DevicePerformance specific API.

Version 1.0.0-beta02

October 4, 2023

androidx.core:core-performance:1.0.0-beta02, androidx.core:core-performance-play-services:1.0.0-beta02, and androidx.core:core-performance-testing:1.0.0-beta02 are released. Version 1.0.0-beta02 contains these commits.

New Features

Test related refactoring.

API Changes

Unchanged API usage pattern.

Version 1.0.0-beta01

September 6, 2023

androidx.core:core-performance:1.0.0-beta01, androidx.core:core-performance-play-services:1.0.0-beta01, and androidx.core:core-performance-testing:1.0.0-beta01 are released. Version 1.0.0-beta01 contains these commits.

New Features

Core Performance - Updated library implementation. (DevicePerformance generic implementation).
Core Performance Play Services - Initial library implementation. (Google specific DevicePerformance implementation).
Core Performance Testing - Initial library implementation. (contains test doubles for Core Performance).

API Changes

Initial beta release of DevicePerformance specific API.

Version 1.0.0-alpha03

August 23, 2023

androidx.core:core-performance:1.0.0-alpha03, androidx.core:core-performance-play-services:1.0.0-alpha03, and androidx.core:core-performance-testing:1.0.0-alpha03 are released. Version 1.0.0-alpha03 contains these commits.

New Features

Initial library implementation of core-performance-testing, containing test doubles for core-performance.
Initial library implementation or core-performance-play-services. Google specific implementation provides up to date media performance class information.

API Changes

Add optional module providing media performance class from Google Play Services.
core-performance constructors changed to support optional implementation.

Version 1.0.0-alpha02

March 23, 2022

androidx.core:core-performance:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

New Features

Provide an easy and reliable mechanism for developers to identify at runtime the device’s level of performance in order to deliver an optimized app experience.
This initial release uses a list of hand-tested devices that are granted performance class values higher than the level declared in Build.VERSION.MEDIA_PERFORMANCE_CLASS

Version 1.0.0-alpha01

December 15, 2021

androidx.core:core-performance:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

Core Splashscreen Version 1.2

Version 1.2.0-alpha02

September 4, 2024

androidx.core:core-splashscreen:1.2.0-alpha02 is released. Version 1.2.0-alpha02 contains these commits.

Bug Fixes

Add isLightTheme attribute to themes of SplashScreen (I01000, b/238522114)
Get splashscreen icon by AppCompatResources (Ib05e, b/289242141, b/263972037)
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. (Ieb9ae, b/345472586)

Version 1.2.0-alpha01

April 17, 2024

androidx.core:core-splashscreen:1.2.0-alpha01 is released. Version 1.2.0-alpha01 contains these commits.

Bug Fixes

Change the cutout mode of Base.Theme.SplashScreen to always since v30.(Idfc3f)
Reset enforceNavigationBarContrast to system default value from API 31, so the splash screen theme won't corrupt activity's theme. From API 31+, the splash screen isn't create as PhoneWindow, so it's unnecessary to inherit the value from API 29. Also remove the override action from applyAppSystemUiTheme, since enforceNavigationBarContrast could already changed from app side during launch, override it from attribute doesn't make sense.(Ic2cd9)
Set default light navigation bar which respects day/night theme. So for API 33+ platform, the splash screen theme won't cause flicker while removing the splash screen. (I8023a)
Do not overwrite activity theme after receiving the splash screen view from api 33.(I10587b)

Core Splashscreen Version 1.1

Version 1.1.0-rc01

April 3, 2024

androidx.core:core-splashscreen:1.1.0-rc01 is released. Version 1.1.0-rc01 contains these commits.

Bug Fixes

Provide default dimensions for wear device with 48x48dp icon (Ib8de8, b/256678037)
Fix SplashScreenView#getIconView cause NPE crash (6abfd6, b/243457485)

Version 1.1.0-alpha02

September 6, 2023

androidx.core:core-splashscreen:1.1.0-alpha02 is released. Version 1.1.0-alpha02 contains these commits.

Bug Fixes

Provide default dimensions for wear device with 48x48dp icon (Ib8de8, b/256678037)

Dependency Update

Core-Splashscreen now compiles against API 34.

Version 1.1.0-alpha01

February 22, 2023

androidx.core:core-splashscreen:1.1.0-alpha01 is released. This was developed in an internal branch.

Bug Fixes

Fixed a NullPointerException when SplashScreenView#getIconView returned null. (e231ab)

Core Splashscreen Version 1.0

Version 1.0.1

April 19, 2023

androidx.core:core-splashscreen:1.0.1 is released. Version 1.0.1 contains these commits.

Bug Fixes

Provide default dimensions for wear device with 48x48dp icon (Ib8de8, b/256678037)

Version 1.0.0

July 27, 2022

The core SplashScreen library brings the new Android 12 splash screen to all devices from API 23. Using the splash screen library, your application doesn't need any custom SplashScreen Activity and leverages the right APIs for a fast launch of your application. To use it, simply follow the steps outlined in our guide. For more information about the Android 12 splash screen, visit the official documentation.

androidx.core:core-splashscreen:1.0.0 is released. Version 1.0.0 contains these commits.

Version 1.0.0-rc01

May 18, 2022

androidx.core:core-splashscreen:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits.

No changes since the last beta release.

Version 1.0.0-beta02

March 23, 2022

androidx.core:core-splashscreen:1.0.0-beta02 is released. Version 1.0.0-beta02 contains these commits.

Bug Fixes

Fixed Lateinit property platformView has not been initialized (b/214835299)

External Contribution

Fix rendering issue on MIUI with dark mode and Explicitly set android:animateLayoutChanges to false to avoid the fading animation when removing the splash screen in the OnExitAnimationListener (#327)

Version 1.0.0-beta01

January 12, 2022

androidx.core:core-splashscreen:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

Bug Fixes

Better night mode handling ensures that night mode is handled when the default parameters are used on all APIs. 2d1d182

Fixes bugs introduced in the new splash screen on Android 12:

Fix systemBar flickering on API 31: Ensure that the system bars do not flicker when customizing the exit animation. 5a75362
Fix insets handling when using OnExitAnimationListener: Ensures that the content does not jump when the OnExitAnimationListener is used. 4c8f264

Version 1.0.0-alpha02

September 29, 2021

androidx.core:core-splashscreen:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

New Features

Better insets support: The splash screen now shows full screen on all APIs even when the OnExitAnimationListener is set.
postSplashScreenTheme is optional: you can simply call activity.setTheme() before onCreate() to set your app theme after the splash screen is shown.
Backward support of the windowSplashScreenIconBackgroundColor attribute: using Theme.SplashScreen.IconBackground and windowSplashScreenIconBackgroundColor, you can add a background to the splash screen icon.
The sizing of the icon has been corrected to match the platform's specs.

API Changes

Added backward compatibility for the windowSplashScreenIconBackgroundColor attribute
- Downgraded the minSdkVersion to API 21 (Idd050, b/198161849, b/197759820, b/198165621)

Bug Fixes

Make postSplashScreenTheme optional (I8c4bf)

Version 1.0.0-alpha01

June 30, 2021

androidx.core:core-splashscreen:1.0.0-alpha01 is released.

New Features

core-splashscreen provides backward compatibility for the new Splash Screen APIs. This first alpha version contains all the new APIs backported down to API 23, with the exception of the icon background.
See the KDocs in androidx.core.splashscreen for usage information.

Core Google Shortcuts Version 1.2

Version 1.2.0-alpha01

July 26, 2023

androidx.core:core-google-shortcuts:1.2.0-alpha01 is released. Version 1.2.0-alpha01 contains these commits.

API Changes

Merged public and experimental API files for a,b,c-paths (I8cfee, b/278769092)
Migrated androidx.core group to use merged public API files (Ifdef4, b/278769092)

Core Google Shortcuts Version 1.1.0

Version 1.1.0

October 24, 2022

androidx.core:core-google-shortcuts:1.1.0 is released. Version 1.1.0 contains these commits.

Important changes since 1.0.0

Migrated from using com.google.firebase:firebase-appindexing to the new com.google.android.gms:play-services-appindex library. This version of the library is not compatible with com.google.firebase:firebase-appindexing. Developers should avoid using both libraries to avoid build errors.

Version 1.1.0-rc01

October 5, 2022

androidx.core:core-google-shortcuts:1.1.0-rc01 is released. Version 1.1.0-rc01 contains these commits.

New Features

Migrated from using com.google.firebase:firebase-appindexing to the new com.google.android.gms:play-services-appindex library. Note that this version of the library is not compatible with com.google.firebase:firebase-appindexing. Developers should avoid using both libraries to avoid build errors.

Version 1.1.0-beta01

September 21, 2022

androidx.core:core-google-shortcuts:1.1.0-beta01 is released. Version 1.1.0-beta01 contains these commits.

New Features

Removed unused dependency. No new features.

Version 1.1.0-alpha03

September 7, 2022

androidx.core:core-google-shortcuts:1.1.0-alpha03 is released. Version 1.1.0-alpha03 contains these commits.

New Features

Removed unused dependency. No new features.

Version 1.1.0-alpha02

August 24, 2022

androidx.core:core-google-shortcuts:1.1.0-alpha02 is released. Version 1.1.0-alpha02 contains these commits.

New Features

Update dependency from com.google.firebase:firebase-appindexing to com.google.android.gms:play-services-appindex. Developers who use this new version should not externally depend on com.google.firebase:firebase-appindexing, as the two libraries are now incompatible.

Version 1.1.0-alpha01

August 4, 2021

androidx.core:core-google-shortcuts:1.1.0-alpha01 is released. Version 1.1.0-alpha01 contains these commits.

New Features

Indexing support for URI based icons in Donated shortcuts to be displayed by Google apps.

Core and Core-ktx Version 1.6.0

Version 1.6.0

June 30, 2021

androidx.core:core:1.6.0 and androidx.core:core-ktx:1.6.0 are released. Version 1.6.0 contains these commits.

Important changes since 1.5.0

Add support for resolving theme attributes in nested ColorStateLists. (I2e409 b/155579892)
Backport tintable background and check mark for CheckedTextView (I8575c)

Version 1.6.0-rc01

June 16, 2021

androidx.core:core:1.6.0-rc01 and androidx.core:core-ktx:1.6.0-rc01 are released. Version 1.6.0-rc01 contains these commits.

API Changes

JobIntentService has been deprecated in favor of WorkManager (Ic7749, b/149049019)

Version 1.6.0-beta02

June 2, 2021

androidx.core:core:1.6.0-beta02 and androidx.core:core-ktx:1.6.0-beta02 are released. Version 1.6.0-beta02 contains these commits.

Bug Fixes

Update BuildCompat to use current long press timeout on latest platforms (b/185118174)
Remove use of synchronized from ContextCompat, ContentLoadingProgress methods.

Version 1.6.0-beta01

May 18, 2021

androidx.core:core:1.6.0-beta01 and androidx.core:core-ktx:1.6.0-beta01 are released. Version 1.6.0-beta01 contains these commits.

API Changes

Backport Objects.requireNonNull() (I27db5, b/179904366)

Version 1.6.0-alpha03

May 5, 2021

androidx.core:core:1.6.0-alpha03 and androidx.core:core-ktx:1.6.0-alpha03 are released. Version 1.6.0-alpha03 contains these commits.

New Features

Add support for resolving theme attributes in nested ColorStateLists. (I2e409 b/155579892)

Bug Fixes

Prevent NPE when handling null custom selection action mode callbacks on AppCompat-backed views. (I033c7, b/173435375)
Add support for setSystemBarsBehavior on SDK < 30. (I062c8, b/173203649)

Version 1.6.0-alpha02

April 15, 2021

androidx.core:core:1.6.0-alpha02 and androidx.core:core-ktx:1.6.0-alpha02 are released. Version 1.6.0-alpha02 contains these commits.

API Changes

Add TelephoneManagerCompat and SubscriptionManagerCompat (I5568d)
Remove deprecated addCapabilityBinding method from ShortcutInfoCompat (Ie8f70)
Add addCapabilityBinding with parameters and addCapabilityBinding without parameters setters to ShortcutInfoCompat.Builder, deprecated old addCapabilityBinding (I90686)
Add LocationCompat class and LocationManagerCompat.getCurrentLocation() (I78d9a)
Deprecated ModeCompat.isNative which is replaced by DisplayCompat.getMode. (I9a6a2)
Added ContextCompat.getAttributionTag() and UserHandleCompat.getUserHandleForUid() (Iea486)

External Contribution

Backport tintable background and check mark for CheckedTextView (I8575c)

Version 1.6.0-alpha01

March 24, 2021

androidx.core:core:1.6.0-alpha01 and androidx.core:core-ktx:1.6.0-alpha01 are released. Version 1.6.0-alpha01 contains these commits.

API Changes

Adds Handler.hasCallbacks() method for parity with platform SDK (Idce1c, b/113855676)
Adds capability related setter methods to ShortcutInfoCompat.Builder (I45af6)

Core Google Shortcuts Version 1.0

Version 1.0.1

May 18, 2022

androidx.core:core-google-shortcuts:1.0.1 is released. Version 1.0.1 contains these commits.

Bug Fixes

Fix proguard rule to prevent a method from being unintentionally removed

Version 1.0.0

June 30, 2021

androidx.core:core-google-shortcuts:1.0.0 is released. Version 1.0.0 contains these commits.

Major features of 1.0.0

Include this module to allow shortcuts saved using ShortcutManagerCompat to also be donated to Google. This will unlock additional features with those shortcuts for users, such as displaying them as suggestions or allowing Google Assistant to fulfill them through voice query. There is no limit to the number of shortcuts that can be donated, and those that are donated this way are saved on-device. For more information, see the full documentation on pushing dynamic shortcuts to Assistant.

Version 1.0.0-rc01

June 16, 2021

androidx.core:core-google-shortcuts:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits.

Version 1.0.0-beta01

May 18, 2021

androidx.core:core-google-shortcuts:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

New Features

Shortcuts added via core-google-shortcuts library will be saved as a Shortcut object in firebase appindexing, instead of a generic schema.org/Thing object.

Bug Fixes

Removed the minSdkVersion requirement from the library. The library will still only work for API version 21 and above, but apps will no longer be required to set their own app’s minSdkVersion to 21.

Version 1.0.0-alpha03

May 5, 2021

androidx.core:core-google-shortcuts:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

Bug Fixes

No longer automatically report shortcut usage when a shortcut is added / updated. Instead usage reporting will be moved to ShortcutManagerCompat#pushDynamicShortcut.

Version 1.0.0-alpha02

April 15, 2021

androidx.core:core-google-shortcuts:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

New Features

By depending on androidx.core:core-google-shortcuts as an optional component along with androidx.core; you can start using ShortcutManagerCompat to donate shortcuts to be used by Google.
A new TrampolineActivity will be merged with apps depending on this module. The TrampolineActivity is used to open shortcuts donated by this module.

API Changes

Added ShortcutInfoChangeListenerImpl, to be used by ShortcutManagerCompat to donate shortcuts to Firebase App Index.

Core and Core-ktx Version 1.5.0

Version 1.5.0

May 18, 2021

androidx.core:core:1.5.0 and androidx.core:core-ktx:1.5.0 are released. Version 1.5.0 contains these commits.

Important changes since 1.4.0

Support for new Insets Animation APIs
Updates to OnReceiveContentListener to support rich content
Backported WindowInsetsController and WindowInsetsCompat APIs to control system bar appearance
Updated ActivityCompat.recreate() to be safely called from any lifecycle state on any API level
Added APIs to supply and retrieve initial surrounding text via EditorInfoCompat, which allows IME apps to avoid additional IPC latency.
Various updates to improve parity with platform SDK APIs

Version 1.5.0-rc02

May 5, 2021

androidx.core:core:1.5.0-rc02 and androidx.core:core-ktx:1.5.0-rc02 are released. Version 1.5.0-rc02 contains these commits.

Bug Fixes

Add support for setSystemBarsBehavior on SDK < 30. (I062c8, b/173203649)

Version 1.5.0-rc01

March 24, 2021

androidx.core:core:1.5.0-rc01 and androidx.core:core-ktx:1.5.0-rc01 are released. Version 1.5.0-rc01 contains these commits.

Summary

No changes from previous beta03

Version 1.5.0-beta03

March 10, 2021

androidx.core:core:1.5.0-beta03 and androidx.core:core-ktx:1.5.0-beta03 are released. Version 1.5.0-beta03 contains these commits.

API Changes

Added ExecutorCompat, which creates an Executor from a Handler. (Ib4ca3, b/181237835)

Version 1.5.0-beta02

February 24, 2021

androidx.core:core:1.5.0-beta02 and androidx.core:core-ktx:1.5.0-beta02 are released. Version 1.5.0-beta02 contains these commits.

Bug Fixes

Deprecated ModeCompat.isNative which is replaced by DisplayCompat.getMode. (Iefa71)
NotificationCompat.MessagingStyle.getText() was incorrectly marked as @NonNull; it is now @Nullable (I05cb7)

Version 1.5.0-beta01

January 13, 2021

androidx.core:core:1.5.0-beta01 and androidx.core:core-ktx:1.5.0-beta01 are released. Version 1.5.0-beta01 contains these commits.

API Changes

Follow API guidelines for Bounds Compat/Platform interoperability (I7da35)
Integrated drag-and-drop (drop events) in AppCompatEditText with OnReceiveContentListener. (Ib26c9, b/175343405)
Connection of the new Insets Animation API with the Platform implementation (I078da)
Added the new Insets Animation APIs (I8aebd)
Updated OnReceiveContentListener and related APIs:
- Updated OnReceiveContentListener so it can be set on any type of view via ViewCompat.
- Removed getSupportedMimeTypes() from OnReceiveContentListener; now MIME types are passed as an additional arg on the ViewCompat method that sets the listener.
- Wrapped arguments to OnReceiveContentListener.onReceiveContent() in an object.
- Added linkUri as a param to onReceiveContent() to ensure backwards compatibility with the keyboard image API.
- Added a Bundle param to onReceiveContent() to ensure backwards compatibility with the keyboard image API and to facilitate evolution of the API in the future.
- Updated onReceiveContent() to return any content that was not consumed, as a means to delegate to the default handling.
- Removed TextViewOnReceiveContentListener from the public API since the default behavior can now be triggered by returning any unconsumed content from the listener.
- (Ib4616, b/173814913)
Deprecated BuildCompat.isAtLeastR (Idb37e)
Moved widget.RichContentReceiverCompat to view.OnReceiveContentListener. (Ifdab7, b/173814913)
Added Preconditions.checkFlagsArgument. (I43952, b/174181100)
Deprecate custom menu for outbound sharing. (I7cd92)
Notifications can now be tagged as missed calls. (I14d90)
Added PackageInfoCompat#getSignatures for retrieving the certificate array for a package (I8e9a3, b/159831205)

Bug Fixes

Fix a bug where setting BigPictureStyle.bigLargeIcon would break the BigPictureStyle for that notification on newer OS versions. (Ic623d)

External Contribution

ShareCompat now uses constructors for creation and the old factory methods have been deprecated. You can now create both builders and readers from a Context and an Activity is no longer required. (I315b6, b/173043501)
Set clip data and grant uri read permission when sharing streams using ShareCompat (I4aa31, b/173137936)

Version 1.5.0-alpha05

November 11, 2020

androidx.core:core:1.5.0-alpha05 and androidx.core:core-ktx:1.5.0-alpha05 are released. Version 1.5.0-alpha05 contains these commits.

API Changes

Added support for new GnssStatus APIs (Id8e22)
Added overloads of FileProvider#getUriForFile to support custom filenames (Ie870b)
Backported the WindowInsetsController APIs to control the system bar appearance. (Ieb4ee)
Renamed getFont with boolean to getCachedFont (Iea520)
Backported the #hide() and #show() methods from WindowInsetsController APIs, added in API 30 (I21573)
Added new API ResourcesCompat#getFont with cacheOnly option (Ic38cf)
Updated androidx notification bubbles APIs for Android 11 (Ib9c70)

Version 1.5.0-alpha04

October 1, 2020

androidx.core:core:1.5.0-alpha04 and androidx.core:core-ktx:1.5.0-alpha04 are released. Version 1.5.0-alpha04 contains these commits.

API Changes

Fix incomplete Style recovery when using NotificationCompat.Builder.<init>(Context,Notification) (Ib297a)
New notification categories types are now available (I9521a)

Bug Fixes

Allow ActivityCompat.recreate() to be safely called from any lifecycle state on any API level. (I62dde, b/160122826)

Version 1.5.0-alpha03

September 16, 2020

androidx.core:core:1.5.0-alpha03 and androidx.core:core-ktx:1.5.0-alpha03 are released. Version 1.5.0-alpha03 contains these commits.

API Changes

ViewCompat is a utility class and shouldn't be instantiated. (If20fa)
APIs to supply and retrieve initial surrounding text were backported to EditorInfoCompat. They allow IME apps to avoid additional IPC latency. (Ie3809)
Query notification channels and groups with compat objects. (I11d18)

Bug Fixes

For pre-P, ensure panes are marked as important for accessibility and support CONTENT_CHANGE_TYPE_PANE_DISAPPEARED events. (Iaeffc)

External Contribution

API lint check for the StaticFinalBuilder is enabled for androidx (I2b11b, b/138602561)

Version 1.5.0-alpha02

August 19, 2020

androidx.core:core:1.5.0-alpha02 and androidx.core:core-ktx:1.5.0-alpha02 are released. Version 1.5.0-alpha02 contains these commits.

New Features

The WindowInsetsCompat APIs have been updated to those in the platform in Android 11. This includes the new ime() inset type, which allows checking the visibility and size of the on-screen keyboard.
- Some caveats about the ime()type, it works very reliably on API 23+ when your Activity is using the adjustResize window soft input mode. If you’re instead using the adjustPan mode, it should work reliably back to API 14.

API Changes

Added ObjectsCompat#toString(Object, String). This offers the behavior of Objects#toString(Object, String) but can be used pre-API 19. (I26cdc)
Added NotificationCompat.Builder.recoverBuilder(Notification) (I6f100)
Add NotificationCompat.Builder.createContentView() and peers (I6fe13)
Add extra data related APIs in AccessibilityNodeInfoCompat (I19567)
Add NotificationCompat.Builder.setSettingsText and NotificationCompat.MessagingStyle.addHistoricMessage (I62bb6)
Update Notification documentation (I1293f)
Fix nullability of NotificationCompat.Builder (I932e3)
Added NotificationChannelCompat and NotificationChannelGroupCompat (Icc3b6)
Add addExtraDataToAccessibilityNodeInfo to AccessibilityNodeProviderCompat (I26575)
Update WindowInsetsCompat to Android 11 APIs (I3df9e)

External Contribution

Add Uri overloads for MailTo methods (I6fa6b)
Added MailTo API which provides consistent behavior and bug fixes for all API levels (Ie9395, b/159827506)

Version 1.5.0-alpha01

June 10, 2020

androidx.core:core:1.5.0-alpha01 and androidx.core:core-ktx:1.5.0-alpha01 are released.

New Features

Provides parity with Android R platform SDK APIs for ShortcutManager, ShortcutInfo, AccessibilityNodeInfo, DisplayCutout, GnssStatus, and Notification classes

Bug Fixes

Make it clear that checking shouldShowPermissionRationale is recommended.
Change AtomicFile to use rename-into-place.
Adjust the Typeface display style with the style of given font. (b/156853883)
Fix failing Notification Builder Tests
Fix register/unregister bug LocationManagerCompat.

Core and Core-ktx Version 1.4.0

Version 1.4.0-alpha01

May 20, 2020

androidx.core:core:1.4.0-alpha01 and androidx.core:core-ktx:1.4.0-alpha01 are released. Version 1.4.0-alpha01 contains these commits.

API Changes

Add common API for inserting rich content (e.g. pasting an image). The new callback provides a single API that apps can implement to support the different ways in which rich content may be inserted. For now the API is only added to AppCompatEditText and will be invoked for the following code paths:
- paste from the clipboard
- content insertion from the IME (InputConnection.commitContent) (I22bf7)
Backported android.os.Process.isApplicationUid(int) to help apps determine whether code is executing in a isolated process (I4c83a, b/153014822)
Backported LocusId to help apps correlate state between different subsystems such as content capture, shortcuts, and notifications. (Ia3129)
Added ancestry sequences to ViewGroup (I5f75c, b/117976097)

Bug Fixes

Added permissions validation for ActivityCompat.requestPermissions() (I372cc, b/122163323)
Extracted v28+ calls into a separate static class, which fixes a NoClassDefFoundError error for View#OnUnhandledKeyEventListener when building an app bundle (Id3419, b/153695093)
Fixed a setChronometerCountDown crash bug (I47282, b/145770610)

Core and Core-ktx Version 1.3.2

Version 1.3.2

October 1, 2020

androidx.core:core:1.3.2 and androidx.core:core-ktx:1.3.2 are released. Version 1.3.2 contains these commits.

Bug Fixes

Allow ActivityCompat.recreate() to be safely called from any lifecycle state on any API level. (I62dde, b/160122826)

Core and Core-ktx Version 1.3.1

Version 1.3.1

July 22, 2020

androidx.core:core:1.3.1 and androidx.core:core-ktx:1.3.1 are released. Version 1.3.1 contains these commits.

Bug Fixes

Fixed an issue where the resolved font resource Typeface weight and style had the wrong values on API Level 29 (b/156853883)

Core and Core-ktx Version 1.3.0

Version 1.3.0

May 27, 2020

androidx.core:core:1.3.0 and androidx.core:core-ktx:1.3.0 are released. Version 1.3.0 contains these commits.

Major changes since 1.2.0

New APIs on NestedScrollView to run smooth scrolls with specified duration
New APIs on ViewCompat to retrieve the original window insets that were dispatched to the view hierarchy

Version 1.3.0-rc01

April 15, 2020

androidx.core:core:1.3.0-rc01 and androidx.core:core-ktx:1.3.0-rc01 are released. Version 1.3.0-rc01 contains these commits.

Bug Fixes

WindowInsetsCompat now properly implements hashCode() and equals() on all supported API levels.

Version 1.3.0-beta01

April 1, 2020

androidx.core:core:1.3.0-beta01 and androidx.core:core-ktx:1.3.0-beta01 are released. Version 1.3.0-beta01 contains these commits.

Version 1.3.0-alpha02

March 4, 2020

androidx.core:core:1.3.0-alpha02 and androidx.core:core-ktx:1.3.0-alpha02 are released. Version 1.3.0-alpha02 contains these commits.

API Changes

New APIs on NestedScrollView to run smooth scrolls with specified duration
A new ViewCompat API to retrieve the original window insets that were dispatched to the view hierarchy

Version 1.3.0-alpha01

January 29, 2020

androidx.core:core:1.3.0-alpha01 and androidx.core:core-ktx:1.3.0-alpha01 are released. Version 1.3.0-alpha01 contains these commits.

New features

Added ContentProviderCompat
Added WindowInsetsCompat.Builder

API changes

Added a NotificationCompat API to silence a notification instance
Added ResourcesCompat.NULL_ID
Deprecated CarExtender.UnreadConversation in NotificationCompat
Added a DisplayCompat API to get the physical size of the device

Bug fixes

Improved the handling actions with no icons in NotificationCompat
Fixed drawable tinting on TextView relative to compound drawables on API Level 23 (aosp/1172194)
Ensured the base context is always a wrapper
Fixed an issue where RecyclerView should not populate Collection[Item]Info by default

Version 1.2.0

February 5, 2020

androidx.core:core:1.2.0 and androidx.core:core-ktx:1.2.0 are released. Version 1.2.0 contains these commits.

Major changes since 1.1.0

Added new APIs and bug fixes in NotificationCompat
Added new APIs to work with BlendMode introduced in AndroidQ in backwards-compatible way
Added new APIs and bug fixes in accessibility compat
Added new APIs to work with ShortcutInfo
Added new APIs to work with WindowInsets
Fixed backwards compatibility for bundle key strings between 28.0 (support library) and 1.1 (AndroidX) in EditorInfoCompat, ShareCompat, WakefulBroadcastReceiver and InputConnectionCompat

Version 1.2.0-rc01

November 20, 2019

androidx.core:core:1.2.0-rc01 and androidx.core:core-ktx:1.2.0-rc01 are released with no changes since 1.2.0-beta02. Version 1.2.0-rc01 contains these commits.

Version 1.2.0-beta02

November 7, 2019

androidx.core:core:1.2.0-beta02 and androidx.core:core:1.2.0-beta02 are released. Version 1.2.0-beta02 contains these commits.

Bug fixes

Updated translations for en-rCA and en-rXC locales.

Version 1.2.0-beta01

October 9, 2019

androidx.core:core:1.2.0-beta01 and androidx.core:core-ktx:1.2.0-beta01 released. Version 1.2.0-beta01 contains these commits.

API Changes

Added support for creating NotificationCompat Actions using IconCompat and deprecated a public field (and its getter) using resource IDs to represent icons for Actions. (aosp/1119192)
Add MathUtils.clamp for longs (aosp/1117300)
Added setChronometerCountDown to NotificationCompat (b/138601213)

Bug Fixes

Fixed an issue with the handling of unicode digits in address detection. (aosp/1129852)

External Contribution

Thank you Sergey Zakharov for enabling the API lint check for MissingBuild and ListenerLast in AndroidX! (aosp/1119191, aosp/1126768)

Version 1.2.0-alpha04

September 5, 2019

androidx.core:core:1.2.0-alpha04 and androidx.core:core-ktx:1.2.0-alpha04 are released. The commits included in this version can be found here.

API changes

Deprecated ShortcutInfoCompat.Builder#setLongLived() and replaced it with a new API with the same name that accepts a boolean as a parameter, to match the similar API in ShortcutInfo.Builder in Android framework.
Added ShortcutInfoCompat.Builder#setRank() and ShortcutInfoCompat#getRank() to match the ShortcutInfo in Android framework.

Bug fixes

Nested pre scrolling is no longer performed before the gesture exceeds touch slop (b/139530818, aosp/1105373). This benefits ViewPager2 and other libraries.

Version 1.2.0-alpha03

August 7, 2019

androidx.core:core:1.2.0-alpha03 and androidx.core:core-ktx:1.2.0-alpha03 are released. The commits included in this version can be found here.

New features

Added UriCompat.toSafeString(Uri) to provide URI escaping that is updatable separately from the platform. (b/130878326)
Added Predicate<T> interface to provide Java 8-style predicates without requiring Java 8 language features.

API changes

Made removeDynamicShortuct() static (b/134993204)
Created factory method for BlendMode Color Filter (b/135943149)
Added async, counter, and isEnabled to TraceCompat (aosp/987332)
Unhid APIs in WindowInsetsCompat and ViewDragHelper (aosp/979408)

Bug fixes

Fixed bug with NestedScrollView scrolling in response to a11y scroll calls. (aosp/971000)
Switched to using SimpleArrayMap in ViewCompat implementation (aosp/1012534)
Fixed bug where FingerprintManager incorrectly checked PackageManager on API Level 23 (b/124066957)

Version 1.2.0-alpha02

June 13, 2019

androidx.core:core:1.2.0-alpha02 and androidx.core:core-ktx:1.2.0-alpha02 are released. The commits included in this version can be found here.

API changes

Added WindowInsetsCompat.wrap() and unwrap(), to be able to wrap and unwrap WindowInsets instances

Version 1.2.0-alpha01

May 7, 2019 androidx.core:core:1.2.0-alpha01 are androidx.core:core-ktx:1.2.0-alpha01 are released.

New features

Add ACTION_PAGE_UP/DOWN/NEXT/PREVIOUS accessibility actions
Add CATEGORY_NOTIFICATION to NotificationCompat
Add support for contextual Notification Actions
Add support for bubbles in NotificationCompat
Added BlendModeCompat APIs to leverage the BlendMode APIs on Android 10 and falling back to PorterDuff.Mode equivalents wherever possible
Add new getters to WindowInsetsCompat and ViewCompat
Add support for tap-to-edit in notifications
DrawerLayout system gesture exclusion rects
Add NotificationCompat API for whether to allow system generated contextual actions
Handle disabled <activity-alias> components in NavUtils
Add AccessibilityNodeInfoCompat.setEntryKey

Bug fixes

Fix exception when loading fonts in TypefaceCompat
Various DayNight fixes
Fix backwards compatibility for bundle key strings between 28.0 (support library) and 1.1 (AndroidX) in EditorInfoCompat, ShareCompat, WakefulBroadcastReceiver and InputConnectionCompat

Version 1.1.0

September 5, 2019

androidx.core:core:1.1.0 and androidx.core:core-ktx:1.1.0 are released. The commits included in this version can be found here.

Important Changes since 1.0.0

Updated accessibility APIs to match the Android 10 platform accessibility APIs
Added improvements to Nested Scrolling; see NestedScrollingChild3 and NestedScrollingParent3.
This library no longer exposes the androidx.collection dependency as part of its API. If you were depending on the androidx.collection types implicitly through a dependency on Core, you will need to add an explicit androidx.collection dependency to your library or app. This change is source-incompatible but retains binary compatibility. The Collection dependency is still a transitive dependency of Core but as an implementation detail instead of part of its API.
Worked around an IPC compatibility issue caused by refactor to androidx (aosp/948725, aosp/938269)
Added a variety of fixes for AppCompat DayNight (aosp/942956)

Version 1.1.0-rc03

August 7, 2019

androidx.core:core:1.1.0-rc03 and androidx.core:core-ktx:1.1.0-rc03 are released. The commits included in this version can be found here.

Bug fixes

Make the hidden androidx.core.app.ComponentActivity implement LifecycleOwner to maintain binary compatibility with androidx.fragment:fragment:1.0.0 (aosp/1094409)

Version 1.1.0-rc02

July 2, 2019

androidx.core:core:1.1.0-rc02 and androidx.core:core-ktx:1.1.0-rc02 are released. The commits included in this version can be found here.

Bug fixes

FingerprintManagerCompat#getFingerprintManagerOrNull on API level 23 should not check PackageManager (b/124066957) (aosp/987433)
Fix equality comparison in AccessibilityNodeInfoCompat (aosp/985736)

Version 1.1.0-rc01

June 5, 2019

androidx.core:core:1.1.0-rc01 and androidx.core:core-ktx:1.1.0-rc01 are released. The commits included in this version can be found here.

Bug fixes

Make image keyboard API backport compatible to all previous impls (aosp/968220)
Remove Guava ListenableFuture from androidx.core:core library dependencies (b/133171974, aosp/965393)
Fix incorrect velocity while flinging with nested scrolling. (aosp/961642)
Add test for mutating TransitionDrawable (b/37033322)

Version 1.1.0-beta01

May 7, 2019

androidx.core:core:1.1.0-beta01 and androidx.core:core-ktx:1.1.0-beta01 are released. The commits included in this version can be found here.

The initial release of AndroidX broke backwards compatibility for Support Library compat APIs that are used for inter-process communication, sending keyed data in bundles. This release fixes this compatibility, restoring communication between code built with Support Library 28.0 (or earlier) and AndroidX 1.1 (or later).

API changes

Undeprecated capability setters (aosp/937281)
RemoteActionCompat is now a 1VersionedParcelable` (aosp/928534)

Bug fixes

AppCompatTextView in core tests should be created with an appcompat theme (aosp/951636)
Use pre-1.0 string values for InputConnectionCompat (aosp/948725)
Use pre-AndroidX strings as fallback interop for bundle keys (aosp/938269)
Fixed bug in DayNight updates when in background (aosp/942956)
Implemented text entry key API for accessibility services in AOSP Keyboard (aosp/943897)
Fixed exception when loading font on devices running API Level 20 and lower
Handle disabled <activity-alias> components in NavUtils (aosp/940788)

Version 1.1.0-alpha05

March 13, 2019

androidx.core:core:1.1.0-alpha05 and androidx.core:core-ktx:1.1.0-alpha05 are released. The full list of commits included in this version can be found here.

New features

New ActivityCompat.recreate() API for working around pre-28 platform bugs (aosp/898940)
New LocationManagerCompat class (aosp/894736)

API changes

This library no longer exposes the ‘collection’ dependency as part of its API. If you were depending on the ‘collection’ types implicitly through a dependency on ‘core’, you will need to add an explicit ‘collection’ dependency to your library or app. This change is source-incompatible but retains binary compatibility. The ‘collection’ dependency is still a transitive dependency of ‘core’ but as an implementation detail instead of part of its API.

Bug fixes

Fixed bug with default tint mode for ImageView on devices running API level 21

Version 1.1.0-alpha04

January 30, 2019

androidx.core:core 1.1.0-alpha04 and androidx.core:core-ktx 1.1.0-alpha04 are released.

API changes

Change value of EXTRA_SHORTCUT_ID to be consistent with the platform (aosp/877712)
Add CATEGORY_NOTIFICATION to NotificationCompat (aosp/861067)

Bug fixes

Fix for fontFamily not working on devices running API level 24 and lower (aosp/807054)
Fixed bug where replacing accessibility actions, and adding accessibility actions, didn't remove old accessibility actions (aosp/848314)

Version 1.1.0-alpha03

December 17, 2018

androidx.core 1.1.0-alpha03 and androidx.core-ktx 1.1.0-alpha03 are released with the following changes. androidx.core-ktx 1.1.0-alpha02 is released to provide a ktx match for androidx.core 1.1.0-alpha02.

New features

Added Notification channels methods to NotificationManagerCompat so developers can use only NotificationManagerCompat when working with notifications. Special thanks to Zdeněk Kořán for this new feature!

API changes

Added new APIs to ShortcutManagerCompat to publish and update dynamic shortcuts.

Version 1.1.0-alpha01

November 5, 2018

androidx.core 1.1.0-alpha01 is released with the following API changes and bug fixes.

New features and API changes

NestedScrollingChild3 and NestedScrollingParent3 add the ‘consumed’ parameter to the overloaded dispatchNestedScroll and * onNestedScroll methods so that the view that drives nested scrolling can be better informed about how much scroll distance was * consumed by parents in each nested scroll pass.
NestedScrollView now implements NestedScrollingChild3 and NestedScrollingParent3, and therefore, the NestedScrollingChild2 and * NestedScrollingParent2 implementations of dispatchNestedScroll and onNestedScroll are not guaranteed to be called. Developers * counting on either being called should also override the new nested scrolling 3 version of dispatchNestedScroll and onNestedScroll.
ShortcutInfoCompat has the following new fields: Persons, categories and isLongLived. Done to advertise it can accept various types * of content.
Renamed SupportActivity to ComponentActivity. See androidx.activity for more info.
Added getMainExecutor() method, which returns an Executor link that will run enqueued tasks on the main thread associated with that * context.
Added compatibility implementation of Resources.getFloat.
Added Results Source to compat RemoteInput. This allows apps to distinguish direct and smart replies for logging purposes.
Added Kotlin extension functions for TextView TextWatcher actions.
Deprecated AccessibilityNodeInfo capability and flag setters; use actions instead.
Added AccessibilityPane to ViewCompat.
Exposed ClickableSpans on pre-O devices through the addition of AccessibilityClickableSpanCompat.
Deprecated AccessibilityNodeInfoCompat.setFocusable(), setClickable(), setLongClickable(), setScrollable(), and setContextClickable(). Added AccessibilityActions instead.
Added ViewCompat.setAccessibilityPaneTitle(), getAccessibilityPaneTitle(), setScreenReaderFocusable(), isScreenReaderFocusable(), setAccessibilityHeading(), and isAccessibilityHeading(), to backport this View accessibility functionality through API 19.
Added ViewCompat.enableAccessibleClickableSpanSupport() to allow developers to make non-URL ClickableSpans accessible back through API 19.

Bug fixes

Fixed bug that caused ResourcesCompat.getFont() crash when the network fails, when using downloadable fonts.
Fixed Null Pointer Exception in TypefaceCompatApi21 that occurred when ContentResolver returned null.
Fixed type error in Array Utils where it expected ColorStateList but got raw colors.

Core-Animation and Core-Animation-Testing 1.0.0

Version 1.0.0

May 1, 2024

androidx.core:core-animation:1.0.0 and androidx.core:core-animation-testing:1.0.0 are released. Version 1.0.0 contains these commits.

Major features of 1.0.0

androidx.core:core-animation is a backport of the Animator API including all the features added to the platform since API Level 14. Some of the notable features are:

ValueAnimator#pause, ValueAnimator#resume (API Level 19)
ObjectAnimator.ofMultiInt, ObjectAnimator.ofMultiFloat (API Level 21)
ValueAnimator#setCurrentFraction (API Level 22)
AnimatorSet#setCurrentPlayTime (API Level 26)
androidx.core:core-animation-testing allows developers to test animators in a deterministic manner. See AnimatorTestRule for the details.

Version 1.0.0-rc01

July 26, 2023

androidx.core:core-animation:1.0.0-rc01, androidx.core:core-animation-testing:1.0.0-rc01, and androidx.core:core-remoteviews:1.0.0-rc01 are released. Version 1.0.0-rc01 contains these commits.

New Features

RemoteViews moves moved to rc01 after stabilizing in beta.

Version 1.0.0-beta01

April 20, 2022

androidx.core:core-animation:1.0.0-beta01 is released with no changes since 1.0.0-alpha02. Version 1.0.0-beta01 contains these commits.

Core-Animation Core-Animation-Testing Version 1.0.0-alpha02

August 19, 2020

androidx.core:core-animation:1.0.0-alpha02 and androidx.core:core-animation-testing:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits.

Bug Fixes

Fix AnimatorSet with multiple Animators for a single property. (aosp/1351310)

Core-Animation Version 1.0.0-alpha01

April 15, 2020

androidx.core:core-animation:1.0.0-alpha01 and androidx.core:core-animation-testing:1.0.0-alpha01 are released. Version 1.0.0-alpha01 contains these commits.

New Features

androidx.core:core-animation is a backport of the Animator API including all the features added to the platform since API Level 14. Some of the notable features are:

ValueAnimator#pause, ValueAnimator#resume (API Level 19)
ObjectAnimator.ofMultiInt, ObjectAnimator.ofMultiFloat (API Level 21)
ValueAnimator#setCurrentFraction (API Level 22)
AnimatorSet#setCurrentPlayTime (API Level 26)
androidx.core:core-animation-testing allows developers to test animators in a deterministic manner. See AnimatorTestRule for the details.

Core-Role Version 1.1.0

Version 1.1.0-rc01

December 15, 2021

androidx.core:core-role:1.1.0-rc01 is released with no changes since 1.1.0-alpha01. Version 1.1.0-rc01 contains these commits.

Core-Role Version 1.1.0-alpha01

April 15, 2020

androidx.core:core-role:1.1.0-alpha01 is released. Version 1.1.0-alpha01 contains these commits.

API Changes

Added role name for system gallery.

Core-Role Version 1.0.0

Version 1.0.0

February 10, 2021

androidx.core:core-role:1.0.0 is released. Version 1.0.0 contains these commits.

Major features of 1.0.0

Added RoleManagerCompat containing the name and documentation for roles that might be available in the system.

Core-Role Version 1.0.0-rc01

April 15, 2020

androidx.core:core-role:1.0.0-rc01 is released with no changes since 1.0.0-beta01. Version 1.0.0-rc01 contains these commits.

Core-Role Version 1.0.0-beta01

November 20, 2019

androidx.core:core:1.0.0-beta01 is released with no changes since 1.0.0-alpha01. Version 1.0.0-beta01 contains these commits.

Core-Role Version 1.0.0-alpha01

July 2, 2019

androidx.core:core-role:1.0.0-alpha01 is released. This is the first release of androidx.core:core-role. The commits included in this initial version can be found here.

New features

Added RoleManagerCompat containing the name and documentation for roles that might be available in the system.

Version 1.0.2

May 7, 2019

androidx.core:core:1.0.2, and androidx.core:core-ktx:1.0.2 are released. This release includes 2 commits.

Bug fixes

Use pre-1.0 string values for InputConnectionCompat (aosp/948725)
Use pre-AndroidX strings as fallback interop for bundle keys (aosp/938269)

Version 1.0.1

November 7, 2018

Bugfix release of core-1.0.1 and appcompat-1.0.2.

Bug fixes

Fixed bug where PrecomputedTextCompat would crash when used with RTL AppCompatTextView. b/113070424

Core-Ktx Version 1.0.1

November 5, 2018

androidx.core-ktx 1.0.1 is released with the following bug fixes:

Fixed bug where implementation of union and intersection were swapped.