Adicionar componentes ao projeto

Antes de começar, leia o Guia para a arquitetura do app e confira princípios úteis que se aplicam a todos os apps Android, assim como orientações para usar os componentes de arquitetura juntos.

Esses componentes estão disponíveis no repositório Maven do Google. Para usá-los, adicione o repositório ao seu projeto.

Abra o arquivo settings.gradle e adicione o repositório google():

dependencyResolutionManagement {
   ...
    repositories {
        google()
        jcenter()
    }
}

dependencyResolutionManagement {
    ...
    repositories {
        google()
        jcenter()
    }
}

Declarar dependências

Abra o arquivo build.gradle do seu app ou módulo e adicione os artefatos necessários como dependências. Você pode adicionar dependências para todos os componentes de arquitetura ou escolher um subconjunto.

Consulte as instruções para declarar dependências para cada componente de arquitetura nas notas da versão:

• Futures (encontrado em androidx.concurrent)
• Lifecycle (incluindo o ViewModel)
• Navigation (incluindo SafeArgs)
• Paging
• Room
• WorkManager

Acesse as versões do AndroidX para consultar os números de versão mais atualizados de cada componente.

Para mais informações sobre a refatoração do AndroidX e como ela afeta esses pacotes de classes e IDs de módulo, consulte Migrar para o AndroidX.

Kotlin

Os módulos de extensão Kotlin têm suporte em várias dependências do AndroidX. Esses módulos têm o sufixo -ktx anexado aos nomes. Por exemplo:

implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version"

implementation("androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version")

se torna

implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"

implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")

Mais informações, incluindo documentos para extensões Kotlin, podem ser encontradas na documentação KTX.

Observação: para apps baseados em Kotlin, use kapt em vez de annotationProcessor. Adicione também o plug-in kotlin-kapt.