Android Jetpack 入门

Jetpack 包含一系列 Android 库，这些库结合了最佳实践并在您的 Android 应用中提供向后兼容性。

该 Jetpack 应用架构指南 提供了构建 Android 应用时应考虑的最佳实践和推荐架构的概述。

以下部分介绍了如何开始使用 Jetpack 组件。

在您的应用中使用 Jetpack 库

所有 Jetpack 组件都可以在 Google Maven 存储库 中找到。

打开 settings.gradle 文件，在 dependencyResolutionManagement { repositories {...}} 块中添加 google() 存储库，如下所示

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 组件（例如，LiveData 和 ViewModel 等架构组件），如下所示

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-ktx 和 lifecycle-viewmodel-ktx。KTX 扩展建立在基于 Java 的 API 之上，利用 Kotlin 特定的语言特性。

要了解新的 Jetpack 库版本，请查看 版本 页面。

基于 Kotlin 的 和 基于 Java 的 API 参考页面可用于所有 Jetpack 库。

验证 Jetpack 依赖项（可选）

截至 2023 年 6 月，Jetpack 团队对 Jetpack 库进行签名。这些签名允许开发人员验证库工件是否由 Google 构建和签名。库在发布更新后即可进行签名验证。

如果您的 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.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 用于满足您的后台调度需求。
  • Room 用于数据存储持久性。
  • 导航 用于管理您的应用导航流程。
  • CameraX 用于满足您的相机应用需求。
  • 请参阅所有 Jetpack 库的 概述。

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

要详细了解如何使用 Jetpack，请查看以下页面

其他资源

在线培训

示例代码

  • 该 Sunflower 演示应用使用了许多不同的 Jetpack 组件来演示 Android 开发最佳实践。

Codelabs

视频