适用于 Eclipse 的 AEM 开发人员工具 aem-developer-tools-for-eclipse

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
开发中

创建对象：

开发人员

CAUTION

AEM 6.4已结束扩展支持，本文档将不再更新。有关更多详细信息，请参阅技术支助期. 查找支持的版本此处.

概述 overview

AEM Developer Tools for Eclipse是一个基于适用于Apache Sling的Eclipse插件已根据Apache许可证2发布。

它提供了以下几项功能，可简化AEM开发：

通过Eclipse Server Connector与AEM实例无缝集成。
内容和OSGI包的同步。
支持调试和代码热切换功能。
通过特定项目创建向导简单引导AEM项目。
轻松编辑JCR属性。

要求 requirements

在使用AEM开发人员工具之前，您需要：

下载并安装面向Java EE开发人员的Eclipse IDE. AEM开发人员工具当前支持Eclipse Kepler或更高版本
可与AEM版本5.6.1或更高版本一起使用
配置Eclipse安装，以通过编辑 eclipse.ini 配置文件，如 Eclipse常见问题解答.

NOTE

在macOS上，您需要右键单击 Eclipse.app 然后选择 显示包内容 以找到 eclipse.ini.

如何安装AEM Developer Tools for Eclipse how-to-install-the-aem-developer-tools-for-eclipse

完成要求在上面，您可以按如下方式安装插件：

浏览 AEM 开发人员工具网站.
复制 安装链接.

请注意，或者，您也可以下载存档文件，而不是使用安装链接。这允许离线安装，但您将无法通过这种方式接收自动更新通知。
在Eclipse中，打开帮助菜单。
单击 安装新软件.
单击 添加…….
在名称键入AEM Developer Tools。
在位置复制安装URL。
单击确定.
同时检查 AEM 和 Sling 插件。
单击 下一步。
单击 下一步。
接受这些临时协议并单击完成.
单击是以便重新启动Eclipse。

如何导入现有项目 how-to-import-existing-projects

NOTE

请参阅从AEM下载Eclipse包时，如何在包中使用.

AEM透视 the-aem-perspective

Eclipse的AEM开发工具附带一个透视，可让您完全控制AEM项目和实例。

chlimage_1-2

示例多模块项目 sample-multi-module-project

AEM Developer Tools for Eclipse附带一个示例的多模块项目，该项目可帮助您快速掌握Eclipse中项目设置的速度，并且是一些AEM功能的最佳实践指南。进一步了解项目原型.

按照以下步骤创建示例项目：

在文件 > 新建 > 项目菜单，浏览到 AEM 选择 AEM多模块项目示例.

单击 下一步。

note note
NOTE
此步骤可能需要一些时间，因为m2eclipse需要扫描原型目录。

chlimage_1-70

选择 com.adobe.granite.archetypes :sample-project-archetype :（最高数） ，然后单击 下一个.
填写名称, 组ID 和 项目ID ，以查看示例项目。您还可以选择设置一些高级属性。

然后，您应该配置一个AEM服务器，Eclipse将连接到该服务器。

要使用调试器功能，您需要在调试模式下启动AEM — 例如，通过将以下内容添加到命令行中即可实现：

code language-none
`-nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123`

chlimage_1-73

单击完成. 随即会创建项目结构。

note note
NOTE
在全新安装中(更具体地说：从未下载maven依赖项时)，您可能会收到创建的项目并出现错误。在本例中，请按照解决无效项目定义.

疑难解答 troubleshooting

解决无效项目定义 resolving-invalid-project-definition

要解决无效的依赖项，项目定义将按如下步骤进行：

选择所有已创建的项目。
右键单击。在菜单中马文选择 更新项目.
检查 强制更新快照/版本.
单击确定。Eclipse会尝试下载所需的依赖项。

在JSP文件中启用标记库自动完成 enabling-tag-library-autocompletion-in-jsp-files

标记库自动完成功能开箱即用，因为项目中已添加了适当的依赖关系。使用AEM Uber Jar时存在一个已知问题，该问题不包括所需的tld和TagExtraInfo文件。

要解决此问题，请确保org.apache.sling.scripting.jsp.taglib对象位于AEM Uber Jar之前的类路径中。对于Maven项目，请将以下依赖项放在pom.xml中Uber Jar之前。

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

确保为部署AEM添加正确的版本。