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

适用于Eclipse徽标的Experience Manager开发人员工具

概述

适用于Eclipse的Experience Manager开发人员工具 是一个基于 适用于Apache Sling的Eclipse插件 根据Apache许可证2发布。

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

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

要求

在使用AEM Developer Tools之前,您需要:

注意

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

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

当您完成 要求 如上所示,您可以安装插件:

  1. 打开 AEM Developer Tools网站.

  2. 复制 安装链接.

    或者,您也可以下载归档文件,而不是使用安装链接。 此方法允许脱机安装,但您不会以这种方式收到未命中的自动更新通知。

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

  4. 单击 安装新软件.

  5. 单击 添加…….

  6. 名称 字段,输入 AEM Developer Tools.

  7. 位置 字段中,复制安装URL。

  8. 单击​添加

  9. 选中两者 AEMSling 插件。

  10. 单击​下一步

  11. 安装详细信息 窗口,单击 下一个 再来一次。

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

  13. 单击 RestartNow 以重新启动Eclipse。

AEM视角

在Eclipse中,“透视”可确定窗口内可用的操作和视图,并支持与Eclipse中的资源进行面向任务的交互。 有关“透视”的更多详细信息,请参阅 Eclipse文档。

适用于Eclipse的Experience Manager开发工具 提供一个可让您完全控制AEM项目和实例的AEM Perspective。 要打开AEM Perspective,请执行以下操作:

  1. 从Eclipse菜单栏中,选择 窗口 -> 透视 -> 打开透视 -> 其他.
  2. 选择 AEM 在对话框中,单击 打开.

Eclipse中的AEM视角

示例多模块项目

适用于Eclipse的Experience Manager开发人员工具 随附一个多模块示例项目,可帮助您快速熟悉Eclipse中的项目设置。 它还可用作几项AEM功能的最佳实践指南。 了解有关项目原型的更多信息.

按照以下步骤创建示例项目:

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

    AEM示例多模块项目

  2. 单击​下一步

    注意

    此步骤可能需要花些时间,因为m2eclipse需要扫描原型目录。

  3. 选择 com.adobe.granite.archetypes : sample-project-archetype : <highest-number> 在菜单中,然后单击 下一个.

    选择原型版本

  4. 为示例项目提供以下字段:

    • 名称
    • 组ID
    • 工件ID
    • appId — 您可能需要展开 高级 设置此值的选项。
    • appTitle — 您可能需要展开 高级 设置此值的选项。
    • — 您可能需要展开 高级 设置此值的选项。

    定义原型属性

  5. 单击​下一步

  6. 然后,配置与Eclipse连接的AEM服务器。

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

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

    连接到AEM服务器

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

    注意

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

如何导入现有项目

您可以使用 新建项目 创建正确结构的功能:

  1. 按照说明创建 示例多模块项目 并且您已经为您创建了以下项目,这些项目允许健康地分离问题:

    • PROJECT.ui.apps 对象 /apps/etc 内容
    • PROJECT.ui.content 对象 /content 已创作
    • PROJECT.core 对于Java™包(当您想要添加Java™代码时,这些包会变得很有趣)
    • PROJECT.it.launcherPROJECT.it.tests 用于集成测试
  2. 替换的内容 PROJECT.ui.apps 使用的项目 appsetc 包文件夹:

    1. 在“项目资源管理器”面板中,展开 PROJECT.ui.apps > src > main > content > jcr_root > apps.
    2. 右键单击 apps 文件夹并选择 显示位置 > 系统资源管理器.
    3. 删除 appsetc 您现在应该看到的文件夹,并将其放在此处 appsetc 内容包的文件夹。
    4. 在Eclipse中,右键单击 PROJECT.ui.apps 项目并选择 刷新.
  3. 然后对 PROJECT.ui.content 并将其内容文件夹替换为您的包之一:

    1. 在“项目资源管理器”面板中,展开 PROJECT.ui.content > src > main > content > jcr_root > content.
    2. 右键单击更深入的内容文件夹并选择 显示位置 -> 系统资源管理器.
    3. 删除您现在应该看到的内容文件夹,并在此处放置内容包的内容文件夹。
    4. 在Eclipse中,右键单击 PROJECT.ui.content 项目并选择 刷新.
  4. 现在,您必须更新 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>
    
  5. 对于已拆分为两个项目的资源包内容,还必须将这些筛选规则拆分为两个项目并相应地更新 filter.xml 这两个项目的文件。

    1. 在Eclipse中,打开 PROJECT.ui.apps/src/main/content/META-INF/filter.xml.

    2. 替换的内容 <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>
        
    3. 然后打开 PROJECT.ui.content/src/main/content/META-INF/filter.xml.

    4. 将规则替换为以开头的包中的规则 /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>
        
  6. 确保保存所有更改。 现在,您可以将该新内容同步到您的AEM实例。

  7. 在“服务器”面板中,确保连接已启动,如果未启动,则确保连接已启动。

  8. 单击 清理并发布 图标。

完成后,您应在实例上运行包,保存后,任何更改都会自动同步到该实例。

如果您希望从项目重新构建包,请右键单击 PROJECT.ui.appsPROJECT.ui.content 并选择 运行方式 -> Maven安装.

现在,您已经创建了一个目标文件夹,其中包含了您的包(例如,名为) PROJECT.ui.apps-0.0.1-SNAPSHOT.zip)。

疑难解答

解析无效的项目定义

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

  1. 选择所有创建的项目。
  2. 右键单击。
  3. 在上下文菜单中,选择 Maven -> 更新项目.
  4. Check 强制更新快照/版本.
  5. 单击​确定

Eclipse下载所需的依赖项。 这可能需要花些时间。

更多信息

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

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

在此页面上