Core

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

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

最新更新时间	当前稳定版	下一候选版本	Beta 版	Alpha 版
2020 年 6 月 10 日	1.3.0	-	-	1.4.0-alpha01

声明依赖项

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

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

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

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

反馈

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

创建新问题

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

Core 和 Core-ktx 版本 1.5.0

版本 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 类的功能

问题修复

明确建议检查 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）

问题修复

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

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 中包含这些提交内容。

问题修复

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，可用于获取设备的物理尺寸

问题修复

改进了 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 中包含这些提交内容。

问题修复

更新了 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 Actions 的支持，并且弃用了以资源 ID 代表 Actions 图标的公开字段（及其 getter）。(aosp/1119192)
针对长整型添加了 MathUtils.clamp (aosp/1117300)
向 NotificationCompat 添加了 setChronometerCountDown (b/138601213)

问题修复

修复了地址检测中处理 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 匹配。

问题修复

在手势超出触摸溢出之前，不再执行嵌套预滚动（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)

问题修复

修复了响应 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

问题修复

修复了在 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。点击此处可查看此版本中包含的提交内容。

问题修复

使隐藏的 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。点击此处可查看此版本中包含的提交内容。

问题修复

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。点击此处可查看此版本中包含的提交内容。

问题修复

使图片键盘 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)

问题修复

core 测试中的 AppCompatTextView 应使用 appcompat 主题背景创建 (aosp/951636)
可对 InputConnectionCompat 使用 1.0 之前版本的字符串值 (aosp/948725)
使用 AndroidX 之前版本的字符串作为 Bundle 密钥的回退交互操作工具 (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 的一部分。

问题修复

修复了运行 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)

问题修复

修复了 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。

问题修复

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

Core-Animation 和 Core-Animation-Testing 1.0.0

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

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 项提交内容。

问题修复

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

版本 1.0.1

2018 年 11 月 7 日

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

问题修复

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

Core-Ktx 版本 1.0.1

2018 年 11 月 5 日

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

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