Versões do AndroidX

As bibliotecas do Jetpack são enviadas separadamente do SO Android. Por isso, as atualizações nas bibliotecas podem ocorrer de forma independente e com mais frequência.

As bibliotecas seguem versões semânticas estritas para compatibilidade binária com uma sequência de versões inversas de revisões de pré-lançamento. Uma string de versão (como 1.0.1-beta02) contém três números que representam os níveis principal, secundário e de correção de bugs. As versões de pré-lançamento também têm um sufixo que especifica o estágio de pré-lançamento (Alfa, Beta, candidato a lançamento) e o número da revisão (01, 02 e assim por diante).

Observação: é recomendável, mas não obrigatório, que as bibliotecas androidx preservem a compatibilidade de origem em versões secundárias. O motivo é que uma atualização da versão principal força todos os artefatos que dependem da anterior a serem explicitamente migrados, o que interrompe o fluxo de trabalho dos desenvolvedores.

Cada versão de uma biblioteca passa por três estágios de pré-lançamento para se tornar uma versão estável. Os critérios para cada estágio de pré-lançamento são:

Alfa

• As versões Alfa são funcionalmente estáveis, mas podem não ter todos os recursos.
• Enquanto uma versão está no estágio Alfa, é possível que APIs sejam adicionadas, removidas ou alteradas.

Beta

• As versões Beta são funcionalmente estáveis e têm uma superfície de API com todos os recursos.
• Elas estão prontas para uso em produção, mas podem conter bugs.
• Uma versão Beta não pode usar os recursos experimentais do compilador (como @UseExperimental).
• As dependências de outras bibliotecas precisam ser versões Beta, RC ou estáveis. Nenhuma dependência Alfa é permitida.

Candidata a lançamento (RC, na sigla em inglês)

• Uma candidata a lançamento é uma possível versão estável.
• Ele pode conter correções fundamentais de última hora.
• A superfície da API é final.
• As dependências de outras bibliotecas precisam ser apenas versões RC ou estáveis.

Uma biblioteca pode ter várias versões simultaneamente. Cada versão tem um estágio de lançamento diferente. Por exemplo, embora a versão estável de androidx.activity possa ser 1.0.0, também pode haver uma versão 1.1.0-beta02 e uma versão 2.0.0-alpha01.

Use esta página para saber mais sobre as atualizações mais recentes das bibliotecas.

A página de notas das versões recentes do AndroidX lista as bibliotecas que foram alteradas recentemente. O repositório Maven do Google mostra o histórico completo de versões.

Use a tabela abaixo para ver as versões estáveis e de pré-lançamento mais recentes de todas as bibliotecas do AndroidX. Os links em cada linha encaminham para as notas da versão da biblioteca. Nas notas da versão, você vai encontrar:

• Histórico cronológico de todas as versões
• Snippet de código com as declarações de dependência padrão do Gradle para usar os artefatos
• Links para as páginas de referência do Kotlin e do Java para os pacotes em cada artefato

Upgrade any library versions in my project that are out of date. Use the latest stable version of any libraries. Inform me if there's any libraries that are likely to be incompatible, and if there are any other changes to code I need to make in my project caused by upgrading to these new versions.

Bibliotecas Jetpack

Algumas bibliotecas do AndroidX, como a câmera, têm vários artefatos que são mantidos separadamente. Essas bibliotecas são marcadas com um asterisco (*). Consulte as notas da versão para ver as atualizações de versão de todos os artefatos.

(*) Esta biblioteca tem vários artefatos. Consulte as notas da versão para mais informações.
Última atualização: 13 de novembro de 2024