Como adicionar componentes ao seu projeto

Antes de começar, recomendamos a leitura do Guia para a arquitetura do app dos Componentes de arquitetura. O guia traz alguns princípios úteis que se aplicam a todos os apps Android e mostra como usar os Componentes de Arquitetura juntos.

Os Componentes de arquitetura estão disponíveis no repositório Maven do Google. Para usá-los, você precisa adicionar o repositório ao seu projeto.

Abra o arquivo settings.gradle e adicione o repositório google(), conforme mostrado abaixo:

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)
• Componentes do ciclo de vida (incluindo ViewModel)
• Navigation (incluindo SafeArgs)
• Paging
• Room
• WorkManager

Acesse as versões do AndroidX para ver 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 a documentação de refatoração do AndroidX.

Kotlin

Os módulos de extensão Kotlin são compatíveis com várias dependências do AndroidX. Esses módulos têm o sufixo “-ktx” anexado aos nomes. 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.