注释

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

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

工件 稳定版本 候选版本 Beta 版本 Alpha 版本
annotation 1.9.1 - - -
annotation-experimental 1.4.1 - - 1.5.0-alpha01
此库上次更新于：2024 年 10 月 30 日

声明依赖项

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

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

Groovy

dependencies {
    implementation "androidx.annotation:annotation:1.9.1"
    // 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.9.1")
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation("androidx.annotation:annotation-experimental:1.4.1")
}

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

反馈

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

创建新问题

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

1.9 版

1.9.1 版

2024年10月30日

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

错误修复

  • 添加了JS目标平台。（I2310b）
  • Kotlin版本更新至1.9（I1a14c）

1.9.0版本

2024年10月16日

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

自1.8.0版本以来的重要更改

  • 添加了对以下Kotlin多平台目标的支持：watchosDeviceArm64、mingwX64、linuxArm64。

1.9.0-rc01版本

2024年10月2日

发布了androidx.annotation:annotation-*:1.9.0-rc01。自之前的测试版以来，1.9.0-rc01版本没有更改。

1.9.0-beta01版本

2024年9月18日

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

API更改

1.9.0-alpha03版本

2024年9月4日

发布了androidx.annotation:annotation-*:1.9.0-alpha03。自之前的alpha版本以来，1.9.0-alpha03版本没有更改。

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版本没有更改。

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版本包含这些提交。

此版本与之前的测试版相比没有任何更改。

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 Native目标中的构建问题（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）

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

Annotation-Experimental 版本 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 的兼容性
  • 显示对实验性注释的 Kotlin 属性的 Java 用法的警告 (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）
  • 显示对实验性注释的 Kotlin 属性的 Java 用法的警告 (I8bd43)
  • 修复 Kotlin 方法上自动修复注释的位置 (Id7a41)

版本 1.4.0-dev01

2023年2月8日

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

  • Annotation-experimental 已为开发者预览版 1.4.0-dev01 启用了 Kotlin 多平台。

Annotation-Experimental 版本 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)

Annotation-Experimental 版本 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 类型，而不是编译专用类型。这意味着 Annotation-Experimental 库的所有客户端都将在其传递依赖项中包含 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)

Annotation-Experimental 版本 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 版本。

Annotation-Experimental 版本 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)

Annotation-Experimental 版本 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。类似地，对于 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）