Gradle 插件

摘要:
Gradle本身只提供基本框架和核心概念,几乎所有功能都以插件的形式提供。插件类型Gradle有两种插件脚本插件二进制插件脚本插件脚本插件通常是一个脚本。发现插件Gradle有一个专门用于发布和搜索插件的网站https://plugins.gradle.org当然,你也可以在Github上搜索。开源的力量是强大的。目前,Gradle建议使用插件{}。与Gradle的内置插件不同,它是由Gradle发布的。使用pluginsDSL应用二进制插件pluginsDSL配置可以轻松访问Gradle插件网站上的插件。

Gradle 本身只提供基本框架和核心概念,几乎所有的功能都是以插件的方式提供的。

例如构建 Java 应用的功能就是通过 Java 插件实现的。

Gradle 内置了很多核心语言插件,基本上能满足大部分的构建工作,但有些插件没有内置或者有些功能没有提供,我们也可以自定义插件来使用,例如 Android Gradle 插件就是基于 Java 插件扩展的。

插件的作用

插件可以封装一系列任务,例如 编译,测试,打包等。

插进可以定义约定,例如 应用Java 插件后,约定的源代码位置就在 src/main/java 目录下。

插件可以封装配置,当项目应用插件时自动应用插进的配置。

插件可以扩展 Gradle 模型,添加可配置的 DSL 元素,例如 Android Gradle 的 android{}

这就是插件,我们只需要按照它的约定的方式,使用它提供的任务、方法或扩展就可以对我们的项目进行构建。

使用插件可以将相似的代码进行封装以提高重用性,使构建脚本高度模块化,增强组织性和可读性。

插件类型

Gradle 有两种插件

  • 脚本插件
  • 二进制插件

脚本插件

脚本插件通常是一个脚本。

脚本插件其实并不能算是一个真正的插件,但我们不能忽视它的作用,它是脚本模块化的基础。

我们可以把复杂的脚本文件,进行分块,分段整理,拆分成一个个职责分明的脚本插件。

就像我们平常封装的 Utils 工具类一样,封装一个 utils.gradle 工具脚本

二进制插件

二进制插件是实现了Plugin 接口的插件,以编程的方式操纵构建。

二进制插件一般是打包在一个 jar 里独立发布的。

发现插件

Gradle 专门有一个网站可以发布和寻找插件 https://plugins.gradle.org

当然也可以在 Github 上搜索,开源的力量是强大的。

使用插件

要使用一个插件必选先找到它,然后把它应用到我们的项目。

将插件应用到我们的项目就可以使用它了。

所以使用一个插件需要两步:

  1. 找到插件并添加到类路径
  2. 应用插件到项目

一旦插件被应用就可以使用它的 API 了。

应用插件就是在目标项目执行插件的 Plugin.apply(T) 方法。

插件的应用是幂等的,应用多次和一次的效果是一样的。

应用脚本插件

前面说过脚本插件其实就是一个脚本,应用脚本插件其实就是将这个脚本加载进来。

使用 apply from 将脚本加载进来

apply from: 'other.gradle'

脚本可以存在本地,也可以存在网络上。

存在本地就使用本项目的相对路径。

存在网络上就要使用 HTTP URL 。

应用二进制插件

二进制插件应用是通过他们的 ID 应用的。

插件 ID 是插件的全局唯一标识符或者名字

Gradle 核心插件的特殊之处就在于他们都有一个简短的 ID,例如 Java 插件的是 "java" 。

其他所有的二进制插件都必须使用完全限定形式的插件 ID (com.github.foo.bar) 。

插件 ID 在哪用就取决于你是使用 plugins{} 还是 buildscript{} 了。

核心插件是作为 Gardle 的一部分在应用时是由 Gradle 分发并自动解析的。

而其他的二进制插件则必须在应用前被找到并解析。

Gradle 通常是在下面这个几个地方去寻找

  • 在上述提到的 Plugins 网站上或者自定义的仓库里
  • 在指定的外部依赖 jar
  • 在项目的 buildSrc 目录下寻找源文件
  • 声明在脚本里的插件

目前有两种方式使用插件,一种是使用新推出的 plugins{} 应用插件,另一种是使用 buildscript{} 应用插件。

目前 Gradle 推荐使用 plugins{} 。

下面是两个方式的使用方法。

使用 buildscript{} 应用二进制插件

使用 buildscript{} 块应用的二进制插件都是通过 Project.apply() 方法完成的。

应用 Java 插件: build.gradle

apply plugin: 'java'

这里的 "java" 就是 Java 插件的 ID,它对应的类型是 org.gradle.api.plugins.JavaPlugin

也可以通过类型应用插件:build.gradle

apply org.gradle.api.plugins.JavaPlugin

因为 org.gradle.api.plugins 是默认导入的,所以也可以直接去掉包名称直接写为

apply plugin:JavaPlugin

要使用第三方的插件就必须先在 buildscript{} 配置 类路径才可以使用。

这个不像 Gradle 的内置插件,是由 Gradle 负责分发的。

例如我们的 Android Gradle 插进,就属于 Android 发布的第三方插件,如果要使用就先要进行配置

buildscript {
    repositories {
        mavenCentral()
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.2.0'
    }
}

因为 Android Gradle 插进是托管在 jcenter 仓库上,所以必须在 repositories{} 添加 jcenter 仓库。

buildscript{} 块是一个在构建项目之前,为项目进行前期准备和初始化相关配置依赖的地方,配置好所需的依赖,就可以应用插件了:

apply plugin: 'com.android.application'

如果没有提前在 buildscript{} 里配置依赖的类路径,会提示找不到这个插件。

使用 plugins DSL 应用二进制插件

plugins DSL 配置可以很方便的访问 Gradle 插件网站上的插件。

这个配置块配置的是一个PluginDependenciesSpec 实例

应用核心插件

plugins {
    id 'java'
}

使用插件 ID (必须是完全限定形式)应用第三方插件

plugins {
    id 'com.jfrog.bintray' version '0.4.1'
}

使用 plugins{} 应用插件就不用先配置依赖然后再使用 apply 方法了,只需要在 plugins{} 里配置就可以了。

plugins DSL 的限制

虽然 plugins DSL 将使用插件的步骤精简了,但还是有一些限制的,它的语法被固定了,不能改变

plugins {
    id «plugin id»                                            // (1)
    id «plugin id» version «plugin version» [apply «false»]   // (2)
}
  1. 适用于有简写名字的核心插件或者已经加载过的第三方插件
  2. 适用于需要被解析的第三方插件

plugin id 和 plugin version 是必需的 且必须是常量,字面量,字符串.其他语句都是不允许的

apply 是可选的,默认是 true;它是控制在应用插件的时候是否立刻使用插件的默认行为。

这个 plugins{} 块 是不能嵌套在别的配置块里的,必须是脚本的顶级模块。

在目前的 5.6.2 版本里 plugins{} 只能在项目的构建脚本里使用,不能在脚本插件里,settings.gradle 以及 init.gradle 脚本里。

应用插件到子项目

可以利用 plugins {} 的 apply 选项将插件应用到某些项目而不是所有项目里。

默认 plugins {} 的插件是立即被解析并应用的。

可以使用 apply false 告诉 Gradle 不应用到当前项目,
然后在子项目的脚本中使用 apply plugin <> 或者 plugins{} 应用插件

settings.gradle

include 'helloA'
include 'helloB'
include 'goodbyeC'

build.gradle

plugins {
    id 'org.gradle.sample.hello' version '1.0.0' apply false
    id 'org.gradle.sample.goodbye' version '1.0.0' apply false
}



subprojects {
    if (name.startsWith('hello')) {
        apply plugin: 'org.gradle.sample.hello'
    }
}

goodbyeC/build.gradle

plugins {
    id 'org.gradle.sample.goodbye'
}

上面的示例演示了如何给多个子项目分别应用不同的插件。

使用 buildSrc 目录下的插件

项目的 buildSrc 目录下的插件也是可以使用的,但必须定义插件 ID 。

下面是一个使用 buildSrc 目录下的插件的示例

这个插件 ID 是 my-plugin 实现的插件类是 my.MyPlugin
buildSrc/build.gradle

plugins {
    id 'java'
    id 'java-gradle-plugin'
}

gradlePlugin {
    plugins {
        myPlugins {
             
            implementationClass = 'my.MyPlugin'
        }
    }
}

dependencies {
    compileOnly gradleApi()
}

使用插件

plugins {
    id 'my-plugin'
}

Plugin Management

这个 pluginManagement DSL 是用来管理插件的,它可以配置插件,自定义仓库,自定义解析规则等。

pluginManagement{} 只能定义在两个地方:

  • settings.gradle 里,并且必须是第一个模块
  • init.gradle 里

settings.gradle

pluginManagement {
    plugins {
    }
    resolutionStrategy {
    }
    repositories {
    }
}

init.gradle

settingsEvaluated { settings ->
    settings.pluginManagement {
        plugins {
        }
        resolutionStrategy {
        }
        repositories {
        }
    }
}

自定义仓库

plugins 默认是在 Gradle 的插件网站寻找插件的

我们可以在 pluginManagement{} 里的 repositories{} 里配置自己的仓库

Gradle 会按照配置的仓库顺序依次寻找插件

settings.gradle

pluginManagement {
    repositories {
        maven {
            url '../maven-repo'
        }
        gradlePluginPortal()
        ivy {
            url '../ivy-repo'
        }
    }
}

首先在位于 ../maven-repo 的Maven 仓库找,找不到再去 Gradle 的插件网站 ,最后是位于 ../ivy-repo 的 ivy 仓库。

插件版本管理

在 pluginManagement{} 里的 plugins{} 里配置插件是没有固定语法限制的。

可以把所有的版本都放在一个单独的脚本里,或者是使用 gradle.properties 文件配置属性

settings.gradle

pluginManagement {
  plugins {
        id 'org.gradle.sample.hello' version "${helloPluginVersion}"
    }
}

build.gradle

plugins {
    id 'org.gradle.sample.hello'
}

gradle.properties

helloPluginVersion=1.0.0

解析规则

解析规则就是解析插件的规则,通过自定义插件规则可以更改 plugins{} 块中的插件请求,例如更改请求的版本或显式指定实现工件坐标。

解析规则是在 pluginManagement{} 里的 resolutionStrategy{} 里配置的。

插件解析策略:

pluginManagement {
    resolutionStrategy {
        eachPlugin {
            if (requested.id.namespace == 'org.gradle.sample') {
                useModule('org.gradle.sample:sample-plugins:1.0.0')
            }
        }
    }
    repositories {
        maven {
            url '../maven-repo'
        }
        gradlePluginPortal()
        ivy {
            url '../ivy-repo'
        }
    }
}

这告诉 Gradle 使用指定的插件实现工件,而不是使用从插件 ID 到 Maven / lvy 坐标的内置默认映射。

除了实际实现插件的工件之外,自定义 Maven 和 lvy 插件仓库必需包含 插件标记工件。

关于将插件发布到自定义的仓库的可以查看 Gradle 插件开发:
传送门

Plugin Marker Artifacts (插件标记工件)

这里插入一个 Maven 中的概念:Artifact (工件)

Artifact 的概念比较抽象,它是 Maven 项目将要产生的文件。
一个Maven 项目可能会产生多个 Artifact ,可能是 jar 文件,源文件,二进制文件,war 文件,甚至是 pom 文件。
每一个 artifact 都有一个 group ID (通常是反转的域名,就像包名),一个 artifact ID (一个名字)以及一个版本号,
这三个组合在一个表示一个 artifact 的坐标:groupId:artifiactId:version

由于 plugins DSL 块只允许通过全局唯一的插件 id 和 version 属性声明插件,因此 Gradle 需要一种方法来查找 插件实现工件 的坐标。
为此,Gradle 将使用坐标查找 插件标记工件 plugin.id:plugin.id.gradle.plugin:plugin.version 。
此标记需要依赖于实际的插件实现。java-gradle-plugin 会自动发布这些标记。

例如,下面的完整示例 sample-plugins 演示了如何使用 java-gradle-plugin,maven-publish 插件和 ivy-publish 插件的组合将 org.gradle.sample.hello 插件和 org.gradle.sample.goodbye 插件发布到 Ivy 和 Maven 仓库。

完整插件发布示例

plugins {
    id 'java-gradle-plugin'
    id 'maven-publish'
    id 'ivy-publish'
}

group 'org.gradle.sample'
version '1.0.0'

gradlePlugin {
    plugins {
        hello {
             
            implementationClass = 'org.gradle.sample.hello.HelloPlugin'
        }
        goodbye {
             
            implementationClass = 'org.gradle.sample.goodbye.GoodbyePlugin'
        }
    }
}

publishing {
    repositories {
        maven {
            url '../../consuming/maven-repo'
        }
        ivy {
            url '../../consuming/ivy-repo'
        }
    }
}

运行 gradle publish 将会产生如下结构
publish 结果

就像前面提到的 插件标记工件 的坐标和插件 id 的映射关系。

下面以 hello 插件举例

  • id 是 org.gradle.sample.hello
  • 版本是 1.0.0

位于 Maven 仓库的 artifact 坐标就是 org.gradle.sample.hello:org.gradle.sample.gradle.plugin:1.0.0

  • groupId: org.gradle.sample
  • artifactId: org.gradle.sample.gradle.plugin
  • version: 1.0.0

对应的就是上面说到的 plugin.id: plugin.id.gradle.plugin:plugin.version


如果我描述的不好或者不太详细,可以查看 《Android Gradle 权威指南》 和 Gradle 用户手册。

免责声明:文章转载自《Gradle 插件》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇防止你的iPhone程序遭盗版(入门篇)Centos7增加磁盘空间并挂载目录(VMware)下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

Gradle添加本地jar包,Maven添加本地jar包

解决问题: gradle添加本地jar包? gradle添加ojdbc? maven添加本地jar包? 1. 为什么ojdbc不能直接导入gradle工程中? 应为ojdbc在oracle的Maven仓库中,在中央Maven仓库中,ojdbc是非法的,所以不能直接从中央Maven仓库中拉取。 2. gradle添加本地jar包? 3. maven添加本地...

Gradle配置最佳实践

https://blog.csdn.net/devilnov/article/details/53321164 本文会不定期更新,推荐watch下项目。如果喜欢请star,如果觉得有纰漏请提交issue,如果你有更好的点子可以提交pull request。本文意在分享作者在实践中掌握的关于gradle的一些技巧。 本文固定连接:https://github...

Crash日志解析

当应用程序崩溃时,会创建一个崩溃报告,这对于了解导致崩溃的原因非常有用。本文档包含有关如何表示,理解和解释崩溃报告的基本信息。 1、介绍 2、获取崩溃和低内存报告 3、象征性的奔溃报告 1、位码(bitCode) 2、确定奔溃报告是否符号化 3、用Xcode标记iOS奔溃报告 4、用atos表示崩溃报告 5、符号故障排除 4、崩溃报告分析 1、...

[C#]使用WebClient上传文件并同时Post表单数据字段到服务端

转自:http://www.97world.com/archives/2963    之前遇到一个问题,就是使用WebClient上传文件的同时,还要Post表单数据字段,一开始以为WebClient可以直接做到,结果发现如果先Post表单字段,就只能获取到字段及其值,如果先上传文件,也只能获取到上传文件的内容。测试了不少时间才发现WebClient不能这...

gradle(转)

一、声明dependency     在build.gradle文件编辑以下代码: Java代码    apply plugin: 'java'      repositories {       mavenCentral()   }      dependencies {       compile group: 'org.hiberna...

【腾讯Bugly干货分享】Android 新一代多渠道打包神器

关于作者: 李涛,腾讯Android工程师,14年加入腾讯SNG增值产品部,期间主要负责手Q动漫、企鹅电竞等项目的功能开发和技术优化。业务时间喜欢折腾新技术,写一些技术文章,个人技术博客:www.ltlovezh.com 。 ApkChannelPackage是一种快速多渠道打包工具,同时支持基于V1和V2签名进行渠道打包。插件本身会自动检测Apk使用的签...