Core

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

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

Artifact Current Stable Release Next Release Candidate Beta Release Alpha Release
core 1.7.0 - - 1.8.0-alpha01
core-animation - - - 1.0.0-alpha02
core-google-shortcuts 1.0.0 - - 1.1.0-alpha01
core-role 1.0.0 - - 1.1.0-alpha01
core-splashscreen - - - 1.0.0-alpha02
This library was last updated on: December 1, 2021

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.7.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-alpha02"
    // To test the Animator APIs
    androidTestImplementation "androidx.core:core-animation-testing:1.0.0-alpha02"

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

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

Kotlin

dependencies {
    val core_version = "1.7.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-alpha02")
    // To test the Animator APIs
    androidTestImplementation("androidx.core:core-animation-testing:1.0.0-alpha02")

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

    // Optional - APIs for SplashScreen, including compatiblity helpers on devices prior Android 12
    implementation("androidx.core:core-splashscreen:1.0.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 and Core-ktx Version 1.7.0

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)

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 Splashscreen Version 1.0

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

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.1.0

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

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

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.0

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

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

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

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

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

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

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

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.

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).

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

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.