如何使用IntelliJ IDEA開發AEM專案

概覽

若要開始使用IntelliJ上的AEM開發，必須執行下列步驟。

在本「操作說明」的其餘章節中，將詳細說明每項說明。

安裝IntelliJ
根據Maven設定您的AEM專案
在Maven POM中準備IntelliJ的JSP支援
將Maven專案匯入IntelliJ

注意

本指南以IntelliJ IDEA Ultimate Edition 12.1.4和AEM 5.6.1為基礎。

安裝IntelliJ IDEA

從JetBrains的「下載」頁面下載IntelliJ IDEA。

然後，請依照該頁上的安裝指示進行。

根據Maven設定您的AEM專案

接著，使用Maven來設定專案，如使用Apache Maven建立AEM專案中所述。

若要開始在IntelliJ IDEA中使用AEM專案，Getting Started in 5 Minutes中的基本設定已足夠。

準備IntelliJ IDEA的JSP支援

此外，IntelliJ IDEA也可提供使用JSP的支援，例如

自動完成標籤庫
對<cq:defineObjects />和<sling:defineObjects />所定義對象的感知

為了讓AEM項目正常運作，請依照使用Apache Maven建立AEM專案中使用JSP的說明操作。

匯入Maven專案

在IntelliJ IDEA中開啟Import對話方塊，方式為
- 如果尚未開啟任何項目，請在歡迎螢幕上選擇導入項目
- 從主菜單中選擇檔案->導入項目
在「導入」對話框中，選擇項目的POM檔案。
繼續使用下列對話方塊中顯示的預設設定。
按一下Next和Finish繼續進行以下對話框。
您現在已設定使用IntelliJ IDEA進行AEM開發

使用IntelliJ IDEA除錯JSP

使用IntelliJ IDEA除錯JSP時，必須執行下列步驟

在專案中設定Web Facet
安裝JSR45支援外掛程式
設定除錯設定檔
設定AEM的除錯模式

IntelliJ IDEA需要瞭解在何處尋找JSP以進行除錯。由於IDEA無法解譯content-package-maven-plugin設定，因此需要手動設定。

轉到檔案->項目結構
選擇Content模組
按一下模組清單上方的+ ，然後選擇Web
作為Web資源目錄，選擇項目的content/src/main/content/jcr_root subdirectory，如下面螢幕抓圖所示。

chlimage_1-48

安裝JSR45支援插件

前往IntelliJ IDEA設定的Plugins窗格
導覽至JSR45 Integration Plugin並選取其旁的核取方塊
按一下Apply
當要求重新啟動IntelliJ IDEA時，請

chlimage_1-49

配置調試配置檔案

轉至運行->編輯配置
按一下+並選擇JSR45 Remote
在配置對話框中，選擇應用程式伺服器旁邊的配置，並配置通用伺服器
如果您想在開始除錯時開啟瀏覽器，請將開始頁面設為適當的URL
刪除所有在啟動任務之前（如果您使用vlt autosync），或在不使用vlt autosync時配置適當的Maven任務
在啟動／連接窗格上，根據需要調整埠
複製IntelliJ IDEA所建議的命令行參數

chlimage_1-50 chlimage_1-51

設定AEM進行除錯模式

最後一個必要步驟是使用IntelliJ IDEA建議的JVM選項來啟動AEM。

您可以直接啟動AEM jar檔案並新增這些選項，例如使用下列命令列：

java -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y -Xmx1024m -XX:MaxPermSize=256M -jar cq-quickstart-5.6.1.jar

您也可以將這些選項新增至crx-quickstart/bin/start的開始指令碼，如下所示。

# ...

# default JVM options
if [ -z "$CQ_JVM_OPTS" ]; then
 CQ_JVM_OPTS='-server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true'
fi

CQ_JVM_OPTS="$CQ_JVM_OPTS -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y"

# ...