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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

适用于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

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

浏览 AEM Developer Tools 网站： https://eclipse.adobe.com/aem/dev-tools/。
复制 安装链接。

或者，您也可以下载归档文件，而不是使用安装链接。这样做允许脱机安装，但您会遗漏自动更新通知。
在Eclipse中，打开帮助菜单。
单击 安装新软件。
单击 添加……。
在名称中，键入AEM Developer Tools。
在位置中，复制安装URL。
单击确定。
检查 AEM 和 Sling 插件。
单击 下一步。
单击 下一步。
接受Lincese协议，然后单击完成。
单击是重新启动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功能的最佳实践指南。了解有关项目原型的更多信息。

要创建示例项目，请完成以下步骤：

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

单击 下一步。

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

chlimage_1-70

从菜单中选择 com.adobe.granite.archetypes ： sample-project-archetype ：（最高编号），然后单击 下一步。
为示例项目填写名称、组ID 和 工件ID。您还可以选择设置一些高级属性。

现在，配置Eclipse可以连接的AEM服务器。

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

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

chlimage_1-73

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

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

疑难解答 troubleshooting

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

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

选择所有已创建的项目。
右键单击。在菜单 Maven 中，选择 更新项目。
检查 强制更新快照/版本。
单击确定。 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添加正确的版本。