如何使用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說明檔案進行遠端除錯

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now