Android Studio使用Google Material库报resource linking failed错误如何解决

错误根因 #

你引入的com.google.android.material:material:1.5.0-alpha05是适配Android 12（API 31）的测试版本，内置了Android 12新增的系统主题色资源system_neutral1_1000。你当前项目的compileSdk配置为30，对应的Android 11 SDK中不存在这个v31专属资源，因此触发资源链接失败错误。

解决方案（二选一即可） #

方案1：升级compileSdk到31及以上（推荐） #

修改模块级build.gradle的android配置块：

android {
    // 替换原有的compileSdk 30、compileSdkVersion 30配置
    compileSdk 31
    defaultConfig {
        // targetSdk同步升级到31，minSdk无需修改，不影响低版本设备运行
        targetSdk 31
        // 其余原有配置保持不变
    }
    // 其余原有配置保持不变
}

同步Gradle后重新构建即可。

方案2：降低Material库版本到适配API 30的稳定版 #

如果暂时不想升级compileSdk，可以将material依赖替换为1.4.0稳定版，该版本无需依赖API 31专属资源：

// 替换原有的implementation 'com.google.android.material:material:1.5.0-alpha05'配置
implementation 'com.google.android.material:material:1.4.0'

同步Gradle后重新构建即可。

操作完成后如果仍报错，可以点击Android Studio顶部菜单「Build」→「Clean Project」，再执行「Rebuild Project」清理缓存后重试。

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