由 Maven 构建

来源：聚合

全名：

org.apache.maven.plugins:maven-source-plugin:3.2.0:aggregate

说明：

聚合器项目中所有模块的聚合源。

属性：

  • 需要执行一个 Maven 项目。
  • 作为聚合器插件执行。
  • 自版本：2.0.3。
  • 默认绑定到生命周期阶段：包。
  • 在执行自身之前调用生命周期阶段 generate-sources的执行。

必需参数

姓名 类型 自从 描述
<默认清单文件> 文件 2.1 要使用的默认 MANIFEST 文件的路径。如果useDefaultManifestFile设置为true，它将被使用 。
默认值为：${project.build.outputDirectory}/META-INF/MANIFEST.MF。

可选参数

姓名 类型 自从 描述
<存档> Maven存档配置 2.1 要使用的存档配置。请参阅Maven 存档器参考。
注意：从 3.0.0 开始，生成的档案包含一个 Maven 描述符。如果您需要抑制 maven 描述符的生成，您可以通过使用归档器配置简单地实现这一点。.
<附加> 布尔值 2.0.3 指定是否将工件附加到项目
默认值为：true。
用户属性是：maven.source.attach。
<分类器> 细绳 2.2 （无描述）
默认值为：sources。
用户属性是：maven.source.classifier。
<排除资源> 布尔值 2.0.4 指定是否从sources-jar 中排除资源。如果您的项目包含大量资源（例如图像）并且您不想将它们包含在 sources-jar 中，这会很方便。
默认值为：false。
用户属性是：maven.source.excludeResources。
<不包括> 细绳[] 2.1 要排除的文件列表。指定为文件集模式，这些模式与将其内容打包到 JAR 中的输入目录相关。
<最终名称> 细绳 2.0.3 用于生成的存档文件的文件名。对于 source:jar 目标，“-sources”附加到此文件名。对于 source:test-jar 目标，附加了“-test-sources”。
默认值为：${project.build.finalName}。
<强制创建> 布尔值 2.1 是否应该强制创建存档。如果设置为 true，则将始终创建 jar。如果设置为 false，则仅当源比 jar 更新时才会创建 jar。
默认值为：false。
用户属性是：maven.source.forceCreation。
<includePom> 布尔值 2.1 指定是否在sources-jar 中包含POM 文件。
默认值为：false。
用户属性是：maven.source.includePom。
<包括> 细绳[] 2.1 要包含的文件列表。指定为文件集模式，这些模式与将其内容打包到 JAR 中的输入目录相关。
<输出目录> 文件 2.0.3 将放置生成的存档文件的目录。
默认值为：${project.build.directory}。
<输出时间戳> 细绳 3.2.0 可重现输出存档条目的时间戳，格式为 ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX或表示自纪元以来秒数的 int（如SOURCE_DATE_EPOCH）。
默认值为：${project.build.outputTimestamp}。
<skipSource> 布尔值 2.2 用于禁用源过程的标志。这主要用于从命令行偶尔调整构建。
默认值为：false。
用户属性是：maven.source.skip。
<useDefaultExcludes> 布尔值 2.1 排除通常排除的文件，例如 SCM 配置。这些在 plexus FileUtils.getDefaultExcludes() 中定义
默认值为：true。
用户属性是：maven.source.useDefaultExcludes。
<使用默认清单文件> 布尔值 2.1 将此设置为true以启用 defaultManifestFile。

默认值为：false。
用户属性是：maven.source.useDefaultManifestFile。

参数详情

<存档>

要使用的存档配置。请参阅Maven 存档器参考。
注意：从 3.0.0 开始，生成的档案包含一个 Maven 描述符。如果您需要抑制 maven 描述符的生成，您可以通过使用归档器配置简单地实现这一点。.
  • 类型：org.apache.maven.archiver.MavenArchiveConfiguration
  • 从: 2.1
  • 要求：否

<附加>

指定是否将工件附加到项目
  • 类型：布尔值
  • 自：2.0.3
  • 要求：否
  • 用户属性：maven.source.attach
  • 默认值：真

<分类器>

（没有说明）
  • 类型：java.lang.String
  • 从: 2.2
  • 要求：否
  • 用户属性：maven.source.classifier
  • 默认值：来源

<默认清单文件>

要使用的默认 MANIFEST 文件的路径。如果useDefaultManifestFile设置为true，它将被使用 。
  • 类型：java.io.File
  • 从: 2.1
  • 要求：是
  • 默认值：${project.build.outputDirectory}/META-INF/MANIFEST.MF

<排除资源>

指定是否从sources-jar 中排除资源。如果您的项目包含大量资源（例如图像）并且您不想将它们包含在 sources-jar 中，这会很方便。
  • 类型：布尔值
  • 自：2.0.4
  • 要求：否
  • 用户属性：maven.source.excludeResources
  • 默认值：假

<不包括>

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

<最终名称>

用于生成的存档文件的文件名。对于 source:jar 目标，“-sources”附加到此文件名。对于 source:test-jar 目标，附加了“-test-sources”。
  • 类型：java.lang.String
  • 自：2.0.3
  • 要求：否
  • 默认值：${project.build.finalName}

<强制创建>

是否应该强制创建存档。如果设置为 true，则将始终创建 jar。如果设置为 false，则仅当源比 jar 更新时才会创建 jar。
  • 类型：布尔值
  • 从: 2.1
  • 要求：否
  • 用户属性：maven.source.forceCreation
  • 默认值：假

<includePom>

指定是否在sources-jar 中包含POM 文件。
  • 类型：布尔值
  • 从: 2.1
  • 要求：否
  • 用户属性：maven.source.includePom
  • 默认值：假

<包括>

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

<输出目录>

将放置生成的存档文件的目录。
  • 类型：java.io.File
  • 自：2.0.3
  • 要求：否
  • 默认值：${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}

<skipSource>

用于禁用源过程的标志。这主要用于从命令行偶尔调整构建。
  • 类型：布尔值
  • 从: 2.2
  • 要求：否
  • 用户属性：maven.source.skip
  • 默认值：假

<useDefaultExcludes>

排除通常排除的文件，例如 SCM 配置。这些在 plexus FileUtils.getDefaultExcludes() 中定义
  • 类型：布尔值
  • 从: 2.1
  • 要求：否
  • 用户属性：maven.source.useDefaultExcludes
  • 默认值：真

<使用默认清单文件>

将此设置为true以启用 defaultManifestFile。
  • 类型：布尔值
  • 从: 2.1
  • 要求：否
  • 用户属性：maven.source.useDefaultManifestFile
  • 默认值：假