Core

代码示例

API 参考文档
androidx.core.animation
androidx.core.app
androidx.core.content
androidx.core.role
androidx.core.view
（请参阅所有核心软件包的参考文档）

针对最新的平台功能和 API 调整应用，同时还支持旧设备。

下表列出了 androidx.core 组中的所有工件。

工件	当前稳定版	下一候选版	Beta 版	Alpha 版
core	1.6.0	-	-	1.7.0-alpha02
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-alpha01

此库的最后更新时间：2021 年 9 月 1 日

声明依赖项

如需添加 Core 的依赖项，您必须将 Google Maven 代码库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
    def core_version = "1.6.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-alpha01"
}

Kotlin

dependencies {
    val core_version = "1.6.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-alpha01")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库的改进有自己的见解，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

Core 和 Core-ktx 版本 1.7.0

版本 1.7.0-alpha02

2021 年 9 月 1 日

发布了 androidx.core:core:1.7.0-alpha02 和 androidx.core:core-ktx:1.7.0-alpha02。版本 1.7.0-alpha02 中包含这些提交内容。

新功能

简化和统一了生命周期感知型菜单的管理方式。如需了解详情，请参阅 MenuProvider。

API 变更

为管理 MenuProvider 的组件添加了 MenuHost 接口。(I83f23)
添加了 MenuProvider 接口，可用于指明组件提供菜单项。(If8a40)
添加了 MenuHostHelper，可简化在组件中实现 MenuHost 的过程。(I74f4a)
添加了 LocationRequestCompat.toLocationRequest()，用于转换为平台类。(I71e75)
添加了 DocumentsContractCompat 类，以便与平台 API 等效。(Ia9e91)
添加了 NotificationCompat.BigPictureStyle.showBigPictureWhenCollapsed(boolean)，以便与平台 API 等效。(I8cd88)
修复了 PermissionChecker 中的 checkSelfPermission 会显示麦克风/摄像头指示标志的问题。(I572a9)
为 setImportantForAccessibility 添加了显式线程注解。(I990fa)
更新了 getUnusedAppRestrictionsStatus，以符合 API 准则。(I28a18)
完善了 getUnusedAppRestrictionsStatus 的功能。(I7c2d6)
为 LocationCompat 添加了对垂直精确度、速度精确度和方位精确度的支持。(I1d3e9)
向 MathUtils 添加了数学兼容性函数。(Idb590)
将 OnReceiveContentListener 集成到了兼容型 API 中。（Ic6914、b/173814913）
添加了 ActivityCompat#isLaunchedFromBubble，以便与平台等效。(I6961a)
添加了 LocationRequest 和 LocationManager.hasProvider()，以便与平台等效。(I4f3e4)

bug 修复

取消了在 PackageManagerCompat 中使用 lambda，以避免 LambdaDesugaring bug。(I36c87)

版本 1.7.0-alpha01

2021 年 6 月 30 日

发布了 androidx.core:core:1.7.0-alpha01 和 androidx.core:core-ktx:1.7.0-alpha01。版本 1.7.0-alpha01 中包含这些提交内容。

API 变更

新增了一个 API 来配置 InputConnection，以便使用 View.performReceiveContent 处理对 InputConnection.commitContent 的 IME 调用。(I3a2ad)
将两个 API 功能合并为一个 (I261df)
修改了两个 API 的功能，用来与未使用的应用限制功能（如权限撤消、应用休眠）搭配使用 (Ic1616)
添加了三个 API，用来与未使用的应用限制功能（如权限撤消、应用休眠）搭配使用 (I606d7)
向多个 Compat 类添加了可为 null 注解（I2802a、b/188452327、b/189962089）
添加了三个 API，用来与未使用的应用限制功能（如权限撤消、应用休眠）搭配使用 (Icafee)
解决了 ViewCompat 中缺少可为 null 注解的问题（Ic346e、b/188453571）

Core Splashscreen 版本 1.0.0

版本 1.0.0-alpha01

2021 年 6 月 30 日

发布了 androidx.core:core-splashscreen:1.0.0-alpha01。

新功能

core-splashscreen 可向后兼容新的 Splash Screen API。此第一个 Alpha 版本包含向后移植到 API 23 的所有新 API，图标背景除外。
如需了解使用信息，请参阅 androidx.core.splashscreen 中的 KDocs。

Core Google Shortcut 版本 1.1.0

版本 1.1.0-alpha01

2021 年 8 月 4 日

发布了 androidx.core:core-google-shortcuts:1.1.0-alpha01。版本 1.1.0-alpha01 中包含这些提交内容。

新功能

支持为 Google 应用要显示的“已捐赠”快捷方式中基于 URI 的图标编制索引。

Core 和 Core-ktx 版本 1.6.0

版本 1.6.0

2021 年 6 月 30 日

发布了 androidx.core:core:1.6.0 和 androidx.core:core-ktx:1.6.0。版本 1.6.0 中包含这些提交内容。

自 1.5.0 以来的重要变更

添加了对解析嵌套 ColorStateList 中主题属性的支持。（I2e409、b/155579892）
向后移植了 CheckedTextView 的可着色背景和对勾标记 (I8575c)

版本 1.6.0-rc01

2021 年 6 月 16 日

发布了 androidx.core:core:1.6.0-rc01 和 androidx.core:core-ktx:1.6.0-rc01。版本 1.6.0-rc01 中包含这些提交内容。

API 变更

JobIntentService 已弃用，取而代之的是 WorkManager（Ic7749、b/149049019）

版本 1.6.0-beta02

2021 年 6 月 2 日

发布了 androidx.core:core:1.6.0-beta02 和 androidx.core:core-ktx:1.6.0-beta02。版本 1.6.0-beta02 中包含这些提交内容。

bug 修复

更新了 BuildCompat，现在可在最新平台上使用当前的长按超时设置 (b/185118174)
从 ContextCompat 和 ContentLoadingProgress 方法中删除了 synchronized。

版本 1.6.0-beta01

2021 年 5 月 18 日

发布了 androidx.core:core:1.6.0-beta01 和 androidx.core:core-ktx:1.6.0-beta01。版本 1.6.0-beta01 中包含这些提交内容。

API 变更

向后移植了 Objects.requireNonNull()（I27db5、b/179904366）

版本 1.6.0-alpha03

2021 年 5 月 5 日

发布了 androidx.core:core:1.6.0-alpha03 和 androidx.core:core-ktx:1.6.0-alpha03。版本 1.6.0-alpha03 中包含这些提交内容。

新功能

添加了对解析嵌套 ColorStateList 中主题属性的支持。（I2e409、b/155579892）

bug 修复

在由 AppCompat 支持的视图中处理 null 自定义选择操作模式回调时，防止出现 NPE。（I033c7、b/173435375）
在版本低于 30 的 SDK 上添加了对 setSystemBarsBehavior 的支持。（I062c8、b/173203649）

版本 1.6.0-alpha02

2021 年 4 月 15 日

发布了 androidx.core:core:1.6.0-alpha02 和 androidx.core:core-ktx:1.6.0-alpha02。版本 1.6.0-alpha02 中包含这些提交内容。

API 变更

添加了 TelephoneManagerCompat 和 SubscriptionManagerCompat (I5568d)
从 ShortcutInfoCompat 中移除了废弃的 addCapabilityBinding 方法 (Ie8f70)
向 ShortcutInfoCompat.Builder 添加了带参数的 addCapabilityBinding setter 和不带参数的 addCapabilityBinding setter，废弃了旧的 addCapabilityBinding (I90686)
添加了 LocationCompat 类和 LocationManagerCompat.getCurrentLocation() (I78d9a)
废弃了 ModeCompat.isNative，改为使用 DisplayCompat.getMode。(I9a6a2)
添加了 ContextCompat.getAttributionTag() 和 UserHandleCompat.getUserHandleForUid() (Iea486)

外部贡献

向后移植 CheckedTextView 的可着色背景和对勾标记 (I8575c)

版本 1.6.0-alpha01

2021 年 3 月 24 日

发布了 androidx.core:core:1.6.0-alpha01 和 androidx.core:core-ktx:1.6.0-alpha01。版本 1.6.0-alpha01 中包含这些提交内容。

API 变更

添加了 Handler.hasCallbacks() 方法，以便与平台 SDK 保持一致（Idce1c、b/113855676）
向 ShortcutInfoCompat.Builder 添加了与功能相关的 setter 方法 (I45af6)

Core Google Shortcut 版本 1.0.0

版本 1.0.0

2021 年 6 月 30 日

发布了 androidx.core:core-google-shortcuts:1.0.0。版本 1.0.0 中包含这些提交内容。

1.0.0 的主要功能

添加此模块后，系统还可以将使用 ShortcutManagerCompat 保存的快捷方式同时捐赠给 Google。如此一来，系统会使用这些快捷方式为用户解锁其他功能，例如将这些快捷方式显示为建议或允许 Google 助理通过语音查询实现这些快捷方式。可以捐赠的快捷方式数量没有限制，以这种方式捐赠的快捷方式将保存在设备中。如需了解详情，请参阅有关将动态快捷方式推送给 Google 助理的完整文档。

版本 1.0.0-rc01

2021 年 6 月 16 日

发布了 androidx.core:core-google-shortcuts:1.0.0-rc01。版本 1.0.0-rc01 中包含这些提交内容。

版本 1.0.0-beta01

2021 年 5 月 18 日

发布了 androidx.core:core-google-shortcuts:1.0.0-beta01。版本 1.0.0-beta01 中包含这些提交内容。

新功能

通过 core-google-shortcuts 库添加的快捷方式将保存为 Firebase appindexing 中的 Shortcut 对象，而非通用的 schema.org/Thing 对象。

bug 修复

从该库中移除了 minSdkVersion 要求。该库仍将只适用于 API 版本 21 及更高版本，但不再需要将应用自己的 minSdkVersion 设置为 21。

版本 1.0.0-alpha03

2021 年 5 月 5 日

发布了 androidx.core:core-google-shortcuts:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

bug 修复

添加/更新快捷方式后，不再自动报告快捷方式的使用情况，而是将使用情况报告移至 ShortcutManagerCompat#pushDynamicShortcut。

版本 1.0.0-alpha02

2021 年 4 月 15 日

发布了 androidx.core:core-google-shortcuts:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

新功能

通过利用作为可选组件的 androidx.core:core-google-shortcuts 与 androidx.core；您可以开始使用 ShortcutManagerCompat 来贡献将被 Google 使用的快捷方式。
新的 TrampolineActivity 将与依靠此模块的应用合并。TrampolineActivity 将用于打开此模块所贡献的快捷方式。

API 变更

添加了 ShortcutInfoChangeListenerImpl，供 ShortcutManagerCompat 用于向 Firebase App Index 贡献快捷方式。

Core 和 Core-ktx 版本 1.5.0

版本 1.5.0

2021 年 5 月 18 日

发布了 androidx.core:core:1.5.0 和 androidx.core:core-ktx:1.5.0。版本 1.5.0 中包含这些提交内容。

自版本 1.4.0 以来的重要变更

支持新的 Insets Animation API
更新了 OnReceiveContentListener，以支持富媒体内容
向后移植了 WindowInsetsController 和 WindowInsetsCompat API，以控制系统栏外观
更新了 ActivityCompat.recreate()，以便在任何 API 级别从任何生命周期状态安全地调用此方法。
添加了 API，以便通过 EditorInfoCompat 提供和检索初始周围文字，从而使 IME 应用避免出现额外的 IPC 延迟。
进行了多项更新，提高了与平台 SDK API 的对等性

版本 1.5.0-rc02

2021 年 5 月 5 日

发布了 androidx.core:core:1.5.0-rc02 和 androidx.core:core-ktx:1.5.0-rc02。版本 1.5.0-rc02 中包含这些提交内容。

bug 修复

在版本低于 30 的 SDK 上添加了对 setSystemBarsBehavior 的支持。（I062c8、b/173203649）

版本 1.5.0-rc01

2021 年 3 月 24 日

发布了 androidx.core:core:1.5.0-rc01 和 androidx.core:core-ktx:1.5.0-rc01。版本 1.5.0-rc01 中包含这些提交内容。

摘要

与之前的 beta03 相比没有任何变化

版本 1.5.0-beta03

2021 年 3 月 10 日

发布了 androidx.core:core:1.5.0-beta03 和 androidx.core:core-ktx:1.5.0-beta03。版本 1.5.0-beta03 中包含这些提交内容。

API 变更

添加了 ExecutorCompat，它会根据处理程序创建 Executor。（Ib4ca3、b/181237835）

版本 1.5.0-beta02

2021 年 2 月 24 日

发布了 androidx.core:core:1.5.0-beta02 和 androidx.core:core-ktx:1.5.0-beta02。版本 1.5.0-beta02 中包含这些提交内容。

bug 修复

废弃了 ModeCompat.isNative，改为使用 DisplayCompat.getMode。(Iefa71)
NotificationCompat.MessagingStyle.getText() 之前被错误地标记为 @NonNull；现已标记为 @Nullable (I05cb7)

版本 1.5.0-beta01

2021 年 1 月 13 日

发布了 androidx.core:core:1.5.0-beta01 和 androidx.core:core-ktx:1.5.0-beta01。版本 1.5.0-beta01 中包含这些提交内容。

API 变更

遵循关于边界兼容性/平台互操作性的 API 准则 (I7da35)
将 AppCompatEditText 中的拖放事件（放置事件）与 OnReceiveContentListener 进行了集成。（Ib26c9、b/175343405）
将新的 Insets Animation API 连接到了平台实现 (I078da)
添加了新的 Insets Animation API (I8aebd)
更新了 OnReceiveContentListener 和相关 API：
- 更新了 OnReceiveContentListener，这样就可以通过 ViewCompat 在任何类型的视图中设置该方法。
- 从 OnReceiveContentListener 中移除了 getSupportedMimeTypes()；现在，MIME 类型会作为附加参数传递给设置监听器的 ViewCompat 方法。
- 将参数封装到对象中的 OnReceiveContentListener.onReceiveContent()。
- 以参数形式向 onReceiveContent() 添加了 linkUri，以确保与键盘图片 API 的向后兼容性。
- 向 onReceiveContent() 添加了 Bundle 参数，以确保与键盘图片 API 的向后兼容性，并且便于在将来改进 API。
- 更新了 onReceiveContent()，以返回未被使用的任何内容，作为委托为默认处理的方法。
- 从公共 API 中移除了 TextViewOnReceiveContentListener，因为现在可以通过从监听器返回任何未被使用的内容触发默认行为。
- （Ib4616、b/173814913）
已弃用 BuildCompat.isAtLeastR (Idb37e)
已将 widget.RichContentReceiverCompat 移至 view.OnReceiveContentListener。（Ifdab7、b/173814913）
添加了 Preconditions.checkFlagsArgument。（I43952、b/174181100）
弃用了用于出站共享的自定义菜单。(I7cd92)
现在，通知可以标记为未接电话。(I14d90)
添加了 PackageInfoCompat#getSignatures，用于检索软件包的证书数组（I8e9a3、b/159831205）

bug 修复

修复了设置 BigPictureStyle.bigLargeIcon 会在新版操作系统上中断该通知的 BigPictureStyle 的错误。(Ic623d)

外部贡献

ShareCompat 现在使用构造函数进行创建，而旧的工厂方法已被弃用。现在，您可以通过 Context 创建构建器和读取器，不再需要 Activity。（I315b6、b/173043501）
使用 ShareCompat 共享数据流时，设置剪辑数据并授予 URI 读取权限（I4aa31、b/173137936）

版本 1.5.0-alpha05

2020 年 11 月 11 日

发布了 androidx.core:core:1.5.0-alpha05 和 androidx.core:core-ktx:1.5.0-alpha05。版本 1.5.0-alpha05 中包含这些提交内容。

API 变更

添加了对新版 GnssStatus API 的支持 (Id8e22)
添加了 FileProvider#getUriForFile 的重载以支持自定义文件名 (Ie870b)
向后移植了用于控制系统栏外观的 WindowInsetsController API。(Ieb4ee)
已将接受布尔值的 getFont 重命名为 getCachedFont (Iea520)
向后移植了 WindowInsetsController API 中的 #hide() 和 #show() 方法，添加到了 API 30 中 (I21573)
添加了包含 cacheOnly 选项的新 API ResourcesCompat#getFont (Ic38cf)
更新了适用于 Android 11 的 AndroidX 通知对话泡 API (Ib9c70)

版本 1.5.0-alpha04

2020 年 10 月 1 日

发布了 androidx.core:core:1.5.0-alpha04 和 androidx.core:core-ktx:1.5.0-alpha04。版本 1.5.0-alpha04 中包含这些提交内容。

API 变更

修复了使用 NotificationCompat.Builder.<init>(Context,Notification) 时出现的样式恢复不完整问题 (Ib297a)
现已推出新的通知类别类型 (I9521a)

bug 修复

允许从任何 API 级别的任何生命周期状态安全地调用 ActivityCompat.recreate()。（I62dde、b/160122826）

版本 1.5.0-alpha03

2020 年 9 月 16 日

发布了 androidx.core:core:1.5.0-alpha03 和 androidx.core:core-ktx:1.5.0-alpha03。版本 1.5.0-alpha03 中包含这些提交内容。

API 变更

ViewCompat 是一个实用程序类，不应被实例化。(If20fa)
用于提供和检索初始周围文字的 API 已向后移植到 EditorInfoCompat。这些 API 支持 IME 应用，可避免出现额外的 IPC 延迟。(Ie3809)
通过 compat 对象查询通知渠道和渠道组。(I11d18)

bug 修复

对于 P 之前的版本，确保将窗格标记为对无障碍功能非常重要，且支持 CONTENT_CHANGE_TYPE_PANE_DISAPPEARED 事件。(Iaeffc)

外部贡献

针对 androidx 启用了 StaticFinalBuilder 的 API lint 检查（I2b11b、b/138602561）

版本 1.5.0-alpha02

2020 年 8 月 19 日

发布了 androidx.core:core:1.5.0-alpha02 和 androidx.core:core-ktx:1.5.0-alpha02。版本 1.5.0-alpha02 中包含这些提交内容。

新功能

WindowInsetsCompat API 已更新至 Android 11 平台中的相应 API。这包括新的 ime() 边衬区类型，可用于检查屏幕键盘的可见性和大小。
- 关于 ime() 类型的一些注意事项：当您的 Activity 使用 adjustResize 窗口软输入模式时，它可以在 API 23 及以上级别上非常可靠地运行。如果您改为使用 adjustPan 模式，则应该回退至 API 14，它才能可靠地运行。

API 变更

添加了 ObjectsCompat#toString(Object, String)。此函数提供 Objects#toString(Object, String) 的行为，但可用于 API 级别 19 之前的级别。(I26cdc)
添加了 NotificationCompat.Builder.recoverBuilder(Notification) (I6f100)
添加了 NotificationCompat.Builder.createContentView() 和类似方法 (I6fe13)
在 AccessibilityNodeInfoCompat 中添加了与 extra 数据相关的 API (I19567)
添加了 NotificationCompat.Builder.setSettingsText 和 NotificationCompat.MessagingStyle.addHistoricMessage (I62bb6)
更新了通知文档 (I1293f)
修复了 NotificationCompat.Builder 的可为 null 性 (I932e3)
添加了 NotificationChannelCompat 和 NotificationChannelGroupCompat (Icc3b6)
在 AccessibilityNodeProviderCompat 中添加了 addExtraDataToAccessibilityNodeInfo (I26575)
将 WindowInsetsCompat 更新为 Android 11 API (I3df9e)

外部贡献

为 MailTo 方法添加了 Uri 重载 (I6fa6b)
添加了提供一致行为的 MailTo API 以及适用于所有 API 级别的问题修复（Ie9395、b/159827506）

版本 1.5.0-alpha01

2020 年 6 月 10 日

发布了 androidx.core:core:1.5.0-alpha01 和 androidx.core:core-ktx:1.5.0-alpha01。

新功能

提供了等同于 Android R 平台 SDK API 用于 ShortcutManager、ShortcutInfo、AccessibilityNodeInfo、DisplayCutout、GnssStatus 和 Notification 类的功能

bug 修复

明确建议检查 shouldShowPermissionRationale。
更改了 AtomicFile 以使用 rename-into-place。
使用指定字体的样式调整 Typeface 显示样式。(b/156853883)
修复了通知构建器测试失败的问题
修复了注册/取消注册问题 LocationManagerCompat。

Core 和 Core-ktx Version 1.4.0

版本 1.4.0-alpha01

2020 年 5 月 20 日

发布了 androidx.core:core:1.4.0-alpha01 和 androidx.core:core-ktx:1.4.0-alpha01。版本 1.4.0-alpha01 中包含这些提交内容。

API 变更

添加了用于插入富媒体内容（例如粘贴图片）的通用 API。新回调提供了一个 API，应用可以实现该单一 API 来支持以不同的方式插入富媒体内容。目前，该 API 仅添加到了 AppCompatEditText，并将为以下代码路径调用：
- 从剪贴板粘贴
- 从 IME 插入内容 (InputConnection.commitContent) (I22bf7)
向后移植了 android.os.Process.isApplicationUid(int)，有助于应用确定代码是否在独立的进程中执行（I4c83a、b/153014822）
向后移植了 LocusId，有助于应用在不同子系统（例如内容捕获、快捷方式和通知）之间关联状态。(Ia3129)
在 ViewGroup 添加了祖先序列（I5f75c、b/117976097）

bug 修复

针对 ActivityCompat.requestPermissions() 添加了权限验证（I372cc、b/122163323）
将 v28+ 调用提取到一个单独的静态类中，该静态类修复了在构建 App Bundle 时 View#OnUnhandledKeyEventListener 发生的 NoClassDefFoundError 错误（Id3419、b/153695093）
修复了 setChronometerCountDown 崩溃问题（I47282、b/145770610）

Core 和 Core-ktx 版本 1.3.2

版本 1.3.2

2020 年 10 月 1 日

发布了 androidx.core:core:1.3.2 和 androidx.core:core-ktx:1.3.2。版本 1.3.2 中包含这些提交内容。

bug 修复

允许从任何 API 级别的任何生命周期状态安全地调用 ActivityCompat.recreate()。（I62dde、b/160122826）

Core 和 Core-ktx 版本 1.3.1

版本 1.3.1

2020 年 7 月 22 日

发布了 androidx.core:core:1.3.1 和 androidx.core:core-ktx:1.3.1。版本 1.3.1 中包含这些提交内容。

bug 修复

修复了 API 级别 29 平台上解析后的字体资源 Typeface 的权重和样式值错误的问题 (b/156853883)

Core 和 Core-ktx 版本 1.3.0

版本 1.3.0

2020 年 5 月 27 日

发布了 androidx.core:core:1.3.0 和 androidx.core:core-ktx:1.3.0。版本 1.3.0 中包含这些提交内容。

自 1.2.0 以来的重要变更

新增了 NestedScrollView API，可实现在指定时长内顺畅滚动
新增了 ViewCompat API，可用于检索已分派给视图层次结构的原始窗口边衬区

版本 1.3.0-rc01

2020 年 4 月 15 日

发布了 androidx.core:core:1.3.0-rc01 和 androidx.core:core-ktx:1.3.0-rc01。版本 1.3.0-rc01 中包含这些提交内容。

bug 修复

WindowInsetsCompat 现在可以在所有支持的 API 级别正确实现 hashCode() 和 equals()。

版本 1.3.0-beta01

2020 年 4 月 1 日

发布了 androidx.core:core:1.3.0-beta01 和 androidx.core:core-ktx:1.3.0-beta01。版本 1.3.0-beta01 中包含这些提交内容。

版本 1.3.0-alpha02

2020 年 3 月 4 日

发布了 androidx.core:core:1.3.0-alpha02 和 androidx.core:core-ktx:1.3.0-alpha02。版本 1.3.0-alpha02 中包含这些提交内容。

API 变更

新增了 NestedScrollView API，可实现在指定时长内顺畅滚动
新增了 ViewCompat API，可用于检索已分派给视图层次结构的原始窗口边衬区

版本 1.3.0-alpha01

2020 年 1 月 29 日

发布了 androidx.core:core:1.3.0-alpha01 和 androidx.core:core-ktx:1.3.0-alpha01。版本 1.3.0-alpha01 中包含这些提交内容。

新功能

添加了 ContentProviderCompat
添加了 WindowInsetsCompat.Builder

API 变更

添加了 NotificationCompat API，可用于将通知实例静音
添加了 ResourcesCompat.NULL_ID
弃用了 NotificationCompat 中的 CarExtender.UnreadConversation
添加了 DisplayCompat API，可用于获取设备的物理尺寸

bug 修复

改进了 NotificationCompat 中没有图标的处理操作
修复了在 API 级别 23，相对于复合可绘制对象，在 TextView 上对可绘制对象进行着色的问题 (aosp/1172194)
确保了基本上下文始终是封装容器
修复了默认情况下 RecyclerView 不应填充 Collection[Item]Info 的问题

版本 1.2.0

2020 年 2 月 5 日

发布了 androidx.core:core:1.2.0 和 androidx.core:core-ktx:1.2.0。版本 1.2.0 中包含以下提交内容。

自 1.1.0 以来的重要变更

在 NotificationCompat 中添加了新的 API 和问题修复
添加了可与 AndroidQ 中以向后兼容方式引入的 BlendMode 结合使用的新 API
在 AccessibilityCompat 中添加了新的 API 和问题修复
添加了可与 ShortcutInfo 结合使用的新 API
添加了可与 WindowInsets 结合使用的新 API
修复了 EditorInfoCompat、ShareCompat、WakefulBroadcastReceiver 和 InputConnectionCompat 中 28.0（支持库）与 1.1 (AndroidX) 之间的软件包密钥字符串的向后兼容性问题

版本 1.2.0-rc01

2019 年 11 月 20 日

发布了 androidx.core:core:1.2.0-rc01 和 androidx.core:core-ktx:1.2.0-rc01，这两个版本与 1.2.0-beta02 相比没有变化。版本 1.2.0-rc01 中包含这些提交内容。

版本 1.2.0-beta02

2019 年 11 月 7 日

发布了 androidx.core:core:1.2.0-beta02 和 androidx.core:core:1.2.0-beta02。版本 1.2.0-beta02 中包含这些提交内容。

bug 修复

更新了 en-rCA 和 en-rXC 语言区域的翻译。

版本 1.2.0-beta01

2019 年 10 月 9 日

发布了 androidx.core:core:1.2.0-beta01 和 androidx.core:core-ktx:1.2.0-beta01。版本 1.2.0-beta01 中包含这些提交内容。

API 变更

增加了对使用 IconCompat 创建 NotificationCompat Action 的支持，并且弃用了以资源 ID 代表 Action 图标的公开字段（及其 getter）。(aosp/1119192)
针对长整型添加了 MathUtils.clamp (aosp/1117300)
向 NotificationCompat 添加了 setChronometerCountDown (b/138601213)

bug 修复

修复了地址检测中处理 Unicode 数字的问题。(aosp/1129852)

外部贡献

感谢 Sergey Zakharov 为在 AndroidX 中针对 MissingBuild 和 ListenerLast 启用 API lint 检查做出的贡献！（aosp/1119191、aosp/1126768）

版本 1.2.0-alpha04

2019 年 9 月 5 日

发布了 androidx.core:core:1.2.0-alpha04 和 androidx.core:core-ktx:1.2.0-alpha04。点击此处可查看此版本中包含的提交内容。

API 变更

弃用了 ShortcutInfoCompat.Builder#setLongLived() 并且将其替换为接受布尔值作为参数且名称不变的新 API，以与 Android 框架的 ShortcutInfo.Builder 中的类似 API 匹配。
添加了 ShortcutInfoCompat.Builder#setRank() 和 ShortcutInfoCompat#getRank() 以与 Android 框架中的 ShortcutInfo 匹配。

bug 修复

在手势超出触摸溢出值之前，不再执行嵌套预滚动（b/139530818、aosp/1105373）。这对 ViewPager2 和其他库有益。

版本 1.2.0-alpha03

2019 年 8 月 7 日

发布了 androidx.core:core:1.2.0-alpha03 和 androidx.core:core-ktx:1.2.0-alpha03。点击此处可查看此版本中包含的提交内容。

新功能

添加了 UriCompat.toSafeString(Uri) 以提供可单独从平台更新的 URI 转义。(b/130878326)
添加了 Predicate<T> 接口以提供 Java 8 风格的谓词，而无需 Java 8 语言功能。

API 变更

将 removeDynamicShortuct() 变为了静态 (b/134993204)
为 BlendMode 色彩滤镜创建了工厂方法 (b/135943149)
向 TraceCompat 添加了 async、counter 和 isEnabled (aosp/987332)
取消隐藏了 WindowInsetsCompat 和 ViewDragHelper (aosp/979408)

bug 修复

修复了响应 a11y 滚动调用方面存在的 NestedScrollView 滚动错误。(aosp/971000)
已切换为在 ViewCompat 实现中使用 SimpleArrayMap (aosp/1012534)
修复了 FingerprintManager 在 API 级别 23 上不当检查 PackageManager 的错误 (b/124066957)

版本 1.2.0-alpha02

2019 年 6 月 13 日

发布了 androidx.core:core:1.2.0-alpha02 和 androidx.core:core-ktx:1.2.0-alpha02。点击此处可查看此版本中包含的提交内容。

API 变更

添加了 WindowInsetsCompat.wrap() 和 unwrap()，以便能够封装和解封装 WindowInsets 实例

版本 1.2.0-alpha01

2019 年 5 月 7 日发布了 androidx.core:core:1.2.0-alpha01 和 androidx.core:core-ktx:1.2.0-alpha01。

新功能

添加了 ACTION_PAGE_UP/DOWN/NEXT/PREVIOUS 无障碍操作
将 CATEGORY_NOTIFICATION 添加到了 NotificationCompat
添加了对上下文通知操作的支持
添加了对 NotificationCompat 中气泡的支持
添加了 BlendModeCompat API，以利用 Android 10 上的 BlendMode API 并尽可能回退到 PorterDuff.Mode 等效项
向 WindowInsetsCompat 和 ViewCompat 添加了新的 getter
添加了对在通知中点按即可修改的支持
DrawerLayout 系统手势排除 rect
添加了 NotificationCompat API，决定是否允许使用系统生成的上下文操作
对 NavUtils 中停用的 <activity-alias> 进行了处理
添加了 AccessibilityNodeInfoCompat.setEntryKey

bug 修复

修复了在 TypefaceCompat 中加载字体时发生的异常
修复了各种 DayNight 问题
修复了 EditorInfoCompat、ShareCompat、WakefulBroadcastReceiver 和 InputConnectionCompat 中 28.0（支持库）和 1.1 (AndroidX) 之间的软件包密钥字符串的向后兼容性问题

版本 1.1.0

2019 年 9 月 5 日

发布了 androidx.core:core:1.1.0 和 androidx.core:core-ktx:1.1.0。点击此处可查看此版本中包含的提交内容。

自 1.0.0 以来的重要变更

更新了无障碍功能 API 以与 Android 10 平台的无障碍功能 API 匹配
添加了嵌套滚动改进；请参阅 NestedScrollingChild3 和 NestedScrollingParent3。
此库不再在其 API 中公开 androidx.collection 依赖项。如果您是通过 Core 上的依赖项隐式依赖 androidx.collection 类型，将需要在您的库或应用中添加显式 androidx.collection 依赖项。此变更与源不兼容，但保留了二进制文件兼容性。Collection 依赖项仍然是 Core 的传递依赖项，但被视为实现细节而非其 API 的一部分。
解决了由 androidx 重构导致的 IPC 兼容性问题（aosp/948725、aosp/938269）
添加了对 AppCompat DayNight 的各种修复 (aosp/942956)

版本 1.1.0-rc03

2019 年 8 月 7 日

发布了 androidx.core:core:1.1.0-rc03 和 androidx.core:core-ktx:1.1.0-rc03。点击此处可查看此版本中包含的提交内容。

bug 修复

使隐藏的 androidx.core.app.ComponentActivity 实现 LifecycleOwner 以保持与 androidx.fragment:fragment:1.0.0 的二进制文件兼容性 (aosp/1094409)

版本 1.1.0-rc02

2019 年 7 月 2 日

发布了 androidx.core:core:1.1.0-rc02 和 androidx.core:core-ktx:1.1.0-rc02。点击此处可查看此版本中包含的提交内容。

bug 修复

API 级别 23 上的 FingerprintManagerCompat#getFingerprintManagerOrNull 不应检查 PackageManager (b/124066957) (aosp/987433)
修复了 AccessibilityNodeInfoCompat 中的等式比较问题 (aosp/985736)

版本 1.1.0-rc01

2019 年 6 月 5 日

发布了 androidx.core:core:1.1.0-rc01 和 androidx.core:core-ktx:1.1.0-rc01。点击此处可查看此版本中包含的提交内容。

bug 修复

使图片键盘 API 向后移植与所有以前的实现兼容 (aosp/968220)
从 androidx.core:core 库依赖项中移除了 Guava ListenableFuture（b/133171974、aosp/965393）
修复了通过嵌套滚动滑动时速度不正确的问题。(aosp/961642)
添加了 TransitionDrawable 转变测试 (b/37033322)

版本 1.1.0-beta01

2019 年 5 月 7 日

发布了 androidx.core:core:1.1.0-beta01 和 androidx.core:core-ktx:1.1.0-beta01。点击此处可查看此版本中包含的提交内容。

AndroidX 的初始版本破坏了用于进程间通信的支持库 compat API 的向后兼容性，以包的形式发送键控数据。此版本修复了该兼容性问题，恢复了使用支持库 28.0（或更低版本）构建的代码与使用 AndroidX 1.1（或更高版本）构建的代码之间的通信。

API 变更

未被弃用的功能 setter (aosp/937281)
RemoteActionCompat 现在是 1VersionedParcelable` (aosp/928534)

bug 修复

core 测试中的 AppCompatTextView 应使用 appcompat 主题背景创建 (aosp/951636)
可对 InputConnectionCompat 使用 1.0 之前版本的字符串值 (aosp/948725)
使用 AndroidX 之前版本的字符串作为软件包密钥的回退交互操作工具 (aosp/938269)
修复了在后台进行 DayNight 更新的相关错误 (aosp/942956)
实现了 AOSP 键盘中用于无障碍服务的文本输入键 API (aosp/943897)
修复了在搭载 API 级别 20 及更低版本的设备上加载字体时发生的异常
对 NavUtils 中停用的 <activity-alias> 组件进行了处理 (aosp/940788)

版本 1.1.0-alpha05

2019 年 3 月 13 日

发布了 androidx.core:core:1.1.0-alpha05 和 androidx.core:core-ktx:1.1.0-alpha05。点击此处可查看此版本中包含的完整提交内容列表。

新功能

新增了 ActivityCompat.recreate() API，用于解决级别 28 之前平台的错误 (aosp/898940)
新增了 LocationManagerCompat 类 (aosp/894736)

API 变更

此库不再将“collection”依赖项作为其 API 的一部分提供。如果您之前通过“core”的依赖项隐式依赖于“collection”类型，将需要向您的库或应用添加显式“collection”依赖项。此变更与源代码不兼容，但保留了二进制文件兼容性。“collection”依赖项仍然是“core”的传递依赖项，但作为实现细节而非其 API 的一部分。

bug 修复

修复了运行 API 级别 21 的设备上 ImageView 的默认色调模式存在的错误

版本 1.1.0-alpha04

2019 年 1 月 30 日

发布了 androidx.core:core 1.1.0-alpha04 和 androidx.core:core-ktx 1.1.0-alpha04。

API 变更

更改了 EXTRA_SHORTCUT_ID 的值以与平台保持一致 (aosp/877712)
向 NotificationCompat 添加了 CATEGORY_NOTIFICATION (aosp/861067)

bug 修复

修复了 fontFamily 在搭载 API 级别 24 及更低版本的设备上无法正常工作的问题 (aosp/807054)
修复了替换无障碍操作以及添加无障碍操作未移除旧无障碍操作的问题 (aosp/848314)

版本 1.1.0-alpha03

2018 年 12 月 17 日

发布了 androidx.core 1.1.0-alpha03 和 androidx.core-ktx 1.1.0-alpha03 及以下变更。发布了 androidx.core-ktx 1.1.0-alpha02，以提供 androidx.core 1.1.0-alpha02 的 ktx 匹配项。

新功能

向 NotificationManagerCompat 添加了通知渠道方法，因此开发者可以在处理通知时仅使用 NotificationManagerCompat。特别感谢 Zdeněk Kořán 为这项新功能做出的贡献！

API 变更

向 ShortcutManagerCompat 添加了新的 API，用于发布和更新动态快捷方式。

版本 1.1.0-alpha01

2018 年 11 月 5 日

发布了 androidx.core 1.1.0-alpha01，并包含以下 API 变更和问题修复。

新功能和 API 变更

NestedScrollingChild3 和 NestedScrollingParent3 向过载的 dispatchNestedScroll 和 * onNestedScroll 方法添加了“consumed”参数，使驱动嵌套滚动的视图能够更好地了解父项在每一遍嵌套滚动中所消耗*的滚动距离。
NestedScrollView 现在实现了 NestedScrollingChild3 和 NestedScrollingParent3，因此不能保证会调用 dispatchNestedScroll 和 onNestedScroll 的 NestedScrollingChild2 和 * NestedScrollingParent2 实现。如果开发者*指望这两者中的任意一个被调用，还应替换新嵌套滚动 3 版本的 dispatchNestedScroll 和 onNestedScroll。
ShortcutInfoCompat 具有以下新字段：Persons、categories 和 isLongLived。添加这些字段是为了告知它可接受各种类型*的内容。
已将 SupportActivity 重命名为 ComponentActivity。如需了解详情，请参阅 androidx.activity。
添加了 getMainExecutor() 方法，该方法会返回一个执行器链接，将在与该*上下文关联的主线程上运行已加入队列的任务。
添加了 Resources.getFloat 的兼容性实现。
向兼容性 RemoteInput 添加了结果来源。这样可让应用出于日志记录目的区分直接回复和智能回复。
为 TextView TextWatcher 操作添加了 Kotlin 扩展函数。
弃用了 AccessibilityNodeInfo 功能和 setter 标记；现在改用操作。
向 ViewCompat 添加了 AccessibilityPane。
通过添加 AccessibilityClickableSpanCompat，在 Android 版本低于 O 的设备上提供了 ClickableSpan。
弃用了 AccessibilityNodeInfoCompat.setFocusable()、setClickable()、setLongClickable()、setScrollable() 和 setContextClickable()。添加了 AccessibilityAction。
添加了 ViewCompat.setAccessibilityPaneTitle()、getAccessibilityPaneTitle()、setScreenReaderFocusable()、isScreenReaderFocusable()、setAccessibilityHeading() 和 isAccessibilityHeading()，将此 View 无障碍功能向后移植，直到 API 19。
添加了 ViewCompat.enableAccessibleClickableSpanSupport()，让开发者能够使非网址 ClickableSpan 的可访问性向后兼容，直到 API 19。

bug 修复

修复了在使用可下载字体的情况下网络出现故障时会导致 ResourcesCompat.getFont() 崩溃的错误。
修复了 ContentResolver 返回 null 时 TypefaceCompatApi21 出现 Null 指针异常的问题。
修复了 Array Utils 希望获得 ColorStateList 但获得的却是原色的类型错误。

Core-Animation 和 Core-Animation-Testing 1.0.0

Core-Animation Core-Animation-Testing 版本 1.0.0-alpha02

2020 年 8 月 19 日

发布了 androidx.core:core-animation:1.0.0-alpha02 和 androidx.core:core-animation-testing:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

bug 修复

修复了 AnimatorSet 为单个属性设置多个 Animator 时的问题。(aosp/1351310)

Core-Animation 版本 1.0.0-alpha01

2020 年 4 月 15 日

发布了 androidx.core:core-animation:1.0.0-alpha01 和 androidx.core:core-animation-testing:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

新功能

androidx.core:core-animation 是 Animator API 的向后移植，包括自 API 级别 14 以来添加到平台中的所有功能。一些重要功能包括：

ValueAnimator#pause、ValueAnimator#resume（API 级别 19）
ObjectAnimator.ofMultiInt、ObjectAnimator.ofMultiFloat（API 级别 21）
ValueAnimator#setCurrentFraction（API 级别 22）
AnimatorSet#setCurrentPlayTime（API 级别 26）
androidx.core:core-animation-testing 允许开发者以确定的方式测试 Animator。如需了解详情，请参阅 AnimatorTestRule。

Core-Role 版本 1.1.0

Core-Role 版本 1.1.0-alpha01

2020 年 4 月 15 日

发布了 androidx.core:core-role:1.1.0-alpha01。版本 1.1.0-alpha01 中包含这些提交内容。

API 变更

添加了系统图库的角色名称。

Core-Role 版本 1.0.0

版本 1.0.0

2021 年 2 月 10 日

发布了 androidx.core:core-role:1.0.0。版本 1.0.0 中包含这些提交内容。

1.0.0 的主要功能

添加了 RoleManagerCompat，其中包含系统中可能提供的角色的名称和文档。

Core-Role 版本 1.0.0-rc01

2020 年 4 月 15 日

发布了 androidx.core:core-role:1.0.0-rc01，该版本与 1.0.0-beta01 相比没有变化。版本 1.0.0-rc01 中包含这些提交内容。

Core-Role 版本 1.0.0-beta01

2019 年 11 月 20 日

发布了 androidx.core:core:1.0.0-beta01，该版本与 1.0.0-alpha01 相比没有变化。版本 1.0.0-beta01 中包含这些提交内容。

Core-Role 版本 1.0.0-alpha01

2019 年 7 月 2 日

发布了 androidx.core:core-role:1.0.0-alpha01。这是 androidx.core:core-role 的第一个版本。点击此处可查看此初始版本中包含的提交内容。

新功能

添加了 RoleManagerCompat，其中包含系统中可能提供的角色的名称和文档。

版本 1.0.2

2019 年 5 月 7 日

发布了 androidx.core:core:1.0.2 和 androidx.core:core-ktx:1.0.2。此版本包含 2 项提交内容。

bug 修复

可对 InputConnectionCompat 使用 1.0 之前版本的字符串值 (aosp/948725)
使用 AndroidX 之前版本的字符串作为软件包密钥的回退交互操作工具 (aosp/938269)

版本 1.0.1

2018 年 11 月 7 日

core-1.0.1 和 appcompat-1.0.2 的问题修复版本。

bug 修复

修复了 PrecomputedTextCompat 在与 RTL AppCompatTextView 配合使用时会崩溃的问题。b/113070424

Core-Ktx 版本 1.0.1

2018 年 11 月 5 日

发布了 androidx.core-ktx 1.0.1，并包含以下问题修复：

修复了交换并集和交集的实现时发生的错误。