gradle-tutorial

gradle tutorial

只推荐使用 Gradle Wrapper, 使用时需要先下载 Gradle, 然后再下载依赖

  • GRADLE_USER_HOME: 默认为 ~/.gradle
  • GRADLE_OPTS: 影响 Wrapper 下载 Gradle

Proxy

官方文档

推荐在 GRADLE_USER_HOME 下增加配置来设置代理

影响 Wrapper 下载 Gradle 和 Daemon 下载依赖

~/.gradle/gradle.properties

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=1080
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=1080
systemProp.socksProxyHost=127.0.0.1
systemProp.socksProxyPort=1080

org.gradle.jvmargs=-Xmx4g -Dfile.encoding=UTF-8
org.gradle.parallel=true
org.gradle.caching=true
org.gradle.warning.mode=all
org.gradle.configuration-cache=true

systemProp.file.encoding=UTF-8

或者设置 GRADLE_OPTS 环境变量, 这里可以解析 HTTP_PROXY 环境得到 Host 和 Port 并追加到 ~/.zshrc 中

影响 Wrapper 下载 Gradle

1
export GRADLE_OPTS="$GRADLE_OPTS -Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=1080 -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=1080"

Mirror

推荐在 GRADLE_USER_HOME 下增加配置来提前设置镜像源

~/.gradle/init.d/mirrors.init.gradle.kts

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
import org.gradle.api.artifacts.repositories.MavenArtifactRepository
import org.gradle.api.artifacts.repositories.IvyArtifactRepository
import org.gradle.api.artifacts.repositories.FlatDirectoryArtifactRepository

gradle.beforeSettings {
    val pluginMirrors = listOf(
        "https://maven.aliyun.com/repository/public",
        "https://maven.aliyun.com/repository/google",
        "https://maven.aliyun.com/repository/spring",
        "https://maven.aliyun.com/repository/gradle-plugin",
        "https://mirrors.tencent.com/nexus/repository/gradle-plugins"
    )
    val dependencyMirrors = listOf(
        "https://maven.aliyun.com/repository/public",
        "https://maven.aliyun.com/repository/google",
        "https://maven.aliyun.com/repository/spring",
        "https://maven.aliyun.com/repository/gradle-plugin",
        "https://mirrors.tencent.com/nexus/repository/gradle-plugins"
    )
    pluginMirrors.forEachIndexed { index, mirror ->
        pluginManagement.repositories.maven {
            name = "PluginMirror$index"
            url = uri(mirror)
        }
    }
    dependencyMirrors.forEachIndexed { index, mirror ->
        dependencyResolutionManagement.repositories.maven {
            name = "DependencyMirror$index"
            url = uri(mirror)
        }
    }
    gradle.settingsEvaluated {
        fun printRepositories(title: String, repositories: Iterable<*>) {
            println("\n[$title]")
            repositories.forEachIndexed { index, repo ->
                val location = when (repo) {
                    is MavenArtifactRepository -> repo.url.toString()
                    is IvyArtifactRepository -> repo.url.toString()
                    is FlatDirectoryArtifactRepository ->
                        repo.dirs.joinToString()
                    else -> "Unknown repository type"
                }
                println("${index + 1}. ${repo.let { (it as org.gradle.api.artifacts.repositories.ArtifactRepository).name }} -> $location")
            }
        }
        printRepositories(
            "Plugin Management",
            pluginManagement.repositories
        )
        printRepositories(
            "Dependency Resolution",
            dependencyResolutionManagement.repositories
        )
        println()
    }
}
println("[Gradle Mirror] Loaded")

Command

check mirrors

1
./gradlew --no-build-cache --no-configuration-cache

or

1
./gradlew build --refresh-dependencies --info 2>&1 | grep -E 'aliyun|mavenCentral|Downloading'

use mirror to download gradle wrapper

1
find . -name 'gradle-wrapper.properties' -exec sed -i 's/services\.gradle\.org\/distributions/mirrors.cloud.tencent.com\/gradle/g' {} +

revert

1
find . -name 'gradle-wrapper.properties' -exec sed -i 's/mirrors\.cloud\.tencent\.com\/gradle/services.gradle.org\/distributions/g' {} +
Licensed under CC BY-NC-SA 4.0
最后更新于 2026-11-04
使用 Hugo 构建
主题 Stack 由 Jimmy 设计