AEM Developer Tools for Eclipse是一个基于 适用于Apache Sling的Eclipse插件 已根据Apache许可证2发布。
它提供了以下几项功能,可简化AEM开发:
在使用AEM开发人员工具之前,您需要:
eclipse.ini
配置文件,如 Eclipse常见问题解答.在macOS上,您需要右键单击 Eclipse.app 然后选择 显示包内容 以找到 eclipse.ini
.
完成 要求 在上面,您可以按如下方式安装插件:
复制 安装链接.
请注意,或者,您也可以下载存档文件,而不是使用安装链接。 这允许离线安装,但您将无法通过这种方式接收自动更新通知。
在Eclipse中,打开 帮助 菜单。
单击 安装新软件.
单击 添加…….
在 名称 enter AEM Developer Tools
.
在 位置 复制安装URL。
单击添加。
同时检查 AEM 和 Sling 插件。
单击下一步。
在 安装详细信息 窗口,单击 下一个 再次。
接受许可协议并单击 完成.
单击 RestartNow 以便重新启动Eclipse。
在Eclipse中,透视可确定窗口内可用的操作和视图,并在Eclipse中启用面向任务的资源交互。 有关“透视”的更多详细信息,请参阅 Eclipse文档。
AEM Development Tools for Eclipse提供了AEM Perspective,它使您能够完全控制AEM项目和实例。 要打开AEM透视图,请执行以下操作:
AEM Developer Tools for Eclipse附带一个示例的多模块项目,该项目可帮助您快速掌握Eclipse中项目设置的速度,并且是一些AEM功能的最佳实践指南。 进一步了解项目原型.
按照以下步骤创建示例项目:
在 文件 > 新建 > 项目 菜单,浏览到 AEM 选择 AEM多模块项目示例.
单击下一步。
此步骤可能需要一些时间,因为m2eclipse需要扫描原型目录。
选择 com.adobe.granite.archetypes : sample-project-archetype : <highest-number>
,然后单击 下一个.
为示例项目提供以下字段:
单击下一步。
然后,您将配置一个AEM服务器,Eclipse将连接到该服务器。
要使用调试器功能,您需要在调试模式下启动AEM — 例如,通过将以下内容添加到命令行中即可实现:
-nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
单击 完成. 随即会创建项目结构。
在全新安装后(更具体地说,当从未下载Maven依赖项时),您可能会收到创建的项目并出现错误。 在本例中,请按照 解决无效项目定义.
您可以使用 新建项目 为您创建正确结构的功能:
按照相关说明创建 示例多模块项目 您将为您创建以下项目,以便能够正常地分离关注事项:
PROJECT.ui.apps
表示 /apps
和 /etc
内容PROJECT.ui.content
表示 /content
创作的PROJECT.core
(当您想要添加Java代码时,这些包会变得有趣)PROJECT.it.launcher
和 PROJECT.it.tests
用于集成测试替换 PROJECT.ui.apps
项目 apps
和 etc
包的文件夹:
PROJECT.ui.apps
> src
> main
> content
> jcr_root
> apps
.apps
文件夹,然后选择 显示位置 > 系统资源管理器.apps
和 etc
您现在应该看到的文件夹,并将其放在此处 apps
和 etc
内容包的文件夹。PROJECT.ui.apps
项目,选择 刷新.那么,为 PROJECT.ui.content
并将其content文件夹替换为您的包之一:
PROJECT.ui.content
> src
> main
> content
> jcr_root
> content
.PROJECT.ui.content
项目,选择 刷新.现在,您必须更新 filter.xml
这两个项目的文件,以对应于内容包的内容。 为此,请打开 META-INF/vault/filter.xml
文件。
filter.xml
文件可以显示:<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
<filter root="/apps/foo"/>
<filter root="/apps/foundation/components/bar"/>
<filter root="/etc/designs/foo"/>
<filter root="/content/foo"/>
<filter root="/content/dam/foo"/>
<filter root="/content/usergenerated/content/foo"/>
</workspaceFilter>
至于已拆分为两个项目的包内容,您还必须将这些过滤器规则拆分为两个,并相应地更新 filter.xml
两个项目的文件。
在Eclipse中,打开 PROJECT.ui.apps/src/main/content/META-INF/filter.xml
.
替换 <workspaceFilter>
元素,其中包的规则以开头 /apps
和 /etc
例如:
<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
<filter root="/apps/foo"/>
<filter root="/apps/foundation/components/bar"/>
<filter root="/etc/designs/foo"/>
</workspaceFilter>
然后打开 PROJECT.ui.content/src/main/content/META-INF/filter.xml
.
将规则替换为以开头的包规则 /content
.
例如:
<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
<filter root="/content/foo"/>
<filter root="/content/dam/foo"/>
<filter root="/content/usergenerated/content/foo"/>
</workspaceFilter>
确保保存所有更改。 您现在可以将新内容同步到AEM实例。
在“服务器”面板中,确保已启动连接,如果未启动连接,请确保已启动连接。
单击 清理并发布 图标。
完成后,您应在实例上运行包,在保存后,任何更改都会自动同步到实例。
如果您希望从项目中重新构建资源包,请右键单击 PROJECT.ui.apps
或 PROJECT.ui.content
选择 运行方式 -> Maven安装.
现在,您有一个目标文件夹,该文件夹已随包一起创建(例如, PROJECT.ui.apps-0.0.1-SNAPSHOT.zip
)。
要解决无效的依赖项,项目定义将按如下步骤进行:
Eclipse下载所需的依赖项。 这可能需要一些时间。
适用于Eclipse网站的官方Apache Sling IDE工具为您提供了以下有用信息:
以下官员 Eclipse 文档可帮助设置您的环境: