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文档可帮助设置您的环境：

在此页面上