适用于 Eclipse 的 AEM 开发人员工具

概述

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

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

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

要求

在使用AEM开发人员工具之前,请执行以下操作:

注意

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

如何安装适用于Eclipse的AEM开发人员工具

一旦您满足了 要求 如上所示,您可以安装插件:

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

  2. 复制 安装链接.

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

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

  4. 单击 安装新软件.

  5. 单击 添加…….

  6. In 名称 键入AEM Developer Tools。

  7. In 位置 复制安装URL

  8. 单击 确定.

  9. 选中两者 AEMSling 插件。

  10. 单击​下一步

  11. 单击​下一步

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

  13. 单击 重新启动Eclipse。

如何导入现有项目

AEM视角

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

chlimage_1-2

示例多模块项目

“AEM开发人员工具”包含一个示例的多模块项目,可帮助您快速了解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. 现在配置Eclipse可以连接的AEM服务器。

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

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

    chlimage_1-73

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

    注意

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

疑难解答

解析无效的项目定义

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

  1. 选择所有创建的项目。
  2. 右键单击。 在菜单中 Maven,选择 更新项目.
  3. Check 强制更新快照/版本.
  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 文档可以帮助设置环境:

在此页面上