Core

上次更新时间 当前稳定版 下一候选版本 Beta 版 Alpha 版
2019 年 11 月 20 日 1.1.0 1.2.0-rc01 - -

声明依赖项

要添加 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"
    }
    

如需详细了解依赖项,请参阅添加编译依赖项

版本 1.2.0

版本 1.2.0-rc01

2019 年 11 月 20 日

发布了 androidx.core:core:1.2.0-rc01androidx.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-beta02androidx.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-beta01androidx.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/1119191aosp/1126768

版本 1.2.0-alpha04

2019 年 9 月 5 日

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

API 变更

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

问题修复

版本 1.2.0-alpha03

2019 年 8 月 7 日

发布了 androidx.core:core:1.2.0-alpha03androidx.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 添加了 asynccounterisEnabled (aosp/987332)
  • 取消隐藏了 WindowInsetsCompatViewDragHelper (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-alpha02androidx.core:core-ktx:1.2.0-alpha02。点击此处可查看此版本中包含的提交内容。

API 变更

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

Core 版本 1.2.0-alpha01

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

新功能

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

问题修复

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

版本 1.1.0

版本 1.1.0

2019 年 9 月 5 日

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

自 1.0.0 以来的重要变更

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

版本 1.1.0-rc03

2019 年 8 月 7 日

发布了 androidx.core:core:1.1.0-rc03androidx.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-rc02androidx.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-rc01androidx.core:core-ktx:1.1.0-rc01。点击此处可查看此版本中包含的提交内容。

问题修复

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

版本 1.1.0-beta01

2019 年 5 月 7 日

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

AndroidX 的初始版本中断了用于进程间通信的支持库 compat API 的向后兼容性,以 Bundle 形式发送键控数据。此版本修复了该兼容性问题,恢复了使用 Support Library 28.0(或更早版本)构建的代码与使用 AndroidX 1.1(或更高版本)构建的代码之间的通信。

API 变更

问题修复

  • 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-alpha05androidx.core:core-ktx:1.1.0-alpha05。点击此处可查看此版本中包含的完整提交内容列表。

新功能

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

API 变更

  • 此库不再在其 API 中公开“collection”。如果您是通过 Core 上的依赖项隐式依赖“collection”类型,将需要在您的库或应用中添加显式“collection”依赖项。此变更与源不兼容,但保留了二进制文件兼容性。“collection”依赖项仍然是“core”的传递依赖项,但被视为实现细节而非其 API 的一部分。

问题修复

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

版本 1.1.0-alpha04

2019 年 1 月 30 日

发布了 androidx.core:core 1.1.0-alpha04androidx.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-alpha03androidx.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() 方法,其返回的 Executor 链接将在与该*上下文关联的主线程上运行已加入队列的任务。
  • 添加了 Resources.getFloat 的兼容性实现。
  • 在兼容性 RemoteInput 中添加了结果来源。这样,应用可以区分直接回复和智能回复,以更好地进行日志记录。
  • 为 TextView TextWatcher 操作添加了 Kotlin 扩展函数。
  • 弃用了 AccessibilityNodeInfo 功能和 setter 标记;现在改用操作。
  • 向 ViewCompat 添加了 AccessibilityPane。
  • 通过添加 AccessibilityClickableSpanCompat 在 O 之前版本的设备上公开了 ClickableSpan。
  • 弃用了 AccessibilityNodeInfoCompat.setFocusable()setClickable()setLongClickable()setScrollable()setContextClickable()。添加了 AccessibilityAction
  • 添加了 ViewCompat.setAccessibilityPaneTitle()getAccessibilityPaneTitle()setScreenReaderFocusable()isScreenReaderFocusable()setAccessibilityHeading()isAccessibilityHeading(),以通过 API 19 向后移植此 View 无障碍功能。
  • 添加了 ViewCompat.enableAccessibleClickableSpanSupport(),这样开发者就可以使非网址 ClickableSpan 通过 API 19 重新访问。

问题修复

  • 修复了使用可下载字体时,如果网络出现故障就会导致 ResourcesCompat.getFont() 崩溃的错误。
  • 修复了 ContentResolver 返回 null 时 TypefaceCompatApi21 出现 Null 指针异常的问题。
  • 修复了 Array Utils 需要 ColorStateList 但获得原始格式的颜色的类型错误。

Core-Role 版本 1.0.0

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

版本 1.0.2

2019 年 5 月 7 日

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

AndroidX 的初始版本中断了用于进程间通信的支持库 compat API 的向后兼容性,以 Bundle 形式发送键控数据。此版本修复了该兼容性问题,恢复了使用 Support Library 28.0(或更早版本)构建的代码与使用 AndroidX 1.1(或更高版本)构建的代码之间的通信。

问题修复

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

版本 1.0.1

版本 1.0.1

2018 年 11 月 7 日

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

问题修复

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

Core-Ktx 版本 1.0.1

2018 年 11 月 5 日

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

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