設定開發工具

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

請注意, ~是用戶目錄的簡稱。 在Windows中,這等同於%HOMEPATH%

安裝Java

Experience Manager是Java應用程式,因此需要Java SDK才能支援開發,而AEM則是Cloud ServiceSDK。

  1. [下載並安裝最新版Java 11 SDK] (https://experience.adobe.com/#/downloads/content/software-distribution/en/general.html?1_group.propertyvalues.property=.%2Fjcr%3Acontent%2Fmetadata%2Fdc%3AsoftwareType&1_group.propertyvalues.operation=equals&1_group.propertyvalues.0_values=software-type%3Atoling&fulltext=Oracle%7E+JDK%7E+11%7E&orderby=%40jcr%3Cont%2Fjcr%3Alast&modified by.sort=dest&p.st=dest&p.llep.p.p=14)
  2. 執行以下命令以確認Java 11 SDK是否已安裝:
    • Windows: java -version
    • macOS / Linux:java --version

Java

安裝Homebrew

使用Homebrew是可選的,但建議使用。

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

  1. 開啟您的終端機
  2. 通過運行以下命令來檢查是否已安裝Homebrew:brew --version
  3. 如果未安裝Homebrew,請安裝Homebrew
  4. 通過運行以下命令來驗證是否安裝了Homebrew:brew --version

荷姆布魯

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

安裝Git

🔗 提供Experience Cloud Manager所使用的原始 碼控制管理系統,因此是開發所需的。

  • 使用Homebrew安裝Git
    1. 開啟終端機/命令提示字元
    2. 執行命令:brew install git
    3. 使用以下命令確認Git是否已安裝:git --version
  • 或者,下載並安裝Git(macOS、Linux或Windows)
    1. 下載及安裝Git
    2. 開啟終端機/命令提示字元
    3. 使用以下命令確認Git是否已安裝:git --version

Git

安裝Node.js(和npm)

Node. jsis是JavaScript執行階段環境,用於搭配AEM專案的ui.frontendsub專案的 前端資 產使用。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(macOS、Linux或Windows)
    1. 下載並安裝Node.js
    2. 開啟終端機/命令提示字元
    3. 使用命令驗證是否已安裝Node.js :node -v
    4. 使用以下命令驗證是否已安裝npm:npm -v

Node.js 和 npm

秘訣

AEM專案原型型的AEM專案會在建置時安裝孤立的Node.js版本。最好將本機開發系統的版本同步(或接近)AEM Maven專案的pom.xml中指定的Node.js和npm版本。

請參閱此範例AEM Project Reactor pom.xml,以了解如何找到Node.js和npm組建版本。

安裝Maven

Apache Maven是開放原始碼的Java命令列工具,用來建置從AEM Project Maven原型產生的AEM專案。 所有主要IDE(IntelliJ IDEAVisual Studio代碼Eclipse等) 已整合Maven支援。

  • 使用Homebrew安裝Maven
    1. 開啟終端機/命令提示字元
    2. 執行命令:brew install maven
    3. 使用命令驗證是否已安裝Maven :mvn -v
  • 或者,下載並安裝Maven(macOS、Linux或Windows)
    1. 下載Maven
    2. 安裝Maven
    3. 開啟終端機/命令提示字元
    4. 使用命令驗證是否已安裝Maven :mvn -v

馬文

設定Adobe I/OCLI

Adobe I/OCLIaio提供對多種Adobe服務(包括Cloud ManagerAsset compute)的命令行訪問。 Adobe I/OCLI在AEM作為Cloud Service的開發中扮演著不可或缺的角色,因為它可讓開發人員:

  • 從AEM as a Cloud Services服務追蹤記錄
  • 從CLI管理Cloud Manager管道

安裝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插件

Adobe I/OCloud Manager增效模組可讓aio CLI透過aio cloudmanager命令與AdobeCloud Manager互動。

  1. 執行aio plugins:install @adobe/aio-cli-plugin-cloudmanager以安裝aio Cloud Manager增效模組

設定Adobe I/OCLIAsset compute插件

Adobe I/OCloud Manager增效模組可讓aio CLI透過aio asset-compute命令產生及執行Asset compute背景工作。

  1. 執行aio plugins:install @adobe/aio-cli-plugin-asset-compute以安裝aioAsset compute插件

設定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 Service」設定檔建立新的Cloud Manager API整合
  5. 取得服務帳戶(JWT)憑證,需要填入Adobe I/OCLI的config.json
  6. config.json檔案載入Adobe I/OCLI
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager PATH_TO_CONFIG_JSON_FILE --file --json
  7. private.key檔案載入Adobe I/OCLI
    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager.private_key PATH_TO_PRIVATE_KEY_FILE --file

通過Adobe I/OCLI開始執行Cloud Manager的命令

設定開發IDE

AEM開發主要包含Java和前端(JavaScript、CSS等)開發及XML管理。 以下是AEM開發中最常用的IDE。

IntelliJ IDEA

IntelliJ IDEA是功能強大的Java開發IDE。IntelliJ IDEA提供兩種風格,一種是免費的社群版本,另一種是商業版(付費)Ultimate版本。 免費的Community版本足以用於AEM開發,但Ultimate 會擴充其功能集

Microsoft Visual Studio代碼

Visual Studio Code (VS Code)是前端開發人員的免費開放原始碼工具。可設定Visual Studio Code ,以便借助Adobe工具​repo​將內容同步與AEM整合。

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

Eclipse

Eclipse IDE 是Java開發的常用IDE,支援由Adobe提 供的AEM 開發工具外掛程式,提供IDE內部GUI,用於編寫JCR內容,並將JCR內容與本機AEM執行個體同步。

本頁內容