罐子:测试罐子

全名

org.apache.maven.plugins:maven-jar-plugin:3.2.2:test-jar

说明

为当前项目构建测试类的 JAR。

属性

  • 需要执行一个 Maven 项目。
  • 需要对范围内的工件进行依赖解析:test
  • 默认绑定到生命周期阶段

必需参数

姓名 类型 自从 描述
<输出目录> 文件 - 包含生成的 JAR 的目录。
默认值为${project.build.directory}
<测试类目录> 文件 - 包含应该打包到 JAR 中的测试类和资源文件的目录。
默认值为${project.build.testOutputDirectory}

可选参数

姓名 类型 自从 描述
<存档> Maven存档配置 - 要使用的存档配置。请参阅Maven 存档器参考
<分类器> 细绳 - 用于test-jar的分类器。
默认值为测试
<不包括> 细绳[] - 要排除的文件列表。指定为文件集模式,这些模式与将其内容打包到 JAR 中的输入目录相关。
<强制创建> 布尔值 - 要求 jar 插件构建一个新的 JAR,即使内容似乎都没有改变。默认情况下,此插件会查看输出 jar 是否存在并且输入是否未更改。如果这些条件为真,插件将跳过 jar 的创建。当其他插件(如 maven-shade-plugin)配置为对 jar 进行后处理时,这不起作用。该插件无法检测到后处理,因此将后处理的 jar 留在原处。当这些插件不希望找到自己的输出作为输入时,这可能会导致失败。将此参数设置为true 可通过强制此插件每次重新创建 jar 来避免这些问题。
3.0.0 开始,该属性已从 jar.forceCreation重命名为 maven.jar.forceCreation
默认值为false
用户属性是maven.jar.forceCreation
<包括> 细绳[] - 要包含的文件列表。指定为文件集模式,这些模式与将其内容打包到 JAR 中的输入目录相关。
<输出时间戳> 细绳 3.2.0 可重现输出存档条目的时间戳,格式为 ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX或表示自纪元以来秒数的 int(如SOURCE_DATE_EPOCH)。
默认值为${project.build.outputTimestamp}
<跳过> 布尔值 - 将此设置为true以绕过 test-jar 生成。不推荐使用它,但有时很方便。
用户属性是maven.test.skip
<skipIfEmpty> 布尔值 - 跳过创建空档案。
默认值为false
<使用默认清单文件> 布尔值 - 已弃用。对于 3.0.0 版本,此参数仅在此处定义以在您使用它时中断构建!
默认值为false
用户属性是jar.useDefaultManifestFile

参数详情

<存档>

要使用的存档配置。请参阅Maven 存档器参考
  • 类型org.apache.maven.archiver.MavenArchiveConfiguration
  • 要求

<分类器>

用于test-jar的分类器。
  • 类型java.lang.String
  • 要求
  • 默认值测试

<不包括>

要排除的文件列表。指定为文件集模式,这些模式与将其内容打包到 JAR 中的输入目录相关。
  • 类型java.lang.String[]
  • 要求

<强制创建>

要求 jar 插件构建一个新的 JAR,即使内容似乎都没有改变。默认情况下,此插件会查看输出 jar 是否存在并且输入是否未更改。如果这些条件为真,插件将跳过 jar 的创建。当其他插件(如 maven-shade-plugin)配置为对 jar 进行后处理时,这不起作用。该插件无法检测到后处理,因此将后处理的 jar 留在原处。当这些插件不希望找到自己的输出作为输入时,这可能会导致失败。将此参数设置为true 可通过强制此插件每次重新创建 jar 来避免这些问题。
3.0.0 开始,该属性已从 jar.forceCreation重命名为 maven.jar.forceCreation
  • 类型布尔值
  • 要求
  • 用户属性maven.jar.forceCreation
  • 默认值

<包括>

要包含的文件列表。指定为文件集模式,这些模式与将其内容打包到 JAR 中的输入目录相关。
  • 类型java.lang.String[]
  • 要求

<输出目录>

包含生成的 JAR 的目录。
  • 类型java.io.File
  • 要求
  • 默认值${project.build.directory}

<输出时间戳>

可重现输出存档条目的时间戳,格式为 ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX或表示自纪元以来秒数的 int(如SOURCE_DATE_EPOCH)。
  • 类型java.lang.String
  • 3.2.0
  • 要求
  • 默认值${project.build.outputTimestamp}

<跳过>

将此设置为true以绕过 test-jar 生成。不推荐使用它,但有时很方便。
  • 类型布尔值
  • 要求
  • 用户属性maven.test.skip

<skipIfEmpty>

跳过创建空档案。
  • 类型布尔值
  • 要求
  • 默认值

<测试类目录>

包含应该打包到 JAR 中的测试类和资源文件的目录。
  • 类型java.io.File
  • 要求
  • 默认值${project.build.testOutputDirectory}

<使用默认清单文件>

已弃用。对于 3.0.0 版本,此参数仅在此处定义以在您使用它时中断构建!
使用此属性将使您的构建失败,因为它已从插件配置中删除。请参阅插件的主要版本升级到版本 3.0.0
  • 类型布尔值
  • 要求
  • 用户属性jar.useDefaultManifestFile
  • 默认值