Gradle 8.9全局仓库配置报错，求Android Studio模板修改方案

一、全局配置本地仓库（无需逐个修改settings.gradle） #

Gradle 7.0+版本默认优先使用settings.gradle中的仓库配置，你之前的allprojects配置针对的是项目级仓库，因此触发报错。正确的全局配置需要通过初始化脚本修改settings层面的仓库设置，步骤如下：

1. 找到Gradle的init.d目录：
   • Windows：C:\Users\你的用户名\.gradle\init.d
   • macOS/Linux：~/.gradle/init.d
2. 创建或修改init.gradle文件，替换为以下内容：

settingsEvaluated { settings ->
    // 配置插件仓库（用于下载Gradle插件）
    settings.pluginManagement {
        repositories {
            maven { url "你的本地仓库地址" }
            google()
            mavenCentral()
        }
    }
    // 配置项目依赖仓库
    settings.dependencyResolutionManagement {
        repositories {
            maven { url "你的本地仓库地址" }
            google()
            mavenCentral()
        }
    }
}

3. 保存后重新执行构建命令，即可全局应用本地仓库配置，无需修改每个项目的settings.gradle。

二、修改Android Studio的settings.gradle模板 #

如果希望新建项目时自动包含本地仓库配置，可以修改AS的模板文件：

1. 找到模板文件路径：

   • Windows：Android Studio安装目录\plugins\android\lib\templates\gradle-projects\NewAndroidProject\root\settings.gradle.ftl
   • macOS：/Applications/Android Studio.app/Contents/plugins/android/lib/templates/gradle-projects/NewAndroidProject/root/settings.gradle.ftl
     如果找不到，可在Android Studio中按Ctrl+Shift+F（Windows/Linux）或Cmd+Shift+F（macOS），搜索settings.gradle.ftl，选择在AS安装目录下搜索

2. 打开模板文件，找到dependencyResolutionManagement区块，添加你的本地仓库地址，修改后示例如下：

<#if includeKotlinKapt!false>
plugins {
    id 'com.android.application' version '${agpVersion}' apply false
    id 'com.android.library' version '${agpVersion}' apply false
    id 'org.jetbrains.kotlin.android' version '${kotlinVersion}' apply false
}
</#if>

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url "你的本地仓库地址" }
        google()
        mavenCentral()
    }
}

rootProject.name = "${rootProjectName}"
include ':app'

3. 保存模板文件后，新建Android项目时，生成的settings.gradle会自动包含你的本地仓库配置。

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