Gradle构建多模块项目的方法步骤

通常我在使用maven构建项目的时候是将应用项目划分为多个更小的模块。

gradle 项目也拥有多于一个组件，我们也将其称之为多项目构建（multi-project build）。

我们首先创建一个多项目构建：

mkdir cmdgradleproj && cd cmdgradleproj
gradle init

这时候

d:\cmdgradleproj> 目录下执行：tree /f

的项目结构如下：

│ build.gradle
│ gradlew
│ gradlew.bat
│ settings.gradle
│ 
├─.gradle
│ └─3.0
│   └─taskartifacts
│       cache.properties
│       cache.properties.lock
│       filehashes.bin
│       filesnapshots.bin
│       filesnapshotstotreesnapshotsindex.bin
│       taskartifacts.bin
│       
└─gradle
  └─wrapper
      gradle-wrapper.jar
      gradle-wrapper.properties

然后，创建多个模块，这里以 core 和 web 模块为例，先创建四个目录（test 文件夹用于编写测试类）：

mkdir core\src\main\java
mkdir core\src\main\test
mkdir web\src\main\java
mkdir web\src\main\resources

 core模块 ：包含一些通用的组件，它们能够被程序的其他模块使用。例子中，只包含一个类：messageservice类返回 ‘hello world!' 字符串。该模块有两个依赖：junit 4.11与commons-lang3。

web模块：模块包含helloworld类，是程序的开端，它从messageservice对象中获取信息，并将接收到的信息写入一个日志文件中。该模块拥有两个依赖：它需要core模块，还使用log4j作为日志。

现在，我们已经创建了所需的目录，下一步是配置gradle构建，先对包含在多项目构建中的项目进行配置。

我们可以通过以下步骤，对包含在多项目构建中的项目进行配置：

1.在根项目的根目录下创建 settings.gradle 文件，一个多项目gradle构建必须含有这个文件，因为它指明了那些包含在多项目构建中的项目。

2.确保 web 和 core 项目包含在我们的多项目构建中。

我们的 settings.gradle 文件如下：

include 'core'
include 'web'
简写：include 'core','web'

修改根目录下的 build.gradle：

// 所有子项目的通用配置
subprojects {
  apply plugin: 'java'
  // apply plugin: 'eclipse'
  apply plugin: 'idea'

  version = '1.0'

  // jvm 版本号要求
  sourcecompatibility = 1.8
  targetcompatibility = 1.8

  // java编译的时候缺省状态下会因为中文字符而失败
  [compilejava,compiletestjava,javadoc]*.options*.encoding = 'utf-8'

  //定义版本号
  ext {
    springversion = '4.3.3.release'
    hibernateversion='5.2.2.final'
  }

  repositories {
    mavencentral()
  }

  jar {
    manifest {
      attributes("implementation-title": "gradle")
    }
  }

  configurations {
    // 所有需要忽略的包定义在此
    all*.exclude group: 'commons-httpclient'
    all*.exclude group: 'commons-logging'
    all*.exclude group: 'commons-beanutils', module: 'commons-beanutils'
  }

  dependencies {
    // 通用依赖
    compile(
        "org.springframework:spring-context:$springversion",
        "org.springframework:spring-orm:$springversion",
        "org.springframework:spring-tx:$springversion",
        "org.springframework.data:spring-data-jpa:1.10.3.release",
        "org.hibernate:hibernate-entitymanager:$hibernateversion",
        "c3p0:c3p0:0.9.1.2",
        "mysql:mysql-connector-java:6.0.4",
        "org.slf4j:slf4j-nop:1.7.21",
        "commons-fileupload:commons-fileupload:1.3.2",
        "com.fasterxml.jackson.core:jackson-databind:2.8.2"
    )

    // 依赖maven中不存在的jar
    ext.jartree = filetree(dir: 'libs', include: '**/*.jar')
    ext.rootprojectlibs = new file(rootproject.rootdir, 'libs').getabsolutepath()
    ext.jartree += filetree(dir: rootprojectlibs, include: '**/*.jar')

    compile jartree

    // 测试依赖
    testcompile(
        "org.springframework:spring-test:$springversion",
        "junit:junit:4.12"
    )
  }

  // 显示当前项目下所有用于 compile 的 jar.
  task listjars(description: 'display all compile jars.') << {
    configurations.compile.each { file file -> println file.name }
  }
}

接下来可以修改 core/build.gradle 来定义 core 模块的依赖：

// jar包的名字
archivesbasename = 'core'

// 还可以定义其他配置，这里直接继承父模块中的配置

web 模块需要依赖 core 模块，故定义 web/build.gradle 如下：

apply plugin:"war" 

dependencies{ 
  // 依赖 core 模块
  compile project(":core") 
  compile( 
      "org.springframework:spring-webmvc:$springversion", 
      "org.apache.taglibs:taglibs-standard-impl:1.2.1" 
  ) 
  //系统提供的依赖
  providedcompile( 
      "javax.servlet:javax.servlet-api:3.1.0", 
      "javax.servlet.jsp:jsp-api:2.2.1-b03", 
      "javax.servlet.jsp.jstl:javax.servlet.jsp.jstl-api:1.2.1" 
  ) 
} 

task jarwithoutresources(type: jar) { 
  basename project.name 
  from("$builddir/classes/main") 
} 

war{ 
  dependson jarwithoutresources 
  from("$projectdir/src/main/resources") { 
    include "*.properties" 
    into("web-inf/classes") 
  } 
  classpath=classpath - sourcesets.main.output 
  classpath filetree(dir:libsdir, include:"${project.name}-${version}.jar") 
} 
task('jarpath')<<{ 
  configurations.runtime.resolve().each { 
    print it.tostring()+";" 
  } 
  println(); 
} 

3. 编译项目

查看所有 jar：

> gradle listjars
// 查看各个模块的依赖：
> gradle :core:dependencies
> gradle :web:dependencies

//编译所有模块：
> gradle build

对比一下，这时候的目录如下：

│  build.gradle
│  gradlew
│  gradlew.bat
│  settings.gradle
│  
├───.gradle
│  └───3.0
│    └───taskartifacts
│        cache.properties
│        cache.properties.lock
│        filehashes.bin
│        filesnapshots.bin
│        filesnapshotstotreesnapshotsindex.bin
│        taskartifacts.bin
│        
├───core
│  │  build.gradle
│  │  
│  ├───build
│  │  ├───libs
│  │  │    core-1.0.jar
│  │  │    
│  │  └───tmp
│  │    └───jar
│  │        manifest.mf
│  │        
│  └───src
│    ├───main
│    │  └───java
│    └───test
│      └───java
├───gradle
│  └───wrapper
│      gradle-wrapper.jar
│      gradle-wrapper.properties
│      
└───web
  │  build.gradle
  │  
  ├───build
  │  ├───libs
  │  │    web-1.0.jar
  │  │    web-1.0.war
  │  │    
  │  └───tmp
  │    ├───jarwithoutresources
  │    │    manifest.mf
  │    │    
  │    └───war
  │        manifest.mf
  │        
  └───src
    └───main
      ├───java
      └───resources

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。