API 文件 | PluginManager |
---|
有助於應用外掛並判斷哪些外掛已應用於 PluginAware
物件。
方法 | 描述 |
apply(type) | 應用給定的外掛。如果外掛已應用,則不執行任何操作。 |
apply(pluginId) | 應用具有給定 ID 的外掛。如果外掛已應用,則不執行任何操作。 |
findPlugin(id) | 傳回已應用給定 ID 的外掛資訊,如果沒有應用具有給定 ID 的外掛,則傳回 null。 |
hasPlugin(id) | 如果已應用具有給定 ID 的外掛,則傳回 |
withPlugin(id, action) | 當指定的外掛應用時,執行給定的動作。 |
void
apply
(Class
<?>
type)
Class
<?>應用給定的外掛。如果外掛已應用,則不執行任何操作。
給定的類別應實作 Plugin
介面,並針對相容的 this
類型進行參數化。
以下兩行程式碼是等效的…
pluginManager.apply org.gradle.api.plugins.JavaPlugin
pluginManager.apply "org.gradle.java"
void
apply
(String
pluginId)
應用具有給定 ID 的外掛。如果外掛已應用,則不執行任何操作。
在 "org.gradle"
命名空間中的外掛可以直接透過名稱應用。也就是說,以下兩行程式碼是等效的…
pluginManager.apply "org.gradle.java" pluginManager.apply "java"
AppliedPlugin
findPlugin
(String
id)
傳回已應用給定 ID 的外掛資訊,如果沒有應用具有給定 ID 的外掛,則傳回 null。
在 "org.gradle"
命名空間中的外掛(即核心 Gradle 外掛)可以透過名稱(例如 "java"
)或 ID "org.gradle.java"
指定。所有其他外掛都必須使用其完整 ID 查詢(例如 "org.company.some-plugin"
)。
某些 Gradle 外掛程式尚未遷移到完全限定的外掛 ID。可以使用此方法透過僅使用非限定 ID(例如 "some-third-party-plugin"
)偵測到此類外掛。
boolean
hasPlugin
(String
id)
如果已應用具有給定 ID 的外掛,則傳回 true
,否則傳回 false
。
void
withPlugin
(String
id, Action
<? super AppliedPlugin
>
action)
Action
<? super AppliedPlugin
>當指定的外掛應用時,執行給定的動作。
如果已應用具有指定 ID 的外掛,則將立即執行提供的動作。否則,將在外掛應用具有指定 ID 後立即執行動作。
給定的動作總是在外掛應用後執行。