AEM Developer Tools for Eclipse

概覽

AEM Developer Tools for Eclipse是以Apache License 2.0底下發行的適用於Apache Sling🔗的 Eclipse外掛程式為基礎的Eclipse外掛程式。

它提供數種可讓AEM開發更輕鬆的功能：

  • 透過Eclipse Server Connector與AEM執行個體緊密整合。
  • 內容和OSGI套件組合的同步。
  • 使用程式碼熱切換功能進行除錯支援。
  • 透過特定專案建立精靈簡單引導AEM專案。
  • 輕鬆編輯JCR屬性。

需求

使用AEM開發人員工具之前，您需要：

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

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

  • 按照Eclipse FAQ中所述編輯您的eclipse.ini配置檔案，以確保您至少擁有1 GB的堆記憶體。

注意

在macOS上，需要按一下右鍵​Eclipse.app，然後選擇​顯示包內容​以查找​eclipse.ini。

如何安裝AEM Developer Tools for Eclipse

完成上述要求後，您就可以依照下列方式安裝外掛程式：

  1. 瀏覽​AEM​開發人員工具網站。

  2. 複製​安裝連結。

    請注意，您也可以下載封存檔，而不是使用安裝連結。 這允許離線安裝，但您會以這種方式遺漏自動更新通知。

  3. 在Eclipse中，開啟​Help​功能表。

  4. 按一下「安裝新軟體」。

  5. 按一下​添加……。

  6. 在​Name​中，鍵入AEM Developer Tools。

  7. 在​Location​中複製安裝URL。

  8. 按一下​確定。

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

  10. 按一下​下一步。

  11. 按一下​下一步。

  12. 接受這些協定，然後按一下​Finish。

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

如何導入現有項目

注意

請參閱從AEM下載套件組合時如何在Eclipse中使用套件組合。

AEM透視

Eclipse適用的AEM開發工具隨附透視，可讓您完全控制AEM專案和例項。

chlimage_1-2

多模組項目示例

AEM Developer Tools for Eclipse隨附範例多模組專案，可協助您快速上手設定Eclipse中的專案，並提供數種AEM功能的最佳實務指南。 深入了解專案原型。

請依照下列步驟建立範例專案：

  1. 在​File > New > Project​菜單中，瀏覽到​AEM​部分並選擇​AEM Sample Multi-Module Project。

    chlimage_1-69

  2. 按一下​下一步。

    注意

    此步驟可能需要一些時間，因為m2eclipse需要掃描原型目錄。

    chlimage_1-70

  3. 選擇​com.adobe.granite.archetypes :sample-project-archetype :（最高數），然後按一下​下一步。

    chlimage_1-71

  4. 填入範例專案的​名稱、群組id​和​工件id。 您也可以選擇設定一些進階屬性。

    chlimage_1-72

  5. 接著，您應設定Eclipse要連線的AEM伺服器。

    若要使用除錯程式功能，您必須以除錯模式啟動AEM — 這可以透過將下列項目新增至命令列來達成：

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

    chlimage_1-73

  6. 按一下​完成。 項目結構隨即建立。

    注意

    在全新安裝上(具體說明：從未下載maven相依性時)，您可能會獲得建立的專案並發生錯誤。 在這種情況下，請按照解決無效項目定義中描述的過程操作。

疑難排解

解決無效的項目定義

要解析無效的依賴項，項目定義將按以下步驟進行：

  1. 選取所有已建立的專案。
  2. 按一下右鍵。 在菜單​Maven​中，選擇​更新項目。
  3. 檢查​強制更新快照/版本。
  4. 按一下​「確定」。Eclipse會嘗試下載所需的相依性。

在JSP檔案中啟用標籤庫自動完成

在專案中新增了適當的相依性時，標籤程式庫自動完成功能會立即運作。 使用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新增正確版本。

更多資訊

適用於Eclipse網站的官方Apache Sling IDE工具可提供您實用的資訊：

  • 本檔案提供Eclipse 使用手冊🔗的Apache Sling IDE工具，引導您了解AEM開發工具支援的整體概念、伺服器整合和部署功能。
  • 疑難排解區段。
  • 已知問題清單。

下列官方的Eclipse檔案可協助您設定環境：

本頁內容