Core
androidx.core.animation
androidx.core.app
androidx.core.content
androidx.core.role
androidx.core.view
(See the refdocs for all core packages)
This table lists all the artifacts in the androidx.core
group.
Artifact | Stable Release | Release Candidate | Beta Release | Alpha Release |
---|---|---|---|---|
core | 1.13.1 | - | 1.15.0-beta01 | - |
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 |
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.13.1" // 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.13.1" // 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.
See the Issue Tracker documentation for more information.
Core-i18n Core-location-altitude Version 1.0.
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 andrekir@pm.me
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 methodaddMslAltitudeToLocation(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 refactoredJetpackConnectionService
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 toaddCall
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 legacyConnectionService
API for devices running older versions of Android.
Core and Core-ktx Version 1.15
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
andimportantForAccessibilityItemCount
fields toCollectionInfoCompat
. (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 to19
. 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 toBiometricPrompt
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 nowfinal
,interpolatePathDataNodes
now throws an exception for incompatible arguments instead of returning aboolean
, andnodesToPath
now belongs toPathParser
rather thanPathParser.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
andSynchronizedPool
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 asGestureDetector
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 asMarginLayoutParams
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 typeT
now matches the nullability of what theaccept()
method receives. (Ie21e0) androidx.core.util.Supplier
has been converted to Kotlin, ensuring that the nullability of the type returned byget()
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
, useListView
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 receiveonUserLeaveHint
events necessary for implementing picture-in-picture. This is implemented byComponentActivity
in Activity1.9.0-alpha01
. (I54892)
API Changes
- Deprecated
androidx.core.os.CancellationSignal
. Usages should be replaced with the platform-providedandroid.os.CancellationSignal
. (Id45f6, b/309499026, b/309054079) - The
OnMultiWindowModeChangedProvider
,OnNewIntentProvider
,OnPictureInPictureModeChangedProvider
,OnConfigurationChangedProvider
, andOnTrimMemoryProvider
interfaces have been converted to Kotlin to ensure that the generic parameters on theConsumer
that their listener methods take have the correct nullability (they are all non-null). (Ib6237) - The
MultiWindowModeChangedInfo
andPictureInPictureModeChangedInfo
classes that are sent to theConsumer
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
andhashCode
methods inPerson
. (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 ofos.BundleCompat
. - Deprecated
BuildCompat.isAtLeastU()
. UseSDK_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)
toTextView
compat classes (Ia9fa9) - Added
TypedValueCompat.getUnitFromComplexDimension()
from Android 14 (I958e8) - Added
setLineHeight(unit, lineHeight)
toTextView
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()
. UseSDK_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)
toTextView
compat classes (I15716) - New
accessibilityDataSensitive
compat property. (I0c6e0) PendingIntentCompat.getActivity
andgetService
may return null whenFLAG_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()
, andLocation.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
toNotifManagerCompat
(aosp/516143e05f824ff49bde3c0c97344a2924867d30) - Deprecated
app.BundleCompat
in favor ofos.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 methodperformHapticFeedback
(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, especiallyisHierarchical
(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 theWindowInsetsController
APIs on some API levels, and is the extraction of the backing implementation forWindowInsetsControllerCompat.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
toNotifManagerCompat
(I8ec95, b/243183646) - Deprecate
app.BundleCompat
in favor ofos.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 ofgetType
requires that the caller hold the correct read permission.FileProvider
now provides a defaultgetTypeAnonymous
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 ofset/getMinMillisBetweteenContentChanges
have been renamed toset/getMinDurationBetweenContentChanges
and now take along
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
andCoordinatorLayout
(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 forAD_SERVICES
extension version (I51d98) - Add
BEHAVIOR_DEFAULT
toWindowInsetsControllerCompat
.BEHAVIOR_SHOW_BARS_BY_SWIPE
andBEHAVIOR_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
toNotificationCompat
(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
usingIcon
(Ice26d) - Added
@RequiresPermission
to APIs that require granting thePOST_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
andis/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 thePOST_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 platformTypeface.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 accompanyingSDK_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, includingonPrepareMenu
andonMenuClosed
- Fixed issue where
FileProvider
would fail withIllegalArgumentException
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 preventClassCastException
(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 notFontWeight.Normal
orFontWeight.Bold
, as the actual loaded weight and style will be used. (#212, b/194553426)
External Contribution
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 theonPrepareMenu()
callback, which is called when a menu is dynamically modified and should be shown. (Ie85f9) - The
MenuProvider
interface now includes theonMenuClosed()
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 inIcon#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. DeprecatedViewCompat.getWindowInsetsController
in favor ofWindowCompat.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 toAccessibilityNodeInfoCompat
(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 byComponentActivity
in Activity1.5.0-alpha02
. (I9f567) - Adds the
OnMultiWindowModeChangedProvider
interface to allow any component to receive multi-window mode change events. This is implemented byComponentActivity
in Activity1.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 platformWindowInsetsController
. 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
, andonTrimMemoryProvider
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 aMenuProvider
is removed prior to the Lifecycle beingDESTROYED
. (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 manageMenuProvider
s. (I83f23) - Added
MenuProvider
interface that can be used to indicate that a component is supplying menu items. (If8a40) - Added
MenuHostHelper
to simplify implementingMenuHost
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
fromPermissionChecker
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
OnReceiveContentListener
into compat APIs. (Ic6914, b/173814913) - Added
ActivityCompat#isLaunchedFromBubble
for platform parity. (I6961a) - Added
LocationRequest
andLocationManager.hasProvider()
for platform parity. (I4f3e4)
Bug Fixes
- Removed the use of lambdas in
PackageManagerCompat
to avoidLambdaDesugaring
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 toInputConnection.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 version1.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 ofSplashScreen
(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 asPhoneWindow
, so it's unnecessary to inherit the value from API 29. Also remove the override action fromapplyAppSystemUiTheme
, sinceenforceNavigationBarContrast
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
whenSplashScreenView#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 theOnExitAnimationListener
(#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 callactivity.setTheme()
beforeonCreate()
to set your app theme after the splash screen is shown.- Backward support of the
windowSplashScreenIconBackgroundColor
attribute: usingTheme.SplashScreen.IconBackground
andwindowSplashScreenIconBackgroundColor
, 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 newcom.google.android.gms:play-services-appindex
library. This version of the library is not compatible withcom.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 newcom.google.android.gms:play-services-appindex
library. Note that this version of the library is not compatible withcom.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
tocom.google.android.gms:play-services-appindex
. Developers who use this new version should not externally depend oncom.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
ColorStateList
s. (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
fromContextCompat
,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
ColorStateList
s. (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
andSubscriptionManagerCompat
(I5568d) - Remove deprecated
addCapabilityBinding
method fromShortcutInfoCompat
(Ie8f70) - Add
addCapabilityBinding
with parameters andaddCapabilityBinding
without parameters setters toShortcutInfoCompat.Builder
, deprecated oldaddCapabilityBinding
(I90686) - Add
LocationCompat
class andLocationManagerCompat.getCurrentLocation()
(I78d9a) - Deprecated
ModeCompat.isNative
which is replaced byDisplayCompat.getMode
. (I9a6a2) - Added
ContextCompat.getAttributionTag()
andUserHandleCompat.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 withandroidx.core
; you can start usingShortcutManagerCompat
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 byShortcutManagerCompat
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
andWindowInsetsCompat
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 byDisplayCompat.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()
fromOnReceiveContentListener
; now MIME types are passed as an additional arg on theViewCompat
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
toview.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 theBigPictureStyle
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 togetCachedFont
(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 newime()
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 theadjustResize
window soft input mode. If you’re instead using theadjustPan
mode, it should work reliably back to API 14.
- Some caveats about the
API Changes
- Added
ObjectsCompat#toString(Object, String)
. This offers the behavior ofObjects#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
andNotificationCompat.MessagingStyle.addHistoricMessage
(I62bb6) - Update Notification documentation (I1293f)
- Fix nullability of NotificationCompat.Builder (I932e3)
- Added
NotificationChannelCompat
andNotificationChannelGroupCompat
(Icc3b6) - Add
addExtraDataToAccessibilityNodeInfo
toAccessibilityNodeProviderCompat
(I26575) - Update WindowInsetsCompat to Android 11 APIs (I3df9e)
External Contribution
- Add
Uri
overloads forMailTo
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
, andNotification
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 forView#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 implementshashCode()
andequals()
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
inNotificationCompat
- 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
andInputConnectionCompat
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
toNotificationCompat
(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 inShortcutInfo.Builder
in Android framework. - Added
ShortcutInfoCompat.Builder#setRank()
andShortcutInfoCompat#getRank()
to match theShortcutInfo
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
, andisEnabled
toTraceCompat
(aosp/987332) - Unhid APIs in
WindowInsetsCompat
andViewDragHelper
(aosp/979408)
Bug fixes
- Fixed bug with
NestedScrollView
scrolling in response to a11y scroll calls. (aosp/971000) - Switched to using
SimpleArrayMap
inViewCompat
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
andInputConnectionCompat
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
andNestedScrollingParent3
. - This library no longer exposes the
androidx.collection
dependency as part of its API. If you were depending on theandroidx.collection
types implicitly through a dependency on Core, you will need to add an explicitandroidx.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
implementLifecycleOwner
to maintain binary compatibility withandroidx.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 checkPackageManager
(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
toNotificationCompat
(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 onlyNotificationManagerCompat
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()
, andsetContextClickable()
. AddedAccessibilityAction
s instead. - Added
ViewCompat.setAccessibilityPaneTitle()
,getAccessibilityPaneTitle()
,setScreenReaderFocusable()
,isScreenReaderFocusable()
,setAccessibilityHeading()
, andisAccessibilityHeading()
, to backport thisView
accessibility functionality through API 19. - Added
ViewCompat.enableAccessibleClickableSpanSupport()
to allow developers to make non-URLClickableSpan
s 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. SeeAnimatorTestRule
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
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 RTLAppCompatTextView
. 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.