如何指定 Maven 编译器插件顺序

how to specify maven compiler plugin order

我正在使用 maven 开发 java 和 kotlin 混合项目。

我现在面临的问题是,maven-compiler-plugin 在编译之前运行 kotlin-maven-plugin

[INFO] --- maven-compiler-plugin:3.0:compile (default-compile) @annotation --- 
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 11 source files to /Users/hannes/workspace/tikxml/annotation/target/classes 
[INFO] --- kotlin-maven-plugin:1.0.0-beta-4583:compile (compile) @ annotation 
[INFO] Kotlin Compiler version 1.0.0-beta-4583

在我的 java 源代码中,我引用了用 kotlin 编写的 类。但是 javac 在 kotlinc 之前运行。因此,maven 会因编译器错误而中断。

我的 pom(父 pom,我使用子模块)如下所示:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.sonatype.oss</groupId>
        <artifactId>oss-parent</artifactId>
        <version>7</version>
    </parent>

    ...

    <modules>
        <module>core</module>
        <module>annotation</module>
        <module>processor</module>
    </modules>


    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <java.version>1.7</java.version>
        <kotlin.version>1.0.0-beta-4583</kotlin.version>
    </properties>


    <build>
        <pluginManagement>
            <plugins>

                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.0</version>
                    <configuration>
                        <source>${java.version}</source>
                        <target>${java.version}</target>
                    </configuration>
                </plugin>
            </plugins>


        </pluginManagement>

        <plugins>

            <plugin>
                <groupId>org.jetbrains.kotlin</groupId>
                <artifactId>kotlin-maven-plugin</artifactId>
                <version>${kotlin.version}</version>
                <executions>
                    <execution>
                        <id>compile</id>
                        <phase>compile</phase>
                        <goals>
                            <goal>compile</goal>
                        </goals>
                        <configuration>
                            <sourceDirs>
                                <source>src/main/java</source>
                            </sourceDirs>
                        </configuration>
                    </execution>
                    <execution>
                        <id>test-compile</id>
                        <phase>test-compile</phase>
                        <goals>
                            <goal>test-compile</goal>
                        </goals>
                        <configuration>
                            <sourceDirs>
                                <source>src/test/java</source>
                            </sourceDirs>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

        </plugins>
    </build>

</project>

一个简单但有效的解决方案是更改应用于 Kotlin Maven 插件执行的两个阶段(<phase> 元素),从 compileprocess-sources 和从test-compileprocess-test-sources

您希望 Kotlin 部分在 Java 之前执行。默认情况下,Maven 将调用 Maven 编译器插件作为源代码 compile 阶段和测试代码 test-compile 阶段的一部分。将 Kotlin 部分移动到它们之前的阶段将按照您的意愿进行流程。

如果您想要相反的方向(首先是 Java 然后是 Kotlin),那么您可以将 Kotlin 部分移至下一阶段(例如:从 compileprocess-classestest-compileprocess-test-classes).

有关 Maven 阶段的更多详细信息,请查看 official documentation

关于 Using Maven 的 Kotlin 文档建议将 kotlin-maven-plugin 执行明确绑定到 process-sources 阶段。由于 maven-compiler-plugin 绑定到 compile 阶段,因此将 kotlin-maven-plugin 绑定到 process-sources 阶段使其首先成为 运行。

<plugin>
    <artifactId>kotlin-maven-plugin</artifactId>
    <groupId>org.jetbrains.kotlin</groupId>
    <version>${kotlin.version}</version>

    <executions>
        <execution>
            <id>compile</id>
            <phase>process-sources</phase>
            <goals> <goal>compile</goal> </goals>
        </execution>

        <execution>
            <id>test-compile</id>
            <phase>process-test-sources</phase>
            <goals> <goal>test-compile</goal> </goals>
        </execution>
    </executions>
</plugin>

如果您愿意使用不同的构建系统,可以使用 Kobalt:

轻松设置依赖项目
val p1 = javaProject { ... }

val p2 = kotlinProject(p1) { ... }

这使得项目 p2 依赖于 p1。您还可以混合使用 Java 和 Kotlin 项目。

虽然比较冗长,但您可以使用以下配置在 compile 阶段同时编译 Java 和 Kotlin 源代码:

<plugin>
    <artifactId>kotlin-maven-plugin</artifactId>
    <groupId>org.jetbrains.kotlin</groupId>
    <version>${kotlin.version}</version>
    <executions>
        <execution>
            <id>kotlin-compile</id>
            <phase>compile</phase>
            <goals>
                <goal>compile</goal>
            </goals>
        </execution>
        <execution>
            <id>kotlin-test-compile</id>
            <phase>test-compile</phase>
            <goals>
                <goal>test-compile</goal>
            </goals>
        </execution>
    </executions>
</plugin>
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.5</version>
    <executions>
        <execution>
            <id>default-compile</id>
            <phase>none</phase>
        </execution>
        <execution>
            <id>default-testCompile</id>
            <phase>none</phase>
        </execution>
        <execution>
            <id>java-compile</id>
            <phase>compile</phase>
            <goals>
                <goal>compile</goal>
            </goals>
        </execution>
        <execution>
            <id>java-test-compile</id>
            <phase>test-compile</phase>
            <goals>
                <goal>testCompile</goal>
            </goals>
        </execution>
    </executions>
</plugin>

通常情况下,插件会按照它们在 POM 中声明的顺序执行,但是 default-compiledefault-testCompile 的执行比较特殊,因为它们是内置的,所以它们总是先执行.上面的配置通过禁用默认编译执行并在 kotlin-maven-plugin 之后声明新的编译执行 maven-compiler-plugin 来解决这个问题。通过这种方式,您可以在构建生命周期的 compile 阶段正确进行所有编译。