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

設定開發工具

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用對象：
  • Experience Manager as a Cloud Service
  • 主題：
  • 開發人員工具

建立對象：

  • 初學者
  • 開發人員

展開 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
$ java --version
Windows
$ java -version
Linux
$ java --version

Java

安裝Homebrew

使用Homebrew是選用的，但建議使用。

Homebrew是適用於macOS、Windows和Linux的開放原始碼套件管理程式。 所有支援工具均可單獨安裝，Homebrew提供便利的方式來安裝和更新Experience Manager開發所需的各種開發工具。

  1. 開啟您的終端機
  2. 執行命令，檢查是否已安裝Homebrew： brew --version。
  3. 如果未安裝Homebrew，請安裝Homebrew
macOS

macOS🔗上的Homebrew需要Xcode或命令列工具，可透過命令安裝：

$ xcode-select --install
Windows
在Windows 10上安裝Homebrew
Linux
在Linux上安裝Homebrew
  1. 執行命令以驗證Homebrew是否已安裝： brew --version

Homebrew

如果您使用Homebrew，請遵循以下章節中的​ 使用Homebrew安裝 ​指示。 如果您​ 不是 ​使用Homebrew，請使用作業系統特定的連結來安裝工具。

安裝Git

Git是Adobe Cloud 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是JavaScript執行階段環境，用來處理AEM專案的​ 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專案原型型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. 使用下列命令確認是否已安裝Maven： $ mvn -v

下載並安裝Maven

  1. 下載Maven

  2. 安裝Maven

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

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

Maven

設定Adobe I/O CLI

Adobe I/O CLI或aio提供各種Adobe服務的命令列存取權，包括Cloud Manager和Asset Compute。 Adobe I/O CLI在AEM as a Cloud Service的開發中起著不可或缺的作用，因為它讓開發人員能夠：

  • AEM as a Cloud Services的尾部記錄
  • 從CLI管理Cloud Manager管道
  • 部署至AEM快速開發環境

安裝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外掛程式

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快速開發環境外掛程式

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外掛程式

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 已擴充其功能集。

video poster

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

  • 下載IntelliJ IDEA
  • 下載存放庫工具

Microsoft Visual Studio Code

Visual Studio Code (VS Code)是供前端開發人員使用的免費開放原始碼工具。 Visual Studio Code可設定為在Adobe工具​ repo ​的協助下，將內容同步處理與AEM整合。

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

video poster

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

  • 下載Visual Studio程式碼
  • 下載存放庫工具
  • 下載AEM Sync VS副檔名

Eclipse

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

video poster

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

  • 下載Eclipse
  • 下載Eclipse開發工具
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69