使用Java定义Gradle插件属性扩展的正确方法?

时间:2013-08-26 05:35:33

标签: java gradle

我正在尝试在Java中创建一个具有属性扩展的Gradle插件(不是约定,因为这显然是oldwrong方式。为了记录,我在Linux机器上使用Gradle 1.6(Ubuntu 12.04)。

我已经知道这应该在Plugin类定义中完成。这是添加扩展的一种方法。创建一个包含您的属性的扩展类:

public class MyPluginExtensions {

    File sourceDir;
    File outputDir;

    public MyPluginExtensions(Project project) {
        this.project = project;
        sourceDir = new File(project.getProjectDir(), "src");
        outputDir = new File(project.getBuildDir(), "out");
    }

}

现在将这些扩展添加到主插件类中的项目中:

public class MyPlugin implements Plugin<Project> {

    @Override
    public void apply(Project project) {

        Map<String,Object> taskInfo = new HashMap<String,Object>();
        taskInfo.put("type", MyPluginTask.class);
        taskInfo.put("description", "Generates blah from blah.");
        taskInfo.put("group", "Blah");
        Task myPluginTask = project.task(taskInfo, "myPluginTask");

        // Define conventions and attach them to tasks
        MyPluginExtensions extensions = new MyPluginExtensions(project);
        myPluginTask.getExtensions().add(
                "sourceDir", 
                extensions.sourceDir);
        myPluginTask.getExtensions().add(
                "outputDir", 
                extensions.outputDir);
    }
}

然而,这种方法似乎并不正确。新的项目属性显示在project.ext命名空间中。我希望能够将插件扩展名解决为:

in my build.gradle:
myPluginTask.sourceDir = file('the/main/src')
myPluginTask.outputDir = file('the/output')

然而,当我把这些东西放在使用我的插件并尝试设置此属性的gradle脚本中时,gradle告诉我我无法设置它:

* What went wrong:
A problem occurred evaluating script.
> There's an extension registered with name 'sourceDir'. You should not reassign it via a property setter.

那么,在基于Java的Gradle插件中为任务添加属性扩展的正确方法是什么?

修改

基于其他一些SO帖子,我尝试一次性添加我的扩展对象:

// first attempt:
//myPluginTask.getExtensions().add("sourceDir", extensions.sourceDir);
//myPluginTask.getExtensions().add("outputDir",extensions.outputDir);

// second attempt
myPluginTask.getExtensions().add("myPluginTask", extensions);

这似乎有效。但是,Gradle现在抱怨我添加了一个动态属性:

Deprecated dynamic property: "sourceDir" on "task ':myPluginTask'", value: "/Users/jfer...".

那么,再次,添加插件扩展属性的正确方法是什么?

编辑2

所以,再次尝试一下,我将扩展添加到项目对象并改为使用create方法:

// first attempt:
//myPluginTask.getExtensions().add("sourceDir", extensions.sourceDir);
//myPluginTask.getExtensions().add("outputDir",extensions.outputDir);

// second attempt
// myPluginTask.getExtensions().add("myPluginTask", extensions);

// third attempt
project.getExtensions().create("myPluginTask", MyPluginExtensions.class, project);

然而,由于以下几个原因,这会失败:

  1. 创建具有相同名称的属性扩展名(“myPluginTask”),因为任务会在任务名称和扩展名之间创建冲突,导致任务从gradle的角度消失(并抛出倾斜错误,例如“No such property” :dependsOn for class ... MyPluginExtensions“)。
  2. 如果我提供的名称不与任务名称冲突(例如“myPluginPropExt”),则create()方法可以正常工作,但是不要按照预期在自己的命名空间中添加扩展名(例如{{1}而是将它添加到项目命名空间(例如project.myPluginPropExt.propertyName)中,这不正确并导致Gradle抛出一堆“不推荐的动态属性”警告。

3 个答案:

答案 0 :(得分:3)

所以这是我的问题的 解决方案:

public class MyPlugin implements Plugin<Project> {

    @Override
    public void apply(Project project) {

        Map<String,Object> taskInfo = new HashMap<String,Object>();
        taskInfo.put("type", MyPluginTask.class);
        taskInfo.put("description", "Generates blah from blah.");
        taskInfo.put("group", "Blah");
        Task myPluginTask = project.task(taskInfo, "myPluginTask");

        // Define conventions and attach them to tasks
        MyPluginExtensions extensions = new MyPluginExtensions(project);

        // the magic extension code:
        project.getExtensions().add("myPluginName", extensions);
    }
}

现在我可以为我的 gradle.build 文件中的一个扩展属性设置一个值(并且我没有收到有关添加已弃用的动态属性的警告):

 myPluginName.sourceDir = file('the/main/src')

最后一招是在我的插件任务中获取此值:

public class MyPluginTask extends DefaultTask {
    @TaskAction
    public void action() {
        MyPluginExtensions extensions = (MyPluginExtensions) getProject()
                .getExtensions().findByName("myPluginName");

        System.out.println("sourceDir value: " + extensions.sourceDir);
    }
}

这很有效,但令我烦恼的是这个解决方案是我希望能够将扩展属性放在与我在基于groovy的插件中看到的任务相同的命名空间(例如myPluginTask.sourceDir)中,但这显然不受支持或只是不起作用。

与此同时,希望这有助于其他人。

答案 1 :(得分:0)

代码正在为任务(而不是项目)添加扩展,这很少有用。之后,它会尝试设置myPluginTask.sourceDir = file('the/main/src'),这是不可能的,因为扩展程序只是以相同的名称注册。

答案 2 :(得分:0)

当您的任务和扩展程序具有相同名称时,您可以在 build.gradle 中执行此操作:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On

RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [R,L]

RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]

RewriteCond %{REQUEST_URI} ^parent-page/child-page/
RewriteCond %{HTTPS} on   
RewriteRule (.*) http://%{HTTP_HOST}%{REQUEST_URI} [R,L]
</IfModule>
# END WordPress