设置开发工具 set-up-development-tools

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

请注意,~用作用户目录的简写。 在Windows中,这相当于%HOMEPATH%

安装Java

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

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

Java

安装Homebrew

使用Homebrew是可选的,但建议使用。

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

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

macOS🔗上的Homebrew需要Xcode命令行工具,可通过命令安装:

code language-shell
$ xcode-select --install
Windows
在Windows 10上安装Homebrew
Linux
在Linux上安装Homebrew
  1. 通过运行以下命令验证是否已安装Homebrew: brew --version

Homebrew

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

安装Git

GitAdobeCloud Manager使用的源代码管理系统,因此是开发所必需的。

使用Homebrew安装Git
  1. 打开终端/命令提示符

  2. 执行命令: $ brew install git

  3. 使用命令$ git --version验证Git是否已安装

下载并安装Git
  1. 下载并安装Git

  2. 打开终端/命令提示符

  3. 使用命令$ git --version验证Git是否已安装

Git

安装Node.js(和npm) node-js

Node.js是一个用于处理AEM项目​ ui.frontend ​子项目的前端资源的JavaScript运行时环境。 Node.js随npm分发,是实际的Node.js包管理器,用于管理JavaScript依赖项。

使用Homebrew安装Node.js
  1. 打开终端/命令提示符

  2. 执行命令: $ brew install node

  3. 使用命令$ node -v验证是否已安装Node.js

  4. 使用命令$ npm -v验证是否已安装npm

下载并安装Node.js
  1. 下载并安装Node.js

  2. 打开终端/命令提示符

  3. 使用命令$ node -v验证是否已安装Node.js

  4. 使用命令$ npm -v验证是否已安装npm

Node.js和npm

TIP
基于AEM Project Archetype的AEM项目在生成时安装隔离版本的Node.js。 最好使本地开发系统的版本与在AEM Maven项目的Reactor pom.xml中指定的Node.js和npm版本保持同步(或接近)。
请参阅此示例AEM Project Reactor pom.xml,了解在何处找到Node.js和npm内部版本的位置。

安装Maven

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

使用Homebrew安装Maven
  1. 打开终端/命令提示符

  2. 执行命令: $ brew install maven

  3. 使用命令$ mvn -v验证是否已安装Maven

下载并安装Maven
  1. 下载Maven

  2. 安装Maven

  3. 打开终端/命令提示符

  4. 使用命令$ mvn -v验证是否已安装Maven

Maven

设置Adobe I/OCLI aio-cli

Adobe I/OCLIaio提供各种Adobe服务的命令行访问权限,包括Cloud ManagerAsset compute。 Adobe I/OCLI在AEM as a Cloud Service的开发中起着不可或缺的作用,因为它使开发人员能够:

  • AEM as aCloud Service服务中的尾日志
  • 从CLI管理Cloud Manager管道
  • 部署到AEM快速开发环境

安装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插件 aio-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/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 Manager API集成

    • 选择已弃用的“服务帐户(JWT)”身份验证类型(目前CLI不支持OAuth)。
    • 创建或上传密钥。
    • 选择“开发人员 — Cloud Service”产品配置文件
  5. 获取服务帐户(JWT)凭据需要填充Adobe I/OCLI的config.json

    code language-json
    //config.json
    {
       "client_id": "Client ID from Service Account (JWT) credential",
       "client_secret": "Client Secret from Service Account (JWT) credential",
       "technical_account_id": "Technical Account ID from Service Account (JWT) credential",
       "ims_org_id": "Organization ID from Service Account (JWT) credential",
       "meta_scopes": [
         "ent_cloudmgr_sdk"
       ]
    }
    
  6. config.json文件加载到Adobe I/OCLI

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager ./path/to/config.json --file --json
  7. private.key文件加载到Adobe I/OCLI

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key ./path/to/private.key --file

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

设置AEM快速开发环境插件 rde

AEM快速开发环境插件允许aio CLI通过aio aem:rde命令与AEM as a Cloud Service 快速开发环境交互。

  1. 执行aio plugins:install @adobe/aio-cli-plugin-aem-rde以安装AEM快速开发环境插件

设置Adobe I/OCLIAsset compute插件 aio-asset-compute

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

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

设置开发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集成content sync。

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

Eclipse

Eclipse IDE ​是用于Java开发的常用IDE,它支持Adobe提供的​ AEM Developer Tools ​插件,从而提供了IDE GUI用于创作和将JCR内容与本地AEM实例同步。

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69