如何使用IntelliJ IDEA開發AEM專案

概覽

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

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

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

安裝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專案

1. 在IntelliJ IDEA中開啟​Import​對話方塊，方式為

   • 如果尚未開啟任何項目，請在歡迎螢幕上選擇​導入項目
   • 從主菜單中選擇​檔案->導入項目

2. 在「導入」對話框中，選擇項目的POM檔案。

   

3. 繼續使用下列對話方塊中顯示的預設設定。

   

4. 按一下​Next​和​Finish​繼續進行以下對話框。

5. 您現在已設定使用IntelliJ IDEA進行AEM開發

   

使用IntelliJ IDEA除錯JSP

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

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

在項目中設定Web Facet

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

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

安裝JSR45支援插件

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

配置調試配置檔案

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

設定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"

# ...

開始調試

您現在都已設定好在AEM中除錯JSP。

1. 選擇​運行->調試->調試配置檔案
2. 在元件程式碼中設定中斷點
3. 在瀏覽器中存取頁面

使用IntelliJ IDEA除錯套件

使用標準的一般遠端除錯連線，可除錯組合中的程式碼。 您可依照Jetbrain說明檔案進行遠端除錯。