Gradle配置全局替换国内镜像 (2024版) 操作指南

25次阅读
没有评论

一、Gradle 基础知识

  1. 什么是 Gradle
    Gradle 是一种基于 JVM 的构建工具,广泛用于 Android 和现代 Java 项目的构建、依赖管理等。在 Gradle 中,您可以使用 build.gradle 文件配置项目的依赖、插件、任务等。
  2. Gradle 如何获取依赖
    Gradle 包管理依赖主要通过 Maven 仓库。默认情况下,它会从官方 Maven 中央仓库(https://repo.maven.apache.org/maven2)以及谷歌的 Maven 仓库(https://dl.google.com/dl/android/maven2)下载所需依赖。但是,因网络环境的原因,这些源在中国可能会非常慢甚至无法访问。

二、使用国内镜像源
为了提升 Gradle 的下载速度,可以使用国内一些托管 Maven 仓库的源,如阿里云、清华大学等。在这个指南中,我们将重点介绍如何使用阿里云的 Maven 镜像。

  1. 阿里云 Maven 镜像地址
    阿里云提供的 Maven 镜像地址如下:
https://maven.aliyun.com/repository/public其他常用的国内镜像源还包括:

清华大学开源软件镜像站:https://mirrors.tuna.tsinghua.edu.cn
中科大镜像:https://mirrors.ustc.edu.cn
三、配置步骤

  1. 找到您的 Gradle 用户目录
    在开始配置之前,您需要知道 Gradle 的用户目录。一般情况下,Gradle 用户目录如下:

Windows: C:\Users\.gradle
macOS 和 Linux: ~/.gradle

  1. 编辑 Gradle 配置文件
    进入 Gradle 用户目录,找到或创建名为 gradle.properties 的文件。该文件用于配置 Gradle 的全局属性。

cd ~/.gradle
touch gradle.properties # 在 Linux/macOS 下创建文件
在 Windows 下,您可以直接使用文本编辑器创建该文件。

使用文本编辑器打开 gradle.properties 文件,并添加如下配置:

阿里云 Maven 镜像

repositories.grails.default = https://maven.aliyun.com/repository/public

Optional, you can add other sources

repositories.grails.default.1 = https://mirrors.tuna.tsinghua.edu.cn/maven/repos/public

Optional, adding Central repository

repositories.grails.default.2 = https://repo.maven.apache.org/maven2

  1. 完整配置示例
    以下是一个完整的 gradle.properties 文件示例:

gradle.properties 示例配置

使用阿里云 Maven 镜像

repositories.grails.default = https://maven.aliyun.com/repository/public
repositories.grails.default.1 = https://mirrors.tuna.tsinghua.edu.cn/maven/repos/public
repositories.grails.default.2 = https://repo.maven.apache.org/maven2

其他可能的配置

systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=1080
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=1080

  1. 配置清华大学和中科大的 Maven 镜像
    如果您选择使用清华大学的镜像,可以将 gradle.properties 文件设置如下:

使用清华大学的 Maven 镜像

repositories.grails.default = https://mirrors.tuna.tsinghua.edu.cn/maven/repos/public
对于中科大的镜像:

使用中科大的 Maven 镜像

repositories.grails.default = https://mirrors.ustc.edu.cn/maven/
四、测试配置

  1. 创建一个简单的 Gradle 项目
    为了验证配置是否成功,您可以创建一个简单的 Gradle 项目。

创建并进入新的项目目录:

mkdir test-gradle
cd test-gradle
初始化 Gradle 项目:

gradle init
按照提示,选择类型为“basic”并完成初始化。

  1. 修改 build.gradle 文件
    在 test-gradle 目录下,找到 build.gradle 文件,编辑其内容如下:

plugins {
id ‘java’
}

repositories {
mavenCentral()
}

dependencies {
implementation ‘org.apache.commons:commons-lang3:3.12.0’
}

task hello {
doLast {
println ‘Hello, Gradle!’
}
}

  1. 构建项目
    在命令行中运行以下命令来构建项目:

gradle build
如果所有配置正确,Gradle 将自动从您设置的国内镜像中下载依赖库,并顺利构建项目。

  1. 运行自定义任务
    在构建完成后,可以运行我们在 build.gradle 文件中定义的 hello 任务以查看输出:

gradle hello
您应该能看到以下输出:

Task :hello
Hello, Gradle!
五、性能测试与优化建议

  1. 下载速度测试
    在您配置好镜像后,可以通过不同项目的下载速度来评估这些镜像的性能。可以试着多次执行 gradle build 命令,并记录所需时间。一般情况下,使用国内镜像后,下载速度会显著提升。
  1. 脚本化配置
    为了避免每次新建项目都需要手动添加镜像配置,可以通过创建一个脚本来自动化此过程。为此,可以使用 Bash 脚本:

!/bin/bash

创建 gradle.properties 文件并添加阿里云镜像配置

cat <> ~/.gradle/gradle.properties

Gradle 配置阿里云镜像

repositories.grails.default = https://maven.aliyun.com/repository/public
EOT

echo “Gradle 配置已更新为阿里云镜像!”
将上述脚本保存为 setup_gradle_mirrors.sh 并给予执行权限:

chmod +x setup_gradle_mirrors.sh
执行脚本以快速配置:

./setup_gradle_mirrors.sh
通过本文的详细指导,您连同实际操作案例配置了 Gradle 的全局替换国内镜像。使用国内镜像源可以显著提高依赖下载速度,从而提高开发效率。建议您在实际开发工作中根据需要选择合适的镜像源,并整合到您的常用工程配置中。

此外,定期关注所用镜像源的性能和可用性,以确保您的开发环境始终保持高效。希望本文能为您提供实际的帮助,提升您的 Gradle 使用体验。对于任何深入的问题或细节,欢迎参与社区讨论或查阅相关资料以获得进一步的信息和支持。

正文完
可以使用微信扫码关注公众号(ID:xzluomor)
post-qrcode
 
评论(没有评论)