新建Android项目编译报错，如何重置环境及换回Groovy Gradle？

这个错误是AGP（Android Gradle插件）7.0+新增的AAR元数据检查导致的，通常是项目依赖的某个库声明的最低兼容版本低于你设置的Android 9.0（API 28）。解决方法：

• 打开项目根目录的gradle.properties文件，添加以下两行配置关闭检查：

android.build.checkAarMetadata=false
android.suppressUnsupportedCompileSdk=28

• 同步项目，若仍报错，检查模块build.gradle.kts中的minSdk是否确实设置为28，确认后清理项目（Build → Clean Project）再重新编译。

为什么默认用KTS？ #

新版本Android Studio默认采用Kotlin DSL是因为它具备类型安全、语法与Kotlin项目一致、编译时检查错误等优势，比Groovy更稳定。

可以换回Groovy，步骤如下： #

1. 根目录文件转换：
   • 将build.gradle.kts重命名为build.gradle，把语法改成Groovy格式，示例：

     plugins {
         id 'com.android.application' version '8.1.0' apply false
         id 'org.jetbrains.kotlin.android' version '1.8.10' apply false
     }
     

   • 将settings.gradle.kts重命名为settings.gradle，转换语法：

     pluginManagement {
         repositories {
             google()
             mavenCentral()
             gradlePluginPortal()
         }
     }
     dependencyResolutionManagement {
         repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
         repositories {
             google()
             mavenCentral()
         }
     }
     
     rootProject.name = '你的项目名'
     include ':app'
     

2. 模块目录（如app）文件转换：
   • 将app/build.gradle.kts重命名为app/build.gradle，转换核心配置，示例：

     plugins {
         id 'com.android.application'
         id 'org.jetbrains.kotlin.android'
     }
     
     android {
         namespace 'com.example.yourapp'
         compileSdk 33
     
         defaultConfig {
             applicationId 'com.example.yourapp'
             minSdk 28
             targetSdk 33
             versionCode 1
             versionName '1.0'
     
             testInstrumentationRunner 'androidx.test.runner.AndroidJUnitRunner'
         }
     
         buildTypes {
             release {
                 minifyEnabled false
                 proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
             }
         }
         compileOptions {
             sourceCompatibility JavaVersion.VERSION_1_8
             targetCompatibility JavaVersion.VERSION_1_8
         }
         kotlinOptions {
             jvmTarget = '1.8'
         }
     }
     
     dependencies {
         implementation 'androidx.core:core-ktx:1.9.0'
         implementation 'androidx.appcompat:appcompat:1.6.1'
         implementation 'com.google.android.material:material:1.9.0'
         implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
         testImplementation 'junit:junit:4.13.2'
         androidTestImplementation 'androidx.test.ext:junit:1.1.5'
         androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
     }
     

3. 同步项目，确认无语法错误即可。

步骤如下：

1. 完全关闭Android Studio（包括后台进程）
2. 删除IDE配置目录：
   • Windows：C:\Users\<你的用户名>\.AndroidStudio<版本号>（比如.AndroidStudioGiraffe）
   • Mac：~/Library/Application Support/Google/AndroidStudio<版本号>
   • Linux：~/.AndroidStudio<版本号>
3. 若需要彻底清除项目相关缓存，可删除当前项目的.gradle、build目录及local.properties文件
4. 重新启动Android Studio，会进入初始设置向导，重新配置SDK路径、主题等，之后即可创建新项目从头开始

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