You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何一次性配置Gradle及依赖适配所有后续Android项目?

Android Studio 全局配置方案(适配Arctic Fox 2020.3.1 Patch 1版本)

以下配置修改后对所有后续新建、导入的项目生效,无需逐个项目调整:

1. 全局Gradle运行规则设置

  • 打开Android Studio,点击顶部菜单栏 File > New Projects Settings > Settings for New Projects(欢迎页可点击 Customize > All settings 进入同个配置界面)
  • 左侧导航栏选择 Build, Execution, Deployment > Build Tools > Gradle
    • 确认Gradle user home为全局通用路径(Windows默认C:\Users\你的用户名\.gradle,Mac/Linux默认~/.gradle),不要设置为项目内的相对路径
    • Use Gradle from选项选择Specified location,手动选择你本地已经下载完成的常用Gradle版本文件夹,不要选择默认的gradle-wrapper.properties选项,即可避免每个新项目单独下载对应版本Gradle
    • 若无需新增依赖,可勾选Offline work开启离线模式,完全跳过网络下载步骤

2. 全局依赖镜像源配置

修改全局初始化脚本,让所有项目优先走国内镜像下载依赖,大幅提升下载速度:

  • 打开上述的Gradle user home目录,新建名为init.gradle的文件(若已存在直接编辑即可)
  • 写入以下配置内容:
allprojects {
    repositories {
        def ALIYUN_PUBLIC = 'https://maven.aliyun.com/repository/public/'
        def ALIYUN_GOOGLE = 'https://maven.aliyun.com/repository/google/'
        def ALIYUN_PLUGIN = 'https://maven.aliyun.com/repository/gradle-plugin/'
        
        all { ArtifactRepository repo ->
            if(repo instanceof MavenArtifactRepository){
                def url = repo.url.toString()
                if (url.startsWith('https://repo1.maven.org/maven2/')) {
                    remove repo
                }
                if (url.startsWith('https://dl.google.com/dl/android/maven2/')) {
                    remove repo
                }
                if (url.startsWith('https://plugins.gradle.org/m2/')) {
                    remove repo
                }
            }
        }
        maven { url ALIYUN_PUBLIC }
        maven { url ALIYUN_GOOGLE }
        maven { url ALIYUN_PLUGIN }
    }
}

3. 项目模板修改(可选)

如果需要彻底统一所有新项目的编译参数、Gradle插件版本,可找到Android Studio安装目录下的plugins/android/lib/templates/gradle-projects/NewAndroidProject/root路径,修改对应模板文件里的compileSdk、buildToolsVersion、Gradle插件版本等参数为你常用的固定值,新建项目时会直接生成对应配置,完全避免版本不匹配导致的重复下载问题。


内容的提问来源于stack exchange,提问作者Kenny83

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.07 17:48:05