此页面由 Cloud Translation API 翻译。

Core

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

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

下表列出了 androidx.core 组中的所有制品。

制品	稳定版	候选版	Beta 版	Alpha 版
core	1.16.0	-	1.17.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.1.0	-	-	-
core-splashscreen	1.0.1	1.2.0-rc01	-	-

此库的最后更新时间：2025 年 7 月 2 日

声明依赖项

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

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

Groovy

dependencies {
    def core_version = "1.16.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.1.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-rc01"
}

Kotlin

dependencies {
    val core_version = "1.16.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.1.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-rc01")
}

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

反馈

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

创建新问题

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

Core-Viewtree 版本 1.0

版本 1.0.0

2025 年 2 月 26 日

androidx.core:core-viewtree:1.0.0 已升级为首个稳定版，与之前的 RC 版相比没有变化。

此库引入了视图能够拥有不相交父级的概念。视图的不相交父级是一个单独的 View 对象，充当视图的父级，但不是通过 View.parent 属性设置的。具有不相交父级的视图示例包括 ViewOverlays、弹出式窗口和对话框，它们都显示在主视图层次结构之外。如果视图没有通过平台的 View.parent 属性设置直接父级，则只能具有不相交的父级。目前，androidx 仅为由 Transition 1.6.0-alpha01 及更高版本创建的 ViewOverlays 设置不相交的父级。您还可以为视图指定自己的不相交父级。如需了解详情，请参阅相关文档。

版本 1.0.0-rc01

2025 年 2 月 12 日

发布了 androidx.core:core-viewtree:1.0.0-rc01，该版本与 Beta 版相比没有变化。

版本 1.0.0-beta01

2025 年 1 月 29 日

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

版本 1.0.0-alpha01

2024 年 12 月 11 日

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

新功能

初始版本 core-viewtree，由 androidx 核心传递性公开。
此初始版本引入了 View 能够拥有不相交父级的概念。视图的不相交父级是一个单独的 View 对象，充当视图的父级，但不是通过 View.parent 属性设置的。具有不相交父级的视图示例包括 ViewOverlays、弹出式窗口和对话框，它们都显示在主视图层次结构之外。如果视图没有通过平台的 View.parent 属性设置直接父级，则只能具有不相交的父级。目前，androidx 仅为由过渡创建的 ViewOverlays 设置不相交的父级。您还可以为视图指定自己的不相交父级。如需了解详情，请参阅相关文档。

API 变更

添加了 ViewParent.getParentOrViewTreeDisjointParent() 和 ViewParent.setViewTreeDisjointParent(View, ViewParent?) 方法 (Ib2950)

Core-i18n 版本 1.0

版本 1.0.0

2025 年 4 月 9 日

发布了 androidx.core:core-i18n:1.0.0。

该组件可让您更轻松地创建适当国际化的应用，重点关注以下两个主要方面：

日期和时间格式设置功能遵循当前最佳实践，尊重用户自定义设置，并提供可在旧版和新版 Android 上正常运行的统一 API。
可用于旧版 API 的 android.icu.text.MessageFormat 向后移植版本。但在新版 Android 上仍然有用，因为它集成了上述日期 / 时间格式设置。这样可以遵循用户设置，而 android.icu.text.MessageFormat 不会这样做。

该组件将成为向后移植新 i18n API、添加新 i18n 功能或修复以及总体上简化国际化的载体。

版本 1.0.0-rc01

2025 年 3 月 26 日

发布了 androidx.core:core-i18n:1.0.0-rc01，该版本与上个 Beta 版相比没有明显变化。版本 1.0.0-rc01 中包含这些提交内容。

版本 1.0.0-beta01

2025 年 3 月 12 日

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

新功能

这是 core-i18n 组件的第一个版本。该组件可帮助您更轻松地创建适当国际化的应用，主要侧重于以下两个方面：
- 日期和时间格式设置功能遵循当前最佳实践，尊重用户自定义设置，并提供可在旧版和新版 Android 上正常运行的统一 API。
- 可用于旧版 API 的 android.icu.text.MessageFormat 向后移植版本。但在新版 Android 上仍然有用，因为它集成了上述日期 / 时间格式设置。这样可以遵循用户设置，而 android.icu.text.MessageFormat 不会这样做。
- 该组件将成为向后移植新 i18n API、添加新 i18n 功能或修复以及总体上简化国际化的载体。

版本 1.0.0-alpha01

2023 年 7 月 26 日

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

Core-location-altitude 版本 1.0。

版本 1.0.0-alpha03

2024 年 10 月 16 日

发布了 androidx.core:core-location-altitude:1.0.0-alpha03、androidx.core:core-location-altitude-external-protobuf:1.0.0-alpha03 和 androidx.core:core-location-altitude-proto:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

安全修复

自此变更起，androidx 会针对 protobuf 4.28.2 进行编译，以解决 CVE-2024-7254。将对 androidx.core:core-location-altitude-proto 和 androidx.core:core-location-altitude-external-protobuf 的依赖项升级到 1.1.0-alpha03，以解决漏洞风险。

bug 修复

移除了对新平台 API 访问权限的手动概述，因为在使用 AGP 7.3 或更高版本（例如 R8 版本 3.3）的 R8 时，以及在使用 AGP 8.1 或更高版本（例如 D8 版本 8.1）的所有 build 时，这种情况都会通过 API 建模自动发生。建议未使用 AGP 的客户更新到 D8 版本 8.1 或更高版本。如需了解更多详情，请参阅这篇文章。（Ieb9ae、b/345472586）

版本 1.0.0-alpha02

2024 年 6 月 12 日

发布了 androidx.core:core-location-altitude:1.0.0-alpha02、androidx.core:core-location-altitude-external-protobuf:1.0.0-alpha02 和 androidx.core:core-location-altitude-proto:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

bug 修复

修复了因重新封装 proto 库而导致的 Proguard 失败。

外部贡献

上述 bug 修复由 andrekir@pm.me 提供

版本 1.0.0-alpha01

2023 年 7 月 26 日

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

新功能

添加了 AltitudeConverterCompat 类，其中包含一个静态方法 addMslAltitudeToLocation(Context, Location) (I11168)。

Core-telecom 版本 1.0。

版本 1.0.0

2025 年 5 月 7 日

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

1.0.0 的主要功能

核心电信 API 的初始稳定版本，重点在于 CallsManager API surface，用于将 VoIP 通话集成到 Android 平台中。

版本 1.0.0-rc01

2025 年 4 月 9 日

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

新功能

新增了实验性 API 调用扩展程序。此版本中新增的实验性扩展程序包括：

支持会议摘要远程扩展程序，允许远程 Surface 从连接的 VoIP 应用接收会议摘要信息（当前发言者和参与者人数）。(7cf095f)
支持调用图标扩展程序，允许 VoIP 应用向远程 InCallService（自动、表盘等）发送图标 URI。图标可以在整个通话过程中更新，并且可以具有相同的 URI 值。(8e1813e)

版本 1.0.0-beta01

2024 年 12 月 11 日

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

新功能

以下新功能的 Beta 版：

在添加通话之前，先提取可用的音频端点。应用开发者现在可以在发起通话之前显示所有可用的端点，以便用户无缝选择自己偏好的音频端点并优化设置。这样一来，您无需在通话开始时进行通话中调整，从而获得更流畅的体验。
针对 VoIP 应用通话扩展功能的实验性 API 支持。通话扩展服务允许应用提供有关正在进行的通话的更多详细信息，例如群组通话或会议中的参与者列表。然后，受支持的远程界面（例如 Android Auto）可以向用户显示此信息，并允许用户与受支持的扩展程序互动。此版本中添加的新实验性扩展程序如下：
- 支持显示群组通话或会议中的参与者，并描述哪个参与者处于活跃状态。支持对参与者执行以下可选操作：
  - 举手和放下手。
  - 踢出参与者。
- 支持通话静音，允许远程 surface 将 VoIP 通话静音，而不会同时将麦克风全局静音。

API 变更

将 addLocalSilenceExtension 重命名为 addLocalCallsilenceExtension (If4a9c)
将 preferredStartingCallEndpoint 从 var 更改为 val。(Iab6b7)
添加了本地通话静音 API (I29dd0)
为 CallEndpointCompat 类实现 compareTo 函数 (Ia06b7)
添加了实验性应用操作 API。(Ifb796)
添加了新的 CallsManager API getAvailableStartingCallEndpoints (Ia8bcf)
更新 ExperimentalAppActions 注释，确保其能准确跟踪实验性功能的所有使用情况。(Id5ea5)

bug 修复

为 Android API 级别 28 至 33 添加了全局静音状态接收器。(I75e66)
修复了以下问题：只有最新连接的 InCallService 能够发送操作事件 (I39599)
为 VoIP 应用操作实现了 ICS 扩展 API。(I1274c)
在 API 级别 34 之前拒绝通话现在会正确销毁 Telecom 中的通话。(I635b7)
addCall 现在会通过 API 而不是父协程正确抛出异常 (I83334)
向 extras bundle (Iebf7f) 添加占位值
移除了对新平台 API 访问权限的手动概述，因为在使用 AGP 7.3 或更高版本（例如 R8 版本 3.3）的 R8 时，以及在使用 AGP 8.1 或更高版本（例如 D8 版本 8.1）的所有 build 时，这种情况都会通过 API 建模自动发生。建议未使用 AGP 的客户更新到 D8 版本 8.1 或更高版本。如需了解更多详情，请参阅这篇文章。（Ieb9ae、b/345472586）
为 CallsManager#addCall 添加了对扩展的实验性支持。(I24d92)
如果平台因异常、达到最大通话数等原因而未能添加通话，Core-Telecom 现在会抛出 CallException。(I41f27)

版本 1.0.0-alpha03

2024 年 4 月 17 日

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

bug 修复

重构了 JetpackConnectionService，以修正 SDK 33 及更低版本中传入的地址为空时出现的问题。重构后的 JetpackConnectionService 还可以应对来自 Telecom 平台 API 的意外 NULL 值。
改进了 addCall/CallControlScope API 文档。
改进了测试可靠性。

版本 1.0.0-alpha02

2023 年 10 月 4 日

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

API 变更

改进了返回布尔值以指示成功/失败的方法的 API 签名，使其改为返回结果类，以清晰指示操作成功或失败的原因。
将 CallControlCallback 方法作为 lambda 实参移至 addCall，以避免需要在调用范围内明确提供回调。

bug 修复

修复了 ConnectionService 兼容性层中的一个 bug，该 bug 会导致在针对 U 之前的 SDK 运行时没有通话音频。
改进 API 文档。

版本 1.0.0-alpha01

2023 年 5 月 10 日

发布了 androidx.core:core-telecom:1.0.0-alpha01。此版本是在内部分支中开发的，应与 Android 14 Beta 2 一起使用。

新功能

引入了 CallsManager API，VoIP 应用可使用该 API 与设备上的 Telecom 框架集成。通知给平台的通话可受益于前台执行优先级、在蓝牙、穿戴式设备和汽车设备上的可见性以及简化的音频路由。

CallsManager API 封装了旧版 ConnectionService API，以供运行旧版 Android 的设备使用。

Core 和 Core-ktx 版本 1.17

版本 1.17.0-beta01

2025 年 7 月 2 日

发布了 androidx.core:core:1.17.0-beta01、androidx.core:core-ktx:1.17.0-beta01 和 androidx.core:core-testing:1.17.0-beta01。自上一个 Alpha 版本以来，版本 1.17.0-beta01 没有任何变化。

版本 1.17.0-alpha01

2025 年 6 月 18 日

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

新功能

核心库已更新为以 Kotlin 2.0 语言级别为目标平台，并且需要使用 Kotlin Gradle 插件 2.0.0 或更高版本。(Idb6b5)

API 变更

添加了 NotificationCompat.ProgressStyle 和 NotificationCompat.Builder.setRequestPromotedOngoing()。如需了解详情，请参阅以进度为中心的通知和实时更新。
添加了 Parcel.use 扩展函数，用于安全处理 Parcel 资源。(I436da)

Core 和 Core-ktx 版本 1.16

版本 1.16.0

2025 年 4 月 9 日

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

自 1.15.0 以来的重要变更

此库现在使用类型使用的 JSpecify nullness 注释。Kotlin 开发者应使用以下编译器实参来强制执行正确用法：-Xjspecify-annotations=strict（这是 Kotlin 编译器从 2.1.0 版开始的默认实参）。（Iaf3e1、b/326456246）

版本 1.16.0-rc01

2025 年 3 月 26 日

发布了 androidx.core:core:1.16.0-rc01、androidx.core:core-ktx:1.16.0-rc01 和 androidx.core:core-testing:1.16.0-rc01。版本 1.16.0-rc01 与之前的 Beta 版相比没有任何变化。

版本 1.16.0-beta01

2025 年 3 月 12 日

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

API 变更

优化了边衬区保护 API (I7050d)
添加了新键，用于获取未放大窗口坐标中的字符边界。(If7a06)
添加了新的布尔值属性，以表示 AccesibilityNodeInfo 是否表示必需字段。(I4fd2d)
将 View.transformMatrixToGlobal 向后移植到 ViewCompat (If17e2)

版本 1.16.0-alpha02

2025 年 1 月 29 日

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

API 变更

添加了 BuildCompat.isAtLeastB，用于检查 Baklava 中添加的 API 是否可用 (I0f89c)
添加了实验性 API 以获取内置显示屏的列表。(Idda4d)
添加了一组与确保系统栏对比度相关的 API (I9849c)

bug 修复

修复了以下问题：在 SDK < 26 上，getLaunchDisplayId() 返回了错误的默认值 0。(Icd679)
此库现在使用类型使用的 JSpecify nullness 注释。Kotlin 开发者应使用以下编译器实参来强制执行正确用法：-Xjspecify-annotations=strict（这是 Kotlin 编译器从 2.1.0 版开始的默认实参）。（Iaf3e1、b/326456246）

版本 1.16.0-alpha01

2024 年 12 月 11 日

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

API 变更

为 ActivityOptionsCompat 添加了 setLaunchDisplayId。（I39e77、b/379669743）
为 SYSTEM_OVERLAYS 添加了兼容性 API。（Ibd1fd、b/287470173）
添加了 OutcomeReceiverCompat，这是 Android 的 OutcomeReceiver 的一个版本，适用于所有 API 级别。（Ib8265、b/380060342）
为 android.view.ScrollFeedbackProvider 添加了兼容性类。(Icaa92)
添加了 ViewCompat.addViewOverlay(View) 作为 View.getOverlay().add(View) 的替代方案。ViewCompat 变体修复了以下问题：在被叠加的视图与叠加层所有者之间，无法解析 LifecycleOwner 和 ViewModelStoreOwner 等所有者。(I81413)
引入了 View 可以具有不相交父级的概念。视图的不相交父视图是指实际上是另一个视图的父视图，但不是通过 View.parent 属性设置的。如需了解详情，请参阅相关文档。(Ib2950)
添加了一个新的 API ViewGroupCompat#installCompatInsetsDispatch，供开发者修复 API 30 之前存在的边衬区调度问题。(I11159)
为 FontsContractCompat 中的 Typeface 样式添加了用于注解的 FontsContractCompat.TypefaceStyle IntDef。(Ib3e5b)

外部贡献

已废弃 BuildCompat.isAtLeastV。调用方应改为直接将 SDK_INT 与 35 进行比较。感谢 Jake Wharton！(I294d1)
向 TaskStackBuilder 添加了可变性标志。感谢 Kamal Faraj！（Ife0ec、b/371534781）

Core 和 Core-ktx 版本 1.15

版本 1.15.0

2024 年 10 月 30 日

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

自 1.14.0 以来的重要变更

移除了对新平台 API 访问权限的手动概述，因为在使用 AGP 7.3 或更高版本（例如 R8 版本 3.3）的 R8 时，以及在使用 AGP 8.1 或更高版本（例如 D8 版本 8.1）的所有 build 时，这种情况都会通过 API 建模自动发生。建议未使用 AGP 的客户更新到 D8 版本 8.1 或更高版本。如需了解更多详情，请参阅这篇文章。（Ieb9ae、b/345472586）
对多个兼容性类进行了更新，以与 Android 15 SDK 保持一致。

版本 1.15.0-rc01

2024 年 10 月 16 日

发布了 androidx.core:core:1.15.0-rc01、androidx.core:core-ktx:1.15.0-rc01 和 androidx.core:core-testing:1.15.0-rc01。版本 1.15.0-rc01 自上一个版本以来没有任何变化。

版本 1.15.0-beta01

2024 年 10 月 2 日

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

API 变更

向 CollectionInfoCompat 添加了 itemCount 和 importantForAccessibilityItemCount 字段。(Ibaf34)

bug 修复

修复了 androidx.core.os.Profiling 中的文档问题 (I2542f)

版本 1.15.0-alpha02

2024 年 8 月 21 日

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

重要变更

移除了对新平台 API 访问权限的手动概述，因为在使用 AGP 7.3 或更高版本（例如 R8 版本 3.3）的 R8 时，以及在使用 AGP 8.1 或更高版本（例如 D8 版本 8.1）的所有 build 时，这种情况都会通过 API 建模自动发生。建议未使用 AGP 的客户更新到 D8 版本 8.1 或更高版本。如需了解更多详情，请参阅这篇文章。（Ieb9ae、b/345472586）

API 变更

为可下载字体定义添加了 fallbackQuery XML 属性，以便使用可下载字体实现字符级回退。(Idd544)
添加了用于使用 ProfilingManager 的辅助 API (If2292)
为 ActivityOptions.setPendingIntentBackgroundActivityStartMode 添加了兼容性方法（I3ba1f、b/349617674）
添加了 DisplayCutoutCompat.getCutoutPath（I58778、b/279635904）
恢复了 ParcelCompat.writeBoolean 的弃用，并在 API 级别 29 及更高版本上委托给平台 API。（I9d243、b/313834577）
创建了采用执行器的 FontsContractCompat.requestFonts（I03016、b/302377512）
恢复了对 LocationCompat.isMock 的弃用，并在 API 级别 31 及更高版本上委托给平台 API。（I55940、b/313834577）
现在，通知可以标记为语音信息。(I068ab)

版本 1.15.0-alpha01

2024 年 6 月 12 日

发布了 androidx.core:core:1.15.0-alpha01、androidx.core:core-ktx:1.15.0-alpha01 和 androidx.core:core-testing:1.15.0-alpha01。此版本是在内部分支中开发的，与 Android 15 Beta 3 (android-35) 兼容。

API 变更

对多个兼容性类进行了更新，以与 Android 15 SDK 保持一致。

Core 和 Core-ktx 版本 1.14

版本 1.14.0-alpha01

2024 年 5 月 1 日

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

新功能

将 androidx 库的默认 minSdkVersion 移至 21 (I6ec7f)

API 变更

弃用了其他过时的兼容性方法。（Ie4470、b/313834577）
弃用了过时的兼容方法。（I01d90、b/313834577）
更新了 isAtLeastV()，以针对最终确定的 V SDK 返回 true。(I6339a)

Core 和 Core-ktx 版本 1.13

版本 1.13.1

2024 年 5 月 1 日

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

bug 修复

修复了以下问题：当手写工具栏显示时，无法通过手指点按切换到常规键盘（I7f843、b/332769437）

版本 1.13.0

2024 年 4 月 17 日

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

自 1.12.0 以来的重要变更

相应库的 minSdkVersion 已提升至 19。许多兼容性 API 已被标记为已弃用，因为它们仅在 API 级别 19 之前需要。
许多类已使用 Kotlin 重写，以便为 Kotlin 使用者提供更好的互操作性，同时保留 Java 兼容性。
移除了 FingerprintManagerCompat，该方法从 Android V 开始不执行任何操作，不应在早期平台上使用。客户端应立即迁移到 BiometricPrompt。
添加了 PathParser，该方法可根据 SVG 路径字符串创建 Path 实例。

版本 1.13.0-rc01

2024 年 4 月 3 日

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

bug 修复

修复了在 API 30 及更高版本上检索初始系统栏外观的问题（I18596、b/219993701）

版本 1.13.0-beta01

2024 年 3 月 20 日

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

API 变更

PathParser 现在是 final，interpolatePathDataNodes 现在会针对不兼容的实参抛出异常，而不是返回 boolean，并且 nodesToPath 现在属于 PathParser 而不是 PathParser.PathDataNode。(I20d62)
FingerprintManagerCompat 在从 Android V 平台 SDK 中移除之前，已软移除。此实现将在不久的将来替换为 no-op，开发者应立即停止使用此类。(I7ca1b)
Pool 接口及其子类 SimplePool 和 SynchronizedPool 现在用 Kotlin 编写。现在，存储在 Pool 中的对象的泛型类型必须为非 null。(I08afe)

外部贡献

GestureDetectorCompat 现已弃用，因为 GestureDetector 保证可在库的最低 SDK 版本中用于平台。感谢 Jake Wharton 的贡献。(Icc4cd)
MarginLayoutParamsCompat 现已弃用，因为 MarginLayoutParams 保证可在平台中作为库的最低 SDK 版本使用。感谢 Jake Wharton 的贡献。(I4e0c3)

版本 1.13.0-alpha05

2024 年 2 月 7 日

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

外部贡献

感谢 Matthew Zavislak 更新了 ContextCompat.registerReceiver 文档，使其更加准确。(8fd733)

版本 1.13.0-alpha04

2024 年 1 月 24 日

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

新功能

添加了 AlarmManagerCompat.canScheduleExactAlarms API（I62e95、b/315440583）

Kotlin 转换

使用 Kotlin 重写了 androidx.core.util.Consumer 类，现在强制要求泛型类型 T 与 accept() 方法接收的内容的是否可为 null 性相匹配。(Ie21e0)
androidx.core.util.Supplier 已转换为 Kotlin，确保 get() 返回的类型的可为 null 性与泛型类型的可为 null 性相匹配。(I21e9c)
已使用 Kotlin 重写 androidx.core.util.Function，确保函数的输入和输出的可为 null 性与所使用的泛型类型相匹配。(I09dd7)

外部贡献

感谢 Kamal Faraj 添加了 AlarmManagerCompat.canScheduleExactAlarms API（I62e95、b/315440583）

版本 1.13.0-alpha03

2024 年 1 月 10 日

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

API 变更

已弃用 ListViewCompat，请直接使用 ListView。（Iacce6、b/318353933）
已弃用 ViewCompat.LAYOUT_DIRECTION_ API。（I51710、b/317055535）
弃用了 ViewCompat 中过时的兼容性方法。（I0bfc2、b/313834577）

版本 1.13.0-alpha02

2023 年 11 月 29 日

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

新功能

添加了 OnUserLeaveHintProvider 接口，以允许任何组件接收实现画中画所需的 onUserLeaveHint 事件。这是在 Activity 1.9.0-alpha01 中通过 ComponentActivity 实现的。(I54892)

API 变更

已废弃 androidx.core.os.CancellationSignal。应该改为使用平台提供的 android.os.CancellationSignal。（Id45f6、b/309499026、b/309054079）
OnMultiWindowModeChangedProvider、OnNewIntentProvider、OnPictureInPictureModeChangedProvider、OnConfigurationChangedProvider 和 OnTrimMemoryProvider 接口已转换为 Kotlin，以确保其监听器方法所采用的 Consumer 上的泛型参数具有正确的可为 null 性（它们都不可为 null）。(Ib6237)
发送到添加到各自的提供程序接口的 Consumer 的 MultiWindowModeChangedInfo 和 PictureInPictureModeChangedInfo 类现在用 Kotlin 编写。(Ie08e2)

依赖项更新

Core 现在依赖于 Lifecycle 2.6.2。(I2d94c)

版本 1.13.0-alpha01

2023 年 10 月 18 日

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

API 变更

将 PathParser 设为公开。该类可以根据 SVG 路径字符串创建 Path 实例。（Ic7af2、b/302376846）
为 Context.createAttributionContext 添加了兼容性方法。（I61dcf、Ibe187）
将 NotificationCompatSideChannelService 标记为已弃用。(I18fd9)
用于差分运动轻拂的新 API。（I46b0d、Ia9f68）
用于跟踪平台 SDK 的 VelocityTracker 的其他兼容性 API。(I32753)

bug 修复

替换 Person 中的 equals 和 hashCode 方法。(I610a5)

Core 和 Core-ktx 版本 1.12

版本 1.12.0

2023 年 9 月 6 日

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

自 1.11.0 以来的重要变更

添加了许多兼容性方法，以使 SDK 34 与 TextView、AccessibilityNodeInfo 等保持一致。
新增了 LocalePreferences API，可帮助开发者轻松访问语言区域数据或用户的语言区域偏好设置。
废弃了 app.BundleCompat，取而代之的是 os.BundleCompat。
已废弃 BuildCompat.isAtLeastU()。请改用 SDK_INT >= 34。

版本 1.12.0-rc01

2023 年 8 月 9 日

发布了 androidx.core:core:1.12.0-rc01、androidx.core:core-ktx:1.12.0-rc01 和 androidx.core:core-testing:1.12.0-rc01，这些版本没有重大变化。版本 1.12.0-rc01 中包含这些提交内容。

版本 1.12.0-beta01

2023 年 7 月 26 日

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

API 变更

向 TextView 兼容性类添加了 setLineHeight(unit, lineHeight) (Ia9fa9)
添加了 Android 14 中的 TypedValueCompat.getUnitFromComplexDimension() (I958e8)
向 TextView compat 类添加了 setLineHeight(unit, lineHeight) (Ib2ee1)
向后移植了各种无障碍功能 API (Ic65ba)
向后移植了 API 34 AccessibilityNodeInfo 方法 (I44182)
将稳定的 SDK 检查从实验性功能中移出 (Ia9b35)
向后移植了 AccessiiblityWindowInfo 34 个 API (I96a5d)
已废弃 BuildCompat.isAtLeastU()。已改用 SDK_INT >= 34。（I4f8e7、b/289269026）
移除了对实验性 isAtLeastU() API 的使用（Ie9117、b/289269026）
将 BuildCompat 迁移到了 Kotlin，以增强 Deprecated 标记（I56775、b/289269026）
向 TextView compat 类添加了 setLineHeight(unit, lineHeight) (I15716)
新的 accessibilityDataSensitive 兼容性属性。(I0c6e0)
指定 FLAG_NO_CREATE 时，PendingIntentCompat.getActivity 和 getService 可能会返回 null。（Iffdf0、b/289696515）
更新了 API 文件，以便为兼容性抑制添加注解。（I8e87a、b/287516207）
添加了 PendingIntentCompat.send() (Iaf707)
添加了 Location.removeVerticalAccuracy()、Location.removeSpeedAccuracy() 和 Location.removeBearingAccuracy() 的兼容版本。(I5b640)

bug 修复

如果视图具有无障碍功能委托，则使该视图对无障碍功能很重要。(If2b54)

版本 1.12.0-alpha05

2023 年 6 月 7 日

发布了 androidx.core:core:1.12.0-alpha05、androidx.core:core-ktx:1.12.0-alpha05 和 androidx.core:core-testing:1.12.0-alpha05。此版本是在内部分支中开发的。

bug 修复

更新了有关 ColorUtils 类的文档，该类用于根据 Material 3 色调、色度和色调 (M3HCT) 参数生成颜色。（I32979、I21c8c）
修复了 android.os.Trace 的弃用 replaceWith (I730f9)

版本 1.12.0-alpha04

2023 年 5 月 10 日

发布了 androidx.core:core:1.12.0-alpha04、androidx.core:core-ktx:1.12.0-alpha04 和 androidx.core:core-testing:1.12.0-alpha04。这是从内部分支发布的。

版本 1.12.0-alpha03

2023 年 4 月 12 日

发布了 androidx.core:core:1.12.0-alpha03、androidx.core:core-ktx:1.12.0-alpha03 和 androidx.core:core-testing:1.12.0-alpha03。这是从内部分支发布的。

API 变更

取消隐藏了 NotificationCompat.TvExtender (aosp/01c67677e9310b2cf4c536d7e951e117d6cce64a)
添加了公共方法来访问 M3HCT 参数并将 M3HCT 值转换为 ARGB (aosp/06810598aa94bee731bbe0d277933b8b9614934e)
添加了 NotificationManager.getCurrentInterruptionFilter (aosp/b0c6940639e35371d212a7ebd7dbf01c14fc7710)
向 NotifManagerCompat 添加了 getCurrentInterruptionFilter (aosp/516143e05f824ff49bde3c0c97344a2924867d30)
废弃了 app.BundleCompat，取而代之的是 os.BundleCompat (aosp/bf6169fe9ee1113065d0cf380bd2e09f31ce0a40)
添加了 TestConsumer，以便开发者可以在测试中记录值。(aosp/f75a4913940e710842168c832a7f57c2dcae4fdf)
添加了 TestConsumer，以便开发者可以在测试中记录值。(aosp/67ad4e2c6488772b7c9a061ee6ca01bba23649f7)

bug 修复

修复了 unregisterGnssMeasurementsCallback() 在 Android R 以下版本中无法正常运行的 bug。(aosp/c5a97c4ee956f87d229ec892f2b8849f392e956c)

版本 1.12.0-alpha01

2023 年 3 月 8 日

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

新功能

提供 API，帮助开发者轻松访问用户的偏好设置或 ICU 中的语言区域数据。可访问的语言区域数据包括小时周期、日历类型、温度单位和一周的第一天。

API 变更

添加了新的 API LocalePreferences，以帮助开发者轻松访问语言区域数据或用户的语言区域偏好设置。

Core 和 Core-ktx 版本 1.11

版本 1.11.0-beta02

2023 年 6 月 7 日

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

bug 修复

更新了有关 ColorUtils 类的文档，该类用于根据 Material 3 色调、色度和色调 (M3HCT) 参数生成颜色。（I32979、I21c8c）
修复了 android.os.Trace 的弃用 replaceWith (I730f9)

版本 1.11.0-beta01

2023 年 5 月 24 日

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

API 变更

向方法 performHapticFeedback 添加了 ViewCompat 支持 (Ib02c6)
将 getDisplay 更改为 #getDisplayOrDefault (I96ff9)
添加了 ContextCompat#getDisplay(Context)（I7011f、b/178183326）
添加了 ContextCompat#getContextForLanguage(Context)，用于在非 Activity 上下文中获取每个应用的语言区域设置（I58e75、b/243457462）

bug 修复

澄清了 CollectionInfoCompat 文档，尤其是 isHierarchical (I14f6c)

版本 1.11.0-alpha04

2023 年 5 月 10 日

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

API 变更

添加了 LinkMovementMethodCompat，用于修复链接触摸处理问题 (Ia632c)
PendingIntent.getBroadcast() 现已正确标记为 @Nullable（Ifff96、b/277630907）

bug 修复

修复了 DisplayManagerCompat 中的 Context 泄漏问题（I3409b、b/279625765）
添加了 SoftwareKeyboardControllerCompat，以提供直接方法来显示和隐藏给定视图的软件键盘。此版本在某些 API 级别上使用 WindowInsetsController API 时，会针对已知问题反向移植解决方法，并提取 WindowInsetsControllerCompat.show 的支持实现，以及隐藏 IME 边衬区类型。(Idd0a3)

版本 1.11.0-alpha03

2023 年 4 月 19 日

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

API 变更

更新了 BuildCompat，为 Android 14 Beta 2 做准备 (Idc1b1, b/276491001)
取消隐藏 NotificationCompat.TvExtender (Ibe13a)
添加了公共方法，用于访问 M3HCT 参数并将 M3HCT 值转换为 ARGB (Id7e9d)

版本 1.11.0-alpha02

2023 年 4 月 5 日

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

API 变更

向 NotifManagerCompat 添加了 getCurrentInterruptionFilter（I8ec95、b/243183646）
弃用了 app.BundleCompat，改用 os.BundleCompat (Idc3a2、b/274577000)
添加了 TestConsumer，以便开发者可以在测试中记录值。(I937c1)

bug 修复

修复了 unregisterGnssMeasurementsCallback() 在 Android R 以下版本中无法正常运行的 bug。(Id1999)

版本 1.11.0-alpha01

2023 年 3 月 22 日

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

API 变更

在 Android U 中，getType 的 ContentProvider API 要求调用方持有正确的读取权限。FileProvider 现在提供默认的 getTypeAnonymous 实现，即不受限制的版本。(I4773f)
为内容捕获 API 添加了兼容类 (I09366)
添加了 NotifCompat.Builder.setLargeIcon(Icon) (Ic0a5b)
向 NotificationManagerCompat 添加了批量通知 API。建议用户在发布多个通知时使用此 API。(I2cd7f)
在 R 之前的平台上添加了支持执行器的 registerGnssMeasurementsCallback() (I579f8)

Core 和 Core-ktx 版本 1.10

版本 1.10.1

2023 年 5 月 10 日

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

外部贡献

修复了因结果为 null 而抛出 BadParcelableException 的问题 b/277434277、b/278118318，由 Mygod Studio 贡献

版本 1.10.0

2023 年 4 月 5 日

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

自 1.9.0 以来的重要变更

废弃了对无障碍功能对象的回收再利用。我们发现，即使在最早的受支持操作系统版本中，性能变化也微不足道。(I0a961)
为 SDK 扩展版本添加了 BuildCompat 常量。(I6084c)
如需了解新 API 和问题修复，请参阅 1.10.0 预发布版本的版本说明。

版本 1.10.0-rc01

2023 年 3 月 8 日

发布了 androidx.core:core:1.10.0-rc01 和 androidx.core:core-ktx:1.10.0-rc01，这两个版本与之前的 Beta 版相比没有变化。

版本 1.10.0-beta01

2023 年 2 月 22 日

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

API 变更

set/getMinMillisBetweteenContentChanges 的 AccessibilityNodeInfoCompat API 已重命名为 set/getMinDurationBetweenContentChanges，且目前在使用期间采用 long。(f46689)
添加了 NotificationCompat.bigLargeIcon(Icon) (I60855)

bug 修复

修复了有关 NotificationCompat.Builder.setShowWhen() 默认值的文档 (ba52a2)
修复了 AccelerateInterpolator / DecelerateInterpolator 文档中的拼写错误 (2173505)
修复了 ShortcutInfoCompat 文档中的拼写错误 (44075f)
使用 NestedScrollView 和 CoordinatorLayout 修复了向上键、向下键、空格键和按键变体的键盘操作 (bdd72e)

版本 1.10.0-alpha02

2023 年 1 月 25 日

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

API 变更

为 AD_SERVICES 扩展版本添加了 BuildCompat 常量 (I51d98)
在 WindowInsetsControllerCompat 中添加了 BEHAVIOR_DEFAULT。废弃了 BEHAVIOR_SHOW_BARS_BY_SWIPE 和 BEHAVIOR_SHOW_BARS_BY_TOUCH(I17b61)

版本 1.10.0-alpha01

2023 年 1 月 11 日

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

API 变更

向 NotificationCompat 添加了 CallStyle（Id9a53、b/199294989）
为 SDK 扩展版本添加了 BuildCompat 常量 (I6084c)
添加了用于在无障碍功能节点上设置初始焦点的 API。(Id199a)
添加了用于更改内容速率限制的新 API (If4ea0)
针对 Android 13 中为 parcel、bundle 和 intent 引入的新 API 添加了兼容性方法。部分 ParcelCompat 方法签名已更新，可能需要在升级时更改来源才能确认新签名。（I57e94、b/242048899）
废弃了对无障碍功能对象的回收再利用。我们发现，即使在最早的受支持版本中，性能变化也微不足道。(I0a961)
针对已废弃的隐藏函数，更新了返回值类型是否可为 null (Ibf7b0)
为 Point 和 PointF 添加了乘法/除法运算符重载（I8e557、b/261574780）

bug 修复

为 AccessibilityEvent#TYPE_ANNOUNCEMENT 添加了建议：尽量避免使用它。(I818bf)
指明列表应有 1 行或 1 列供无障碍功能使用 (Ia1223)

Core 和 Core-ktx 版本 1.9.0

版本 1.9.0

2022 年 9 月 7 日

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

自 1.8.0 以来的重要变更

进行了更新，以提高与 Android 13 的兼容性，包括可为 null 性更改以及与框架 API 的一致性
添加了 IntentSanitizer，用于在启动 intent 之前清理不安全的 intent。(Ib0be5)
使用 Icon 添加了对 BigPictureStyle 的支持 (Ice26d)
向在 SDK 33 及更高版本中需要授予 POST_NOTIFICATIONS 权限的 API 添加了 @RequiresPermission。(Ie542e)
改进了 Android 13 无障碍功能框架 API 和兼容性 API 之间的一致性（I93c97、I5a074、Iedf82）

版本 1.9.0-rc01

2022 年 8 月 24 日

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

bug 修复

IntentSanitizer.sanitizeByFiltering 在过滤时不再向日志写入内容 (69b3b55)

版本 1.9.0-beta01

2022 年 8 月 10 日

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

API 变更

添加了对 ACTION_SHOW_TEXT_SUGGESTIONS 和 is/setTextSelectable 的兼容项 (Iedf82)
添加了 IntentSanitizer，用于在启动 intent 之前清理不安全的 intent。(Ib0be5)
使用 Icon 添加了对 BigPictureStyle 的支持（Ice26d、b/215583339）
更新了可为 null 性注解（I34cce、b/236498052、b/236498029、b/236497996、b/236497942、b/236497884、b/236497726）
添加了 LocationManagerCompat.registerGnssMeasurementsCallback 以解决 Android R bug。(Ie0f6f)

bug 修复

向在 SDK 33 及更高版本中需要授予 POST_NOTIFICATIONS 权限的 API 添加了 @RequiresPermission。（Ie542e、b/238790278）
向 androidx-platform-dev 中添加了对 T 中引入的 API 的支持。()
添加了对 T 中引入的 API 的支持。(I358f1)
当 compat impl 无法在 API 级别 14-20 上解析时，TypefaceCompate.create(..., weight, italic) 将回退到平台 Typeface.create（I1ee34、b/145311058）
向 androidx-main am: d5747be010 添加了 AndroidX 中之前不存在的无障碍功能框架常量。(I5a074)
添加了 AndroidX 中之前不存在的无障碍功能框架常量。(I93c97)

外部贡献

向后移植了 Typeface#create(Typeface, int, boolean)，允许通过字体系列创建具有特定粗细的字体 (I342dc)

版本 1.9.0-alpha05

2022 年 6 月 15 日

发布了 androidx.core:core:1.9.0-alpha05 和 androidx.core:core-ktx:1.9.0-alpha05。版本 1.9.0-alpha05 是在一个不公开的预发布分支中开发的，没有公开提交内容。

API 变更

更新了可为 null 性，以与 Tiramisu Beta 3 SDK 中的最终 API Surface 保持一致
minCompileSdk 的级别现为 33，以与 Tiramisu Beta 3 SDK 保持一致

版本 1.9.0-alpha04

2022 年 5 月 18 日

发布了 androidx.core:core:1.9.0-alpha04 和 androidx.core:core-ktx:1.9.0-alpha04。版本 1.9.0-alpha04 是基于预发布的 Android SDK 构建的，并且没有公开发布的提交历史记录。

bug 修复

还原了已废弃的 BuildCompat.isAtLeastT() 及相关 SDK_INT 检查

版本 1.9.0-alpha03

2022 年 4 月 27 日

发布了 androidx.core:core:1.9.0-alpha03 和 androidx.core:core-ktx:1.9.0-alpha03。版本 1.9.0-alpha04 包含 1.8.0-beta01 中的所有提交内容，但已基于 Android 13 Beta 1 进行了构建。

此版本需要使用 Android 13 Beta 1 进行编译，并且不能保证在运行时与未来开发者预览版兼容。

版本 1.9.0-alpha02

2022 年 3 月 23 日

发布了 androidx.core:core:1.9.0-alpha02 和 androidx.core:core-ktx:1.9.0-alpha02。版本 1.9.0-alpha02 包含 1.8.0-alpha06 中的所有提交内容，但已基于 Tiramisu DP2 进行了构建。

版本 1.9.0-alpha01

2022 年 2 月 23 日

发布了 androidx.core:core:1.9.0-alpha01 和 androidx.core:core-ktx:1.9.0-alpha01。版本 1.9.0-alpha01 是通过内部分支构建的，没有公开可见的提交内容。

此版本需要使用 Android Tiramisu DP1 进行编译，并且不能保证在运行时与未来开发者预览版兼容。

新功能

与 Android Tiramisu DP1 兼容。

Core 和 Core-ktx 版本 1.8.0

版本 1.8.0

2022 年 6 月 1 日

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

自 1.7.0 以来的重要变更

清理了大量可为 null 性注解，以提高 Kotlin 的易用性
改进了 ShortcutInfoCompat、NotificationCompat 等的平台一致性
添加了新接口，使组件能够接收画中画模式和多窗口模式变更事件（由 ComponentActivity 在 activity 库中实现）
改进了 MenuProvider 回调方法，包括 onPrepareMenu 和 onMenuClosed
修复了以下问题：FileProvider 在某些设备上会失败并抛出 IllegalArgumentException
修复了 TypefaceCompat 在 API 29 及以上版本中应用了不正确字体粗细的问题 (b/194553426)，感谢 RikkaW 的贡献

版本 1.8.0-rc02

2022 年 5 月 18 日

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

bug 修复

将 OnSharedElementsReadyListener 类型转换为完全限定的平台类，以防止出现 ClassCastException (0029fed)

版本 1.8.0-rc01

2022 年 5 月 11 日

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

API 变更

添加了针对下个预发布周期的 BuildCompat 检查（If5a8f、b/229859122）
针对最终确定的 SDK_INT 值更新了 BuildCompat.isAtLeastT()。(Iffae0)

版本 1.8.0-beta01

2022 年 4 月 20 日

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

版本 1.8.0-alpha07

2022 年 4 月 6 日

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

bug 修复

现在，TypefaceCompat 将在 API 29 及以上级别上同时遵循请求的样式信息和加载的样式信息。这是加载的字体不是 FontWeight.Normal 或 FontWeight.Bold 时发生的行为变更，因为系统将使用实际加载的粗细和样式。（#212、b/194553426）

外部贡献

感谢 RikkaW 为确保我们在 API 29 及以上级别上的 TypefaceCompat 中正确应用 Typeface 粗细做出的贡献。#212

版本 1.8.0-alpha06

2022 年 3 月 23 日

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

API 变更

MenuProvider 接口现在包含 onPrepareMenu() 回调，该回调在菜单被动态修改及应显示时调用。(Ie85f9)
MenuProvider 接口现在包含 onMenuClosed() 方法，该方法在菜单应关闭时使用。(If5a16)
更新了 IconCompat#getResId，使其具有适当的资源注解类型，以与 Icon#getResId 的框架中的相应方法匹配 (I49700)
恢复了之前仅依赖于 WindowInsetsControllerCompat 的 View 的变更，再次需要一个 Window，这对于管理某些窗口标记来说是必需的。废弃了 ViewCompat.getWindowInsetsController，改为使用 WindowCompat.getInsetsController，以确保使用正确的 Window（例如，如果 View 位于对话框中）。(I660ae、b/219572936)
更新了 core 和 appcompat 中的可为 null 性，以匹配 Tiramisu DP2 (I0cbb7)
向 BitmapCompat 中添加了一个方法，使位图缩小更流畅。(Ib706c)
向 ActivityCompat.requestDragAndDropPermissions 添加了可为 null 性注解（I0f2b0、b/206113378）
向 FileProvider 添加了一项解决方法，供 OEM 从清单中移除元数据。(I82f63)

bug 修复

考虑了 a11y 窗格可见性状态在 <P 中的父级可见性变更 (I8e04f)

版本 1.8.0-alpha05

2022 年 2 月 23 日

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

API 变更

更新了 androidx.core.os 类的可为 null 性（If18cd、b/206113622）
更新了 androidx.core.app 类的可为 null 性（I657eb、b/206113302）
更新了 androidx.core.text 类的可为 null 性（I08329、b/206113384）
向 AccessibilityNodeInfoCompat 添加了 ExtraData 函数（If2fc7、b/137789185）
为 bundleOf() 添加了零参数过载，以避免在创建空 bundle 时出现不可见的数组分配 (If7089)
添加了 Continuation<T>.asFoo() 适配器，用于创建回调，来为接受通用回调类型的 Android API 编写挂起封装容器 (I6615e)
添加了可为 null 的 Drawable.toBitmapOrNull 方法，以避免异常 (I2342a)

版本 1.8.0-alpha04

2022 年 2 月 9 日

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

API 变更

添加了 OnPictureInPictureModeChangedProvider 接口，以允许任何组件接收画中画模式变更事件。这是在 Activity 1.5.0-alpha02 中通过 ComponentActivity 实现的。(I9f567)
添加了 OnMultiWindowModeChangedProvider 接口，以允许任何组件接收多窗口模式变更事件。这是在 Activity 1.5.0-alpha02 中通过 ComponentActivity 实现的。(I62d91)
清除了部分 androidx.core API 的可为 null 性。(Ia0e2f、b/206113818)

版本 1.8.0-alpha03

2022 年 1 月 26 日

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

API 变更

将 WindowInsetsControllerCompat 转换为依赖于 View，而不是 Window 或平台 WindowInsetsController。这样可以改善对话框的行为（显示 IME），并确保非废弃的创建方法可以解决问题 (b/180881870)。（I29264、b/207401542、b/210121779）
清除了部分 androidx.core API 的可为 null 性。（Ib2583、b/206113818）
修复了 performAccessibilityAction 参数的可为 null 性 (Ibbafe)
添加了一个方法，可解决由以主题为键的缓存和 Theme.applyStyle 引起的 ColorStateList 问题（I9188b、b/207739887）
更新了快捷方式可见性 API，提高了可读性 (Ia58df)
为 persistableBundleOf() 添加了零参数过载，以避免在创建空 PersistableBundle 时进行不必要的数组分配 (Icd7a4)

版本 1.8.0-alpha02

2021 年 12 月 15 日

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

API 变更

针对日后推出的 SDK 添加了实验性 BuildCompat 方法（Iafd82、b/207528937）
添加了文档与快捷方式相互转换的实用程序方法。(Id512c)
更新了适用于快捷方式的可见性 API，让内容显示更清晰 (I86dec)
添加了 OnNewIntentProvider、OnConfigurationChangedProvider 和 onTrimMemoryProvider 接口。这些接口可用于指示自定义 activity 可以将这些事件分派给任何添加监听器的组件。（If1f8b、If623b、Ia9295）

版本 1.8.0-alpha01

2021 年 12 月 1 日

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

API 变更

大量清理了可为 null 性注解
新添加了 API ShortcutInfoCompat.Builder#setHiddenFromLauncher，用于确定是否应在启动器中隐藏快捷方式。(Ia2a71)
添加了 NotificationCompat.Action#setAuthenticationRequired（Ieeafa、b/202172887）
添加了 NotificationCompat.BigPictureStyle.setContentDescription (I3b483)
添加了扩展函数 Map<String, Any?>.toPersistableBundle() (I82c86)

bug 修复

调整了无障碍操作的滚动距离 (If74ae)
移除了 Javadocs 中的硬编码语言代码 (Ie5d68)

Core 和 Core-ktx 版本 1.7

版本 1.7.0

2021 年 10 月 27 日

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

自 1.6.0 以来的重要变更

添加了对与 SDK 30 及更高版本的权限撤消和应用休眠功能互动的支持，并在支持的设备上向后移植到 SDK 23。如需了解详情，请参阅 IntentCompat.createManageUnusedAppRestrictionsIntent。
添加了对在组件中组合菜单的支持，请参阅 MenuProvider 了解详情。

版本 1.7.0-rc01

2021 年 10 月 13 日

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

版本 1.7.0-beta02

2021 年 9 月 29 日

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

bug 修复

现在，如果在 Lifecycle 变为 DESTROYED 状态之前移除 MenuProvider，MenuHostHelper 会正确移除所有 LifecycleObserver。（Ibe2e1、b/199788262）
更新了“未使用的应用限制常量”的说明，以便为开发者提供更清晰的说明 (I2858e)

版本 1.7.0-beta01

2021 年 9 月 15 日

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

API 变更

LocationRequestCompat.toProvider 现在可以返回 null (Ib5a09)

版本 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 Remote Views 版本 1.1

版本 1.1.0

2024 年 6 月 12 日

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

自 1.0.0 以来的重要变更

核心 RemoteViews 移至 1.1.0 稳定版。

版本 1.1.0-rc01

2024 年 5 月 14 日

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

新功能

将 RemoteViews 1.1.0 移至候选版本。

bug 修复

将 androidx 库的默认 minSdkVersion 移至 21。(I6ec7f)

版本 1.1.0-beta02

2024 年 4 月 17 日

发布了 androidx.core:core-remoteviews:1.1.0-beta02。自上个版本以来，没有重大变化。

版本 1.1.0-beta01

2024 年 4 月 3 日

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

版本 1.1.0-alpha01

2024 年 2 月 7 日

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

新功能

版本递增，以匹配依赖项版本。

Core Remote Views 版本 1.0

版本 1.0.0

2023 年 9 月 6 日

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

1.0.0 的主要功能

将 core-remoteviews 移至稳定版 1.0.0

版本 1.0.0-beta04

2023 年 5 月 10 日

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

bug 修复

修复了在兼容性库中的极端情况下抛出 ArrayOutOfBoundsException 的问题。

版本 1.0.0-beta03

2022 年 10 月 5 日

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

新功能

未添加任何新功能。

版本 1.0.0-beta02

2022 年 8 月 10 日

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

bug 修复

版本修复

版本 1.0.0-beta01

2022 年 6 月 29 日

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

新功能

Core-RemoteViews 已发布 Beta 版。

版本 1.0.0-alpha03

2022 年 2 月 23 日

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

bug 修复

修复了基础架构问题。

版本 1.0.0-alpha02

2022 年 1 月 26 日

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

版本 1.0.0-alpha01

2021 年 12 月 15 日

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

新功能

可以向后移植新的 RemoteViews.setRemoteAdapter API。
添加了 Kotlin 扩展函数，以便在调用 RemoteViews 方法时避免使用反射机制。
带有辅助函数函数的库，用于处理 App Widget 尺寸调整 API。

Core Performance 版本 1.0

版本 1.0.0

2024 年 1 月 10 日

发布了 androidx.core:core-performance:1.0.0、androidx.core:core-performance-play-services:1.0.0 和 androidx.core:core-performance-testing:1.0.0。版本 1.0.0 中包含这些提交内容。

1.0.0 的主要功能

核心性能 - 为开发者提供了一种可靠的机制，使其能够在运行时识别设备的性能水平，从而相应地优化应用的用户体验。
核心性能 Play 服务 - Google 专用实现，可为经过测试的设备和操作系统版本提供最新的媒体性能等级信息。
核心性能测试 - 核心性能的测试替身。

bug 修复

修复了在版本 1.0.0-beta2 中发现的初始化 PlayServicesDevicePerformance 时发生的崩溃问题。(b/318803680)

版本 1.0.0-rc01

2023 年 12 月 13 日

发布了 androidx.core:core-performance:1.0.0-rc01、androidx.core:core-performance-play-services:1.0.0-rc01 和 androidx.core:core-performance-testing:1.0.0-rc01。版本 1.0.0-rc01 中包含这些提交内容。

新功能

核心性能 - 更新了库实现。（DevicePerformance 通用实现）。
核心效果 Play 服务 - 初始库实现。（Google 特定的 DevicePerformance 实现）。
核心性能测试 - 初始库实现。（包含核心性能的测试替身）。

API 变更

DevicePerformance 特定 API 的初始 RC 版本。

版本 1.0.0-beta02

2023 年 10 月 4 日

发布了 androidx.core:core-performance:1.0.0-beta02、androidx.core:core-performance-play-services:1.0.0-beta02 和 androidx.core:core-performance-testing:1.0.0-beta02。版本 1.0.0-beta02 中包含这些提交内容。

新功能

测试相关重构。

API 变更

API 使用模式未发生变化。

版本 1.0.0-beta01

2023 年 9 月 6 日

发布了 androidx.core:core-performance:1.0.0-beta01、androidx.core:core-performance-play-services:1.0.0-beta01 和 androidx.core:core-performance-testing:1.0.0-beta01。版本 1.0.0-beta01 中包含这些提交内容。

新功能

核心性能 - 更新了库实现。（DevicePerformance 通用实现）。
核心效果 Play 服务 - 初始库实现。（Google 特定的 DevicePerformance 实现）。
核心性能测试 - 初始库实现。（包含核心性能的测试替身）。

API 变更

DevicePerformance 特定 API 的初始 Beta 版。

版本 1.0.0-alpha03

2023 年 8 月 23 日

发布了 androidx.core:core-performance:1.0.0-alpha03、androidx.core:core-performance-play-services:1.0.0-alpha03 和 androidx.core:core-performance-testing:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

新功能

core-performance-testing 的初始库实现，包含核心性能的测试替身。
初始库实现或 core-performance-play-services。Google 特定实现提供最新的媒体性能等级信息。

API 变更

添加了可选模块，用于提供来自 Google Play 服务的媒体性能等级。
更改了核心性能构造函数，以支持可选实现。

版本 1.0.0-alpha02

2022 年 3 月 23 日

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

新功能

为开发者提供了一种简单可靠的机制，使其能够在运行时识别设备的性能水平，从而优化应用体验。
此初始版本使用经手动测试的设备列表，这些设备所获性能等级值高于 Build.VERSION.MEDIA_PERFORMANCE_CLASS 中声明的级别

版本 1.0.0-alpha01

2021 年 12 月 15 日

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

Core Splashscreen 版本 1.2

版本 1.2.0-rc01

2025 年 7 月 2 日

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

版本 1.2.0-beta02

2025 年 4 月 23 日

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

版本 1.2.0-beta01

2025 年 2 月 26 日

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

版本 1.2.0-alpha02

2024 年 9 月 4 日

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

bug 修复

向 SplashScreen 的主题添加了 isLightTheme 属性（I01000、b/238522114）
通过 AppCompatResources 获取启动画面图标（Ib05e、b/289242141、b/263972037）
移除了对新平台 API 访问权限的手动概述，因为在使用 AGP 7.3 或更高版本（例如 R8 版本 3.3）的 R8 时，以及在使用 AGP 8.1 或更高版本（例如 D8 版本 8.1）的所有 build 时，这种情况都会通过 API 建模自动发生。建议未使用 AGP 的客户更新到 D8 版本 8.1 或更高版本。如需了解更多详情，请参阅这篇文章。（Ieb9ae、b/345472586）

版本 1.2.0-alpha01

2024 年 4 月 17 日

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

bug 修复

自版本 30 起，将 Base.Theme.SplashScreen 的刘海屏模式更改为始终。(Idfc3f)
将 enforceNavigationBarContrast 从 API 31 开始重置为系统默认值，这样启动画面主题就不会损坏 activity 的主题。从 API 31 开始，启动画面不再创建为 PhoneWindow，因此无需从 API 29 继承该值。另请从 applyAppSystemUiTheme 中移除替换操作，因为 enforceNavigationBarContrast 可能已在启动期间从应用端发生更改，因此从属性替换它没有意义。(Ic2cd9)
设置默认的浅色导航栏，该导航栏会根据白天/夜间主题进行调整。因此，对于 API 33 及更高版本的平台，启动画面主题不会在移除启动画面时导致闪烁。(I8023a)
在从 API 33 接收到启动画面视图后，不再覆盖 activity 主题。(I10587b)

Core Splashscreen 版本 1.1

版本 1.1.0-rc01

2024 年 4 月 3 日

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

bug 修复

为具有 48x48dp 图标的 Wear 设备提供默认尺寸（Ib8de8、b/256678037）
修复了 SplashScreenView#getIconView 导致 NPE 崩溃的问题（6abfd6、b/243457485）

版本 1.1.0-alpha02

2023 年 9 月 6 日

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

bug 修复

为具有 48x48dp 图标的 Wear 设备提供默认尺寸（Ib8de8、b/256678037）

依赖项更新

Core-Splashscreen 现在针对 API 34 进行编译。

版本 1.1.0-alpha01

2023 年 2 月 22 日

发布了 androidx.core:core-splashscreen:1.1.0-alpha01。这是在内部分支中开发的。

bug 修复

修复了 SplashScreenView#getIconView 返回 null 时出现的 NullPointerException。(e231ab)

Core Splashscreen 版本 1.0

版本 1.0.1

2023 年 4 月 19 日

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

bug 修复

为具有 48x48dp 图标的 Wear 设备提供默认尺寸（Ib8de8、b/256678037）

版本 1.0.0

2022 年 7 月 27 日

核心 SplashScreen 库为搭载 API 23 及更高版本的所有设备带来了新的 Android 12 启动画面。使用启动画面库，您的应用无需任何自定义 SplashScreen activity，并可利用正确的 API 快速启动应用。若要使用它，只需按照我们的指南中的步骤操作即可。如需详细了解 Android 12 启动画面，请参阅官方文档。

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

版本 1.0.0-rc01

2022 年 5 月 18 日

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

与上个 Beta 版相比没有变化。

版本 1.0.0-beta02

2022 年 3 月 23 日

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

bug 修复

修复了 Lateinit property platformView has not been initialized (b/214835299)

外部贡献

修复了在深色模式下使用 MIUI 时出现的渲染问题，并明确将 android:animateLayoutChanges 设置为 false，以避免在 OnExitAnimationListener 中移除启动画面时出现淡出动画 (#327)

版本 1.0.0-beta01

2022 年 1 月 12 日

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

bug 修复

提升了夜间模式处理能力，可确保所有 API 中均使用默认参数时系统能处理夜间模式。2d1d182

修复了 Android 12 的新启动画面中引入的 bug：

解决了 API 31 中的 systemBar 闪烁问题：确保系统栏在自定义退出动画时不闪烁。 5a75362
解决了使用 OnExitAnimationListener 时出现的边衬区处理问题：确保在使用 OnExitAnimationListener 时内容不会跳转。4c8f264

版本 1.0.0-alpha02

2021 年 9 月 29 日

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

新功能

更好的边衬区支持：启动画面现在会对所有 API 显示全屏，即使设置了 OnExitAnimationListener 也是如此。
postSplashScreenTheme 是可选操作：您只需在 onCreate() 前调用 activity.setTheme() 即可在显示启动画面后设置应用主题。
向后支持 windowSplashScreenIconBackgroundColor 属性：您可以使用 Theme.SplashScreen.IconBackground 和 windowSplashScreenIconBackgroundColor 将背景添加到启动画面图标。
已更正图标的尺寸，使其符合平台规范。

API 变更

为 windowSplashScreenIconBackgroundColor 属性添加了向后兼容性
- 将 minSdkVersion 降级为 API 21（Idd050、b/198161849、b/197759820、b/198165621）

bug 修复

将 postSplashScreenTheme 设为可选属性 (I8c4bf)

版本 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 Shortcuts 版本 1.2

版本 1.2.0-alpha01

2023 年 7 月 26 日

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

API 变更

合并了 a、b、c 路径的公共 API 文件和实验性 API 文件（I8cfee、b/278769092）
已迁移 androidx.core 群组以使用合并的公共 API 文件（Ifdef4、b/278769092）

Core Google Shortcut 版本 1.1.0

版本 1.1.0

2022 年 10 月 24 日

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

自 1.0.0 以来的重要变更

从使用 com.google.firebase:firebase-appindexing 迁移到了新的 com.google.android.gms:play-services-appindex 库。此版本的库与 com.google.firebase:firebase-appindexing 不兼容。开发者应避免使用这两个库，以免出现构建错误。

版本 1.1.0-rc01

2022 年 10 月 5 日

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

新功能

从使用 com.google.firebase:firebase-appindexing 迁移到了新的 com.google.android.gms:play-services-appindex 库。请注意，此版本的库与 com.google.firebase:firebase-appindexing 不兼容。开发者应避免使用这两个库，以免出现构建错误。

版本 1.1.0-beta01

2022 年 9 月 21 日

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

新功能

移除了未使用的依赖项。没有新功能。

版本 1.1.0-alpha03

2022 年 9 月 7 日

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

新功能

移除了未使用的依赖项。没有新功能。

版本 1.1.0-alpha02

2022 年 8 月 24 日

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

新功能

将依赖项从 com.google.firebase:firebase-appindexing 更新为 com.google.android.gms:play-services-appindex。使用此新版本的开发者不应在外部依赖 com.google.firebase:firebase-appindexing，因为这两个库现在并不兼容。

版本 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 Shortcuts 版本 1.0

版本 1.0.1

2022 年 5 月 18 日

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

bug 修复

修复了 Proguard 规则，以防止方法被意外移除

版本 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 会在新版 OS 上中断该通知的 BigPictureStyle 的 bug。(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 级别的 bug 修复（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)
修复了通知构建器测试失败的问题
修复了注册/取消注册 bug 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 崩溃的 bug（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 和 bug 修复
添加了可与 AndroidQ 中以向后兼容方式引入的 BlendMode 结合使用的新 API
在 AccessibilityCompat 中添加了新的 API 和 bug 修复
添加了可与 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 滚动 bug。(aosp/971000)
已切换为在 ViewCompat 实现中使用 SimpleArrayMap (aosp/1012534)
修复了 FingerprintManager 在 API 级别 23 上不当检查 PackageManager 的 bug (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 更新的相关 bug (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 之前平台的 bug (aosp/898940)
新增了 LocationManagerCompat 类 (aosp/894736)

API 变更

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

bug 修复

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

版本 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)
修复了替换无障碍操作以及添加无障碍操作时未移除旧无障碍操作的 bug (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 变更和 bug 修复。

新功能和 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() 崩溃的 bug。
修复了 ContentResolver 返回 null 时 TypefaceCompatApi21 出现 null 指针异常的问题。
修复了 Array Utils 希望获得 ColorStateList 但获得的却是原色的类型错误。

Core-Animation 和 Core-Animation-Testing 1.0.0

版本 1.0.0

2024 年 5 月 1 日

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

1.0.0 的主要功能

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。

版本 1.0.0-rc01

2023 年 7 月 26 日

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

新功能

RemoteViews 移动已在 Beta 版中稳定下来，现在已移至 rc01。

版本 1.0.0-beta01

2022 年 4 月 20 日

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

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

版本 1.1.0

2025 年 3 月 12 日

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

版本 1.1.0-rc01

2021 年 12 月 15 日

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

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 修复版本。

bug 修复

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

Core-Ktx 版本 1.0.1

2018 年 11 月 5 日

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

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