AEM Developer Tools for Eclipse

概述

AEM Developer Tools for Eclipse是一个基于Apache License 2下发布的Eclipse plugin for Apache Sling的Eclipse插件。

它优惠了几个使AEM开发更容易的功能：

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

要求

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

• 下载并安装Eclipse IDE for Java EE Developers。 AEM开发人员工具当前支持EclipseKepler或更新版本

• 可与AEM 5.6.1或更高版本一起使用

• 按照Eclipse常见问题解答中的说明，通过编辑eclipse.ini配置文件，配置Eclipse安装以确保至少拥有1 GB的堆内存。

如何安装AEM Developer Tools for Eclipse

满足上述要求后，可以按如下方式安装插件：

1. 浏览​AEM​开发人员工具网站。

2. 复制​安装链接。

   请注意，您也可以下载存档文件，而不是使用安装链接。 这允许脱机安装，但您会以这种方式错过自动更新通知。

3. 在Eclipse中，打开​帮助​菜单。

4. 单击​安装新软件。

5. 单击​添加……。

6. 在​名称​中，键入AEM Developer Tools。

7. 在​位置​中，复制安装URL。

8. 单击​确定。

9. 检查​AEM​和​Sling​插件。

10. 单击​下一步。

11. 单击​下一步。

12. 接受这些链接协议，然后单击​完成。

13. 单击​是​以重新启动Eclipse。

如何导入现有项目

AEM透视

AEM Development Tools for Eclipse附带一个透视图，它优惠您对AEM项目和实例的完全控制。

示例多模块项目

AEM Developer Tools for Eclipse附带一个范例、多模块项目，它可以帮助您快速掌握Eclipse中的项目设置，并作为几个AEM功能的最佳实践指南。 进一步了解Project Archetype。

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

1. 在​文件 > 新建 > 项目​菜单中，浏览至​AEM​部分并选择​AEM示例多模块项目。

   

2. 单击​下一步。

   注意

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

   

3. 选择​com.adobe.granite.archetypes:示例——项目——原型：(highest number)，然后单击​Next。

   

4. 为示例项目填写​名称、组id​和​项目id。 您还可以选择设置一些高级属性。

   

5. 然后，您应配置Eclipse将连接到的AEM服务器。

   要使用调试器功能，您需要在调试模式下启动AEM —— 这可以通过向命令行添加以下内容来实现：

       -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
   

   

6. 单击​完成。 将创建项目结构。

   注意

   在新安装中(更具体地说：当从未下载依赖项时)，您可能会创建出错误的项目。 在这种情况下，请按照解决无效项目定义中描述的过程操作。

疑难解答

解析无效的项目定义

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

1. 选择所有创建的项目。
2. 右键单击。 在菜单​Maven​中，选择​更新项目。
3. 检查​强制更新快照／发行版。
4. 单击​确定。Eclipse会尝试下载所需的依赖项。

在JSP文件中启用标记库自动完成

标签库自动完成功能开箱即用，前提是向项目添加了适当的依赖关系。 使用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的部署添加正确的版本。

更多信息

适用于Eclipse网站的Apache Sling IDE官方工具为您提供有用的信息：

• 本文档将指导您了解AEM开发工具支持的总体概念、服务器集成和部署功能，其中​Apache Sling IDE工具包，用于Eclipse​用户指南。
• 疑难解答部分。
• 已知问题列表。

以下官方Eclipse文档可以帮助您设置环境:

• Eclipse快速入门
• Eclipse Luna帮助系统
• Maven Integration(m2eclipse)