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

How to enable maven profile when built version is not -SNAPSHOT?

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

因此,我想配置我的项目,以便在构建发布版本时 运行 一些额外的步骤,并在编译 SNAPSHOT 版本时跳过它们,但我找不到启用配置文件的方法,如果${project.version} 包含 -SNAPSHOT.

有什么建议吗?

我会建议你另一个解决方案。

为什么不在配置文件中设置版本而不是在版本上决定配置文件激活?喜欢这里:

<version>${projectVersion}</version>

<profiles>
    <profile>
        <id>snapshot</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <properties>
            <projectVersion>1.0-SNAPSHOT</projectVersion>
        </properties>
    </profile>
    <profile>
        <id>release</id>
        <properties>
            <projectVersion>1.0-RELEASE</projectVersion>
        </properties>
    </profile>
</profiles>

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

  • 使用 buid-helper-maven-plugin 及其 regex-property 目标解析默认 ${project.version} 属性 并创建一个新的 ${only.when.is.snapshot.used} 属性 值true${project.version} 如果找到 SNAPSHOT 后缀。
  • 使用其 skipSource 选项配置 maven-source-plugin 以执行其 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 的默认配置文件,它实际上会调用相同的源代码和 javadoc 插件,并且可以通过 属性 performRelease 激活设置为值 true。也就是说,您可以在任何 Maven 项目上调用以下内容:

mvn clean package -DperformRelease=true

mvn clean package -Prelease-profile

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

https://www.mojohaus.org/versions-maven-plugin/examples/use-releases.html

使用目标mvn versions:use-releases