设置开发工具 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. 通过运行以下命令,验证是否已安装Oracle Java 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

GitAdobe Cloud 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是一个用于处理JavaScript项目​ ui.frontend ​子项目的前端资源的AEM运行时环境。 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项目原型的AEM项目在构建时安装独立版本的Node.js。 最好使本地开发系统的版本与在AEM Maven项目的Reactor pom.xml中指定的Node.js和npm版本保持同步(或接近)。
有关查找Node.js和npm内部版本的位置,请参阅此示例AEM项目Reactor pom.xml

安装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/O CLI aio-cli

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

安装Adobe I/O CLI

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

设置Adobe I/O CLI Cloud Manager插件 aio-cloud-manager

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

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

设置Adobe I/O CLI身份验证

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

  1. 登录到console.adobe.io

  2. 确保包含要连接到的Cloud Manager产品的组织在Adobe组织切换器中处于活动状态

  3. 创建新项目或打开现有Adobe I/O项目

    • Adobe I/O Console项目只是集成的组织分组,可创建或使用基于您希望如何管理集成的现有项目。
    • 如果创建新项目,则在出现提示时选择“空项目”(与“从模板创建”)
    • Adobe I/O Console程序是与Cloud Manager程序不同的概念
  4. 创建新的Cloud Manager API集成

    • 选择“Oauth服务器到服务器”凭据类型。
    • 选择“部署管理员 — Cloud Service”产品配置文件。
    • 保存配置的API
  5. 获取凭据需要通过打开新创建的“OAuth服务器到服务器”凭据并从右上角操作栏中选择“下载JSON”来填充Adobe I/O CLI的config.json

  6. 打开下载的JSON文件,并将所有密钥重命名为小写。 例如,CLIENT_ID变为client_id

  7. config.json文件加载到Adobe I/O CLI

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager /path/to/downloaded/json --file --json

通过Adobe I/O CLI开始执行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/O CLI Asset Compute插件 aio-asset-compute

Adobe I/O Cloud Manager插件允许aio CLI通过aio asset-compute命令生成和运行Asset Compute Worker。

  1. 执行aio plugins:install @adobe/aio-cli-plugin-asset-compute以安装aio Asset 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 Code可以设置为在Adobe工具​ repo ​的帮助下将内容同步与AEM集成。

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

Eclipse

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

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