注释

  
公开元数据，帮助工具和其他开发者了解您的应用程序代码。

此表列出了 androidx.annotation 组中的所有工件。

工件 稳定版 候选版本 Beta 版 Alpha 版
annotation 1.8.2 - - 1.9.0-alpha03
annotation-experimental 1.4.1 - - 1.5.0-alpha01
此库上次更新于：2024 年 9 月 4 日

声明依赖项

要添加对 Annotation 的依赖项，您必须将 Google Maven 存储库添加到您的项目。阅读 Google 的 Maven 存储库 以获取更多信息。

在您的应用程序或模块的 build.gradle 文件中添加您需要的工件的依赖项

Groovy

dependencies {
    implementation "androidx.annotation:annotation:1.8.2"
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation "androidx.annotation:annotation-experimental:1.4.1"
}

Kotlin

dependencies {
    implementation("androidx.annotation:annotation:1.8.2")
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation("androidx.annotation:annotation-experimental:1.4.1")
}

有关依赖项的更多信息，请参阅 添加构建依赖项。

反馈

您的反馈有助于使 Jetpack 变得更好。如果您发现新的问题或有改进此库的想法，请告诉我们。在创建新的问题之前，请查看此库中的 现有问题。您可以通过单击星形按钮为现有问题添加您的投票。

创建新的问题

有关更多信息，请参阅 问题跟踪器文档。

版本 1.9

版本 1.9.0-alpha03

2024 年 9 月 4 日

androidx.annotation:annotation-*:1.9.0-alpha03 已发布。版本 1.9.0-alpha03 自上一个 Alpha 版以来包含 无更改。

版本 1.9.0-alpha02

2024 年 8 月 21 日

androidx.annotation:annotation-*:1.9.0-alpha02 已发布。版本 1.9.0-alpha02 包含 这些提交。

新功能

版本 1.9.0-alpha01

2024 年 6 月 26 日

androidx.annotation:annotation-*:1.9.0-alpha01 已发布。版本 1.9.0-alpha01 包含 这些提交。

外部贡献

  • 添加了对 linuxArm64 多平台目标的支持（感谢 Jake Wharton！）

版本 1.8

版本 1.8.2

2024 年 8 月 7 日

androidx.annotation:annotation-*:1.8.2 已发布。版本 1.8.2 包含 这些提交。

错误修复

版本 1.8.1

2024 年 7 月 24 日

androidx.annotation:annotation-*:1.8.1 已发布。版本 1.8.1 包含 这些提交。

错误修复

  • 包含了额外的 Kotlin 多平台目标：watchos，tvos。

版本 1.8.0

2024 年 5 月 14 日

androidx.annotation:annotation-*:1.8.0 已发布。版本 1.8.0 包含 这些提交。

自 1.7.0 以来重要的更改

  • 添加了 @ReplaceWith 注解来表达对已弃用 API 的替换
  • @MainThread 注解已移至通用源代码集。

版本 1.8.0-rc01

2024 年 5 月 1 日

androidx.annotation:annotation-*:1.8.0-rc01 已发布。版本 1.8.0-rc01 自上一个 Beta 版本以来 没有变化。

版本 1.8.0-beta02

2024 年 4 月 17 日

androidx.annotation:annotation-*:1.8.0-beta02 已发布。版本 1.8.0-beta02 自上一个版本以来没有任何变化。

版本 1.8.0-beta01

2024 年 4 月 3 日

androidx.annotation:annotation-*:1.8.0-beta01 已发布。版本 1.8.0-beta01 包含 这些提交。

新功能

  • ReplaceWith 注解现在是 API 稳定的，但与之相关的 lint 检查和自动修复功能尚未发布。

版本 1.8.0-alpha02

2024 年 3 月 20 日

androidx.annotation:annotation-*:1.8.0-alpha02 已发布，没有显著变化。版本 1.8.0-alpha02 包含 这些提交。

版本 1.8.0-alpha01

2024 年 2 月 21 日

androidx.annotation:annotation-*:1.8.0-alpha01 已发布。 版本 1.8.0-alpha01 包含这些提交。

API 更改

  • 添加了 @ReplaceWith 注解来表达对已弃用 API 的替换。 (I38db3, b/322373864)

外部贡献

  • 感谢 Ivan Matkov 将 @MainThread 注解移至通用源代码集。 (6f228c)

版本 1.7

版本 1.7.1

2023 年 12 月 13 日

androidx.annotation:annotation-*:1.7.1 已发布。 版本 1.7.1 包含这些提交。

错误修复

  • 在插入默认平台依赖项时使用 compile 范围。 (I4958f)

版本 1.7.0

2023 年 9 月 6 日

androidx.annotation:annotation-*:1.7.0 已发布。 版本 1.7.0 包含这些提交。

自 1.6.0 以来重要的更改

  • 包含针对 iOS、Linux 和 MacOS 平台的 Kotlin 多平台工件。
  • 现在您可以在 KMM 项目中使用注解。请注意，注解的非 Android 目标仍然是实验性的，但我们决定合并版本，以便开发人员更轻松地尝试它们。具体来说，在 alpha 开发阶段，一些注解可能会在通用代码和特定平台代码之间移动，因为我们正在确定边界。

版本 1.7.0-rc01

2023 年 8 月 23 日

androidx.annotation:annotation-*:1.7.0-rc01 已发布。 版本 1.7.0-rc01 包含这些提交。

此版本不包含自上一个 Beta 版本以来的任何更改。

版本 1.7.0-beta01

2023 年 8 月 9 日

androidx.annotation:annotation-*:1.7.0-beta01 已发布。 版本 1.7.0-beta01 包含这些提交。

新功能

  • 稳定发布的 API

版本 1.7.0-alpha03

2023 年 7 月 26 日

androidx.annotation:annotation-*:1.7.0-alpha03 已发布。 版本 1.7.0-alpha03 包含这些提交。

错误修复

  • Maven POM 发布现在包括默认的 JVM 目标多平台工件作为依赖项。

版本 1.7.0-alpha02

2023 年 3 月 24 日

androidx.annotation:annotation-*:1.7.0-alpha02 已发布。

错误修复

  • 从 Maven 工件中删除了依赖约束，以解决 Kotlin 本地目标中的构建问题 (b/274786186, KT-57531)。

版本 1.7.0-alpha01

2023 年 3 月 22 日

androidx.annotation:annotation-*:1.7.0-alpha01 已发布。 版本 1.7.0-alpha01 包含这些提交。

新功能

  • 包含针对 iOS、Linux 和 MacOS 平台的 Kotlin 多平台工件。
  • 现在您可以在 KMM 项目中使用注解。请注意，注解的非 Android 目标仍然是实验性的，但我们决定合并版本，以便开发人员更轻松地尝试它们。具体来说，在 alpha 开发阶段，一些注解可能会在通用代码和特定平台代码之间移动，因为我们正在确定边界。

版本 1.6

版本 1.6.0

2023 年 2 月 22 日

androidx.annotation:annotation:1.6.0 和 androidx.annotation:annotation-jvm:1.6.0 已发布。 版本 1.6.0 包含这些提交。

自 1.5.0 以来重要的更改

  • 添加了 @RequiresExtension 注解来表达 API 需要特定扩展 SDK 的特定版本 (I5e4fe)
  • 使用 Kotlin 多平台工具链转换注解库以进行构建 (I3be8d)

版本 1.6.0-rc01

2023 年 2 月 8 日

androidx.annotation:annotation:1.6.0-rc01 和 androidx.annotation:annotation-jvm:1.6.0-rc01 已发布。 版本 1.6.0-rc01 包含这些提交。

  • 注解已稳定发布候选版本 1.6.0-rc01。

版本 1.6.0-beta01

2023 年 1 月 25 日

androidx.annotation:annotation:1.6.0-beta01 和 androidx.annotation:annotation-jvm:1.6.0-beta01 已发布，与 1.6.0-alpha01 相比没有变化。

版本 1.6.0-alpha01

2023 年 1 月 11 日

androidx.annotation:annotation-*:1.6.0-alpha01 已发布。 版本 1.6.0-alpha01 包含这些提交。

版本 1.6.0-dev01

2023 年 2 月 8 日

androidx.annotation:annotation-*:1.6.0-dev01 已发布。 版本 1.6.0-dev01 包含这些提交。

  • 注解已为开发人员预览版 1.6.0-dev01 启用了 Kotlin 多平台。

新功能

  • 添加了 @RequiresExtension 注解来表达 API 需要特定扩展 SDK 的特定版本。 (I5e4fe)
  • 使用 Kotlin 多平台工具链转换注解库以进行构建 (I3be8d)

版本 1.5.0

版本 1.5.0

2022 年 9 月 21 日

androidx.annotation:annotation:1.5.0 已发布。 版本 1.5.0 包含这些提交。

自 1.4.0 以来重要的更改

  • 注解库已完全迁移到 Kotlin 源代码，从而支持 Kotlin 特定目标的使用地点和其他与 Kotlin 兼容的注解功能。

版本 1.5.0-rc01

2022 年 9 月 7 日

androidx.annotation:annotation:1.5.0-rc01 已发布。 版本 1.5.0-rc01 包含这些提交。

  • 与之前的 1.5.0 Beta 版本相比没有变化。

版本 1.5.0-beta01

2022 年 8 月 24 日

androidx.annotation:annotation:1.5.0-beta01 已发布。 版本 1.5.0-beta01 包含这些提交。

  • 与之前版本相比没有变化。API 表面已冻结以供 Beta 版本使用。

版本 1.5.0-alpha02

2022 年 8 月 10 日

androidx.annotation:annotation:1.5.0-alpha02 已发布。 版本 1.5.0-alpha02 包含这些提交。

  • 自上一个 Alpha 版本以来没有变化。

版本 1.5.0-alpha01

2022 年 7 月 27 日

androidx.annotation:annotation:1.5.0-alpha01 已发布。 版本 1.5.0-alpha01 包含这些提交。

新功能

  • 注解库已完全迁移到 Kotlin 源代码，从而支持 Kotlin 特定目标的使用地点和其他与 Kotlin 兼容的注解功能。

版本 1.4.0

版本 1.4.0

2022 年 6 月 15 日

androidx.annotation:annotation:1.4.0 已发布。 版本 1.4.0 包含这些提交。

自 1.3.0 以来重要的更改

  • @RestrictTo 已迁移到 Kotlin 源代码，现在支持 @file 使用地点。因此，注解库现在依赖于 Kotlin 标准库。
  • @ReturnThis (b/140249763): 确保此方法的覆盖方法必须返回相同的实例（适用于构建器等）。
  • @OpenForTesting (b/141539024): 标记为“open”的 Kotlin 类和方法可以使用此注解进行标记，lint 将确保此类仅从单元测试中进行子类化（方法仅从单元测试中进行覆盖）。
  • @DeprecatedSinceApi (b/37116481): 指示注解方法（或类或字段）是平台 API 的移植库的一部分，自给定 API 级别起不再需要该库。
  • @EmptySuper: 指示此方法被定义为空，因此在覆盖时，您不需要调用它（事实上，您不应该调用它；例如，它可以包含向后兼容性检查）。

版本 1.4.0-rc01

2022 年 6 月 1 日

androidx.annotation:annotation:1.4.0-rc01 已发布。 版本 1.4.0-rc01 包含这些提交。

  • API 表面和功能已最终确定以供发布。

版本 1.4.0-beta01

2022 年 5 月 18 日

androidx.annotation:annotation:1.4.0-beta01 已发布。 版本 1.4.0-beta01 包含这些提交。

  • 自上一个 Alpha 版本以来没有变化。API 表面已锁定以供 Beta 版本发布。

版本 1.4.0-alpha02

2022 年 2 月 9 日

androidx.annotation:annotation:1.4.0-alpha02 已发布。 版本 1.4.0-alpha02 包含这些提交。

新功能

  • 添加了 @ReturnThis、@OpenForTesting、@EmptySuper 和 @DeprecatedSinceApi 注解。 (21946a2)

  • @ReturnThis (b/140249763): 确保此方法的覆盖方法必须返回相同的实例（适用于构建器等）

  • @OpenForTesting (b/141539024): 标记为“open”的 Kotlin 类和方法可以使用此注释，lint 将确保此类仅从单元测试中子类化（并且方法仅被覆盖）

  • @DeprecatedSinceApi (b/37116481): 表示带注释的方法（或类或字段）是平台 API 的回溯库的一部分，在给定的 API 级别不再需要。

  • @EmptySuper: 指示此方法被定义为空，因此在覆盖时，您不需要调用它（事实上，您不应该调用它；例如，它可以包含向后兼容性检查）。

版本 1.4.0-alpha01

2021 年 12 月 15 日

androidx.annotation:annotation:1.4.0-alpha01 已发布。 版本 1.4.0-alpha01 包含这些提交。

API 更改

  • 将 RestrictTo 注释迁移到 Kotlin 源代码 (Ia6336)

版本 1.3.0

版本 1.3.0

2021 年 11 月 3 日

androidx.annotation:annotation:1.3.0 已发布。 版本 1.3.0 包含这些提交。

自 1.2.0 以来重要的更改

  • @Discouraged 注释用于标记无法合理弃用的 API，但会对性能造成重大负面影响，并且不应在正常的生产代码中调用。
  • @Context 注释用于标记泛型上下文，以便开发人员可以更轻松地迁移到新的 API。
  • @GravityInt 注释用于标记包含打包到整数中的重力值的元素。
  • 弃用 @InspectableProperty，转而使用 @Attribute 用于 androidx.resourceinspection

版本 1.3.0-rc01

2021 年 10 月 27 日

androidx.annotation:annotation:1.3.0-rc01 已发布。 版本 1.3.0-rc01 包含这些提交。

版本 1.3.0-beta01

2021 年 9 月 29 日

androidx.annotation:annotation:1.3.0-beta01 已发布。 版本 1.3.0-beta01 包含这些提交。

API 更改

  • 要求在 @Discouraged 的“message”中提供解释。 (I3390f)
  • 添加 @Discouraged 注释用于标记不鼓励使用的元素。 (Ib2549)
  • 使 RestrictTo 注释从 Studio 文档弹出窗口可见 (Ie8e1a, b/183134648)

错误修复

  • 添加 Context 注释以标记泛型上下文，以便开发人员可以更轻松地迁移到新的 API。 (Ie581a)

版本 1.3.0-alpha01

2021 年 3 月 24 日

androidx.annotation:annotation:1.3.0-alpha01 已发布。 版本 1.3.0-alpha01 包含这些提交。

API 更改

  • 弃用 @InspectableProperty，转而使用 @Attribute 在 androidx.resourceinspection 中。 (Ic0eff)
  • 添加了 @GravityInt 注释用于标记包含打包到整数中的重力值的元素。 (Ifcaa4, b/180620048)

注释实验版 1.5

版本 1.5.0-alpha01

2024 年 8 月 21 日

androidx.annotation:annotation-experimental:1.5.0-alpha01 已发布。 版本 1.5.0-alpha01 包含 这些提交。

API 更改

  • 在 RequiresOptIn 中添加 message 以匹配 Kotlin stdlib 注释，默认值为空字符串。 (I1f50e)

注释实验版 1.4

版本 1.4.1

2024 年 4 月 3 日

androidx.annotation:annotation-experimental:1.4.1 已发布。 版本 1.4.1 包含 这些提交。

错误修复

  • 修复 isKotlin 的用法，以避免意外地在 Kotlin 文件中触发 RequiresOptIn 检查。 (I2d8c1f)

版本 1.4.0

2024 年 1 月 24 日

androidx.annotation:annotation-experimental:1.4.0 已发布。 版本 1.4.0 包含这些提交。

自 1.3.0 以来重要的更改

  • 添加对 Kotlin 多平台的支持
  • 修复与 Kotlin 2.0 的兼容性
  • 针对 Java 使用实验性注释的 Kotlin 属性显示警告 (I8bd43)
  • 修复 Kotlin 方法上自动修复注释的放置 (Id7a41)

版本 1.4.0-rc01

2024 年 1 月 10 日

androidx.annotation:annotation-experimental:1.4.0-rc01 已发布。 版本 1.4.0-rc01 自上次发布以来没有任何更改。

版本 1.4.0-beta01

2023 年 12 月 13 日

androidx.annotation:annotation-experimental:1.4.0-beta01 已发布。 自上次发布以来没有任何更改。

版本 1.4.0-alpha01

2023 年 11 月 29 日

androidx.annotation:annotation-experimental:1.4.0-alpha01 已发布。 版本 1.4.0-alpha01 包含这些提交。

错误修复

  • 为了解决 b/301598518，临时删除类级自动修复建议。 (Id98b2)
  • 针对 Java 使用实验性注释的 Kotlin 属性显示警告 (I8bd43)
  • 修复 Kotlin 方法上自动修复注释的放置 (Id7a41)

版本 1.4.0-dev01

2023 年 2 月 8 日

androidx.annotation:annotation-experimental:1.4.0-dev01 已发布。 版本 1.4.0-dev01 包含这些提交。

  • 注释实验版已为开发人员预览版 1.4.0-dev01 启用了 Kotlin 多平台。

注释实验版 1.3.1

版本 1.3.1

2023 年 6 月 21 日

androidx.annotation:annotation-experimental:1.3.1 已发布。 版本 1.3.1 包含这些提交。

错误修复

  • 在应用 lint 自动修复时，将注释放置在修饰符列表的开头。 (b/251172715)
  • 使用 lint 检查来阻止在 Kotlin 源代码中使用 androidx.annotation.RequiresOptIn (b/241097743)

注释实验版 1.3.0

版本 1.3.0

2022 年 9 月 7 日

androidx.annotation:annotation-experimental:1.3.0 已发布。 版本 1.3.0 包含这些提交。

自 1.2.0 以来重要的更改

  • 添加对包级使用 @androidx.annotation.OptIn 的支持 (I24d58)
  • 将 Kotlin stdlib 依赖项移至 API 类型，而不是仅编译。 这意味着注释实验版库的所有客户端都将在其传递依赖项中包含 Kotlin 标准库。

版本 1.3.0-rc01

2022 年 8 月 24 日

androidx.annotation:annotation-experimental:1.3.0-rc01 已发布。 版本 1.3.0-rc01 包含这些提交。

  • 与上次发布相比没有任何更改。 实施已冻结以供 RC。

版本 1.3.0-beta01

2022 年 8 月 10 日

androidx.annotation:annotation-experimental:1.3.0-beta01 已发布。 版本 1.3.0-beta01 包含这些提交。

  • 与 alpha 版本相比没有任何更改。 此库已稳定以供 beta 版本发布。

版本 1.3.0-alpha01

2022 年 7 月 27 日

androidx.annotation:annotation-experimental:1.3.0-alpha01 已发布。 版本 1.3.0-alpha01 包含这些提交。

API 更改

  • 添加对包级使用 @androidx.annotation.OptIn 的支持 (I24d58)

注释实验版 1.2.0

版本 1.2.0

2021 年 12 月 15 日

androidx.annotation:annotation-experimental:1.2.0 已发布。 版本 1.2.0 包含这些提交。

自 1.1.0 以来重要的更改

此库现在针对 Java 8 语言级别。

版本 1.2.0-rc01

2021 年 12 月 1 日

androidx.annotation:annotation-experimental:1.2.0-rc01 已发布。 版本 1.2.0-rc01 包含这些提交。

与 beta 版本相比没有任何更改。

版本 1.2.0-beta01

2021 年 11 月 17 日

androidx.annotation:annotation-experimental:1.2.0-beta01 已发布。 版本 1.2.0-beta01 包含这些提交。

API 更改

API 已最终确定以供 beta 版本发布。

注释实验版 1.2.0-alpha01

2021 年 6 月 30 日

androidx.annotation:annotation-experimental:1.2.0-alpha01 已发布。 版本 1.2.0-alpha01 包含这些提交。

新功能

  • 库现在针对 Java 8 语言级别

版本 1.2.0

版本 1.2.0

2021 年 3 月 24 日

androidx.annotation:annotation:1.2.0 已发布。 版本 1.2.0 包含这些提交。

自 1.1.0 以来重大的更改

  • 添加了 @ChecksSdkIntAtLeast 注释，该注释可用于标识用于在 SDK 级别上对访问进行门控并满足 NewApi lint 检查的方法或字段。
  • 添加了 @DoNotInline 注释，该注释与 Proguard 规则配对，以防止成员在优化期间被内联。
  • 现在，各种注释都使用 @Documented 进行注释，以确保它们在带注释成员的文档中显示。

版本 1.2.0-rc01

2021 年 2 月 24 日

androidx.annotation:annotation:1.2.0-rc01 已发布。 版本 1.2.0-rc01 包含这些提交。

版本 1.2.0-beta01

2021 年 1 月 13 日

androidx.annotation:annotation:1.2.0-beta01 已发布。 版本 1.2.0-beta01 包含这些提交。

API 更改

  • 新的 @DoNotInline 注释，指示代码优化器（例如 Proguard、R8）不要内联带注释的方法。 (I3dfe8, b/141326133)

版本 1.2.0-alpha01

2020 年 5 月 14 日

androidx.annotation:annotation:1.2.0-alpha01 已发布。 版本 1.2.0-alpha01 包含这些提交。

新功能

  • 添加了 @ChecksSdkIntAtLeast 注释。 这使得 androidx 和用户能够注释表示 SDK_INT 检查的方法和字段。 (I89a54, b/120255046)

注释实验版 1.1.0

版本 1.1.0

2021 年 4 月 7 日

androidx.annotation:annotation-experimental:1.1.0 已发布。 版本 1.1.0 包含这些提交。

自 1.0.0 以来重大的更改

  • Jetpack 的实验性注解已重写为 Kotlin，以支持多个标记类并改进对弃用处理。
  • RequiresOptIn 和 OptIn 注解已添加，与 Kotlin 保持一致，而 Experimental 和 UsesExperimental 注解已被弃用。

版本 1.1.0-rc02

2021 年 3 月 24 日

androidx.annotation:annotation-experimental:1.1.0-rc02 已发布。版本 1.1.0-rc02 包含以下提交。

错误修复

  • 已添加 Proguard 规则，以确保代码优化不会因缺少 Kotlin 元注解而发出警告。

版本 1.1.0-rc01

2021 年 3 月 10 日

androidx.annotation:annotation-experimental:1.1.0-rc01 已发布。版本 1.1.0-rc01 包含以下提交。

自上一个 beta 版本以来无更改。

版本 1.1.0-beta01

2021 年 1 月 27 日

androidx.annotation:annotation-experimental:1.1.0-beta01 已发布。版本 1.1.0-beta01 包含以下提交。

API 更改

  • Experimental 注解的 androidx 变体已被弃用，以保持与 Kotlin 一致。它已被 androidx 变体的 RequiresOptIn 注解取代，并且面向 Java 的 linter 已更新，以支持新的 Kotlin 注解和新的 androidx 变体。（I52495，b/151331381）

版本 1.1.0-alpha01

2020 年 7 月 22 日

androidx.annotation:annotation-experimental:1.1.0-alpha01 已发布。版本 1.1.0-alpha01 包含以下提交。

新功能

  • 实验性注解库现在用 Kotlin 编写，但不依赖 Kotlin 标准库。它包含一个 Proguard 文件，允许从仅使用 Java 编程语言的项目中剥离不必要的 Kotlin 元数据。
  • @UseExperimental 现在支持多个标记类（aosp/1185577，b/145137892）

Annotation-Experimental 版本 1.0.0

Annotation-Experimental 版本 1.0.0

2019 年 11 月 7 日

androidx.annotation:annotation-experimental:1.0.0 和 androidx.annotation:annotation-experimental-lint:1.0.0 已发布，自 1.0.0-rc01 以来没有变化。版本 1.0.0 包含以下提交。

1.0.0 的主要功能

  • 基于 Lint 的 Kotlin @Experimental 语义在 Java 源代码中的强制执行
  • Java 注解，提供与 Kotlin 的 @Experimental 和 @UseExperimental 注解等效的行为，而无需依赖 Kotlin

Annotation-Experimental 版本 1.0.0-rc01

2019 年 10 月 23 日

androidx.annotation:annotation-experimental:1.0.0-rc01 和 androidx.annotation:annotation-experimental-lint:1.0.0-rc01 已发布。版本 1.0.0-rc01 包含以下提交。

已知问题

当使用 Studio 3.5 稳定版时，IDE 中不会显示来自 @Experimental 使用 lint 检测器的警告，用于 Kotlin @Experimental 注解的无效 Java 使用情况。请参阅 b/140640322。

Annotation-Experimental 版本 1.0.0-beta01

2019 年 10 月 9 日

androidx.annotation:annotation-experimental:1.0.0-beta01 和 androidx.annotation:annotation-experimental-lint:1.0.0-beta01 已发布，自版本 1.0.0-alpha01 以来没有变化。版本 1.0.0-beta01 包含以下提交。

Annotation-Experimental 版本 1.0.0-alpha01

2019 年 9 月 18 日

androidx.annotation:annotation-experimental:1.0.0-alpha01 和 androidx.annotation:annotation-experimental-lint:1.0.0-alpha01 已发布。这些是 annotation-experimental 1.0.0-alpha01 中包含的提交，这些是 annotation-experimental-lint 1.0.0-alpha01 中包含的提交

新功能

  • Jetpack 实验性注解库提供 Kotlin 的 实验性 API 标记 的 Java 兼容实现。-lint 工件提供实验性使用限制的基于 Lint 的实现，并强制执行对 Kotlin 本机实验性 API 标记的 Java 使用的限制。

  • 当将 annotation-experimental 工件用作依赖项时，annotation-experimental-lint 工件提供的 Lint 规则将自动强制执行。

版本 1.1.0

版本 1.1.0

2019 年 6 月 5 日

androidx.annotation:annotation:1.1.0 已发布，自 1.1.0-rc01 以来没有变化。

版本 1.1.0-rc01

2019 年 5 月 7 日

androidx.annotation:annotation:1.1.0-rc01 已发布，自 1.1.0-beta01 以来没有变化。此版本中包含的提交可以在 此处 找到。

版本 1.1.0-beta01

2019 年 4 月 3 日

androidx.annotation:annotation:1.1.0-beta01 已发布。此版本中包含的提交可以在 此处 找到。

新功能

  • 新的 @InspectableProperty 注解，以支持 Android 10 中添加的新视图检查 API。此注解可以应用于视图或其他 UI 元素的 getter。代码生成工具可以使用它来创建伴随对象，将属性名称和属性 ID 映射到属性值，而不会产生反射的开销。

API 更改

  • 重大更改：@ContentView 已更改为构造函数注解，并且 @LayoutRes 值已被删除。希望支持 @ContentView 注解的类应将此注解添加到接受 @LayoutRes int 参数的构造函数中。这修复了在库模块中使用此注解时的错误。（b/128352521）

版本 1.1.0-alpha02

2019 年 3 月 13 日

androidx.annotation:annotation:1.1.0-alpha02 已发布。此版本中包含的完整提交列表可以在 此处 找到。

新功能

  • 新的 API 限制范围：RestrictTo.Scope.LIBRARY_GROUP_PREFIX。它将使用限制在包内，这些包的组共享相同的库组前缀，直到最后一个 .（句点）。例如，由于库 foo.bar:lib1 和 foo.baz:lib2 共享前缀 foo，因此它们可以使用彼此的 API，这些 API 限制为此范围。同样，对于 com.foo.bar:lib1 和 com.foo.baz:lib2，它们共享 com.foo. 前缀，并且可以共享限制在该范围内的 API。但是，库 com.bar.qux:lib3 将无法使用受限制的 API，因为它只共享前缀 com.，而不是一直到最后一个 .（句点）。

版本 1.1.0-alpha01

2019 年 1 月 30 日

androidx.annotation:annotation 1.1.0-alpha01 已发布。

新功能

  • 添加了 @ContentView 注解，允许您指定要膨胀的布局 XML 文件。这在 ComponentActivity 的 1.0.0-alpha04 和 Fragment 的 1.1.0-alpha04 版本中作为使用 setContentView() 或覆盖 onCreateView() 的替代方法。（aosp/837619）

版本 1.0.2

版本 1.0.2

2019 年 2 月 25 日

androidx.annotation:annotation 1.0.2 已发布。

错误修复

  • 更正嵌入在 jar 中的 R8/ProGuard 规则。这些规则错误地引用了旧的 android.support.annotation 类型而不是 androidx.annotation。注意：这只会影响您的构建，如果您没有使用 getDefaultProguardFile，因为这些默认规则还包含两个包的正确规则。（aosp/891685）
  • 添加一个 R8/ProGuard 规则，该规则明确保留了 @Keep 注解本身。这确保了 ProGuard 不会在实际遵守其语义之前从类型中删除注解。注意：这只会影响您的构建，如果您没有使用 getDefaultProguardFile，因为这些默认规则还包含两个包的正确规则。（aosp/903818）