Maven Eclipse 插件 - maven-eclipse-plugin

日食：拉德

生成 rad-6 配置文件。

Mojo 属性：

需要 Maven 2.0 项目才能执行。
generate-resources在执行自身之前调用生命周期阶段的执行。

必需参数

姓名	类型	描述
构建输出目录	`File`	默认输出目录默认值为`${project.build.outputDirectory}`.
使用项目参考	`boolean`	当设置为 false 时，插件将不会创建子项目，而是使用本地存储库中安装的包引用这些子项目默认值为`true`.

可选参数

姓名	类型	描述
addGroupIdToProjectName	`boolean`	如果设置为`true`，则工件的 groupId 将附加到生成的 Eclipse 项目的名称中。有关其他选项，请参见 projectNameTemplate。默认值为`false`。
addVersionToProjectName	`boolean`	如果设置为`true`，则工件的版本号将附加到生成的 Eclipse 项目的名称中。有关其他选项，请参见 projectNameTemplate。默认值为`false`。
额外的构建命令	`List`	要添加到默认命令的 Eclipse 构建命令列表。老款式： <additionalBuildcommands> <buildcommand>org.springframework.ide.eclipse.core.springbuilder</buildcommand> </additionalBuildcommands> 新风格： <additionalBuildcommands> <buildCommand> <name>org.ui.externaltools.ExternalToolBuilder</name> <triggers>auto,full,incremental,</triggers> <arguments> <LaunchConfigHandle><project>./externalToolBuilders/MavenBuilder.launch</LaunchConfighandle> </arguments> </buildCommand> </additionalBuildcommands> 注意和之间的区别。您可以混合和匹配新旧样式的配置条目。`buildcommandbuildCommand`
附加配置	`EclipseConfigFile[]`	允许为运行 eclipse:eclipse 时将写入磁盘的 eclipse 配置额外的通用配置文件。对于每个文件，您可以指定名称和文本内容。 <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-eclipse-plugin</artifactId> <configuration> <additionalConfig> <file> <name>.checkstyle</name> <content> <![CDATA[<fileset-config file-format-version="1.2.0" simple-config="true"> <fileset name="all" enabled="true" check-config-name="acme corporate style" local="false"> <file-match-pattern match-pattern="." include-pattern="true"/> </fileset> <filter name="NonSrcDirs" enabled="true"/> </fileset-config>]]> </content> </file> </additionalConfig> </configuration> </plugin> 除了内容，您还可以定义（从 2.5 版开始）一个 url 来下载文件： <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-eclipse-plugin</artifactId> <configuration> <additionalConfig> <file> <name>.checkstyle</name> <url>http://some.place.org/path/to/file</url> </file> </additionalConfig> </configuration> 或位置： <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-eclipse-plugin</artifactId> <configuration> <additionalConfig> <file> <name>.checkstyle</name> <location>/checkstyle-config.xml</location> </file> </additionalConfig> </configuration> <dependencies> <!-- The file defined in the location is stored in this dependency --> <dependency> <groupId>eclipsetest</groupId> <artifactId>checkstyle-config</artifactId> <version>1.0</version> </dependency> </dependencies> </plugin>
附加项目方面	`Map`	要添加到默认方面的 Eclipse 项目方面的列表。 <additionalProjectFacets> <jst.jsf>1.1<jst.jsf/> </additionalProjectFacets>
附加项目性质	`List`	要添加到默认项目性质的 Eclipse 项目性质列表。 <additionalProjectnatures> <projectnature>org.springframework.ide.eclipse.core.springnature</projectnature> </additionalProjectnatures>
神器收藏家	`ArtifactCollector`	工件收集器，需要解决依赖关系。
神器工厂	`ArtifactFactory`	工件工厂，需要下载源 jar 以包含在类路径中。
工件元数据源	`ArtifactMetadataSource`	没有说明。
神器解析器	`ArtifactResolver`	工件解析器，需要下载源 jar 以包含在类路径中。
构建命令	`List`	eclipse 构建命令列表。默认情况下`org.eclipse.jdt.core.javabuilder`会添加构建器和所需的 WTP 构建器。如果您为此参数指定任何配置，则只会使用指定的那些构建命令；不会添加默认值。为此使用`additionalBuildCommands`参数。配置示例：老款： <buildcommands> <buildcommand>org.eclipse.wst.common.modulecore.ComponentStructuralBuilder</buildcommand> <buildcommand>org.eclipse.jdt.core.javabuilder</buildcommand> <buildcommand>org.eclipse.wst.common.modulecore.ComponentStructuralBuilderDependencyResolver</buildcommand> </buildcommands> 有关新样式，请参阅`additionalBuildCommands`。
类路径容器	`List`	容器类路径条目列表。默认情况下`org.eclipse.jdt.launching.JRE_CONTAINER` 会添加类路径容器。配置示例： <classpathContainers> <classpathContainer>org.eclipse.jdt.launching.JRE_CONTAINER</classpathContainer> <classpathContainer>org.eclipse.jst.server.core.container/org.eclipse.jst.server.tomcat.runtimeTarget/Apache Tomcat v5.5</classpathContainer> <classpathContainer>org.eclipse.jst.j2ee.internal.web.container/artifact</classpathContainer> </classpathContainers>
下载Javadocs	`boolean`	启用/禁用 javadoc 附件的下载。默认为假。当此标志为`true` 远程存储库时检查 javadocs：为了避免重复检查不可用的 javadoc 档案，将状态缓存保存到根项目的目标目录中。运行`mvn:clean`或删除文件`mvn-eclipse-cache.properties`以重置此缓存。
下载来源	`boolean`	启用/禁用源附件的下载。默认为假。当此标志为`true` 远程存储库时，检查源：为了避免重复检查不可用的源存档，状态缓存被保存到根项目的目标目录中。运行`mvn:clean`或删除文件`mvn-eclipse-cache.properties`以重置此缓存。
eclipseDownloadSources	`boolean`	启用/禁用源附件的下载。默认为假。已弃用 - 使用 downloadSources
eclipse项目目录	`File`	Eclipse 工作区目录。
排除	`List`	要从 Eclipse 类路径中排除的工件列表，由一些 Eclipse 类路径容器提供 [MECLIPSE-79]
生成的资源目录名	`String`	使用它来指定与 target/generated-resources/rad6 不同的生成资源文件夹。设置为“无”以跳过此文件夹生成。默认值为`target/generated-resources/rad6`。
limitProjectReferencesToWorkspace	`boolean`	限制对当前工作空间的项目引用的使用。当工作空间中不可用时，不会为反应器中的项目创建项目引用。默认值为`false`。
定位器	`ResourceManager`	ResourceManager 用于从资源中获取附加配置文件
显现	`File`	清单文件的相对路径默认值为`${basedir}/META-INF/MANIFEST.MF`.
包装	`String`	项目包装。
pde	`boolean`	它是一个 PDE 项目吗？如果是，插件将必要的性质和构建命令添加到 .project 文件。此外，它将所有库复制到项目本地目录并引用它们，而不是引用本地 Maven 存储库中的文件。它还确保了 META-INF/MANIFEST.MF 中的“Bundle-Classpath”是同步的。默认值为`false`。
项目名称模板	`String`	允许配置 Eclipse 项目的名称。如果设置此属性胜过 addVersionToProjectName 和 addGroupIdToProjectName 您可以使用`[groupId]`,`[artifactId]`和 `[version]`变量。例如。`[groupId].[artifactId]-[version]`
项目性质	`List`	eclipse 项目性质列表。默认情况下`org.eclipse.jdt.core.javanature`会添加性质和所需的 WTP 性质。使用此属性添加的自然会替换默认列表。 <projectnatures> <projectnature>org.eclipse.jdt.core.javanature</projectnature> <projectnature>org.eclipse.wst.common.modulecore.ModuleCoreNature</projectnature> </projectnatures>
跳过	`boolean`	为真时跳过操作。默认值为`false`。
战争上下文根	`String`	Web 应用程序的上下文根。该参数仅在当前项目为war项目时使用，否则将被忽略。
工作区	`String`	读取此 Eclipse 工作区，并且在此处检测到的所有工件都将作为 Eclipse 项目连接，并且不会链接到本地存储库中的 jar。要求是它是使用与 reactor 项目类似的 wtp 设置创建的，但项目名称模板不同。工作区项目中的 pom 可能不包含 artefactId、groupId 和 version 标签中的变量。
wtpContextName	`String`	WTP 模块的 JEE 上下文名称。（例如 WEB 上下文名称）。
wtpapplicationxml	`boolean`	必须在单独的目录中为 ear 项目编写应用程序文件。默认值为`false`。
wtpdefaultserver	`String`	WTP 定义的服务器用于部署信息。
wtpmanifest	`boolean`	必须为 java 项目编写清单文件，以便 wtp 的 jee 类路径正确。默认值为`false`。
wtp版本	`String`	将为其生成配置文件的 WTP 版本。默认值为“none”（不生成 WTP 配置），支持的版本为“R7”、“1.0”和“1.5” 默认值为`none`.

参数详情

addGroupIdToProjectName

如果设置为true，则工件的 groupId 将附加到生成的 Eclipse 项目的名称中。有关其他选项，请参见 projectNameTemplate。

类型：boolean
必需：No
表达式：${eclipse.addGroupIdToProjectName}
默认：false

addVersionToProjectName 如果设置为true，则工件的版本号将附加到生成的 Eclipse 项目的名称中。有关其他选项，请参见 projectNameTemplate。

类型：boolean
必需：No
表达式：${eclipse.addVersionToProjectName}
默认：false

AdditionalBuildcommands 要添加 到默认命令的 Eclipse 构建命令列表。老款式：

<additionalBuildcommands>
<buildcommand>org.springframework.ide.eclipse.core.springbuilder</buildcommand>
</additionalBuildcommands>

新风格：

<additionalBuildcommands>
<buildCommand>
<name>org.ui.externaltools.ExternalToolBuilder</name>
<triggers>auto,full,incremental,</triggers>
<arguments>
<LaunchConfigHandle>&lt;project&gt;./externalToolBuilders/MavenBuilder.launch</LaunchConfighandle>
</arguments>
</buildCommand>
</additionalBuildcommands>

注意和之间的区别。您可以混合和匹配新旧样式的配置条目。 buildcommandbuildCommand

类型：java.util.List
必需：No

additionalConfig 允许为 eclipse 配置额外的通用配置文件，这些文件将在运行 eclipse:eclipse 时写入磁盘。对于每个文件，您可以指定名称和文本内容。

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-eclipse-plugin</artifactId>
<configuration>
<additionalConfig>
<file>
<name>.checkstyle</name>
<content>
<![CDATA[<fileset-config file-format-version="1.2.0" simple-config="true">
<fileset name="all" enabled="true" check-config-name="acme corporate style" local="false">
<file-match-pattern match-pattern="." include-pattern="true"/>
</fileset>
<filter name="NonSrcDirs" enabled="true"/>
</fileset-config>]]>
</content>
</file>
</additionalConfig>
</configuration>
</plugin>

除了内容，您还可以定义（从 2.5 版开始）一个 url 来下载文件：

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-eclipse-plugin</artifactId>
<configuration>
<additionalConfig>
<file>
<name>.checkstyle</name>
<url>http://some.place.org/path/to/file</url>
</file>
</additionalConfig>
</configuration>

或位置：

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-eclipse-plugin</artifactId>
<configuration>
<additionalConfig>
<file>
<name>.checkstyle</name>
<location>/checkstyle-config.xml</location>
</file>
</additionalConfig>
</configuration>
<dependencies>
<!-- The file defined in the location is stored in this dependency -->
<dependency>
<groupId>eclipsetest</groupId>
<artifactId>checkstyle-config</artifactId>
<version>1.0</version>
</dependency>
</dependencies>
</plugin>

类型：org.apache.maven.plugin.eclipse.EclipseConfigFile[]
必需：No

AdditionalProjectFacets 要添加 到默认项目构面的 Eclipse 项目构面列表。

<additionalProjectFacets>
<jst.jsf>1.1<jst.jsf/>
</additionalProjectFacets>

类型：java.util.Map
必需：No

AdditionalProjectnatures 要添加 到默认项目性质的 Eclipse 项目性质列表。

<additionalProjectnatures>
<projectnature>org.springframework.ide.eclipse.core.springnature</projectnature>
</additionalProjectnatures>

类型：java.util.List
必需：No

artifactCollector 工件收集器，需要解决依赖关系。

类型：org.apache.maven.artifact.resolver.ArtifactCollector
必需：No

artifactFactory 工件工厂，需要下载源 jars 以包含在类路径中。

类型：org.apache.maven.artifact.factory.ArtifactFactory
必需：No

artifactMetadataSource 否描述。

类型：org.apache.maven.artifact.metadata.ArtifactMetadataSource
必需：No

artifactResolver 工件解析器，需要下载源 jar 包以包含在类路径中。

类型：org.apache.maven.artifact.resolver.ArtifactResolver
必需：No

buildOutputDirectory 默认输出目录

类型：java.io.File
必需：Yes
表达式：${outputDirectory}
默认：${project.build.outputDirectory}

buildcommands Eclipse 构建命令列表。默认情况下org.eclipse.jdt.core.javabuilder会添加构建器和所需的 WTP 构建器。如果您为此参数指定任何配置，则只会使用指定的那些构建命令；不会添加默认值。为此使用additionalBuildCommands参数。配置示例：老款：

<buildcommands>
<buildcommand>org.eclipse.wst.common.modulecore.ComponentStructuralBuilder</buildcommand>
<buildcommand>org.eclipse.jdt.core.javabuilder</buildcommand>
<buildcommand>org.eclipse.wst.common.modulecore.ComponentStructuralBuilderDependencyResolver</buildcommand>
</buildcommands>

有关新样式，请参阅additionalBuildCommands。

类型：java.util.List
必需：No

classpathContainers 容器类路径条目的列表。默认情况下org.eclipse.jdt.launching.JRE_CONTAINER 会添加类路径容器。配置示例：

<classpathContainers>
<classpathContainer>org.eclipse.jdt.launching.JRE_CONTAINER</classpathContainer>
<classpathContainer>org.eclipse.jst.server.core.container/org.eclipse.jst.server.tomcat.runtimeTarget/Apache Tomcat v5.5</classpathContainer>
<classpathContainer>org.eclipse.jst.j2ee.internal.web.container/artifact</classpathContainer>
</classpathContainers>

类型：java.util.List
必需：No

downloadJavadocs 启用/禁用 javadoc 附件的下载。默认为假。当此标志为true 远程存储库时检查 javadocs：为了避免重复检查不可用的 javadoc 档案，将状态缓存保存到根项目的目标目录中。运行mvn:clean或删除文件mvn-eclipse-cache.properties以重置此缓存。

类型：boolean
必需：No
表达式：${downloadJavadocs}

downloadSources 启用/禁用源附件的下载。默认为假。当此标志为true 远程存储库时，检查源：为了避免重复检查不可用的源存档，状态缓存被保存到根项目的目标目录中。运行mvn:clean或删除文件mvn-eclipse-cache.properties以重置此缓存。

类型：boolean
必需：No
表达式：${downloadSources}

eclipseDownloadSources 启用/禁用源附件的下载。默认为假。已弃用 - 使用 downloadSources

类型：boolean
必需：No
表达式：${eclipse.downloadSources}

eclipseProjectDir Eclipse 工作区目录。

类型：java.io.File
必需：No
表达式：${eclipse.projectDir}

excludes 要从 eclipse 类路径中排除的工件列表，由某些 eclipse classPathContainer [MECLIPSE-79] 提供

类型：java.util.List
自：2.5
必需：No

generatedResourceDirName 使用它来指定与 target/generated-resources/rad6 不同的生成资源文件夹。设置为“无”以跳过此文件夹生成。

类型：java.lang.String
必需：No
表达式：${generatedResourceDirName}
默认：target/generated-resources/rad6

limitProjectReferencesToWorkspace 限制对当前工作空间的项目引用的使用。当工作空间中不可用时，不会为反应器中的项目创建项目引用。

类型：boolean
必需：No
表达式：${eclipse.limitProjectReferencesToWorkspace}
默认：false

定位器 ResourceManager 用于从资源中获取附加配置文件

类型：org.codehaus.plexus.resource.ResourceManager
必需：No

manifest 清单文件的相对路径

类型：java.io.File
必需：No
表达式：${eclipse.manifest}
默认：${basedir}/META-INF/MANIFEST.MF

打包项目打包。

类型：java.lang.String
必需：No
表达式：${project.packaging}

pde 它是一个PDE 项目吗？如果是，插件将必要的性质和构建命令添加到 .project 文件。此外，它将所有库复制到项目本地目录并引用它们，而不是引用本地 Maven 存储库中的文件。它还确保了 META-INF/MANIFEST.MF 中的“Bundle-Classpath”是同步的。

类型：boolean
必需：No
表达式：${eclipse.pde}
默认：false

projectNameTemplate 允许配置 Eclipse 项目的名称。如果设置此属性胜过 addVersionToProjectName 和 addGroupIdToProjectName 您可以使用[groupId],[artifactId]和 [version]变量。例如。[groupId].[artifactId]-[version]

类型：java.lang.String
必需：No
表达式：${eclipse.projectNameTemplate}

projectnaturals Eclipse 项目性质的列表。默认情况下org.eclipse.jdt.core.javanature会添加性质和所需的 WTP 性质。使用此属性添加的自然会替换默认列表。

<projectnatures>
<projectnature>org.eclipse.jdt.core.javanature</projectnature>
<projectnature>org.eclipse.wst.common.modulecore.ModuleCoreNature</projectnature>
</projectnatures>

类型：java.util.List
必需：No

skip 为 true 时跳过该操作。

类型：boolean
必需：No
表达式：${eclipse.skip}
默认：false

useProjectReferences 设置为 false 时，插件不会创建子项目，而是使用本地存储库中已安装的包引用这些子项目

类型：boolean
必需：Yes
表达式：${eclipse.useProjectReferences}
默认：true

warContextRoot Web 应用程序 的上下文根。该参数仅在当前项目为war项目时使用，否则将被忽略。

类型：java.lang.String
必需：No

工作区读取这个 Eclipse 工作区，并且在那里检测到的所有工件都将作为 Eclipse 项目连接，并且不会链接到本地存储库中的 jar。要求是它是使用与 reactor 项目类似的 wtp 设置创建的，但项目名称模板不同。工作区项目中的 pom 可能不包含 artefactId、groupId 和 version 标签中的变量。

类型：java.lang.String
自：2.5
必需：No
表达式：${eclipse.workspace}

wtpContextName WTP 模块的 JEE 上下文名称。（例如 WEB 上下文名称）。

类型：java.lang.String
必需：No
表达式：${wtpContextName}

wtpapplicationxml 必须在单独的目录中为ear 项目编写应用程序文件。

类型：boolean
必需：No
表达式：${eclipse.wtpapplicationxml}
默认：false

wtpdefaultserver WTP 定义的服务器用于部署信息。

类型：java.lang.String
必需：No
表达式：${eclipse.wtpdefaultserver}

wtpmanifest 必须为 java 项目编写清单文件，以便 wtp 的 jee 类路径正确。

类型：boolean
必需：No
表达式：${eclipse.wtpmanifest}
默认：false

wtpversion 将为其生成配置文件的 WTP 版本。默认值为“none”（不生成 WTP 配置），支持的版本为“R7”、“1.0”和“1.5”

类型：java.lang.String
必需：No
表达式：${wtpversion}
默认：none

概述

配置

例子

项目文档

日食：拉德

必需参数

可选参数

参数详情