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

在此页面上