项目构建--Gradle--依赖管理(四)

一、依赖管理

1. 依赖配置
   compile:编译范围依赖在所有的 classpath 中可用，同时它们也会被打包
   runtime:runtime依赖在运行和测试系统的时候需要，但在编译的时候不需要。比如，你可能在编译的时候只需要 JDBC API JAR，而只有在运行的时候才需要 JDBC 驱动实现
   testCompile:测试期编译需要的附加依赖
   testRuntime:测试运行期需要

dependencies {
    // 本地项目
    compile project(':com.csii.channel.core:core-common')
    compile project(':com.csii.channel.core:core-dynamic')
  // 外部依赖
    compile group: 'commons-net', name: 'commons-net', version:'2.0'
    compile group: 'com.google.guava', name: 'guava', version:'21.0'
    compile group: 'org.apache.mina', name: 'mina-core', version:'2.0.16'
    testCompile group: 'junit', name: 'junit', version:'4.12'
}

二、仓库

1. 远程仓库
   使用Maven中央仓库，maven仓库的URL为：http://repo1.maven.org/maven2/

repositories {
    mavenCentral()
}

使用Maven远程仓库

repositories {
    mavenLocal()
    maven { url "http://maven.aliyun.com/nexus/content/groups/public/" }
    maven { url 'https://repo.spring.io/milestone' }
    mavenCentral()
}

2. 本地仓库
   配置Gradle使用maven本地仓库：
   CRADLE_USER_HOME：D:.m2\repository

   
   
   配置Gradle使用maven本地仓库
   
   

   修改配置build.gradle：

/**
 * 指定所使用的仓库，mavenCentral()表示使用中央仓库，
 * 此刻项目中所需要的jar包都会默认从中央仓库下载到本地指定目录
 * 配置mavenLocal()表示引入jar包的时候，先从本地仓库中找，没有再去中央仓库下载
 */
repositories {
    mavenLocal()
    mavenCentral()
}

3. 修改或者添加额外的私有仓库地址
   直接修改 settings.gradle 来添加其它仓库：

// settings.gradle
pluginManagement {
    repositories {
        maven {
            url 'http://examle.com/maven-repo'
        }
        gradlePluginPortal()
    }
}

三、多项目构建

多项目构成：allProjects = root项目+各子项目
settings文件声明了所需的配置来实例化项目的层次结构。在默认情况下，这个文件被命名为settings.gradle，并且和根项目的build.gradle文件放在一起，该文件在初始化阶段被执行。根项目就像一个容器，子项目会迭代访问它的配置并注入到自己的配置中。

1. 多项目构建
   多项目构建总是需要指定一个树根，树中的每一个节点代表一个项目，每一个Project对象都指定有一个表示在树中位置的路径；在设置文件中我们还可以使用一套方法来自定义构建项目树。
   settings.gradle作用就是用于多项目构建，一般像这样：

// 父模块名称
rootProject.name = 'iot-cloud-platform'
/* 引入子模块 */
include 'iot-commons'
include 'iot-service'
include 'iot-config'
include 'iot-docs'
include 'iot-gateway'
include 'iot-quartz'
include 'iot-monitor'
include 'iot-register'
include 'iot-ui'
include 'iot-transaction'
include 'iot-auth'
include 'iot-service:user-center'
findProject(':iot-service:user-center')?.name = 'user-center'

2. subprojects子项目通用配置
   subprojects是对所有Child Project的配置:

subprojects {
    apply plugin: 'java'
    apply plugin: 'idea'
    // spring boot 插件
    apply plugin: 'org.springframework.boot'
    // 必须添加spring依赖管理
    apply plugin: 'io.spring.dependency-management'
    repositories {
        mavenLocal()
        // 阿里云仓库
        maven { url "http://maven.aliyun.com/nexus/content/groups/public/" }
        // Spring仓库
        maven { url 'https://repo.spring.io/milestone' }
        mavenCentral()
    }
    dependencies {
        testImplementation('org.springframework.boot:spring-boot-starter-test') {
            exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
        }
    }
    dependencyManagement {
        imports {
            // SpringCloud依赖
            mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
        }
    }
    jar {
        manifest.attributes provider: 'gradle'
    }
}

3. buildScript
   buildScript块的repositories主要是为了Gradle脚本自身的执行，获取脚本依赖插件。
   buildscript中的声明是gradle脚本自身需要使用的资源。可以声明的资源包括依赖项、第三方插件、maven仓库地址等。
   gradle在执行脚本时，会优先执行buildscript代码块中的内容，然后才会执行剩余的build脚本。

buildscript {
    // 定义SpringCloud版本，统一规定springboot的版本
    ext {
        set('springCloudVersion', "Hoxton.RC2")
        set('springBootVersion', "2.2.1.RELEASE")
        set('version', "1.0.0")
    }
    dependencies {
        // 用来打包
        classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
    }
}

ext：ext是自定义属性，现在很多人都喜欢把所有关于版本的信息都利用ext放在另一个自己新建的gradle文件中集中管理。

4. allprojects
   allprojects块的repositories用于多项目构建，为所有项目提供共同所需依赖包。而子项目可以配置自己的repositories以获取自己独需的依赖包。

buildscript和allprojects的作用和区别：
buildscript中的声明是gradle脚本自身需要使用的资源，就是说它自己需要的资源，跟你其它模块其实并没有什么关系。而allprojects声明的却是所有module所需要使用的资源，就是说你的每个module都需要用同一个第三库的时候，可以在allprojects里面声明。

allprojects {
    repositories {
        mavenLocal()
        // 阿里云仓库
        maven { url "http://maven.aliyun.com/nexus/content/groups/public/" }
        // Spring仓库
        maven { url 'https://repo.spring.io/milestone' }
        mavenCentral()
    }
    // 指定编码格式
    tasks.withType(JavaCompile) {
        options.encoding = "UTF-8"
    }
}

四、gradle.properties

  gradle中的常用属性可以写在gradle.properties中。
  一般我们都把全局属性都编写在一个工具类中，如果是有环境的切换的话，那么我们还会定义一个标志来进行相应的变换。对于项目而言，有时候需要配置某些敏感信息。比如密码，帐号等。而这些信息需要被很多类共同使用，所以必须有一个全局的配置。当需要把项目push到git上时，我们不希望别人看到我们项目的key，token等。我们可以将这些信息设置在gradle.properties中。
只有在Android中才可使用。

AppKey = 1234567890

在build.gradle(module app)中进行变量的重定义，即将配置内容转化成java能够使用的形式:

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            //buildConfigField用于给BuildConfig文件添加一个字段
            buildConfigField("String","KEY","\"${AppKey}\"")
        }
        debug{
            buildConfigField("String","KEY","\"${AppKey}\"")
        }
    }
}

五、Gradle 插件(Plugins)

Gradle 也可以用下面的方式声明使用的插件：

plugins {
    id 'org.springframework.boot' version '2.2.1.RELEASE'
    id 'io.spring.dependency-management' version '1.0.8.RELEASE'
    id 'java'
}

其实是从 Gradle 官方的插件仓库https://plugins.gradle.org/m2/下载的。

六、常见的task命令

build:当运行gradle build命令时Gradle将会编译和测试你的代码，并且创建一个包含类和资源的JAR文件。
clean:当运行gradle clean命令时Gradle将会删除build生成的目录和所有生成的文件。
assemble:当运行gradle assemble命令时Gradle将会编译并打包代码，但是并不运行单元测试。
check:当运行gradle check命令时Gradle将会编译并测试你的代码，其他的插件会加入更多的检查步骤。

七、gradle-wrapper

Wrapper是对Gradle的一层包装，便于在团队开发过程中统一Gradle构建的版本号，这样大家都可以使用统一的Gradle版本进行构建。

wrapper

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.4-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

distributionUrl是要下载的gradle的地址，使用哪个版本的gradle，就在这里修改。
gradle的3种版本：
gradle-xx-all.zip是完整版，包含了各种二进制文件，源代码文件，和离线的文档。
gradle-xx-bin.zip是二进制版，只包含了二进制文件（可执行文件），没有文档和源代码。
gradle-xx-src.zip是源码版，只包含了Gradle源代码，不能用来编译你的工程。

zipStoreBase和zipStorePath组合在一起，是下载的gradle-3.1-bin.zip所存放的位置。
zipStorePath是zipStoreBase指定的目录下的子目录。

distributionBase和distributionPath组合在一起，是解压gradle-5.6.4-bin.zip之后的文件的存放位置。
distributionPath是distributionBase指定的目录下的子目录。

下载位置可以和解压位置不一样。
zipStoreBase和distributionBase有两种取值：GRADLE_USER_HOME和PROJECT。
其中，GRADLE_USER_HOME表示用户目录。
在windows下是%USERPROFILE%/.gradle，例如C:\Users.gradle\。
在linux下是$HOME/.gradle，例如~/.gradle。
PROJECT表示工程的当前目录，即gradlew所在的目录。

八、依赖分组

在Gradle中，依赖都被会分配到某一个具体的configuration中，Configuration代表着一个或多个构件及构件所需依赖的一个分组。

configurations.all {
    resolutionStrategy {
        force 'org.hamcrest:hamcrest-core:1.3'
    }
}

九、依赖版本冲突

Gradle对解决传递依赖提供了两种策略，使用最新版本或者直接导致构建失败。默认的策略是使用最新版本。虽然这样的策略能够解决一些问题，但是还是不够。常见的一种情况是，NoSuchMethond或者ClassNotFound。这时候，你可能需要一些特殊手段，比如排除不想要的传递依赖。
排除传递依赖的方式有两种：
1.直接在configuration中排除
2.在具体的某个dependency中排除

configurations {
    compile.exclude module: 'commons'
    all*.exclude group: 'org.gradle.test.excludes', module: 'reports'
}

dependencies {
    compile("org.gradle.test.excludes:api:1.0") {
        exclude module: 'shared'
    }
}

十、常见问题：

1. Main class name has not been configured and it could not be resolved、