Android Studio创建空白项目时资源链接失败问题求助

错误原因 #

这些android:color/system_neutral1_*、android:color/system_neutral2_*是*Android 12（API Level 31）*引入的系统颜色资源，出现找不到的问题，通常是项目编译配置与SDK资源不匹配导致的。

解决步骤 #

• 更新编译与目标SDK版本至31及以上
  打开Module级别的build.gradle文件（非Project级），修改配置：

  android {
      compileSdkVersion 31 // 可升级至更高版本，如34
      defaultConfig {
          targetSdkVersion 31 // 建议与compileSdkVersion保持一致
      }
  }
  

• 安装对应版本的Android SDK
  打开Android Studio的SDK Manager（路径：Tools > SDK Manager），在SDK Platforms标签下勾选Android 12（API 31）或更高版本，点击Apply完成资源安装。

• 更新Android Gradle插件版本
  打开Project级别的build.gradle文件，调整插件版本以适配compileSdkVersion（如compileSdkVersion 31对应插件版本需≥7.0.0）：

  dependencies {
      classpath "com.android.tools.build:gradle:7.0.4" // 可使用更高兼容版本
  }
  

• 清理并重建项目
  点击顶部菜单栏Build > Clean Project，完成后执行Build > Rebuild Project，清除缓存后重新构建。

替代方案（不推荐） #

若暂时不想升级SDK版本，可手动替换系统颜色：找到values-v31/values-v31.xml文件，将所有@android:color/system_neutral*替换为自定义十六进制颜色值（如#FFFFFF），但此方法会破坏系统主题一致性。

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