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

例如構(gòu)建 Java 應(yīng)用的功能就是通過 Java 插件實現(xiàn)的。

Gradle 內(nèi)置了很多核心語言插件，基本上能滿足大部分的構(gòu)建工作雾鬼，但有些插件沒有內(nèi)置或者有些功能沒有提供膀藐，我們也可以自定義插件來使用屠阻，例如 Android Gradle 插件就是基于 Java 插件擴展的。

插件的作用

插件可以封裝一系列任務(wù)额各，例如 編譯国觉，測試，打包等虾啦。

插進可以定義約定麻诀，例如 應(yīng)用Java 插件后，約定的源代碼位置就在 src/main/java 目錄下傲醉。

插件可以封裝配置蝇闭，當項目應(yīng)用插件時自動應(yīng)用插進的配置。

插件可以擴展 Gradle 模型硬毕，添加可配置的 DSL 元素呻引，例如 Android Gradle 的 android{}

這就是插件，我們只需要按照它的約定的方式吐咳，使用它提供的任務(wù)逻悠、方法或擴展就可以對我們的項目進行構(gòu)建。

使用插件可以將相似的代碼進行封裝以提高重用性韭脊，使構(gòu)建腳本高度模塊化童谒，增強組織性和可讀性。

插件類型

Gradle 有兩種插件

• 腳本插件
• 二進制插件

腳本插件

腳本插件通常是一個腳本乾蓬。

腳本插件其實并不能算是一個真正的插件惠啄，但我們不能忽視它的作用，它是腳本模塊化的基礎(chǔ)。

我們可以把復雜的腳本文件撵渡，進行分塊融柬，分段整理，拆分成一個個職責分明的腳本插件趋距。

就像我們平常封裝的 Utils 工具類一樣粒氧，封裝一個 utils.gradle 工具腳本

二進制插件

二進制插件是實現(xiàn)了Plugin 接口的插件，以編程的方式操縱構(gòu)建节腐。

二進制插件一般是打包在一個 jar 里獨立發(fā)布的外盯。

發(fā)現(xiàn)插件

Gradle 專門有一個網(wǎng)站可以發(fā)布和尋找插件 https://plugins.gradle.org

當然也可以在 Github 上搜索，開源的力量是強大的翼雀。

使用插件

要使用一個插件必選先找到它饱苟，然后把它應(yīng)用到我們的項目。

將插件應(yīng)用到我們的項目就可以使用它了狼渊。

所以使用一個插件需要兩步：

1. 找到插件并添加到類路徑
2. 應(yīng)用插件到項目

一旦插件被應(yīng)用就可以使用它的 API 了箱熬。

應(yīng)用插件就是在目標項目執(zhí)行插件的 Plugin.apply(T) 方法。

插件的應(yīng)用是冪等的狈邑，應(yīng)用多次和一次的效果是一樣的城须。

應(yīng)用腳本插件

前面說過腳本插件其實就是一個腳本，應(yīng)用腳本插件其實就是將這個腳本加載進來米苹。

使用 apply from 將腳本加載進來

apply from: 'other.gradle'

腳本可以存在本地糕伐，也可以存在網(wǎng)絡(luò)上。

存在本地就使用本項目的相對路徑蘸嘶。

存在網(wǎng)絡(luò)上就要使用 HTTP URL 良瞧。

應(yīng)用二進制插件

二進制插件應(yīng)用是通過他們的 ID 應(yīng)用的。

插件 ID 是插件的全局唯一標識符或者名字

Gradle 核心插件的特殊之處就在于他們都有一個簡短的 ID亏较，例如 Java 插件的是 "java" 莺褒。

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

插件 ID 在哪用就取決于你是使用 plugins{} 還是 buildscript{} 了雪情。

核心插件是作為 Gardle 的一部分在應(yīng)用時是由 Gradle 分發(fā)并自動解析的遵岩。

而其他的二進制插件則必須在應(yīng)用前被找到并解析。

Gradle 通常是在下面這個幾個地方去尋找

• 在上述提到的 Plugins 網(wǎng)站上或者自定義的倉庫里
• 在指定的外部依賴 jar
• 在項目的 buildSrc 目錄下尋找源文件
• 聲明在腳本里的插件

目前有兩種方式使用插件巡通，一種是使用新推出的 plugins{} 應(yīng)用插件尘执，另一種是使用 buildscript{} 應(yīng)用插件。

目前 Gradle 推薦使用 plugins{} 宴凉。

下面是兩個方式的使用方法誊锭。

使用 buildscript{} 應(yīng)用二進制插件

使用 buildscript{} 塊應(yīng)用的二進制插件都是通過 Project.apply() 方法完成的。

應(yīng)用 Java 插件: build.gradle

apply plugin: 'java'

這里的 "java" 就是 Java 插件的 ID弥锄，它對應(yīng)的類型是 org.gradle.api.plugins.JavaPlugin

也可以通過類型應(yīng)用插件：build.gradle

apply org.gradle.api.plugins.JavaPlugin

因為 org.gradle.api.plugins 是默認導入的丧靡，所以也可以直接去掉包名稱直接寫為

apply plugin:JavaPlugin

要使用第三方的插件就必須先在 buildscript{} 配置 類路徑才可以使用蟆沫。

這個不像 Gradle 的內(nèi)置插件，是由 Gradle 負責分發(fā)的温治。

例如我們的 Android Gradle 插進饭庞，就屬于 Android 發(fā)布的第三方插件，如果要使用就先要進行配置

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

因為 Android Gradle 插進是托管在 jcenter 倉庫上熬荆，所以必須在 repositories{} 添加 jcenter 倉庫舟山。

buildscript{} 塊是一個在構(gòu)建項目之前，為項目進行前期準備和初始化相關(guān)配置依賴的地方卤恳，配置好所需的依賴累盗，就可以應(yīng)用插件了：

apply plugin: 'com.android.application'

如果沒有提前在 buildscript{} 里配置依賴的類路徑，會提示找不到這個插件突琳。

使用 plugins DSL 應(yīng)用二進制插件

plugins DSL 配置可以很方便的訪問 Gradle 插件網(wǎng)站上的插件若债。

這個配置塊配置的是一個PluginDependenciesSpec 實例

應(yīng)用核心插件

plugins {
    id 'java'
}

使用插件 ID （必須是完全限定形式）應(yīng)用第三方插件

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

使用 plugins{} 應(yīng)用插件就不用先配置依賴然后再使用 apply 方法了，只需要在 plugins{} 里配置就可以了本今。

plugins DSL 的限制

雖然 plugins DSL 將使用插件的步驟精簡了拆座，但還是有一些限制的，它的語法被固定了冠息，不能改變

plugins {
    id ?plugin id?                                            // (1)
    id ?plugin id? version ?plugin version? [apply ?false?]   // (2)
}

1. 適用于有簡寫名字的核心插件或者已經(jīng)加載過的第三方插件
2. 適用于需要被解析的第三方插件

plugin id 和 plugin version 是必需的 且必須是常量,字面量,字符串.其他語句都是不允許的

apply 是可選的，默認是 true孕索；它是控制在應(yīng)用插件的時候是否立刻使用插件的默認行為逛艰。

這個 plugins{} 塊 是不能嵌套在別的配置塊里的，必須是腳本的頂級模塊搞旭。

在目前的 5.6.2 版本里 plugins{} 只能在項目的構(gòu)建腳本里使用散怖，不能在腳本插件里，settings.gradle 以及 init.gradle 腳本里肄渗。

應(yīng)用插件到子項目

可以利用 plugins {} 的 apply 選項將插件應(yīng)用到某些項目而不是所有項目里镇眷。

默認 plugins {} 的插件是立即被解析并應(yīng)用的。

可以使用 apply false 告訴 Gradle 不應(yīng)用到當前項目,
然后在子項目的腳本中使用 apply plugin <<plugin id>> 或者 plugins{} 應(yīng)用插件

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'
}

上面的示例演示了如何給多個子項目分別應(yīng)用不同的插件翎嫡。

使用 buildSrc 目錄下的插件

項目的 buildSrc 目錄下的插件也是可以使用的欠动，但必須定義插件 ID 。

下面是一個使用 buildSrc 目錄下的插件的示例

這個插件 ID 是 my-plugin 實現(xiàn)的插件類是 my.MyPlugin
buildSrc/build.gradle

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

gradlePlugin {
    plugins {
        myPlugins {
            id = 'my-plugin'
            implementationClass = 'my.MyPlugin'
        }
    }
}

dependencies {
    compileOnly gradleApi()
}

使用插件

plugins {
    id 'my-plugin'
}

Plugin Management

這個 pluginManagement DSL 是用來管理插件的惑申，它可以配置插件具伍，自定義倉庫，自定義解析規(guī)則等圈驼。

pluginManagement{} 只能定義在兩個地方：

• settings.gradle 里人芽，并且必須是第一個模塊
• init.gradle 里

settings.gradle

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

init.gradle

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

自定義倉庫

plugins 默認是在 Gradle 的插件網(wǎng)站尋找插件的

我們可以在 pluginManagement{} 里的 repositories{} 里配置自己的倉庫

Gradle 會按照配置的倉庫順序依次尋找插件

settings.gradle

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

首先在位于 ../maven-repo 的Maven 倉庫找，找不到再去 Gradle 的插件網(wǎng)站 绩脆，最后是位于 ../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

解析規(guī)則

解析規(guī)則就是解析插件的規(guī)則惕味，通過自定義插件規(guī)則可以更改 plugins{} 塊中的插件請求害碾，例如更改請求的版本或顯式指定實現(xiàn)工件坐標。

解析規(guī)則是在 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 使用指定的插件實現(xiàn)工件慌随，而不是使用從插件 ID 到 Maven / lvy 坐標的內(nèi)置默認映射。

除了實際實現(xiàn)插件的工件之外躺同，自定義 Maven 和 lvy 插件倉庫必需包含 插件標記工件阁猜。

關(guān)于將插件發(fā)布到自定義的倉庫的可以查看 Gradle 插件開發(fā)：
傳送門

Plugin Marker Artifacts (插件標記工件)

這里插入一個 Maven 中的概念：Artifact (工件)

Artifact 的概念比較抽象，它是 Maven 項目將要產(chǎn)生的文件蹋艺。
一個Maven 項目可能會產(chǎn)生多個 Artifact 剃袍，可能是 jar 文件，源文件捎谨，二進制文件民效，war 文件，甚至是 pom 文件涛救。
每一個 artifact 都有一個 group ID (通常是反轉(zhuǎn)的域名畏邢，就像包名)，一個 artifact ID （一個名字）以及一個版本號检吆，
這三個組合在一個表示一個 artifact 的坐標：groupId:artifiactId:version

由于 plugins DSL 塊只允許通過全局唯一的插件 id 和 version 屬性聲明插件舒萎，因此 Gradle 需要一種方法來查找 插件實現(xiàn)工件 的坐標。
為此蹭沛，Gradle 將使用坐標查找 插件標記工件 plugin.id:plugin.id.gradle.plugin:plugin.version 臂寝。
此標記需要依賴于實際的插件實現(xiàn)。java-gradle-plugin 會自動發(fā)布這些標記摊灭。

例如咆贬，下面的完整示例 sample-plugins 演示了如何使用 java-gradle-plugin，maven-publish 插件和 ivy-publish 插件的組合將 org.gradle.sample.hello 插件和 org.gradle.sample.goodbye 插件發(fā)布到 Ivy 和 Maven 倉庫帚呼。

完整插件發(fā)布示例

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

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

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

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

運行 gradle publish 將會產(chǎn)生如下結(jié)構(gòu)

pluginMarker.png

就像前面提到的 插件標記工件 的坐標和插件 id 的映射關(guān)系掏缎。

下面以 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

對應(yīng)的就是上面說到的 plugin.id: plugin.id.gradle.plugin:plugin.version

如果我描述的不好或者不太詳細，可以查看 《Android Gradle 權(quán)威指南》 和 Gradle 用戶手冊萝挤。

微信掃一掃御毅，關(guān)注我的公眾號