Google 致力于为黑人社区推动种族平等。查看具体举措。

Core

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

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

工件 当前稳定版 下一候选版本 Beta 版 Alpha 版
core 1.3.2 - 1.5.0-beta01 -
core-animation - - - 1.0.0-alpha02
core-role - 1.0.0-rc01 - 1.1.0-alpha01
此库的最后更新时间：2021 年 1 月 13 日

声明依赖项

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

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

dependencies {
    def core_version = "1.3.2"

    // 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-rc01"

    // To use the Animator APIs
    implementation "androidx.core:core-animation:1.0.0-alpha02"
    // To test the Animator APIs
    androidTestImplementation "androidx.core:core-animation-testing:1.0.0-alpha02"
}

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

反馈

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

创建新问题

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

Core 和 Core-ktx 版本 1.5.0

版本 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）

问题修复

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

外部贡献

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

版本 1.5.0-alpha05

2020 年 11 月 11 日

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

API 变更

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

版本 1.5.0-alpha04

2020 年 10 月 1 日

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

API 变更

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

问题修复

  • 允许从任何 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)

问题修复

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

新功能

  • WindowInsetsCompat API 已更新至 Android 11 平台中的相应 API。这包括新的 ime() 边衬区类型，可用于检查屏幕键盘的可见性和大小。

    • 关于 ime() 类型的一些注意事项：当您的 Activity 使用 adjustResize 窗口软输入模式时，它可以在 API 23 及以上级别上非常可靠地运行。如果您改为使用 adjustPan 模式，则应该回退至 API 14，它才能可靠地运行。

API 变更

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

外部贡献

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

版本 1.5.0-alpha01

2020 年 6 月 10 日

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

新功能

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

问题修复

  • 明确建议检查 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.2

版本 1.3.2

2020 年 10 月 1 日

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

问题修复

  • 允许从任何 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 中包含这些提交内容。

问题修复

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

问题修复

  • 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

版本 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 Action 的支持，并且弃用了以资源 ID 代表 Action 图标的公开字段（及其 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 匹配。

问题修复

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

版本 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 变更

问题修复

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

版本 1.1.0-alpha05

2019 年 3 月 13 日

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

新功能

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

API 变更

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

问题修复

  • 修复了运行 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 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 中包含这些提交内容。

问题修复

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

Core-Animation 版本 1.0.0-alpha01

2020 年 4 月 15 日

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

新功能

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

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

Core-Role 版本 1.1.0

Core-Role 版本 1.1.0-alpha01

2020 年 4 月 15 日

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

API 变更

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

Core-Role 版本 1.0.0

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

版本 1.0.2

2019 年 5 月 7 日

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

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

问题修复

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

版本 1.0.1

版本 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，并包含以下问题修复：

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