# gradle

**Repository Path**: sjzalex/gradle

## Basic Information

- **Project Name**: gradle
- **Description**: Fork from https://github.com/gradle/gradle/tree/master
- **Primary Language**: Groovy
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-06-17
- **Last Updated**: 2023-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gradle Document

## 常用指令

```shell
# 清空build目录
gradle clean
# 编译业务代码和配置文件
gradle classes
# 编译测试代码，生成测试报告
gradle test
# 构建项目
gradle build
# 跳过测试构建
gradle build -x test
```


## 下载加速

> `Gradle_HOME/init.d/init.gradle`

```groovy
allprojects {
    repositories {
        mavenLocal() 
        maven { name "Alibaba"; url "https://maven.aliyun.com/repository/public" } 
        maven { name "Bstek"; url "https://nexus.bsdn.org/content/groups/public/" } 
        mavenCentral()
    }
    buildscript {
        repositories {
            maven { name "Alibaba"; url 'https://maven.aliyun.com/repository/public' } 
            maven { name "Bstek"; url 'https://nexus.bsdn.org/content/groups/public/' } 
            maven { name "M2"; url 'https://plugins.gradle.org/m2/' }
        }
    }
}
```

> 1.启用 `init.gradle` 的方法

1. 命令行指定：`gradle --init-script dir/init.gradle -q taskName`
2. `init.gradle` 存放在 `USER_HOME/.gradle/` 目录下
3. `init.gradle` 存放在 `USER_HOME/.gradle/.init` 目录下
4. `init.gradle` 存放在 `GRADLE_HOME/.init/` 目录下

上述多个条件同时满足时，会按照 `1-4` 的顺序执行文件

给定目录下存在多个 init 脚本时，会按照 `a-z` 的顺序执行文件

每个 `init` 脚本都对应一个 `gradle` 实例，实现了 `Script` 接口

> 2.仓库地址

1. `mavenLocal()` 按 `USER_HOME/.m1/setting.xml` >> `M2-HOME/conf/setting.xml` >> `USER_HOME/.m2/repository` 的顺序查找本地 Maven 仓库中的 jar 包
2. `mavenCentral()` 是 Maven 的中央仓库，直接申明使用即可

`gradle` 优先使用本地仓库，本地仓库不存在时从远程仓库下载到缓存中

`gradle` 缓存地址：`USER_HOME/.gradle/caches` 或 `GRADLE_USER_HOME/caches` 目录

## 包装器

`Gradle Wrapper` 是对 Gradle 的包装，用于解决实际开发中不同项目使用不同版本的问题

`gradlew/gradlew.bat` 是对 `wrapper` 中 `gradle` 命令的封装

`gradle` 和 `gradlew` 命令使用方式完全一致，但 wrapper 中的版本可能和本地不一致

```shell
# 指定 gradle 版本
gradle wrapper --gradle--version 7.5.1
# 指定 gradle 发行版的 URL
gradle wrapper --gradle-distribution-url

```