Как добавить компоненты в проект

Прежде чем начать, ознакомьтесь с руководством по архитектуре приложений. В нем вы найдете полезные принципы, применимые ко всем приложениям Android, и инструкции по совместному использованию компонентов архитектуры.

Компоненты архитектуры доступны в репозитории Google Maven. Чтобы использовать их, добавьте хранилище в проект.

Откройте файл settings.gradle и добавьте репозиторий google():

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

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

Объявление зависимостей

Откройте файл build.gradle для приложения или модуля и добавьте нужные артефакты в качестве зависимостей. Вы можете добавить зависимости для всех компонентов архитектуры или выбрать подмножество.

Инструкции по объявлению зависимостей для каждого компонента архитектуры приведены в примечаниях к выпуску:

• Futures (в androidx.concurrent)
• Lifecycle (включая ViewModel)
• Навигация (включая SafeArgs)
• Разбивка на страницы
• Комната
• WorkManager

Актуальные номера версий для каждого компонента можно найти в примечаниях к выпускам AndroidX.

Подробнее о рефакторинге AndroidX и о том, как он влияет на эти пакеты классов и идентификаторы модулей, рассказывается в статье Переход на AndroidX.

Kotlin

Модули расширения Kotlin поддерживаются для нескольких зависимостей AndroidX. К названиям таких модулей добавляется суффикс -ktx. Пример:

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

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

Результат:

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

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

Дополнительную информацию, в том числе документацию по расширениям Kotlin, можно найти в документации по KTX.

Примечание. В приложениях на Kotlin используйте kapt вместо annotationProcessor. Также необходимо добавить плагин kotlin-kapt.