适用于 Eclipse 的 AEM 开发人员工具 aem-developer-tools-for-eclipse

适用于Eclipse的AEM Developer Tools的圆形图像基元。

概述 overview

“AEM Developer Tools”是一个基于Apache许可证2下发布的适用于Apache Sling🔗的Eclipse插件的Eclipse插件。

它提供了几项使AEM开发更轻松的功能:

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

要求 requirements

在使用AEM Developer Tools之前,请执行以下操作:

  • 下载并安装适用于Java™ EE开发人员的Eclipse IDE。 AEM Developer Tools当前支持Eclipse Kepler或更高版本

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

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

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

如何安装适用于Eclipse的AEM开发人员工具 how-to-install-the-aem-developer-tools-for-eclipse

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

  1. 浏览​ AEM Developer Tools ​网站: https://eclipse.adobe.com/aem/dev-tools/

  2. 复制​ 安装链接

    或者,您也可以下载归档文件,而不是使用安装链接。 这样做允许脱机安装,但您会遗漏自动更新通知。

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

  4. 单击​ 安装新软件

  5. 单击​ 添加……

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

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

  8. 单击​ 确定

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

  10. 单击​ 下一步

  11. 单击​ 下一步

  12. 接受Lincese协议,然后单击​ 完成

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

如何导入现有项目 how-to-import-existing-projects

NOTE
查看从AEM🔗下载包时如何在Eclipse中使用包。

AEM视角 the-aem-perspective

AEM Development Tools for Eclipse附带了一个透视,您可以通过该透视图完全控制AEM项目和实例。

chlimage_1-2

示例多模块项目 sample-multi-module-project

“AEM开发人员工具”包含一个示例的多模块项目,可帮助您快速上手Eclipse中的项目设置。 它还可用作几项AEM功能的最佳实践指南。 了解有关项目原型的更多信息

要创建示例项目,请完成以下步骤:

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

    chlimage_1-69

  2. 单击​ 下一步

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

    chlimage_1-70

  3. 从菜单中选择​ com.adobe.granite.archetypes : sample-project-archetype : (最高编号),然后单击​ 下一步

    chlimage_1-71

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

    chlimage_1-72

  5. 现在,配置Eclipse可以连接的AEM服务器。

    要使用Debugger功能,请确保在调试模式下启动AEM,这可以通过在命令行中添加以下内容来实现:

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

    chlimage_1-73

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

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

疑难解答 troubleshooting

解析无效的项目定义 resolving-invalid-project-definition

要解决无效依赖项和项目定义,请按照以下步骤操作:

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

在JSP文件中启用标记库自动完成 enabling-tag-library-autocompletion-in-jsp-files

标记库自动完成可开箱即用,前提是将适当的依赖关系添加到项目中。 使用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添加正确的版本。

更多信息 more-information

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

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2