AEM Developer Tools for Eclipse

概述

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

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

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

要求

在使用AEM开发人员工具之前,您需要:

注意

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

如何安装AEM Developer Tools for Eclipse

满足上述要求后,可按如下方式安装插件:

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

  2. 复制​Installation Link

    请注意,或者,您也可以下载存档文件,而不是使用安装链接。 这允许离线安装,但您将无法通过这种方式接收自动更新通知。

  3. 在Eclipse中,打开​Help​菜单。

  4. 单击​安装新软件

  5. 单击​添加……

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

  7. 在​Location​中,复制安装URL。

  8. 单击​确定

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

  10. 单击​下一步

  11. 单击​下一步

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

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

如何导入现有项目

注意

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

AEM透视

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

chlimage_1-2

多模块项目示例

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

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

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

    chlimage_1-69

  2. 单击​下一步

    注意

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

    chlimage_1-70

  3. 选择​com.adobe.granite.archetypes :sample-project-archetype :(最高数),然后单击​下一页

    chlimage_1-71

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

    chlimage_1-72

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

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

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

    chlimage_1-73

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

    注意

    在全新安装中(更具体地说:从未下载maven依赖项时),您可能会收到创建的项目并出现错误。 在这种情况下,请按照解析无效项目定义中描述的过程操作。

疑难解答

解决无效的项目定义

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

  1. 选择所有已创建的项目。
  2. 右键单击。 在菜单​Maven​中,选择​更新项目
  3. 检查​Force Updates of Snapshot/Releases
  4. 单击​确定。Eclipse会尝试下载所需的依赖项。

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

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

要解决此问题,请确保org.apache.sling.scripting.jsp.taglib对象位于AEM 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文档可帮助设置您的环境:

在此页面上