Maven Eclipse 插件 - eclipse:eclipse

日食：日食

全名：

org.apache.maven.plugins:maven-eclipse-plugin:2.6:eclipse

说明：

生成以下 eclipse 配置文件：

.project和.classpath文件
.setting/org.eclipse.jdt.core.prefs具有项目特定的编译器设置
WTP（Web Tools Project）的各种配置文件，如果参数wtpversion设置为有效版本（默认不生成WTP配置）

如果此目标在多项目根目录上运行，则模块之间的依赖关系将在 Eclipse 中配置为直接项目依赖关系（除非useProjectReferences设置为 false）。

属性：

需要执行 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>
ajdt版本	`String`	`-`	将为其生成配置文件的 AJDT 版本。默认值为“1.5”，支持的版本为“none”、“1.4”和“1.5”。默认值为：`1.5`。
构建命令	`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 eclipse:remove-cache`，或使用该 `forceRecheck`选项。
下载来源	`boolean`	`-`	启用/禁用源附件的下载。默认为假。当此标志为`true`远程存储库时，检查源：为了避免重复检查不可用的源存档，维护状态缓存。要重置此缓存运行`mvn eclipse:remove-cache`，或使用该 `forceRecheck`选项。
eclipseDownloadSources	`boolean`	`-`	已弃用。{0}。使用下载源
eclipse项目目录	`File`	`-`	Eclipse 工作区目录。
排除	`List`	`2.5`	要从 Eclipse 类路径中排除的工件列表，由一些 Eclipse 类路径容器提供 [MECLIPSE-79]
强制重新检查	`boolean`	`-`	启用/禁用重新检查远程存储库以下载源/javadoc 附件。默认为假。当此标志为`true`并且源或 javadoc 附件具有状态缓存以指示它不可用时，将重新检查远程存储库以查找源或 javadoc 附件，并更新状态缓存以反映新状态。
limitProjectReferencesToWorkspace	`boolean`	`-`	限制对当前工作空间的项目引用的使用。当工作空间中不可用时，不会为反应器中的项目创建项目引用。默认值为：`false`。
显现	`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`。
工作区	`File`	`2.5`	读取此 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

附加构建命令：

要添加到默认命令的 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

附加配置：

允许为运行 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

附加项目方面：

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

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

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

附加项目性质：

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

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

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

ajdt版本：

将为其生成配置文件的 AJDT 版本。默认值为“1.5”，支持的版本为“none”、“1.4”和“1.5”。

类型：java.lang.String
必需：No
表达式：${eclipse.ajdtVersion}
默认：1.5

构建输出目录：

默认输出目录

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

构建命令：

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

类路径容器：

容器类路径条目列表。默认情况下 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

下载Javadocs：

启用/禁用 javadoc 附件的下载。默认为假。当此标志为true远程存储库时，会检查 javadocs：为了避免重复检查不可用的 javadoc 档案，会保留状态缓存。要重置此缓存运行mvn eclipse:remove-cache，或使用该 forceRecheck选项。

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

下载来源：

启用/禁用源附件的下载。默认为假。当此标志为true远程存储库时，检查源：为了避免重复检查不可用的源存档，维护状态缓存。要重置此缓存运行mvn eclipse:remove-cache，或使用该 forceRecheck选项。

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

eclipseDownloadSources：

已弃用。使用下载源

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

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

eclipseProjectDir：

Eclipse 工作区目录。

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

不包括：

要从 Eclipse 类路径中排除的工件列表，由一些 Eclipse 类路径容器提供 [MECLIPSE-79]

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

强制重新检查：

启用/禁用重新检查远程存储库以下载源/javadoc 附件。默认为假。当此标志为true并且源或 javadoc 附件具有状态缓存以指示它不可用时，将重新检查远程存储库以查找源或 javadoc 附件，并更新状态缓存以反映新状态。

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

limitProjectReferencesToWorkspace：

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

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

清单：

清单文件的相对路径

类型：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

项目名称模板：

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

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

项目性质：

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

跳过：

为真时跳过操作。

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

使用项目参考：

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

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

工作区：

读取此 Eclipse 工作区，并且在此处检测到的所有工件都将作为 Eclipse 项目连接，并且不会链接到本地存储库中的 jar。要求是它是使用与 reactor 项目类似的 wtp 设置创建的，但项目名称模板不同。工作区项目中的 pom 可能不包含 artefactId、groupId 和 version 标签中的变量。如果未定义工作区，则将尝试通过检查目录层次结构来定位它。