设置开发工具 set-up-development-tools
Adobe Experience Manager (AEM) 开发需要在开发人员计算机上,安装和设置一组必不可少的开发工具。这些工具支持AEM项目的开发和构建。
请注意,~
用作用户目录的简写。 在Windows中,这相当于%HOMEPATH%
。
安装Java
Experience Manager是一种Java应用程序,因此需要Java SDK来支持开发和AEM as a Cloud Service SDK。
- 下载并安装最新版本的Java 11 SDK
- 通过运行以下命令验证是否已安装OracleJava 11 SDK:
code language-shell |
---|
|
code language-shell |
---|
|
code language-shell |
---|
|
安装Homebrew
使用Homebrew是可选的,但建议使用。
Homebrew是适用于macOS、Windows和Linux的开源包管理器。 所有的支持工具都可以单独安装,Homebrew为安装和更新Experience Manager开发所需的各种开发工具提供了便捷的方式。
- 打开终端
- 通过运行以下命令检查是否已安装Homebrew:
brew --version
。 - 如果未安装Homebrew,请安装Homebrew
- 通过运行以下命令验证是否已安装Homebrew:
brew --version
如果您使用的是Homebrew,请按照以下部分中的 使用Homebrew安装 说明进行操作。 如果您 不是 使用Homebrew,请使用特定于操作系统的链接安装工具。
安装Git
Git是AdobeCloud Manager使用的源代码管理系统,因此是开发所必需的。
-
打开终端/命令提示符
-
执行命令:
$ brew install git
-
使用命令
$ git --version
验证Git是否已安装
-
打开终端/命令提示符
-
使用命令
$ git --version
验证Git是否已安装
安装Node.js(和npm) node-js
Node.js是一个用于处理AEM项目 ui.frontend 子项目的前端资源的JavaScript运行时环境。 Node.js随npm分发,是实际的Node.js包管理器,用于管理JavaScript依赖项。
-
打开终端/命令提示符
-
执行命令:
$ brew install node
-
使用命令
$ node -v
验证是否已安装Node.js -
使用命令
$ npm -v
验证是否已安装npm
-
打开终端/命令提示符
-
使用命令
$ node -v
验证是否已安装Node.js -
使用命令
$ npm -v
验证是否已安装npm
安装Maven
Apache Maven是一个开源Java命令行工具,用于构建从AEM项目Maven原型生成的AEM项目。 所有主要IDE (IntelliJ IDEA、Visual Studio Code、Eclipse等) 集成了Maven支持。
-
打开终端/命令提示符
-
执行命令:
$ brew install maven
-
使用命令
$ mvn -v
验证是否已安装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
- 确保已安装Node.js,因为Adobe I/OCLI是npm模块
- 运行
node --version
以确认
- 运行
- 执行
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交互。
- 执行
aio plugins:install @adobe/aio-cli-plugin-cloudmanager
以安装aio Cloud Manager插件。
设置Adobe I/OCLI身份验证
为了使Adobe I/OCLI与Cloud Manager进行通信,必须在Adobe I/O控制台🔗中创建Cloud Manager集成,并且必须获取凭据才能成功进行身份验证。
-
确保包含要连接到的Cloud Manager产品的组织在Adobe组织切换器中处于活动状态
-
创建新项目或打开现有Adobe I/O
- Adobe I/O控制台项目只是由集成、创建或使用以及现有项目组成的组织分组,具体取决于您希望如何管理您的集成。
- 如果创建新项目,则在出现提示时选择“空项目”(与“从模板创建”)
- Adobe I/O控制台程序是与Cloud Manager程序不同的概念
-
创建新的Cloud Manager API集成
- 选择已弃用的“服务帐户(JWT)”身份验证类型(目前CLI不支持OAuth)。
- 创建或上传密钥。
- 选择“开发人员 — Cloud Service”产品配置文件
-
获取服务帐户(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" ] }
-
将
config.json
文件加载到Adobe I/OCLI$ aio config:set ims.contexts.aio-cli-plugin-cloudmanager ./path/to/config.json --file --json
-
将
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 快速开发环境交互。
- 执行
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工作程序。
- 执行
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实例同步。