Gradle系列——Gradle的build.gradle文件详情(基于Gradle文档7.5)day3-3

  • build.gradle
  • build常用方法和属性
  • 解决一些版本,字符集问题(常见属性配置)
  • Repositories(仓库配置)
  • Subprojects和Allprojects
  • 在父工程中通过project方法操作子工程
  • 使用ext扩展用户自定义属性
  • 项目发布
  • 发布步骤
  • 1.引入maven发布插件
  • 2.设置发布代码
  • 3.选择发布指令
  • 生成Javadoc


build.gradle

  1. 其实build.gradle文件支持使用Java或Groovy或Kotlin编写
  2. 每个project都会有一个build.gadle文件该文件是项目构建的入口,可配置版本、插件、依赖库等信息。
  3. 每个build文件都有一个对应的Project实例.对build.gradle,文件配置,本质就是设置Project实例的属性和方法。
  4. 由于每个project都会有一个build文件,那么Root Project也不列外Root Project 可以获取到所有Child Project,所以在Root Project的 build文件中我们可以对Child Project统一配置,比如应用的插件、依赖的maven 中心仓库等。

在子工程中可以使用parent获取父工程

build常用方法和属性

gradle怎么编译java项目 gradle build.gradle_自定义属性

解决一些版本,字符集问题(常见属性配置)

//指定使用什么版本的JDK语法编译源代码,跟编译环境有关,在有java插件时才能用
sourceCompatibility = 1.8
//指定生成特定于某个JDK版本的class文件:跟运行环境有关,在有java插件时才能用
targetCompatibility = 1.8
//业务编码字符集,注意这是指定源码解码的字符集[编译器
JcompileJava.options.encoding "UTF一8"
//测试编码字符集,注意这是指定源码解码的字符集[编译器]
compileTestJava. options.encoding "UTF一8"
//编译JAVA文件时采用UTF-8 :注意这是指定源码编码的字符集【源文件】
tasks.withType (JavaCompile) {
options.encoding = "UTF一8"
)
//编译JAVA文件时采用UTF-8 :注意这是指定文档编码的字符集【源文件】
tasks.withType (Javadoc) {
options.encoding ="UTF一8"
)

Repositories(仓库配置)

配置在父工程中,对子工程无效
我们可以在其中配置多个仓库进行使用

repositories i
//gradle中会按着仓库配置的顺序,从上往下依次去对应的仓库中找所需要的jar包:
//如果找到,则停止向下搜索,如果找不到,继续在下面的仓库中查找
//指定去本地某个磁盘目录中查找:使用本地file文件协议:一般不用这种方式
maven { url 'file: ///D:/gradle/gradleRepos' }
maven { url "$rootDir/lib/release" }
//指定去maven的本地仓库查找
mavenLocal ()
//指定去maven的私服或者第三方镜像仓库查找
maven { name "Alibaba" ; url "https : //maven.aliyun . com/repository/public" }maven { name "Bstek" ; url "https: / /nexus ,bsdn.org/content/groups/public/" }
//指定去maven的远程仓库查找:即https : //repo.maven.apache.org/maven2/
mavenCentral ()
//去google仓库查找
google ()

Subprojects和Allprojects

  1. Subprojects:当前项目的子工程
  2. Allprojects:当前项目所有工程

我们可以使用这两个属性进行任务配置等操作

allprojects {
	tasks.create ( ' hello ' ) {
			println "project name is $task.project.name"
	}
}

在父工程中通过project方法操作子工程

如下

project('kid1'){
	//书写build.gradle的各种属性
	dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.7.0'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.7.0'
    implementation files('lib/mybatis-plus-spring-starter.jar','lib/mysql-connect-java.jar')
    implementation fileTree('dir':'lib',includes: ['*.jar'])
	}

}

使用ext扩展用户自定义属性

Project和Task都允许用户添加额外的自定义属性,要添加额外的属性,通过应用所属对象的ext 属性即可实现。添加之后可以通过ext属性对自定义属性读取和设置,如果要同时添加多个自定义属性,可以通过ext代码块

ext{
    maker="xxx"
    projectVersion="1.0"
    sdk=[
            minVersion:JavaVersion.VERSION_1_8
    ]
}

我们使用的时候直接使用$取值即可

项目发布

将写好的模块发布,提供他人使用

gradle怎么编译java项目 gradle build.gradle_java_02

发布步骤

1.引入maven发布插件

plugins {
    id 'maven-publish'
}

2.设置发布代码

publishing{
    publications{
        myLibrary(MavenPublication){
            groupId = 'cn.fly.xxx'
            artifactId = 'xxx'
            version = '1.0.1'
            from components.java //设置发布jar包
        }
    }
    repositories {
        //本地仓库
        mavenLocal()
        //发布到私服
        maven{
            name = '私服仓库名称'
            url = '本地仓库地址或私服仓库地址'
            def releasesRepoUrl = layout.buildDirectory.dir('repos/releases')
            def snapshotsRepoUrl = layout.buildDirectory.dir('repos/snapshots')
            url = version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl
            //配置认证信息
//            credentials{
//                username='zhangsan'
//                password='xxxxxxxx'
//            }
        }
    }
}

3.选择发布指令

  1. generatePomFileForPubNamePublication:生成pom文件
  2. publishPubNamePublication.ToRepoNameRepository:发布项目到指定仓库.如果没有仓库名,默认为maven
  3. publishPubNamePublicationToMavenLocal:将PubName 发布复制到本地Maven仓库中包括POM文件和其他元数据。
  4. publish:发布到repositories中指定的仓库(为比如Maven私服)
  5. publishToMavenLocal: 执行所有发布任务中的操作发布到本地 maven仓库【默认在用户目录下的.m2/repository】。

gradle怎么编译java项目 gradle build.gradle_java_03

生成Javadoc

我们需要添加java-library的插件

plugins {
    id 'java-library'
}

并配置如下属性

javadoc.options.encoding="UTF-8"

java{
	withJavadocJar()
	withSourcesJar()
}