Gradle on Tofuwine's Blog

Maven/Gradle 镜像仓库

Fri, 31 May 2024 00:00:00 +0000

Maven 镜像仓库（阿里云）：

`1`	`https://maven.aliyun.com/repository/public`

gradle plugin 镜像仓库（阿里云）：

`1`	`https://maven.aliyun.com/repository/gradle-plugin`

配置指南：阿里云云效 Maven

Gradle FAQs

Sun, 21 Apr 2024 00:00:00 +0000

Gradle 目前支持两种 DSL（Domain Specific Language）：Groovy DSL 和 Kotlin DSL

更改 Gradle 本地仓库

新建环境变量 GRADLE_USER_HOME，并指定路径，即可修改 Gradle 本地仓库地址。

指定 Java 版本

Kotlin DSL

`1`	`java.sourceCompatibility = JavaVersion.VERSION_17`

Javadoc 编码问题

问题详情：

`1`	`error: unmappable character (0x89) for encoding GBK`

解决方式：

Kotlin DSL

在 build.gradle.kts 文件中添加如下内容：

tasks {
    compileJava {
        options.encoding = "UTF-8"
    }
    compileTestJava {
        options.encoding = "UTF-8"
    }
}

无法识别 lombok 问题

Kotlin DSL

// lombok 使用如下依赖 (版本号可替换)
// https://mvnrepository.com/artifact/org.projectlombok/lombok
compileOnly("org.projectlombok:lombok:1.18.26")
annotationProcessor("org.projectlombok:lombok:1.18.26")

distributionUrl 国内镜像

gradle/wrapper/gradle-wrapper.properties 文件 distributionUrl 默认如下（以 Gradle 8.7 为例）：

`1`	`distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip`

因为众所周知的原因，在国内使用该地址下载可能受阻。我们可以改用国内镜像地址（以腾讯镜像为例）：

`1`	`distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.7-bin.zip`

或者也可以指向本地文件：

`1`	`distributionUrl=file:///D:/Downloads/gradle-8.7-bin.zip`

建议使用国内镜像。

Gradle 配置私有仓库

Sat, 20 Apr 2024 00:00:00 +0000

Gradle 使用 Nexus3 作为私有仓库

官方文档参考：declaring-repositories

1. 项目级配置

步骤1：新建 gradle.properties 文件，并添加如下配置：

1
2
3

nexusUrl=nexus url
nexusUsername=nexus username
nexusPassword=nexus password

步骤2：在 build.gradle 中添加如下配置

// 从 Nexus 下载依赖
repositories {
  // 优先使用本地仓库
  mavenLocal()

  // 使用 Nexus 私有仓库
  maven {
    url "${nexusUrl}"
    credentials {
      username "${nexusUsername}"
      password "${nexusPassword}"
    }
  }
}

2. 全局配置

官方文档参考： init_scripts

在 gradle 安装目录下的 init.d 文件夹内，创建 init.gradle 文件，并添加如下配置：

allprojects {

    // 从 Nexus 下载依赖
    repositories {
        // 优先使用本地仓库
        mavenLocal()

        // 使用 Nexus 私有仓库
        maven {
            url "nexus url"
            credentials {
                username "nexus username"
                password "nexus password"
            }
        }
    }
}

Gradle 使用 Nexus3 作为插件库

官方文档参考：plugins

1. 项目级配置

步骤1：新建 gradle.properties 文件，并添加如下配置：

1
2
3

nexusUrl=nexus url
nexusUsername=nexus username
nexusPassword=nexus password

步骤2：在 settings.gradle 中首行添加如下配置：

pluginManagement {
    repositories {
        maven {
            url "${nexusUrl}"
            credentials {
                username "${nexusUsername}"
                password "${nexusPassword}"
            }
        }
        gradlePluginPortal()
    }
}

2. 全局配置

在 gradle 安装目录下新建 init.gradle 文件，并添加如下配置：

settingsEvaluated { settings ->
    settings.pluginManagement {
        repositories {
			// 使用 Nexus 私有仓库
			maven {
				url "nexus url"
				credentials {
					username "nexus username"
					password "nexus password"
				}
			}
			gradlePluginPortal()
        }
    }
}

Gradle 发布到 Nexus3

官方文档参考：publishing_maven:repositories ，sample_publishing_credentials

步骤1：新建 gradle.properties 文件，并添加如下配置：

nexusReleasesUrl=nexus release url
nexusSnapshotsUrl=nexus snapshot url
nexusUsername=nexus username
nexusPassword=nexus password

步骤2：在 plugins 节点下添加 maven-publish 插件

1
2
3

plugins {
	id 'maven-publish'
}

步骤3：在 build.gradle 文件中，添加如下配置：

// 发布到 私有库
publishing {
  publications {
    binary(MavenPublication) {
      from components.java
    }
    binaryAndSources(MavenPublication) {
      from components.java
      artifact sourcesJar
    }
  }

  repositories {
    maven {
      name 'Nexus'
      // 用户口令
      credentials {
        username "${nexusUsername}"
        password "${nexusPassword}"
      }

      // RELEASE 仓库
      def releasesRepoUrl = "${nexusReleasesUrl}"

      // SNAPSHOT 仓库
      def snapshotsRepoUrl = "${nexusSnapshotsUrl}"

      // 根据版本信息动态判断发布到 SNAPSHOT 还是 RELEASE 仓库
      url = version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl
    }
  }
}