設定開發工具 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
- 透過執行命令,確認已安裝Oracle Java 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是Adobe Cloud Manager使用的原始檔控制管理系統,因此是開發所需。
-
開啟您的終端機/命令提示字元
-
執行命令:
$ brew install git
-
使用下列命令驗證Git是否已安裝:
$ git --version
-
開啟您的終端機/命令提示字元
-
使用下列命令驗證Git是否已安裝:
$ git --version
安裝Node.js (和npm) node-js
Node.js是JavaScript執行階段環境,用來處理AEM專案的 ui.frontend 子專案的前端資產。 Node.js與npm一同發佈,是實際的Node.js封裝管理員,用於管理JavaScript相依性。
-
開啟您的終端機/命令提示字元
-
執行命令:
$ brew install node
-
使用下列命令,驗證是否已安裝Node.js:
$ node -v
-
使用下列命令驗證是否已安裝npm:
$ npm -v
-
開啟您的終端機/命令提示字元
-
使用下列命令,驗證是否已安裝Node.js:
$ node -v
-
使用下列命令驗證是否已安裝npm:
$ npm -v
安裝Maven
Apache Maven是開放原始碼Java命令列工具,用於建置從AEM專案Maven原型產生的AEM專案。 所有主要IDE (IntelliJ IDEA、Visual Studio Code、Eclipse等)均已整合Maven支援。
-
開啟您的終端機/命令提示字元
-
執行命令:
$ brew install maven
-
使用下列命令確認是否已安裝Maven:
$ mvn -v
設定Adobe I/O CLI aio-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
- 確認已安裝Node.js,因為Adobe I/O CLI是npm模組
- 執行
node --version
以確認
- 執行
- 執行
npm install -g @adobe/aio-cli
以全域安裝aio
npm模組
設定Adobe I/O CLI Cloud Manager外掛程式 aio-cloud-manager
Adobe I/O Cloud Manager外掛程式可讓aio CLI透過aio cloudmanager
命令與Adobe Cloud Manager互動。
- 執行
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整合,且必須取得認證才能成功驗證。
-
確保包含要連線之Cloud Manager產品的組織在Adobe組織切換器中處於活動狀態
-
建立新的或開啟現有的Adobe I/O程式
- Adobe I/O Console專案不過是依您想要管理整合的方式而組成的組織性整合群組、建立或使用以及現有的專案。
- 如果建立新專案,則在出現提示時選取「空白專案」(與「從範本建立」的比較)
- Adobe I/O Console程式與Cloud Manager程式有不同的概念
-
建立新的Cloud Manager API整合
- 選取「Oauth伺服器對伺服器」認證型別。
- 選取「部署管理員 — Cloud Service」產品設定檔。
- 儲存已設定的API
-
取得認證時,需要開啟新建立的「OAuth伺服器對伺服器」認證,然後從右上角的動作列選取「下載JSON」,以填入Adobe I/O CLI的config.json。
-
開啟下載的JSON檔案,並將所有金鑰重新命名為小寫。 例如,
CLIENT_ID
會變成client_id
。 -
將
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快速開發環境外掛程式 rde
AEM快速開發環境外掛程式可讓aio CLI透過aio aem:rde
命令與AEM as a Cloud Service 快速開發環境互動。
- 執行
aio plugins:install @adobe/aio-cli-plugin-aem-rde
以安裝AEM快速開發環境外掛程式。
設定Adobe I/O CLI Asset Compute外掛程式 aio-asset-compute
Adobe I/O Cloud Manager外掛程式可讓aio CLI透過aio asset-compute
命令產生及執行Asset Compute Worker。
- 執行
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 已擴充其功能集。
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特定性的部分進階功能。
Eclipse
Eclipse IDE 是Java開發的熱門IDE,可支援Adobe提供的 AEM Developer Tools 外掛程式,提供IDE中的GUI以供撰寫及同步JCR內容與本機AEM執行個體。