文件AEMAEM 教學課程AEM as a Cloud Service 教學課程

設定開發工具 set-up-development-tools

Last update: Tue Apr 02 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Beginner
  • Developer

展開 Adobe Experience Manager (AEM) 的開發作業前，開發人員的電腦上需先安裝與設定一套簡單的開發工具。這些工具可支援AEM專案的開發與建置。

請注意 ~ 會用作使用者目錄的速記。 在Windows中，這相當於 %HOMEPATH%.

安裝Java

Experience Manager是一種Java應用程式，因此需要Java SDK來支援開發和AEMas a Cloud ServiceSDK。

  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

Git 原始檔控制管理系統是由 AdobeCloud Manager因此，是開發時的必要專案。

使用Homebrew安裝Git

  1. 開啟您的終端機/命令提示字元

  2. 執行命令： $ brew install git

  3. 使用命令確認已安裝Git： $ git --version

下載並安裝Git

  1. 下載並安裝Git

  2. 開啟您的終端機/命令提示字元

  3. 使用命令確認已安裝Git： $ git --version

Git

安裝Node.js （和npm） node-js

Node.js 是一個用於處理AEM專案的前端資產的JavaScript執行階段環境 ui.frontend 子專案。 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

  1. 下載並安裝Node.js

  2. 開啟您的終端機/命令提示字元

  3. 使用下列命令確認已安裝Node.js： $ node -v

  4. 使用下列命令驗證是否已安裝npm： $ npm -v

Node.js和npm

TIP
AEM專案原型-based AEM專案會在建置時安裝隔離版本的Node.js。 最好讓本機開發系統的版本與在AEM Maven專案的Reactor pom.xml中指定的Node.js和npm版本保持同步（或接近）。
請參閱此範例 AEM專案反應器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. 使用命令確認已安裝Maven： $ mvn -v

下載並安裝Maven

  1. 下載Maven

  2. 安裝Maven

  3. 開啟您的終端機/命令提示字元

  4. 使用命令確認已安裝Maven： $ mvn -v

Maven

設定Adobe I/OCLI aio-cli

此 ADOBE I/OCLI，或 aio，提供各種Adobe服務的命令列存取權，包括 Cloud Manager 和 asset compute. Adobe I/OCLI在AEMas 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/OAdobe Cloud Manager外掛程式允許aio CLI透過 aio cloudmanager 命令。

  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

開始 正在執行命令 適用於Cloud Manager，透過Adobe I/OCLI。

設定AEM快速開發環境外掛程式 rde

AEM快速開發環境外掛程式可讓aio CLI與AEMas a Cloud Service互動 快速開發環境 透過 aio aem:rde 命令。

  1. 執行 aio plugins:install @adobe/aio-cli-plugin-aem-rde 安裝 AEM快速開發環境外掛程式.

設定Adobe I/OCLIAsset compute外掛程式 aio-asset-compute

Adobe I/OCloud Manager外掛程式可讓aio CLI透過產生並執行Asset compute背景工作 aio 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開發，但旗艦版仍可使用 擴充其功能集.

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

Microsoft Visual Studio Code

Visual Studio Code (VS Code)是適用於前端開發人員的免費開放原始碼工具。 Visual Studio Code可設定為在Adobe工具的協助下與AEM整合內容同步。 存放庫.

Visual Studio Code是前端開發人員建立前端計畫碼、JavaScript、CSS和HTML的理想選擇。 VS Code透過支援Java 擴充功能，可能缺乏更具Java特定性的部分進階功能。

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

Eclipse

Eclipse IDE 是Java開發的熱門IDE，並支援 AEM Developer Tools Adobe此外掛程式，提供IDE內部的GUI，以供撰寫及將JCR內容與本機AEM執行個體同步。

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

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