如何修改 build.gradle 以实现 Snackbar 并解决依赖解析失败？

2026-11-04排障赵师傅

先删除 implementation 'com.google.android.material:snackbar:1.0.0'，保留 com.google.android.material:material，并确认应用依赖使用的仓库中已配置 google()。

Snackbar 已包含在 Material Components 库中。com.google.android.material.snackbar 是 Java 包名，没有对应的独立依赖 com.google.android.material:snackbar:1.0.0。

1. 修改 app 模块的 build.gradle

将原来的两行依赖改为：

dependencies {
    implementation 'com.google.android.material:material:1.0.0'
}

这与 Material Components 的依赖声明方式一致。

这里沿用问题中的 1.0.0，便于先修正依赖坐标，并非推荐新项目使用该版本。如果要升级，还需要检查所选版本对 compileSdk、minSdk、Android Gradle Plugin 等的要求。

2. 确认 Google Maven 仓库配置正确

仓库的配置位置取决于项目结构。以下示例均为 Groovy DSL，请合并到已有配置中，不要覆盖整个文件。

在 settings.gradle 中统一管理仓库的项目

如果项目已有 dependencyResolutionManagement，检查其中的 repositories：

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}

保留已有的 repositoriesMode 等配置。如果项目设置了 FAIL_ON_PROJECT_REPOS，就在这里配置仓库，不要再向模块的 build.gradle 添加 repositories。

pluginManagement.repositories 用于解析 Gradle 插件，应用中的 implementation 依赖则需要配置依赖仓库。相关规则见 Gradle 仓库配置文档。

使用旧式仓库配置的项目

如果项目没有上述集中管理配置，通常可以检查项目根目录 build.gradle 中的配置：

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

Material Components 通过 Google Maven 仓库发布，因此需要配置 google()。只在 buildscript.repositories 中添加它，不能替代应用依赖所需的仓库配置。

3. 重新同步，并查看具体失败原因

修改后执行 Gradle Sync，再重新构建。也可以在项目根目录运行：

./gradlew :app:assembleDebug --stacktrace --info

Windows 下可使用 gradlew.bat。

题目中的报错：

Could not resolve all files for configuration ':app:debugRuntimeClasspath'

是运行时依赖解析失败的汇总信息，仅凭这一行无法确定具体原因。需要继续查看后面的 Could not find、Could not GET 或 Caused by：

如果仍指向 com.google.android.material:snackbar:1.0.0，检查其他模块或依赖配置中是否还留有该声明。
如果找不到 com.google.android.material:material:1.0.0，检查 google() 是否配置在实际生效的依赖仓库中。
出现连接超时、代理或证书错误时，需要处理 Gradle 的网络访问问题。
提示离线模式下没有缓存时，关闭 Gradle Offline 模式后重新构建。

即使 Android Studio 的 Java 编辑器没有标红，也不能说明安装时所需的全部依赖都已解析成功。

4. 在 Java 中显示 Snackbar

依赖解析成功后，导入：

import com.google.android.material.snackbar.Snackbar;

Activity 调用 setContentView(...) 且页面可见后，可以在主线程中显示消息：

Snackbar.make(
        findViewById(android.R.id.content),
        "操作已完成",
        Snackbar.LENGTH_LONG
).show();

Snackbar.make(...) 需要传入页面中的一个 View，以便向上查找适合承载 Snackbar 的父布局。具体行为见 Snackbar API 文档。

如果需要显示更多行，可以在 show() 前设置消息文本的最大行数：

import android.widget.TextView;
import com.google.android.material.snackbar.Snackbar;

// 在 Activity 的实例方法中执行
Snackbar snackbar = Snackbar.make(
        findViewById(android.R.id.content),
        "第一行消息\n第二行消息\n第三行消息",
        Snackbar.LENGTH_LONG
);

TextView messageView = snackbar.getView().findViewById(
        com.google.android.material.R.id.snackbar_text
);
messageView.setMaxLines(5);

snackbar.show();

这里的 5 是示例行数，可以按消息长度调整。LENGTH_LONG 控制显示时长，行数由文本视图控制。如果内容很长，需要用户完整阅读，更适合使用对话框或页面内文本。

5. 旧项目还要检查 AndroidX

Material Components 使用 AndroidX。项目已经完成迁移的，保留现有配置即可；仍使用 android.support.* 的，需要检查迁移情况，避免与 AndroidX 依赖混用。

使用 AndroidX 的项目，可以在 gradle.properties 中确认以下配置：

android.useAndroidX=true

这个开关无法单独完成所有源码和依赖的迁移，也无法修复不存在的 Maven 坐标。先删除错误的 snackbar 依赖，再根据完整构建日志处理剩余错误。