java - 当构建版本不是-SNAPSHOT 时如何启用 Maven 配置文件？

Question

我正在尝试使用 gitflow-helper-maven-plugin我的 Maven 构建的扩展。

因此，我想配置我的项目，以便在构建发布版本时运行一些额外的步骤，并在编译 SNAPSHOT 版本时跳过它们，但是如果 ${project .version 包含 -SNAPSHOT。

有什么建议吗？

Answer 1

下面是一种可能的方法，您可以始终在 Maven 构建中模拟 if 语句:

• 使用 buid-helper-maven-plugin 及其 regex-property 目标来解析默认的 ${project.version} 属性并创建一个新的 ${only.when.is.snapshot.used} 属性，值为 true 或 ${project.version} 以防万一找到 SNAPSHOT 后缀。
• 配置 maven-source-plugin 以使用其 skipSource 的特殊配置执行其 jar 目标选项并将新的(动态)${only.when.is.snapshot.used} 属性传递给它:如果是快照，它将具有值 true 因此跳过执行，否则将具有值 ${project.version} 将用作 false，因此不会跳过此执行
• 使用其 skip 为 maven-javadoc-plugin 配置与上面相同的内容选项

上述方法的示例是:

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>build-helper-maven-plugin</artifactId>
    <version>1.10</version>
    <executions>
        <execution>
            <!-- sets the only.when.is.snapshot.used property to true if SNAPSHOT was used, 
                to the project version otherwise -->
            <id>build-helper-regex-is-snapshot-used</id>
            <phase>validate</phase>
            <goals>
                <goal>regex-property</goal>
            </goals>
            <configuration>
                <name>only.when.is.snapshot.used</name>
                <value>${project.version}</value>
                <regex>.*-SNAPSHOT</regex>
                <replacement>true</replacement>
                <failIfNoMatch>false</failIfNoMatch>
            </configuration>
        </execution>
    </executions>
</plugin>

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-source-plugin</artifactId>
    <version>3.0.1</version>
    <executions>
        <execution>
            <id>create-sources</id>
            <phase>package</phase>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
                <!-- skip when version is SNAPSHOT -->
                <skipSource>${only.when.is.snapshot.used}</skipSource>
            </configuration>
        </execution>
    </executions>
</plugin>
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.10.4</version>
    <executions>
        <execution>
            <id>create-javadoc</id>
            <phase>package</phase>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
                <!-- skip when version is SNAPSHOT -->
                <skip>${only.when.is.snapshot.used}</skip>
            </configuration>
        </execution>
    </executions>
</plugin>

也就是说，不需要配置文件，只有在使用非 SNAPSHOT 版本时才会启用此配置，动态且无需任何进一步配置(命令行选项或其他)。

---

附带提醒一下，您还可以查看 maven-release-plugin，它只会在 performing 时有效地调用源代码和 javadoc 插件。没有增加上述方法的(次要)复杂性的版本。

否则，您可以简单地使用来自 Maven Super POM 的默认配置文件这实际上会调用相同的 source 和 javadoc 插件，并且可以通过将属性 performRelease 设置为值 true 来激活。也就是说，您可以在任何 Maven 项目中调用以下内容:

mvn clean package -DperformRelease=true

或

mvn clean package -Prelease-profile

并且您将自动受益于默认的 super 配置文件并生成源代码和 javadoc jar，尽管这种方法应该作为最后一个选项使用，因为在未来的版本中可能会从 super pom 中删除配置文件。