向项目添加组件

问题跟踪器

报告问题，以便我们可以修复错误。

在开始之前，我们建议您先阅读架构组件的应用架构指南。该指南包含一些适用于所有 Android 应用的有用原则，并展示了如何将架构组件组合到一起使用。

架构组件可从 Google 的 Maven 代码库中获得。为了使用这些组件，您必须将代码库添加到项目中。

打开 settings.gradle 文件并添加 google() 代码库，如下所示：

Groovy

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

Kotlin

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

警告：JCenter 代码库已于 2021 年 3 月 31 日变为只读代码库。如需了解详情，请参阅 JCenter 服务更新。

声明依赖项

打开应用或模块的 build.gradle 文件，然后添加所需的软件工件作为依赖项。您可以为所有架构组件添加依赖项，也可以选择其中一部分。

请参阅版本说明中关于为每个架构组件声明依赖项的说明：

• Futures（可在 androidx.concurrent 中找到）
• 生命周期组件（包括 ViewModel）
• 导航（包括 SafeArgs）
• Paging
• Room
• WorkManager

如需了解每个组件的最新版本号，请参阅 AndroidX 版本。

如需详细了解 AndroidX 重构及其对这些类软件包和模块 ID 的影响，请参阅 AndroidX 重构文档。

Kotlin

Kotlin 扩展模块支持使用多个 AndroidX 依赖项。这些模块的名称后附加了后缀“-ktx”。例如：

Groovy

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

Kotlin

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

会变为

Groovy

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

Kotlin

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

您可以在 KTX 文档中找到更多信息，包括 Kotlin 扩展程序的文档。

注意：对于基于 Kotlin 的应用，请确保使用 kapt 而不是 annotationProcessor。您还应添加 kotlin-kapt 插件。