如何使用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專案

  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 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，如下面螢幕抓圖所示。

chlimage_1-48

安裝JSR45支援插件

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

chlimage_1-49

配置調試配置檔案

  1. 轉至​運行->編輯配置
  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說明檔案進行遠端除錯。

本頁內容