Android项目采用libs依赖格式时，如何添加GIF支持？

核心原因 #

你当前用的是**Gradle版本目录（Version Catalog）**管理依赖（即libs.xxx的引用方式），不能直接在build.gradle.kts里写硬编码的依赖字符串，必须先在版本目录文件中配置，再通过libs引用。

解决步骤 #

1. 配置版本目录文件 #

找到项目根目录下的gradle/libs.versions.toml文件，按以下方式修改：

[versions]
# 新增版本号定义
gifDrawable = "1.2.22"

[libraries]
# 新增依赖条目
gif-drawable = { module = "pl.droidsonroids.gif:android-gif-drawable", version.ref = "gifDrawable" }

2. 在build.gradle.kts中引用依赖 #

修改模块下的build.gradle.kts的dependencies块，添加引用：

dependencies {
    implementation(libs.appcompat)
    implementation(libs.material)
    implementation(libs.activity)
    implementation(libs.constraintlayout)
    // 新增GIF依赖
    implementation(libs.gif.drawable)
    testImplementation(libs.junit)
    androidTestImplementation(libs.ext.junit)
    androidTestImplementation(libs.espresso.core)
}

3. 检查仓库配置（若仍失败） #

确保项目根目录的settings.gradle.kts中，dependencyResolutionManagement块已经包含mavenCentral()仓库，因为该依赖托管在Maven Central：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral() // 必须存在这一行
    }
}

4. 同步项目 #

点击Android Studio右上角的Sync Project with Gradle Files按钮，完成依赖同步。

内容的提问来源于stack exchange，提问作者mikawaii