Android Jetpack 使用入门

Jetpack 包含一系列 Android 库,它们都采用最佳做法并在 Android 应用中提供向后兼容性。

Jetpack 应用架构指南概述了构建 Android 应用时要考虑的最佳做法和推荐架构。

下文介绍了如何开始使用 Jetpack 组件。

在应用中使用 Jetpack 库

所有 Jetpack 组件都可在 Google Maven 代码库中找到。

打开 settings.gradle 文件,将 google() 代码库添加到 dependencyResolutionManagement { repositories {...}} 块中,如下所示:

Groovy

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

Kotlin

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

然后,您可以在模块的 build.gradle 文件中添加 Jetpack 组件(例如 LiveDataViewModel 等架构组件),如下所示:

Groovy

dependencies {
    def lifecycle_version = "2.2.0"

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

Kotlin

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-ktxlifecycle-viewmodel-ktx 所示。KTX 扩展在基于 Java 的 API 基础上构建,充分利用了 Kotlin 特有的语言功能。

如需了解新的 Jetpack 库版本,请查看版本页面。

基于 Kotlin 以及基于 Java 的 API 参考文档页面适用于所有 Jetpack 库。

验证 Jetpack 依赖项(可选)

自 2023 年 6 月起,Jetpack 团队已签署 Jetpack 库。这些 通过签名,开发者可以验证库制品是否已构建, 签名。库在经过签名验证后, 发布更新。

如果您的 Android 项目启用了签名验证,请按以下步骤操作 在 Gradle 项目中验证 Jetpack 依赖项:

  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.fragmentandroidx.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 的 Keyserver 网站

利用 Jetpack

Jetpack 库可以单独使用,也可以组合使用,以满足应用的不同需求。

  • WorkManager - 满足您的后台调度需求。
  • Room - 实现数据存储持久性。
  • Navigation - 管理应用导航流程。
  • CameraX - 满足相机应用需求。
  • 请参阅所有 Jetpack 库的概览

Jetpack 库在 androidx 命名空间中发布。如果项目目前使用 Android 支持库,请阅读如何迁移到 androidx 命名空间

如需详细了解如何使用 Jetpack,请查看以下页面:

其他资源

在线培训

示例代码

  • Sunflower 这个演示应用使用许多不同的 Jetpack 组件来演示 Android 开发的最佳做法。

Codelab

视频