Show Menu
主题×

AEM Developer Tools for Eclipse

概述

AEM Developer Tools for Eclipse是一个Eclipse插件,它基于Apache License 2下发布的 Eclipse插件for Apache Sling
它提供了几个使AEM开发更轻松的功能:
  • 通过Eclipse Server Connector与AEM实例无缝集成。
  • 内容和OSGI包的同步。
  • 使用代码热切换功能支持调试。
  • 通过特定项目创建向导简单引导AEM项目。
  • 轻松编辑JCR属性。

要求

在使用AEM开发人员工具之前,您需要:
  • 下载并安 装适用于Java EE开发人员的Eclipse IDE 。 AEM开发人员工具当前支持Eclipse Kepler或更高版本
  • 可与AEM 5.6.1版或更高版本一起使用
  • 配置Eclipse安装,以确保通过编辑配置文件(如 eclipse.ini Eclipse常见问题中所述)至少拥有1GB 堆内存
在macOS上,您需要右键单击 Eclipse.app ,然后选择“显 示包内容 ”以查找您的 eclipse.ini

如何安装Eclipse的AEM Developer Tools

满足上述要求后 要求 ,您可以按如下方式安装插件:
  1. 浏览 AEM
  2. 复制安 装链接
    请注意,您也可以下载存档,而不是使用安装链接。 这允许脱机安装,但这样会错过自动更新通知。
  3. 在Eclipse中,打开“帮 ”菜单。
  4. 单击“ 安装新软件”
  5. 单击 ​添加…….
  6. 在名 称中 ,键入AEM Developer Tools。
  7. 位置 ,复制安装URL。
  8. Click Ok .
  9. 检查 AEM Sling 插件。
  10. 单击​ 下一步
  11. 单击​ 下一步
  12. 接受这些链接协议,然后单击“ 完成 ”。
  13. 单击 ,以重新启动Eclipse。

如何导入现有项目

AEM透视

适用于Eclipse的AEM开发工具随“透视图”一起提供,使您能够完全控制AEM项目和实例。

示例多模块项目

适用于Eclipse的AEM开发人员工具附带一个多模块项目示例,它可以帮助您快速掌握Eclipse中的项目设置,并作为多个AEM功能的最佳实践指南。 进一步了解Project Archetype
按照以下步骤创建示例项目:
  1. 在“文 >新建 >项目 ”菜单中,浏览至“AEM示例”和“ AEM模块多项目项目”部分的AEM和SELECT Section。
  2. 单击​ 下一步
    此步骤可能需要一段时间,因为m2eclipse需要扫描原型目录。
  3. 择com.adobe.granite.archetypes:示例——项目——原型:(最大数) ,然后单击“下 一步”
  4. 为示例项 目填写名 组ID 对象ID 。 您还可以选择设置一些高级属性。
  5. 然后,您应配置Eclipse将连接到的AEM服务器。
    要使用调试器功能,您需要在调试模式下启动AEM —— 这可以通过向命令行添加以下内容来实现:
        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
    
    
  6. 单击“ 完成 ”。 将创建项目结构。
    在全新安装中(更具体地说:当从未下载过依赖项时),您可能会创建出包含错误的项目。 在这种情况下,请按照解决无效项目定义中 所述的过程操作

疑难解答

解析无效的项目定义

要解析无效的依赖关系和项目定义,请按如下步骤继续:
  1. 选择所有创建的项目。
  2. 右键单击。 在菜单中, 选择 “更 新项目”
  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部署添加正确版本。

More information

适用于Eclipse网站的Apache Sling IDE正式工具集为您提供了有用的信息:
以下官方 Eclipse 文档可以帮助您设置环境: