Eclipse 適用的 AEM 開發人員工具 aem-developer-tools-for-eclipse

適用於Eclipse之AEM Developer Tools的圓形影像模組。

概觀 overview

「AEM Developer Tools」是以Apache授權2所發行適用於Apache Sling🔗的Eclipse外掛程式為基礎的Eclipse外掛程式。

它提供數項功能,讓AEM開發更容易:

  • 透過Eclipse伺服器聯結器與AEM執行個體緊密整合。
  • 內容和OSGI套件組合的同步。
  • 使用程式碼熱交換功能提供除錯支援。
  • 透過特定專案建立精靈,簡單BootstrapAEM專案。
  • 輕鬆編輯JCR屬性。

要求 requirements

使用AEM開發人員工具之前,請先執行下列動作:

  • 下載並安裝適用於Java™ EE開發人員的Eclipse IDE。 AEM開發人員工具目前支援Eclipse Kepler或更新版本

  • 可搭配AEM 5.6.1或更新版本使用

  • 依照Eclipse常見問答集所述,編輯您的eclipse.ini設定檔,設定Eclipse安裝,確保您至少有1 GB的棧積記憶體。

NOTE
在macOS上按一下滑鼠右鍵​ Eclipse.app,然後選取​ 顯示封裝內容 ​以尋找您的eclipse.ini

如何安裝適用於Eclipse的AEM開發人員工具 how-to-install-the-aem-developer-tools-for-eclipse

當您符合上述需求後,您可以依照下列方式安裝外掛程式:

  1. 瀏覽https://eclipse.adobe.com/aem/dev-tools/的​ AEM Developer Tools ​網站。

  2. 複製​ 安裝連結

    或者,您也可以下載封存,而不使用安裝連結。 這樣做允許離線安裝,但您會遺漏自動更新通知。

  3. 在Eclipse中,開啟​ 說明 ​功能表。

  4. 按一下​ 安裝新軟體

  5. 按一下​ 新增……

  6. 在​ 名稱 ​中,輸入AEM Developer Tools。

  7. 在​ 位置 ​中,複製安裝URL。

  8. 按一下​ 確定

  9. 檢查​ AEM ​和​ Sling ​外掛程式。

  10. 按一下「下一步」。

  11. 按一下「下一步」。

  12. 接受Lincese合約,然後按一下​ 完成

  13. 按一下​ ​重新啟動Eclipse。

如何匯入現有的專案 how-to-import-existing-projects

NOTE
請參閱如何在Eclipse中使用從AEM下載的套件。

AEM觀點 the-aem-perspective

Eclipse適用的AEM開發工具隨附的透視功能可讓您完全控制AEM專案和執行個體。

chlimage_1-2

多模組專案範例 sample-multi-module-project

「AEM開發人員工具」包含範例、多模組專案,可幫助您在Eclipse中快速完成專案設定。 它也是幾項AEM功能的最佳實務指南。 進一步瞭解專案原型

若要建立範例專案,請完成以下步驟:

  1. 在​ 檔案 > 新增 > 專案 ​功能表中,瀏覽至​ AEM ​區段並選取​ AEM範例多模組專案

    chlimage_1-69

  2. 按一下「下一步」。

    note note
    NOTE
    此步驟可能需要一點時間,因為m2eclipse必須掃描原型目錄。

    chlimage_1-70

  3. 從功能表選擇​ com.adobe.granite.archetypes : sample-project-archetype : (最高編號),然後按一下​ 下一步

    chlimage_1-71

  4. 填寫範例專案的​ 名稱群組識別碼 ​和​ 成品ID。 您也可以選擇設定一些進階屬性。

    chlimage_1-72

  5. 現在設定Eclipse可連線的AEM伺服器。

    若要使用偵錯工具功能,請確定您是以偵錯模式啟動AEM,方法是在命令列新增下列內容:

    code language-none
        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
    

    chlimage_1-73

  6. 按一下​ 完成。 專案結構隨即建立。

    note note
    NOTE
    在全新安裝中(更具體地說:從未下載過maven相依性時),您可能會收到建立專案的錯誤。 在此情況下,請依照解決無效的專案定義中說明的程式進行。

疑難排解 troubleshooting

解析無效的專案定義 resolving-invalid-project-definition

若要解決無效的相依性和專案定義,請依照下列步驟進行:

  1. 選取所有已建立的專案。
  2. 按一下滑鼠右鍵。 在功能表​ Maven ​中,選取​ 更新專案
  3. 檢查​ 強制更新快照/版本
  4. 按一下​ 確定。 Eclipse會嘗試下載必要的相依性。

在JSP檔案中啟用標籤庫自動完成 enabling-tag-library-autocompletion-in-jsp-files

只要將適當的相依性新增至專案,標籤程式庫自動完成功能即可立即運作。 使用AEM Uber Jar時,有一個已知問題,其中不包含所需的tld和TagExtraInfo檔案。

若要解決此問題,請確保org.apache.sling.scripting.jsp.taglib成品在AEM Uber Jar之前的類別路徑中。 對於Maven專案,請將以下相依性放在pom.xml中的Uber Jar之前。

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

請務必新增正確版本的AEM部署。

詳細資訊 more-information

Eclipse網站的官方Apache Sling IDE工具提供您實用資訊:

下列正式Eclipse檔案可協助您設定環境:

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2