Annotation

  
Expor metadados que ajudam as ferramentas e outros desenvolvedores a entender o código do seu app.

Esta tabela lista todos os artefatos no grupo androidx.annotation.

Artefato Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
annotation 1.9.1 - - -
annotation-experimental 1.5.1 - - 1.6.0-alpha01
Esta biblioteca foi atualizada pela última vez em: 22 de outubro de 2025

Declarar dependências

Para adicionar uma dependência a Annotation, é preciso adicionar o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

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.5.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.5.1")
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.9

Versão 1.9.1

30 de outubro de 2024

Lançamento de androidx.annotation:annotation-*:1.9.1. A versão 1.9.1 contém estes commits.

Correções de bugs

  • Adição da plataforma de destino JS. (I2310b).
  • Atualização da versão do Kotlin para 1.9 (I1a14c)

Versão 1.9.0

16 de outubro de 2024

Lançamento de androidx.annotation:annotation-*:1.9.0. A versão 1.9.0 contém estes commits.

Mudanças importantes desde a versão 1.8.0

  • Adição de suporte aos seguintes destinos do Kotlin Multiplatform: watchosDeviceArm64, mingwX64, linuxArm64.

Versão 1.9.0-rc01

2 de outubro de 2024

Lançamento de androidx.annotation:annotation-*:1.9.0-rc01. A versão 1.9.0-rc01 não tem mudanças desde a versão Beta anterior.

Versão 1.9.0-beta01

18 de setembro de 2024

Lançamento de androidx.annotation:annotation-*:1.9.0-beta01. A versão 1.9.0-beta01 contém estes commits.

Mudanças na API

  • Adição de suporte à plataforma de destino watchosDeviceArm64 (I1cc04, b/364652024).

Versão 1.9.0-alpha03

4 de setembro de 2024

Lançamento de androidx.annotation:annotation-*:1.9.0-alpha03. A versão 1.9.0-alpha03 não tem mudanças desde a versão Alfa anterior.

Versão 1.9.0-alpha02

21 de agosto de 2024

Lançamento de androidx.annotation:annotation-*:1.9.0-alpha02. A versão 1.9.0-alpha02 contém estes commits.

Novos recursos

Versão 1.9.0-alpha01

26 de junho de 2024

Lançamento de androidx.annotation:annotation-*:1.9.0-alpha01. A versão 1.9.0-alpha01 contém estes commits.

Contribuição externa

  • Adiciona suporte para o destino multiplataforma linuxArm64 (agradecimentos a Jake Wharton).

Versão 1.8

Versão 1.8.2

7 de agosto de 2024

Lançamento de androidx.annotation:annotation-*:1.8.2. A versão 1.8.2 contém estes commits.

Correções de bugs

Versão 1.8.1

24 de julho de 2024

Lançamento de androidx.annotation:annotation-*:1.8.1. A versão 1.8.1 contém estes commits.

Correções de bugs

  • Inclui outros destinos do Kotlin Multiplatform: watchos, tvos.

Versão 1.8.0

14 de maio de 2024

Lançamento de androidx.annotation:annotation-*:1.8.0. A versão 1.8.0 contém estes commits.

Mudanças importantes desde a versão 1.7.0

  • Adição da anotação @ReplaceWith para expressar substituições de APIs descontinuadas
  • A anotação @MainThread foi movida para o conjunto de origem comum.

Versão 1.8.0-rc01

1º de maio de 2024

Lançamento de androidx.annotation:annotation-*:1.8.0-rc01. A versão 1.8.0-rc01 não tem mudanças desde a versão Beta anterior.

Versão 1.8.0-beta02

17 de abril de 2024

Lançamento de androidx.annotation:annotation-*:1.8.0-beta02. A versão 1.8.0-beta02 não tem mudanças desde a versão anterior.

Versão 1.8.0-beta01

3 de abril de 2024

Lançamento de androidx.annotation:annotation-*:1.8.0-beta01. A versão 1.8.0-beta01 contém estes commits.

Novos recursos

  • A anotação ReplaceWith agora é estável na API, mas a verificação de lint associada com correção automática ainda não foi lançada.

Versão 1.8.0-alpha02

20 de março de 2024

Lançamento de androidx.annotation:annotation-*:1.8.0-alpha02 sem mudanças importantes. A versão 1.8.0-alpha02 contém estes commits.

Versão 1.8.0-alpha01

21 de fevereiro de 2024

Lançamento de androidx.annotation:annotation-*:1.8.0-alpha01. A versão 1.8.0-alpha01 contém estas confirmações.

Mudanças na API

  • Adição da anotação @ReplaceWith para expressar substituições de APIs descontinuadas. (I38db3, b/322373864).

Contribuições externas

  • Agradecemos a Ivan Matkov por mover a anotação @MainThread para o conjunto de origem comum. (6f228c)

Versão 1.7

Versão 1.7.1

13 de dezembro de 2023

Lançamento de androidx.annotation:annotation-*:1.7.1. A versão 1.7.1 contém estas confirmações.

Correções de bugs

  • Use o escopo compile ao inserir a dependência padrão da plataforma. (I4958f).

Versão 1.7.0

6 de setembro de 2023

Lançamento de androidx.annotation:annotation-*:1.7.0. A versão 1.7.0 contém estas confirmações.

Mudanças importantes desde a versão 1.6.0

  • Inclui artefatos do Kotlin Multiplatform para plataformas iOS, Linux e MacOS.
  • Agora é possível usar anotações em projetos KMM. Os destinos não Android das anotações ainda estão em fase experimental, mas decidimos mesclar as versões para facilitar o teste pelos desenvolvedores. Especificamente, algumas anotações podem mudar entre código comum e específico da plataforma durante o desenvolvimento Alfa à medida que finalizamos os limites.

Versão 1.7.0-rc01

23 de agosto de 2023

Lançamento de androidx.annotation:annotation-*:1.7.0-rc01. A versão 1.7.0-rc01 contém estas confirmações.

Esta versão não contém mudanças em relação à versão Beta anterior.

Versão 1.7.0-beta01

9 de agosto de 2023

Lançamento de androidx.annotation:annotation-*:1.7.0-beta01. A versão 1.7.0-beta01 contém estas confirmações.

Novos recursos

  • APIs estabilizadas para lançamento

Versão 1.7.0-alpha03

26 de julho de 2023

Lançamento de androidx.annotation:annotation-*:1.7.0-alpha03. A versão 1.7.0-alpha03 contém estes commits.

Correções de bugs

  • A publicação do POM do Maven agora inclui o artefato multiplataforma padrão direcionado à JVM como dependência

Versão 1.7.0-alpha02

24 de março de 2023

Lançamento de androidx.annotation:annotation-*:1.7.0-alpha02.

Correções de bugs

  • As restrições de dependência foram removidas dos artefatos do Maven para contornar um problema de build em destinos nativos do Kotlin (b/274786186, KT-57531).

Versão 1.7.0-alpha01

22 de março de 2023

Lançamento de androidx.annotation:annotation-*:1.7.0-alpha01. A versão 1.7.0-alpha01 contém estas confirmações.

Novos recursos

  • Inclui artefatos do Kotlin Multiplatform para plataformas iOS, Linux e MacOS.
  • Agora é possível usar anotações em projetos KMM. Os destinos não Android das anotações ainda estão em fase experimental, mas decidimos mesclar as versões para facilitar o teste pelos desenvolvedores. Especificamente, algumas anotações podem mudar entre código comum e específico da plataforma durante o desenvolvimento Alfa à medida que finalizamos os limites.

Versão 1.6

Versão 1.6.0

22 de fevereiro de 2023

Lançamento de androidx.annotation:annotation:1.6.0 e androidx.annotation:annotation-jvm:1.6.0. A versão 1.6.0 contém estas confirmações.

Mudanças importantes desde a versão 1.5.0

  • Adiciona uma anotação @RequiresExtension para expressar que uma API exige uma versão específica de um SDK de extensão específico (I5e4fe).
  • Biblioteca de anotações convertida para build usando a cadeia de ferramentas do Kotlin Multiplatform (I3be8d)

Versão 1.6.0-rc01

8 de fevereiro de 2023

Lançamento de androidx.annotation:annotation:1.6.0-rc01 e androidx.annotation:annotation-jvm:1.6.0-rc01. A versão 1.6.0-rc01 contém estas confirmações.

  • A anotação foi estabilizada para o candidato a lançamento 1.6.0-rc01.

Versão 1.6.0-beta01

25 de janeiro de 2023

Lançamento de androidx.annotation:annotation:1.6.0-beta01 e androidx.annotation:annotation-jvm:1.6.0-beta01, sem mudanças desde 1.6.0-alpha01.

Versão 1.6.0-alpha01

11 de janeiro de 2023

Lançamento de androidx.annotation:annotation-*:1.6.0-alpha01. A versão 1.6.0-alpha01 contém estas confirmações.

Versão 1.6.0-dev01

8 de fevereiro de 2023

Lançamento de androidx.annotation:annotation-*:1.6.0-dev01. A versão 1.6.0-dev01 contém estas confirmações.

  • A anotação ativou o Kotlin Multiplatform para a prévia do desenvolvedor 1.6.0-dev01.

Novos recursos

  • Adiciona uma anotação @RequiresExtension para expressar que uma API exige uma versão específica de um SDK de extensão específico. (I5e4fe)
  • Biblioteca de anotações convertida para build usando a cadeia de ferramentas do Kotlin Multiplatform (I3be8d)

Versão 1.5.0

Versão 1.5.0

21 de setembro de 2022

Lançamento de androidx.annotation:annotation:1.5.0. A versão 1.5.0 contém estas confirmações.

Mudanças importantes desde a versão 1.4.0

  • A biblioteca de anotações foi totalmente migrada para fontes Kotlin, resultando em suporte para sites de uso de destino específicos do Kotlin e outros recursos de anotação compatíveis com Kotlin.

Versão 1.5.0-rc01

7 de setembro de 2022

Lançamento de androidx.annotation:annotation:1.5.0-rc01. A versão 1.5.0-rc01 contém estas confirmações.

  • Nenhuma mudança desde a versão Beta 1.5.0 anterior.

Versão 1.5.0-beta01

24 de agosto de 2022

Lançamento de androidx.annotation:annotation:1.5.0-beta01. A versão 1.5.0-beta01 contém estas confirmações.

  • Nenhuma mudança em relação à versão anterior. A superfície da API foi congelada para a versão Beta.

Versão 1.5.0-alpha02

10 de agosto de 2022

Lançamento de androidx.annotation:annotation:1.5.0-alpha02. A versão 1.5.0-alpha02 contém estas confirmações.

  • Nenhuma mudança desde a última versão Alfa.

Versão 1.5.0-alpha01

27 de julho de 2022

Lançamento de androidx.annotation:annotation:1.5.0-alpha01. A versão 1.5.0-alpha01 contém estas confirmações.

Novos recursos

  • A biblioteca de anotações foi totalmente migrada para fontes Kotlin, resultando em suporte para sites de uso de destino específicos do Kotlin e outros recursos de anotação compatíveis com Kotlin.

Versão 1.4.0

Versão 1.4.0

15 de junho de 2022

Lançamento de androidx.annotation:annotation:1.4.0. A versão 1.4.0 contém estas confirmações.

Mudanças importantes desde a versão 1.3.0

  • O @RestrictTo foi migrado para fontes Kotlin e agora oferece suporte ao site de uso do @file. Como resultado, a biblioteca Annotation agora depende da biblioteca padrão Kotlin.
  • @ReturnThis (b/140249763): garante que os métodos de substituição desse método retornem a mesma instância (destinada a builders etc.).
  • @OpenForTesting (b/141539024): as classes e os métodos Kotlin marcados como "abertos" podem ter essa anotação, e o lint vai garantir que essa classe tenha apenas uma subclasse (e métodos que só sejam substituídos) de testes de unidade.
  • @DeprecatedSinceApi (b/37116481): indica que o método, a classe ou o campo anotado faz parte de uma biblioteca de backport para uma API de plataforma, que não é mais necessária do nível de API fornecido em diante.
  • @EmptySuper: indica que esse método está definido como vazio, então ele não precisa ser chamado na substituição e, na verdade, você não deve fazer isso. Por exemplo, ele pode conter a verificação de compatibilidade com versões anteriores.

Versão 1.4.0-rc01

1º de junho de 2022

Lançamento de androidx.annotation:annotation:1.4.0-rc01. A versão 1.4.0-rc01 contém estas confirmações.

  • A superfície e a funcionalidade da API foram finalizadas para lançamento.

Versão 1.4.0-beta01

18 de maio de 2022

Lançamento de androidx.annotation:annotation:1.4.0-beta01. A versão 1.4.0-beta01 contém estas confirmações.

  • Nenhuma mudança desde a última versão Alfa. A plataforma da API foi bloqueada para a versão Beta.

Versão 1.4.0-alpha02

9 de fevereiro de 2022

Lançamento de androidx.annotation:annotation:1.4.0-alpha02. A versão 1.4.0-alpha02 contém estas confirmações.

Novos recursos

  • Adição das anotações @ReturnThis, @OpenForTesting, @EmptySuper e @DeprecatedSinceApi (21946a2).

  • @ReturnThis (b/140249763): garante que os métodos de substituição desse método retornem a mesma instância (destinada a builders etc.).

  • @OpenForTesting (b/141539024): as classes e os métodos Kotlin marcados como "abertos" podem ter essa anotação, e o lint vai garantir que essa classe tenha apenas uma subclasse (e métodos que só sejam substituídos) de testes de unidade.

  • @DeprecatedSinceApi (b/37116481): indica que o método, a classe ou o campo anotado faz parte de uma biblioteca de backport para uma API de plataforma, que não é mais necessária do nível de API fornecido em diante.

  • @EmptySuper: indica que esse método está definido como vazio, então ele não precisa ser chamado na substituição e, na verdade, você não deve fazer isso. Por exemplo, ele pode conter a verificação de compatibilidade com versões anteriores.

Versão 1.4.0-alpha01

15 de dezembro de 2021

Lançamento de androidx.annotation:annotation:1.4.0-alpha01. A versão 1.4.0-alpha01 contém estas confirmações.

Mudanças na API

  • Anotação RestrictTo migrada para origens Kotlin (Ia6336).

Versão 1.3.0

Versão 1.3.0

3 de novembro de 2021

Lançamento de androidx.annotation:annotation:1.3.0. A versão 1.3.0 contém estas confirmações.

Mudanças importantes desde a versão 1.2.0

  • A anotação @Discouraged para marcar APIs que não podem ser descontinuadas, mas têm impacto negativo significativo no desempenho e não podem ser chamadas no código de produção normal foi adicionada.
  • A anotação @Context foi adicionada para marcar contextos genéricos que os desenvolvedores podem migrar a novas APIs com mais facilidade.
  • A anotação @GravityInt para marcar elementos que contêm valores de gravidade em números inteiros foi adicionada.
  • O uso de @InspectableProperty foi suspenso em favor de @Attribute para androidx.resourceinspection.

Versão 1.3.0-rc01

27 de outubro de 2021

androidx.annotation:annotation:1.3.0-rc01 é lançado. A versão 1.3.0-rc01 contém estas confirmações.

Versão 1.3.0-beta01

29 de setembro de 2021

androidx.annotation:annotation:1.3.0-beta01 é lançado. A versão 1.3.0-beta01 contém estas confirmações.

Mudanças na API

  • Exige uma explicação em "mensagem" para a anotação @Discouraged (I3390f).
  • Adição da anotação @Discouraged para marcar elementos não recomendados (Ib2549).
  • A anotação RestrictTo fica visível no pop-up de documentos do Studio (Ie8e1a, b/183134648).

Correções de bugs

  • Adicione a anotação Context para marcar contextos genéricos. Assim, os desenvolvedores podem migrar para novas APIs com mais facilidade (Ie581a).

Versão 1.3.0-alpha01

24 de março de 2021

Lançamento de androidx.annotation:annotation:1.3.0-alpha01. A versão 1.3.0-alpha01 contém estas confirmações.

Mudanças na API

  • O uso de @InspectableProperty foi suspenso em favor do @Attribute em androidx.resourceinspection (Ic0eff).
  • Adição da anotação @GravityInt para marcar elementos que contêm valores de gravidade em números inteiros (Ifcaa4, b/180620048).

Annotation-Experimental versão 1.6

Versão 1.6.0-alpha01

22 de outubro de 2025

Lançamento de androidx.annotation:annotation-experimental:1.6.0-alpha01. A versão 1.6.0-alpha01 contém estes commits.

Mudanças na API

  • A anotação OptIn agora é compatível com o destino ElementType.PARAMETER.

Annotation-Experimental versão 1.5

Versão 1.5.1

16 de julho de 2025

Lançamento de androidx.annotation:annotation-experimental:1.5.1. A versão 1.5.1 contém estes commits.

Versão 1.5.0

7 de maio de 2025

Lançamento de androidx.annotation:annotation-experimental:1.5.0. A versão 1.5.0 contém estes commits.

Mudanças importantes desde a versão 1.4.0

  • Adição de message a RequiresOptIn para corresponder à anotação da biblioteca padrão do Kotlin com o valor padrão de string vazia. (I1f50e).
  • Essa biblioteca agora é destinada ao nível de linguagem Kotlin 2.0 e exige o KGP 2.0.0 ou mais recente. (Idb6b5).

Versão 1.5.0-rc01

23 de abril de 2025

Lançamento de androidx.annotation:annotation-experimental:1.5.0-rc01. A versão 1.5.0-rc01 não tem mudanças desde a versão Beta anterior. Consulte os commits.

Versão 1.5.0-beta01

9 de abril de 2025

Lançamento de androidx.annotation:annotation-experimental:1.5.0-beta01. A versão 1.5.0-beta01 contém estes commits.

Mudanças importantes

  • Essa biblioteca agora é destinada ao nível de linguagem Kotlin 2.0 e exige o KGP 2.0.0 ou mais recente (Idb6b5).

Versão 1.5.0-alpha01

21 de agosto de 2024

Lançamento de androidx.annotation:annotation-experimental:1.5.0-alpha01. A versão 1.5.0-alpha01 contém estes commits.

Mudanças na API

  • Adicione message a RequiresOptIn para corresponder à anotação da biblioteca padrão do Kotlin com o valor padrão de string vazia. (I1f50e).

Annotation-Experimental versão 1.4

Versão 1.4.1

3 de abril de 2024

Lançamento de androidx.annotation:annotation-experimental:1.4.1. A versão 1.4.1 contém estes commits.

Correções de bugs

  • Corrigido o uso de isKotlin para evitar o acionamento acidental da verificação RequiresOptIn em arquivos Kotlin. (I2d8c1f).

Versão 1.4.0

24 de janeiro de 2024

Lançamento de androidx.annotation:annotation-experimental:1.4.0. A versão 1.4.0 contém estas confirmações.

Mudanças importantes desde a versão 1.3.0

  • Adicionar suporte para Kotlin multiplataforma
  • Correção da compatibilidade com o Kotlin 2.0
  • Mostrar avisos para usos em Java de propriedades Kotlin anotadas experimentalmente (I8bd43).
  • Correção do posicionamento da anotação de correção automática em métodos Kotlin (Id7a41)

Versão 1.4.0-rc01

10 de janeiro de 2024

Lançamento de androidx.annotation:annotation-experimental:1.4.0-rc01. A versão 1.4.0-rc01 não tem mudanças desde a versão anterior.

Versão 1.4.0-beta01

13 de dezembro de 2023

Lançamento de androidx.annotation:annotation-experimental:1.4.0-beta01. Não houve mudanças desde a versão anterior.

Versão 1.4.0-alpha01

29 de novembro de 2023

Lançamento de androidx.annotation:annotation-experimental:1.4.0-alpha01. A versão 1.4.0-alpha01 contém estas confirmações.

Correções de bugs

  • Remova temporariamente as sugestões de correção automática no nível da classe para contornar b/301598518. (Id98b2).
  • Mostrar avisos para usos em Java de propriedades Kotlin anotadas experimentalmente (I8bd43).
  • Correção do posicionamento da anotação de correção automática em métodos Kotlin (Id7a41)

Versão 1.4.0-dev01

8 de fevereiro de 2023

Lançamento de androidx.annotation:annotation-experimental:1.4.0-dev01. A versão 1.4.0-dev01 contém estas confirmações.

  • A Annotation-experimental ativou o Kotlin multiplataforma para a prévia para desenvolvedores 1.4.0-dev01.

Annotation-Experimental versão 1.3.1

Versão 1.3.1

21 de junho de 2023

Lançamento de androidx.annotation:annotation-experimental:1.3.1. A versão 1.3.1 contém estas confirmações.

Correções de bugs

  • Coloque a anotação no início da lista de modificadores ao aplicar a correção automática do lint. (b/251172715).
  • Use a verificação de lint para desencorajar o uso de androidx.annotation.RequiresOptIn em fontes Kotlin (b/241097743).

Annotation-Experimental versão 1.3.0

Versão 1.3.0

7 de setembro de 2022

Lançamento de androidx.annotation:annotation-experimental:1.3.0. A versão 1.3.0 contém estas confirmações.

Mudanças importantes desde a versão 1.2.0

  • Adição de suporte para uso no nível do pacote de @androidx.annotation.OptIn (I24d58).
  • A dependência da biblioteca padrão do Kotlin foi movida para o tipo de API, em vez de apenas para compilação. Isso significa que todos os clientes da biblioteca Annotation-Experimental vão incluir a biblioteca padrão do Kotlin nas dependências transitivas.

Versão 1.3.0-rc01

24 de agosto de 2022

Lançamento de androidx.annotation:annotation-experimental:1.3.0-rc01. A versão 1.3.0-rc01 contém estas confirmações.

  • Nenhuma mudança em relação à versão anterior. A implementação foi congelada para o RC.

Versão 1.3.0-beta01

10 de agosto de 2022

Lançamento de androidx.annotation:annotation-experimental:1.3.0-beta01. A versão 1.3.0-beta01 contém estas confirmações.

  • Nenhuma mudança desde a versão Alfa. Essa biblioteca foi estabilizada para o lançamento da versão Beta.

Versão 1.3.0-alpha01

27 de julho de 2022

Lançamento de androidx.annotation:annotation-experimental:1.3.0-alpha01. A versão 1.3.0-alpha01 contém estas confirmações.

Mudanças na API

  • Adição de suporte para uso no nível do pacote de @androidx.annotation.OptIn (I24d58).

Annotation-Experimental versão 1.2.0

Versão 1.2.0

15 de dezembro de 2021

Lançamento de androidx.annotation:annotation-experimental:1.2.0. A versão 1.2.0 contém estas confirmações.

Mudanças importantes desde a 1.1.0

Esta biblioteca agora é destinada ao nível de linguagem Java 8.

Versão 1.2.0-rc01

1.º de dezembro de 2021

Lançamento de androidx.annotation:annotation-experimental:1.2.0-rc01. A versão 1.2.0-rc01 contém estas confirmações.

Nenhuma mudança desde a versão Beta.

Versão 1.2.0-beta01

17 de novembro de 2021

androidx.annotation:annotation-experimental:1.2.0-beta01 é lançado. A versão 1.2.0-beta01 contém estas confirmações.

Mudanças na API

As APIs foram finalizadas para a versão Beta.

Annotation-Experimental versão 1.2.0-alpha01

30 de junho de 2021

Lançamento de androidx.annotation:annotation-experimental:1.2.0-alpha01. A versão 1.2.0-alpha01 contém estas confirmações.

Novos recursos

  • A biblioteca agora é destinada ao nível de linguagem Java 8.

Versão 1.2.0

Versão 1.2.0

24 de março de 2021

Lançamento de androidx.annotation:annotation:1.2.0. A versão 1.2.0 contém estas confirmações.

Principais mudanças desde a versão 1.1.0

  • Adição da anotação @ChecksSdkIntAtLeast, que pode ser usada para identificar métodos ou campos usados para limitar o acesso no nível do SDK e atender à verificação de lint NewApi.
  • Adição da anotação @DoNotInline, que é pareada com uma regra do Proguard para evitar que os membros sejam colocados in-line durante a otimização.
  • Uma variedade de anotações agora são anotadas com @Documented para garantir que apareçam na documentação para membros anotados.

Versão 1.2.0-rc01

24 de fevereiro de 2021

Lançamento de androidx.annotation:annotation:1.2.0-rc01. A versão 1.2.0-rc01 contém estas confirmações.

Versão 1.2.0-beta01

13 de janeiro de 2021

Lançamento de androidx.annotation:annotation:1.2.0-beta01. A versão 1.2.0-beta01 contém estas confirmações.

Mudanças na API

  • Nova anotação @DoNotInline, que instrui os otimizadores de código (por exemplo, Proguard, R8) a não deixar in-line o método anotado (I3dfe8, b/141326133).

Versão 1.2.0-alpha01

14 de maio de 2020

androidx.annotation:annotation:1.2.0-alpha01 é lançado. A versão 1.2.0-alpha01 contém estas confirmações.

Novos recursos

  • Anotação @ChecksSdkIntAtLeast adicionada. Isso permite que o AndroidX e os usuários anotem métodos e campos que representam uma verificação SDK_INT. (I89a54, b/120255046)

Annotation-Experimental: versão 1.1.0

Versão 1.1.0

7 de abril de 2021

Lançamento de androidx.annotation:annotation-experimental:1.1.0. A versão 1.1.0 contém estas confirmações.

Principais mudanças desde a versão 1.0.0

  • As anotações experimentais do Jetpack foram reescritas em Kotlin para oferecer compatibilidade com várias classes de marcador e melhoria no tratamento da suspensão de uso.
  • As anotações RequiresOptIn e OptIn foram adicionadas para paridade com o Kotlin, e o uso das anotações Experimental e UsesExperimental foi suspenso.

Versão 1.1.0-rc02

24 de março de 2021

Lançamento de androidx.annotation:annotation-experimental:1.1.0-rc02. A versão 1.1.0-rc02 contém estas confirmações.

Correções de bugs

  • Inclusão de regras do Proguard para garantir que a otimização do código não avise sobre as meta anotações ausentes do Kotlin.

Versão 1.1.0-rc01

10 de Março de 2021

Lançamento de androidx.annotation:annotation-experimental:1.1.0-rc01. A versão 1.1.0-rc01 contém estas confirmações.

Nenhuma mudança desde a versão Beta anterior.

Versão 1.1.0-beta01

27 de janeiro de 2021

Lançamento do androidx.annotation:annotation-experimental:1.1.0-beta01. A versão 1.1.0-beta01 contém estas confirmações.

Mudanças na API

  • A variante androidx da anotação Experimental foi suspensa para fornecer paridade com o Kotlin. Ela foi substituída por uma variante androidx da anotação RequiresOptIn, e a inspeção para Java foi atualizada para oferecer compatibilidade com as novas anotações do Kotlin e da nova AndroidX (I52495, b/151331381).

Versão 1.1.0-alpha01

22 de julho de 2020

androidx.annotation:annotation-experimental:1.1.0-alpha01 é lançado. A versão 1.1.0-alpha01 contém estas confirmações.

Novos recursos

  • A biblioteca de anotações Experimental agora está escrita em Kotlin, mas não exige que a biblioteca Kotlin padrão seja incluída como uma dependência. Ela inclui um arquivo do Proguard que permite a remoção de metadados Kotlin desnecessários de projetos que usam apenas a linguagem de programação Java.
  • @UseExperimental agora é compatível com várias classes de marcador (aosp/1185577, b/145137892).

Annotation-Experimental Versão 1.0.0

Annotation-Experimental Versão 1.0.0

7 de novembro de 2019

Lançamento de androidx.annotation:annotation-experimental:1.0.0 e androidx.annotation:annotation-experimental-lint:1.0.0, sem alterações desde 1.0.0-rc01. A versão 1.0.0 contém essas confirmações (link em inglês).

Principais recursos da versão 1.0.0

  • Aplicação baseada em lint da semântica @Experimental do Kotlin no código-fonte Java
  • Anotações Java que fornecem comportamento equivalente às annotations @Experimental e @UseExperimental do Kotlin, sem a necessidade de uma dependência em Kotlin

Annotation-Experimental Versão 1.0.0-rc01

23 de outubro de 2019

Lançamento de androidx.annotation:annotation-experimental:1.0.0-rc01 e androidx.annotation:annotation-experimental-lint:1.0.0-rc01. A versão 1.0.0-rc01 contém essas confirmações (link em inglês).

Problemas conhecidos

Ao usar a versão estável do Studio 3.5, os avisos do detector lint de uso @Experimental não são exibidos no ambiente de desenvolvimento integrado para usos inválidos do Java de anotação Kotlin @Experimental. Consulte b/140640322 (link em inglês).

Annotation-Experimental Versão 1.0.0-beta01

9 de outubro de 2019

Lançamento de androidx.annotation:annotation-experimental:1.0.0-beta01 e androidx.annotation:annotation-experimental-lint:1.0.0-beta01, sem alterações desde 1.0.0-alpha01. A versão 1.0.0-beta01 contém essas confirmações (link em inglês).

Annotation-Experimental Versão 1.0.0-alpha01

18 de setembro de 2019

Lançamento de androidx.annotation:annotation-experimental:1.0.0-alpha01 e androidx.annotation:annotation-experimental-lint:1.0.0-alpha01. Essas são as confirmações incluídas no annotation-experimental 1.0.0-alpha01, e essas são as confirmações incluídas no annotation-experimental-lint 1.0.0-alpha01.

Novos recursos

  • A biblioteca de anotações Jetpack Experimental fornece uma implementação compatível com Java de marcadores de API experimentais (link em inglês) de Kotlin. O artefato -lint fornece uma implementação baseada em Lint de restrições de uso experimentais e impõe restrições no uso de Java dos marcadores de API nativos experimentais de Kotlin.

  • Ao usar o artefato annotation-experimental como uma dependência, as regras de Lint fornecidas pelo artefato annotation-experimental-lint serão aplicadas automaticamente.

Versão 1.1.0

Versão 1.1.0

5 de junho de 2019

androidx.annotation:annotation:1.1.0 é lançado sem mudanças desde 1.0.0-rc01.

Versão 1.1.0-rc01

7 de maio de 2019

Lançamento do androidx.annotation:annotation:1.1.0-rc01 sem alterações do 1.1.0-beta01. As confirmações incluídas nessa versão podem ser encontradas aqui (link em inglês).

Versão 1.1.0-beta01

3 de abril de 2019

androidx.annotation:annotation:1.1.0-beta01 é lançado. As confirmações incluídas nessa versão podem ser encontradas aqui (link em inglês).

Novos recursos

  • Nova anotação @InspectableProperty para oferecer compatibilidade com as novas APIs de inspeção de visualização adicionadas no Android 10. Essa anotação pode ser aplicada a getters em visualizações ou outros elementos de IU. As ferramentas de geração de código podem usá-la para criar objetos complementares que mapeiam nomes de propriedades e atribuem códigos a valores de propriedades sem a sobrecarga de reflexão.

Mudanças na API

  • Mudança importante: @ContentView foi alterado para uma anotação do construtor, e o valor @LayoutRes foi removido. As classes que querem oferecer compatibilidade com anotações @ContentView precisam adicionar essa anotação a um construtor que usa um parâmetro @LayoutRes int. Isso corrige um problema ao usar essa anotação nos módulos da biblioteca. (b/128352521, link em inglês)

Versão 1.1.0-alpha02

13 de março de 2019

androidx.annotation:annotation:1.1.0-alpha02 é lançado. A lista completa de confirmações incluídas nessa versão pode ser encontrada neste link.

Novos recursos

  • Novo escopo de restrição da API: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. Ele restringe o uso ao código em pacotes cujos grupos compartilham o mesmo prefixo do grupo de bibliotecas até o último . (ponto final). Por exemplo, como as bibliotecas foo.bar:lib1 e foo.baz:lib2 compartilham o prefixo foo, elas podem usar as APIs uma da outra que estão restritas a esse escopo. Da mesma forma, com.foo.bar:lib1 e com.foo.baz:lib2 compartilham o prefixo com.foo. e podem compartilhar APIs restritas a esse escopo. No entanto, a biblioteca com.bar.qux:lib3 não poderá usar a API restrita porque ela compartilha apenas o prefixo com., e não todos até o último . (ponto final).

Versão 1.1.0-alpha01

30 de janeiro de 2019

Lançamento do androidx.annotation:annotation 1.1.0-alpha01.

Novos recursos

  • Adicionada uma anotação @ContentView que permite indicar qual arquivo XML de layout será inflado. Essa opção é compatível com ComponentActivity na versão 1.0.0-alpha04 e com o Fragment na versão 1.1.0-alpha04, como alternativa ao uso de setContentView()ou à substituição de onCreateView(), respectivamente. (aosp/837619, link em inglês)

Versão 1.0.2

Versão 1.0.2

25 de fevereiro de 2019

Lançamento do androidx.annotation:annotation 1.0.2.

Correções de bugs

  • Correção das regras do R8/ProGuard incorporadas no jar. Elas faziam referência incorreta aos tipos android.support.annotation antigos em vez de androidx.annotation. Observação: isso só teria afetado suas compilações se você não estivesse usando getDefaultProguardFile, uma vez que essas regras padrão também incluíam as regras corretas para os dois pacotes. (aosp/891685).
  • Adição de uma regra do R8/ProGuard que mantém explicitamente a própria anotação @Keep. Isso garante que o ProGuard não remova a anotação dos tipos antes de realmente respeitar a semântica relacionada. Observação: isso só teria afetado suas compilações se você não estivesse usando getDefaultProguardFile, uma vez que essas regras padrão também incluíam as regras corretas para os dois pacotes. (aosp/903818, link em inglês)