在开始之前,我们建议您先阅读这篇应用架构指南。该指南提及了一些对任何应用都有意义的原则,并且展示了应该如何把架构组件整合起来。
Android 架构组件可以从 Google 的 Maven 仓库中获取,要使用组件,您必须将仓库添加到项目中。
打开您的项目(而非您的应用或模块)的 build.gradle
文件,然后添加 google()
仓库,如下所示:
allprojects {
repositories {
google()
jcenter()
}
}
打开您的应用或模块的 build.gradle
文件,然后添加您需要依赖的 artifact。您可以添加所有架构组件的全部依赖,或者只添加其中的一部分。
请参阅发行日志中有关为每个组件声明依赖关系的说明:
- WorkManager:后台任务管理
- Navigation(包含 SafeArgs):导航
- Paging:分页
- Lifecycle components(包含 ViewModel):生命周期组件
- Futures (在 androidx.concurrent 包中):并发
- Room(此项为译者补充):数据持久化
欲了解有关 AndroidX 重构的更多细节、以及它会如何影响包和模块的 ID,请参阅 AndroidX 重构。
几个 AndroidX 依赖项已支持 Kotlin 扩展模块。 这些模块的名称后面附加了后缀 “-ktx”。 例如:
implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version"
变成
implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"
欲了解包括 Kotlin 扩展的更多信息,请参阅 Android KTX。
注意:请务必在基于 Kotlin 的应用中使用 kapt 而非 annotationProcessor。此外,您还应该添加 kotlin-kapt 插件。