1. 确保项目已启用 AndroidX
RecyclerView
的现代版本属于 AndroidX 库,需确保项目已启用 AndroidX:
- 在
gradle.properties
中应有以下配置(通常新建项目默认开启):android.useAndroidX=true android.enableJetifier=true
2. 添加依赖
在 模块级 构建文件(通常是 app/build.gradle
或 app/build.gradle.kts
)中添加 RecyclerView
依赖:
对于 Groovy 语法(build.gradle
):
dependencies {
// 最新版本可在 Google Maven 查找:https://maven.google.com/web/index.html?q=recyclerview
implementation 'androidx.recyclerview:recyclerview:1.3.2'
// 可选:如果需要使用 RecyclerView的选择功能(如单选/多选)
implementation 'androidx.recyclerview:recyclerview-selection:1.1.0'
}
对于 Kotlin 语法(build.gradle.kts
):
dependencies {
// 最新版本同上
implementation("androidx.recyclerview:recyclerview:1.3.2")
// 可选:选择功能依赖
implementation("androidx.recyclerview:recyclerview-selection:1.1.0")
}
对于使用了版本目录的 Kotlin 语法(build.gradle.kts
):
1. 首先在版本目录中定义RecyclerView版本
打开项目的版本目录文件(通常是 gradle/libs.versions.toml
),添加RecyclerView的版本定义:
RecyclerView的最新版本可以在Google Maven仓库查询获取。
[versions]
# 其他版本...
recyclerview = "1.3.2" # 可替换为最新版本
[libraries]
# 其他库...
androidx-recyclerview = { group = "androidx.recyclerview", name = "recyclerview", version.ref = "recyclerview" }
2. 在依赖中添加RecyclerView引用
在你提供的依赖块中添加RecyclerView依赖:
dependencies {
// 添加RecyclerView依赖
implementation(libs.androidx.recyclerview)
// 可选:如果需要使用选择功能
implementation(libs.androidx.recyclerview.selection)
}
3. 同步项目
添加依赖后,点击 Android Studio 工具栏中的 Sync Now 按钮,或执行 File > Sync Project with Gradle Files,完成依赖下载和配置。