Начало работы с Android Jetpack

Jetpack включает в себя коллекцию библиотек Android, которые включают в себя лучшие практики и обеспечивают обратную совместимость в ваших приложениях Android.

Руководство Jetpack по архитектуре приложений содержит обзор лучших практик и рекомендуемой архитектуры, которые следует учитывать при создании приложения для Android.

В следующих разделах описано, как начать использовать компоненты Jetpack.

Используйте библиотеку Jetpack в своем приложении.

Все компоненты Jetpack доступны в репозитории Google Maven .

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

классный

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        jcenter()
    }
}

Котлин

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        jcenter()
    }
}

Затем вы можете добавить компоненты Jetpack, такие как компоненты архитектуры, такие как LiveData и ViewModel , в файл build.gradle вашего модуля, как показано здесь:

классный

dependencies {
    def lifecycle_version = "2.2.0"

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

Котлин

dependencies {
    val lifecycle_version = "2.2.0"

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

Многие библиотеки Jetpack предоставляют расширения Android KTX , как показано выше, с помощью lifecycle-livedata-ktx и lifecycle-viewmodel-ktx . Расширения KTX основаны на API на основе Java и используют преимущества языка, специфичные для Kotlin.

Чтобы узнать о новых выпусках библиотеки Jetpack, посетите страницу «Релизы» .

Справочные страницы API на основе Kotlin и Java доступны для всех библиотек Jetpack.

Проверьте зависимости Jetpack (необязательно)

По состоянию на июнь 2023 года команда Jetpack подписывает библиотеки Jetpack. Эти подписи позволяют разработчикам проверять, что артефакты библиотеки созданы и подписаны Google. Библиотека имеет право на проверку подписи после публикации обновления.

Если в вашем проекте Android включена проверка подписи, выполните следующие действия, чтобы проверить зависимости Jetpack в проекте Gradle:

  1. Добавьте доверенные ключи Google в раздел <trusted-keys> в $PROJECT_ROOT/gradle/verification-metadata.xml :

    <trusted-keys>
        <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b">
            ...
        </trusted-key>
        <trusted-key id="a5f483cd733a4ebaea378b2ae88979fb9b30acf2">
            ...
        </trusted-key>
        ...
    </trusted-keys>
    
  2. Добавьте запись <trusting group> для каждой библиотеки, которую использует проект. Вот пример библиотек androidx.fragment и androidx.emoji2 :

    <trusted-keys>
        <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b">
            <trusting group="androidx.fragment"/>
            <trusting group="androidx.emoji2"/>
        </trusted-key>
        <trusted-key id="a5f483cd733a4ebaea378b2ae88979fb9b30acf2">
            <trusting group="androidx.fragment"/>
            <trusting group="androidx.emoji2"/>
        </trusted-key>
        ...
    </trusted-keys>
    

При возникновении проблем с проверкой зависимостей посетите руководство Gradle по устранению неполадок с проверкой зависимостей .

Наконец, подробную информацию о нашем доверенном ключе можно просмотреть на сайте сервера ключей Ubuntu .

Воспользуйтесь преимуществом Jetpack

Библиотеки Jetpack можно использовать отдельно или в сочетании для удовлетворения различных потребностей ваших приложений.

  • WorkManager для фонового планирования.
  • Место для постоянного хранения данных.
  • Навигация для управления потоком навигации вашего приложения.
  • CameraX для нужд вашего приложения камеры.
  • См. Обзор всех библиотек Jetpack.

Библиотеки Jetpack публикуются в пространстве имен androidx . Если ваш проект в настоящее время использует библиотеку поддержки Android, прочитайте, как перейти на пространство имен androidx .

Чтобы узнать больше об использовании Jetpack, посетите эти страницы:

Дополнительные ресурсы

Онлайн обучение

Пример кода

  • Демо-приложение Sunflower использует множество различных компонентов Jetpack для демонстрации передового опыта разработки под Android.

Кодлабы

Видео