向项目中添加组件

问题跟踪器

请报告问题，以便我们修复 bug。

在开始之前，请先阅读应用架构指南，了解适用于所有 Android 应用的实用原则，以及有关搭配使用架构组件的指南。

架构组件可从 Google 的 Maven 制品库中获得。如需使用这些组件，请将该制品库添加到项目中。

打开 settings.gradle 文件并添加 google() 库：

Groovy

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

Kotlin

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

警告：从 2021 年 3 月 31 日起，JCenter 库处于只读状态。如需了解详情，请参阅 JCenter 服务更新。

声明依赖项

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

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

• Futures（可在 androidx.concurrent 中找到）
• Lifecycle（包括 ViewModel）
• Navigation（包括 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 插件。