如何使用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設定專案,如How-To Build AEM Projects using Apache Maven中所述。

若要開始在IntelliJ IDEA中使用AEM專案,5分鐘後快速入門中的基本設定已足夠。

準備IntelliJ IDEA的JSP支援

IntelliJ IDEA也可提供使用JSP的支援,例如

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

為了讓此功能發揮作用,請按照How-To With JSPs中的說明,使用Apache Maven建立AEM專案。

導入Maven項目

  1. 開啟IntelliJ IDEA中的​Import​對話框,方法為

    • 如果您尚未開啟任何專案,請在歡迎畫面上選取​匯入專案
    • 從主菜單中選擇​檔案 — >導入項目
  2. 在「匯入」對話方塊中,選取專案的POM檔案。

    chlimage_1-45

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

    chlimage_1-46

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

  5. 您現在已透過IntelliJ IDEA設定為AEM開發

    chlimage_1-47

使用IntelliJ IDEA調試JSP

使用IntelliJ IDEA調試JSP時需要執行以下步驟

  • 在專案中設定Web面向
  • 安裝JSR45支援外掛程式
  • 設定除錯設定檔
  • 設定AEM以進行除錯模式

在項目中設定Web面

IntelliJ IDEA需要了解在何處查找用於調試的JSP。 由於IDEA無法解譯content-package-maven-plugin設定,因此需要手動配置。

  1. 轉至​檔案 — >項目結構
  2. 選擇​Content​模組
  3. 按一下模組清單上方的​+​並選擇​Web
  4. 作為Web資源目錄,選擇項目的content/src/main/content/jcr_root subdirectory,如下面螢幕快照所示。

chlimage_1-48

安裝JSR45支援插件

  1. 轉到IntelliJ IDEA設定中的​插件​窗格
  2. 導覽至​JSR45 Integration Plugin ,並選取其旁的核取方塊
  3. 按一下​Apply
  4. 請求重新啟動IntelliJ IDEA

chlimage_1-49

配置調試配置檔案

  1. 轉至​Run -> Edit Configurations
  2. 點擊​+​並選擇​JSR45 Remote
  3. 在配置對話框中,選擇​應用程式伺服器​旁邊的​配置​並配置通用伺服器
  4. 如果您想在開始偵錯時開啟瀏覽器,請將啟動頁面設為適當的URL
  5. 如果使用vlt autosync,請刪除所有​啟動前​任務;如果不使用vlt autosync,請配置適當的Maven任務
  6. 在​啟動/連接​窗格上,根據需要調整埠
  7. 複製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"

# ...

啟動調試

現在,您都已設定為在AEM中調試JSP。

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

chlimage_1-52

使用IntelliJ IDEA調試套件組合

可以使用標準通用遠程調試連接調試套件中的代碼。 您可以依照Jetbrain檔案進行遠端除錯

本頁內容