文档AEMAEM 教程AEM as a Cloud Service 教程

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

Last update: Tue Jul 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 初学者
  • 开发人员

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

Git是AdobeCloud 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 IDEA、Visual Studio Code、Eclipse等） 集成了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/OCLI或aio提供各种Adobe服务的命令行访问权限，包括Cloud Manager和Asset 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 扩展了其功能集。

https://video.tv.adobe.com/v/39743?quality=12&learn=on&captions=chi_hans

Microsoft Visual Studio代码

Visual Studio Code (VS Code)是面向前端开发人员的免费开源工具。 Visual Studio代码可以设置为在Adobe工具​ repo ​的帮助下与AEM集成content sync。

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

https://video.tv.adobe.com/v/25907?quality=12&learn=on

Eclipse

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

https://video.tv.adobe.com/v/25906?quality=12&learn=on

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