Gradle初探（二）：build.gradle常用配置（java和web项目）

3. 常用配置（针对JAVA和WEB项目）

 

打开build.gradle文件，由于是IDEA创建的，所以里面已经有了一些内容。

图3.1

group和version分别为项目的所在组和版本信息。和Maven类似，而artifactId在gradle则是项目的name，值保存在settings.gradle文件的rootProject.name中。

针对java项目和web项目，根据官方文档，我将build.gradle进行了如下修改，如图所示：

图3.2

apply plugin: 'java'//添加Java插件

apply plugin :'maven'//添加Maven插件

添加Java和Maven插件，可以使用两者的相关配置。

---

sourceCompatibility=1.7

targetCompatibility =1.7

分别指定开发环境和编译使用的JDK版本。根据Maven项目经验，在不同IDE间导入Maven项目时，经常会出错，通过指定JDK可以有效解决此问题，故保险起见，这里也加上。

---

task createJavadoc(type: Javadoc)  {

      source = sourceSets.main.allJava

}

配置了这个任务后，执行gradle的javadoc命令，可以自动生产javaDoc文档。前提当然你自己有给类和方法按规范添加注解。

---

tasks.withType(JavaCompile) {

        options.encoding ="UTF-8"

}

设置编码为UTF-8，如果不设置，则注释有中文等情况时，生成javaDoc会出现乱码，并且执行build命令时会出现警告和错误。

---

repositories {

      mavenLocal()//添加Maven本地资源库

      mavenCentral()//添加Maven中央资源库

}

配置获取资源的资源库

mavenLocal()表示会从本地获取资源，获取资源的顺序为

%USER_HOME%/.m2/settings.xml中指定的路径 > 

%M2_HOME%/conf/settings.xml中指定的路径 >

 %USER_HOME%/.m2/repository。

注：这里发现一个BUG，按照官方文档说，如果系统用户文件夹下的.m2中不存在settings.xml文件会自动去找%M2_HOME%的settings.xml文件，实际却不会，然后直接指向了%USER_HOME%/.m2/repository。建议自定义maven本地库的，把%M2_HOME%的settings.xml文件COPY一份到%USER_HOME%/.m2目录下即可。

---

mavenCentral()表示会从Maven中央库获取数据。

除这2种，gradle还可以从指定的URL获取资源，比如：

repositories {

    maven {

        url"http://127.0.0.1:8081/nexus/content/repositories/"

    }

     mavenLocal()//添加Maven本地资源库

     mavenCentral()//添加Maven中央资源库

}

这里除了本地和中央库，还会从我本地的Maven私服中获取资源。

---

dependencies {

     testCompile 'junit:junit:4.12'//添加单元测试

     testCompile 'org.springframework:spring-test:4.2.5.RELEASE'// Spring测试支持

     compile 'org.springframework:spring-context:4.2.5.RELEASE'

}

添加依赖包，和Maven类似。上面我采用的是简写语法，还有一种是完整的写法，如下：

testCompile group:'junit', name:'junit', version:'4.12'

和Maven类似，gradle导入依赖包也可以定义其作用的生命周期：

compile：编译时必须。

runtime：运行时必须，包括编译时。

testCompile：测试编译时必须。

testRuntime：测试运行时必须，包括编译时。

注：此外配置依赖包，还可以模块化配置、导入list、配置是否传递等。还没细看。

以上这些已经可以支撑平常的java或web项目开发了。接下来还有一个问题，项目开发时，经常会模块化开发，有时候有些jar可以复用，或者项目需要按不同版本（SNAPSHOT/RELEASE等）发布到Maven私服中，下面就说说如何发布项目到Maven私服等资源库中。