Gradle插件:Convention vs. Extension

时间:2013-07-11 08:59:30

标签: plugins gradle

我正在编写Gradle插件,我正在通过阅读用户指南和Gradle项目中插件的源代码来学习Gradle。

在源代码中,我找到了两种向项目添加属性的方法:

  • 约定(由JavaBasePlugin设置并由JavaPlugin使用)
  • 扩展程序(由AnnoncePlugin设置并由BuildAnnouncementsPlugin使用)。

我不明白它们之间的区别以及使用哪种情况。有人可以解释一下吗?

PS:有人可以在SO中添加标签“gradle-plugin”吗?

1 个答案:

答案 0 :(得分:7)

我在forum of Gradle上找到了答案:

  

扩展和约定是动态扩展构建模型的类似(但不完全相同)的方法。扩展是更新的概念,并且在很大程度上取代了惯例。简而言之,只使用扩展,不要使用约定。

     

[...]

     

扩展是在用户定义的名称下附加到构建模型的任意(通常是用户定义的)类的实例。扩展类可以定义任意方法。假设它附加到Project对象,扩展允许您添加project.foo.someMethod,但不允许添加project.someMethod。由于每个扩展都有自己的命名空间(在本例中为foo),名称冲突的可能性大大降低(与约定相比)。