用法

有关如何使用执行器目标的简要示例。

通用插件配置信息

有关在项目中包含和配置插件的信息,请参阅以下链接:

执行者:执行魔力

此目标旨在绑定到生命周期阶段并在您的pom.xml中进行配置。强制执行者执行配置的规则以检查某些约束。此处描述了可用的内置规则。除了要执行的规则之外,这些目标还支持三个选项:

  • 跳过- 通过配置文件或从命令行使用-Denforcer.skip跳过检查的快速方法。
  • fail - 如果在规则失败时目标应该使构建失败。默认值为true。如果为 false,则错误将被记录为警告。
  • failFast - 如果目标应该在第一次失败后停止检查。默认值为false

每个要执行的规则都应该与该规则的特定配置一起添加到规则元素中。

从 1.4 版开始,您可以将级别元素添加到规则中。有效值为WARNERROR。当指定WARN级别 时,规则只会发出警告,但不会使构建失败。

示例插件配置:

<project>
  [...]
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-enforcer-plugin</artifactId>
        <version>3.0.0</version>
        <executions>
          <execution>
            <id>enforce-versions</id>
            <goals>
              <goal>enforce</goal>
            </goals>
            <configuration>
              <rules>
                <bannedPlugins>
                  <!-- will only display a warning but does not fail the build. -->
                  <level>WARN</level>
                  <excludes>
                    <exclude>org.apache.maven.plugins:maven-verifier-plugin</exclude>
                  </excludes>
                  <message>Please consider using the maven-invoker-plugin (http://maven.apache.org/plugins/maven-invoker-plugin/)!</message>
                </bannedPlugins>
                <requireMavenVersion>
                  <version>2.0.6</version>
                </requireMavenVersion>
                <requireJavaVersion>
                  <version>1.5</version>
                </requireJavaVersion>
                <requireOS>
                  <family>unix</family>
                </requireOS>
              </rules>
            </configuration>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
  [...]
</project>

执行者:display-info mojo

此目标用于确定标准规则检测到的当前信息:

   mvn enforcer:display-info
   ...
   [enforcer:display-info]
       Maven Version: 2.0.6
       JDK Version: 1.5.0_11 normalized as: 1.5.0-11
       OS Info: Arch: x86 Family: windows Name: windows xp Version: 5.1