如何声明gradle Antlr任务输出规范以避免不必要的重建

Question

我有一个典型的Antlr 4.5项目，其中有两个语法文件：MyLexer。g4和MyParser。Antlr从中生成6个输出文件：MyLexer。java，MyLexer。标记，MyParser。java，MyParser。令牌，MyParserBaseListener。java和MyParserListener。Java语言gradle任务都工作正常，因此输出文件都按预期生成、编译和测试。

问题是gradle认为这6个目标文件总是过时，因此每次运行或调试会话都必须重新生成它们，因此即使源文件没有更改，也必须重新编译主java项目。

生成文件的gradle任务将输出规范定义为生成6个输出文件的文件夹。我认为我需要一种方法将其定义为6个特定文件而不是输出文件夹。我只是不知道这样做的语法。

这是我构建的相关部分。gradle文件：

ext.antlr4 = [
    antlrSource:    "src/main/antlr",
    destinationDir: "src/main/java/com/myantlrquestion/core/antlr/generated",
    grammarpackage:               "com.myantlrquestion.core.antlr.generated"
]

task makeAntlrOutputDir << {
    file(antlr4.destinationDir).mkdirs()
}

task compileAntlrGrammars(type: JavaExec, dependsOn: makeAntlrOutputDir) {
    // Grammars are conveniently sorted alphabetically. I assume that will remain true.
    // That ensures that files named *Lexer.g4 are listed and therefore processed before the corresponding *Parser.g4
    // It matters because the Lexer must be processed first since the Parser needs the .tokens file from the Lexer.
    // Also note that the output file naming convention for combined grammars is slightly different from separate Lexer and Parser grammars.
    def grammars = fileTree(antlr4.antlrSource).include('**/*.g4')
    def target = file("${antlr4.destinationDir}")
    inputs.files grammars
    // TODO: This output spec is incorrect, so this task is never considered up to date.
    // TODO: Tweak the outputs collection so it is correct with combined grammars as well as separate Lexer and Parser grammars.
    outputs.dir target

    main = 'org.antlr.v4.Tool'
    classpath = configurations.antlr4
    // Antlr command line args are at https://theantlrguy.atlassian.net/wiki/display/ANTLR4/ANTLR+Tool+Command+Line+Options
    args = ["-o", target,
            "-lib", target,
            //"-listener",      //"-listener" is the default
            //"-no-visitor",    //"-no-visitor" is the default
            "-package", antlr4.grammarpackage,
            grammars.files 
    ].flatten()

    // include optional description and group (shown by ./gradlew tasks command)
    description = 'Generates Java sources from ANTLR4 grammars.'
    group       = 'Build'
}

compileJava {
    dependsOn compileAntlrGrammars
    // this next line isn't technically needed unless the antlr4.destinationDir is not under buildDir, but it doesn't hurt either
    source antlr4.destinationDir
}

task cleanAntlr {
    delete antlr4.destinationDir
}
clean.dependsOn cleanAntlr

Answer 1

请尝试以下代码：

generatedFiles = ['MyLexer.java',] // and so on..
generatedFiles.each { f -> outputs.file("$target/$f") }

Answer 2

我发现问题不在于目标文件过期了，而是因为在清理Antlr任务中的一个错误，每次运行任何gradle任务时，它们都会被删除。问题是在gradle的初始化和配置阶段，即使清理Antlr任务本身没有被执行，清理Antlr中的所有代码都在运行。

最初，任务定义为：

task cleanAntlr {
    delete antlr4.destinationDir
}
clean.dependsOn cleanAntlr

解决方案是这样定义它：（注意“

task cleanAntlr << {
    delete antlr4.destinationDir
}
clean.dependsOn cleanAntlr

...或者，为了更加清晰，请使用这个更详细但功能等效的任务定义：

task cleanAntlr {
    doLast() {
        // Be sure to wrap the execution phase code inside doLast(). 
        // Otherwise it will run during the initialization or configuration phase, even when an unrelated task is is run.
        // It would also run when the NetBeas IDE first loaded the project.
        //println 'Deleting Antlr Directory: ' + antlr4.destinationDir
        delete antlr4.destinationDir
    }
}
clean.dependsOn cleanAntlr

修复该错误后，CompileantlRGramars任务的原始输出规范可以正常工作。无需指定每个单独的输出文件。第15.9.2节对此进行了很好的解释https://gradle.org/docs/current/userguide/more_about_tasks.html.

def grammars = fileTree(antlr4.antlrSource).include('**/*.g4')
def target = file("${antlr4.destinationDir}")
inputs.files grammars
outputs.dir target