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的堆内存。

注意

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

如何安装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下载Eclipse中的捆绑包时如何使用它。

AEM透视

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

chlimage_1-2

示例多模块项目

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

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

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

    chlimage_1-69

  2. 单击​下一步

    注意

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

    chlimage_1-70

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

    chlimage_1-71

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

    chlimage_1-72

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

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

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

    chlimage_1-73

  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官方工具为您提供有用的信息:

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

在此页面上