设置开发工具

Adobe Experience Manager(AEM)开发需要在开发人员计算机上安装和设置一组必不可少的开发工具。 这些工具支持AEM项目的开发和构建。

请注意, ~用作用户目录的简写形式。 在Windows中,这等同于%HOMEPATH%

安装Java

Experience Manager是一个Java应用程序,因此需要Java SDK来支持开发和AEM as a JavaCloud ServiceSDK。

  1. 下载并安装最新版本的Java 11 SDK
  2. 通过运行以下命令验证是否已安装Java 11 SDK:
    • Windows: java -version
    • macOS / Linux:java --version

Java

安装Homebrew

可以选择使用Homebrew,但建议使用。

Homebrew是适用于macOS、Windows和Linux的开源包管理器。 所有支持工具都可以单独安装,Homebrew为安装和更新Experience Manager开发所需的各种开发工具提供了一种方便的方法。

  1. 打开终端
  2. 通过运行命令检查是否已安装Homebrew:brew --version
  3. 如果未安装Homebrew,请安装Homebrew
  4. 通过运行命令验证Homebrew是否已安装:brew --version

家酿

如果您使用的是Homebrew,请按照以下部分中的​Install using Homebrew​说明操作。 如果您​​使用Homebrew,请使用特定于操作系统的链接安装工具。

安装Git

🔗 提供Experience Cloud Manager使用的源代码 管理系统,因此需要进行开发。

  • 使用Homebrew安装Git
    1. 打开终端/命令提示符
    2. 执行命令:brew install git
    3. 使用命令验证Git是否已安装:git --version
  • 或者,下载并安装Git(macOS、Linux或Windows)
    1. 下载并安装Git
    2. 打开终端/命令提示符
    3. 使用命令验证Git是否已安装:git --version

Git

安装Node.js(和npm)

Node. jsis一个JavaScript运行时环境,用于处理AEM项目ui.frontendsub项目的 前端资 产。Node.js与npm一起分发,后者是事实上的Node.js包管理器,用于管理JavaScript依赖关系。

  • 使用Homebrew安装Node.js
    1. 打开终端/命令提示符
    2. 执行命令:brew install node
    3. 使用命令验证Node.js是否已安装:node -v
    4. 使用命令验证npm是否已安装:npm -v
  • 或者,下载并安装Node.js(macOS、Linux或Windows)
    1. 下载并安装Node.js
    2. 打开终端/命令提示符
    3. 使用命令验证Node.js是否已安装:node -v
    4. 使用命令验证npm是否已安装:npm -v

Node.js和npm

小贴士

基于AEM项目原型的AEM项目在生成时会安装一个孤立版本的Node.js。最好将本地开发系统的版本与AEM Maven项目的Reactor pom.xml中指定的Node.js和npm版本保持同步(或接近)。

请参阅此示例AEM Project Reactor pom.xml ,以了解在何处查找Node.js和npm内部版本。

安装Maven

Apache Maven是一款开源Java命令行工具,用于构建从AEM Project Maven Archetype生成的AEM项目。 所有主要IDE(IntelliJ IDEAVisual Studio代码Eclipse等) 集成了Maven支持。

  • 使用Homebrew安装Maven
    1. 打开终端/命令提示符
    2. 执行命令:brew install maven
    3. 使用命令验证Maven是否已安装:mvn -v
  • 或者,下载并安装Maven(macOS、Linux或Windows)
    1. 下载Maven
    2. 安装Maven
    3. 打开终端/命令提示符
    4. 使用命令验证Maven是否已安装:mvn -v

马文

设置Adobe I/OCLI

Adobe I/OCLIaio提供对各种Adobe服务(包括Cloud ManagerAsset compute)的命令行访问。 Adobe I/OCLI在AEM上作为Cloud Service进行开发时发挥了不可或缺的作用,因为它使开发人员能够:

  • 从AEM as a Cloud Services服务跟踪日志
  • 从CLI中管理Cloud Manager管道

安装Adobe I/OCLI

  1. 确保Node.js已安装,因为Adobe I/OCLI是npm模块
    • 运行node --version以确认
  2. 执行npm install -g @adobe/aio-cli以全局安装aio npm模块

设置Adobe I/OCLI Cloud Manager插件

Adobe I/OCloud Manager插件允许aio CLI通过aio cloudmanager命令与AdobeCloud Manager交互。

  1. 执行aio plugins:install @adobe/aio-cli-plugin-cloudmanager以安装aio Cloud Manager插件

设置Adobe I/OCLIAsset compute插件

Adobe I/OCloud Manager插件允许aio CLI通过aio asset-compute命令生成和运行Asset compute工作程序。

  1. 执行aio plugins:install @adobe/aio-cli-plugin-asset-compute以安装aioAsset compute插件

设置Adobe I/OCLI身份验证

为了使Adobe I/OCLI与Cloud Manager通信,必须在Adobe I/O控制台🔗中创建Cloud Manager集成,并且必须获取凭据才能成功进行身份验证。

  1. 登录到console.adobe.io
  2. 确保包含要连接到的Cloud Manager产品的组织在Adobe组织切换器中处于活动状态
  3. 创建新程序或打开现有Adobe I/O程序
    • Adobe I/O控制台程序只是将集成分组,根据您管理集成的方式创建或使用现有程序
    • 如果创建新项目,则在出现提示时选择“空项目”(与"从模板创建")
    • Adobe I/O控制台程序是Cloud Manager程序的不同概念
  4. 使用“开发人员 — Cloud Service”配置文件创建新的Cloud Manager API集成
  5. 获取服务帐户(JWT)凭据需要填充Adobe I/OCLI的config.json
  6. config.json文件加载到Adobe I/OCLI中
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager PATH_TO_CONFIG_JSON_FILE --file --json
  7. private.key文件加载到Adobe I/OCLI中
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key PATH_TO_PRIVATE_KEY_FILE --file

通过Adobe I/OCLI开始执行Cloud Manager的命令

设置开发IDE

AEM开发主要由Java和前端(JavaScript、CSS等)开发和XML管理组成。 以下是用于AEM开发的最常用IDE。

IntelliJ IDEA

IntelliJ IDEA 是一款功能强大的Java开发IDE。IntelliJ IDEA有两种版本,一种是免费的社区版本,另一种是商业(付费)Ultimate版本。 免费的社区版本足以用于AEM开发,但Ultimate 扩展了其功能集

Microsoft Visual Studio代码

Visual Studio Code (VS Code)是一款面向前端开发人员的免费开源工具。可以设置Visual Studio代码,以便借助Adobe工具​repo​将内容同步与AEM集成。

Visual Studio Code是主要创建前端代码的前端开发人员的理想选择;JavaScript、CSS和HTML。 虽然VS代码通过extensions支持Java,但它可能缺少一些由更特定于Java的组件提供的高级功能。

Eclipse

Eclipse IDE 是用于Java开发的常用IDE,它支持由 AEM 提供的Adobe开发人员工具插件,该插件提供了用于创作IDE内容以及将JCR内容与本地AEM实例同步的IDE内GUI。

在此页面上