EclipseAEM的開發人員工具

概覽

The AEM Developer Tools for Eclipse是Eclipse外掛程式，以Apache License 2下發行的Eclipse plugin for Apache Sling為基礎。

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

  • 透過Eclipse Server Connector與AEM例項緊密整合。
  • 內容與OSGI組合的同步化。
  • 使用程式碼熱切換功能來除錯支援。
  • 透過特定專案建AEM立精靈，輕鬆引導專案。
  • 輕鬆編輯JCR屬性。

要求

在使用「開AEM發人員工具」之前，您必須：

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

  • 可與5.AEM6.1版或更新版本一起使用

  • 按照Eclipse常見問答集中所述，編輯您的eclipse.ini設定檔，以設定您的Eclipse安裝以確保您至少擁有1GB的堆積記憶體。

注意

在macOS上，您必須在​Eclipse.app​上按一下滑鼠右鍵，然後選取​顯示封裝內容，才能找到您的​eclipse.ini。

如何安AEM裝Eclipse的Developer Tools

完成上述要求後，您可以按如下方式安裝插件：

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

  2. 複製​安裝連結。

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

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

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

  5. 按一下​添加……。

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

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

  8. 按一下​確定。

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

  10. 按一下​下一步。

  11. 按一下​下一步。

  12. 接受這些線上合約，然後按一下「完成」。

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

如何導入現有項目

注意

請參閱如何從下載Eclipse中的搭售AEM套件時使用。

透視AEM

EclipseAEM的開發工具提供透視功能，讓您完全掌控專案AEM和執行個體。

chlimage_1-2

多模組項目示例

Developer AEM Tools for Eclipse隨附範例、多模組專案，可協助您快速上手使用Eclipse中的專案設定，並提供多項功能的最佳實務指AEM南。 進一步瞭解Project Archetype。

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

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

    chlimage_1-69

  2. 按一下​下一步。

    注意

    這個步驟可能需要一段時間，因為m2eclipse需要掃描原型型錄。

    chlimage_1-70

  3. 選擇​com.adobe.granite.archetypes:樣本——項目——原型：（最高數），然後按一下​Next。

    chlimage_1-71

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

    chlimage_1-72

  5. 然後，您應設定EclipseAEM將連線至的伺服器。

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

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

    chlimage_1-73

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

    注意

    在全新安裝中(更具體而言：從未下載過依賴項時)，您可能會建立出錯誤的項目。 在這種情況下，請遵循解決無效項目定義中描述的過程。

疑難排解

解決無效的項目定義

要解決無效的從屬關係和項目定義，請按如下步驟進行：

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

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

標籤庫自動完成功能不會立即生效，因為專案中已新增適當的相依性。 使用Uber Jar時有一個已知問題AEM，它不包括所需的tld和TagExtraInfo檔案。

若要解決這個問題，請確定org.apache.sling.scripting.jsp.taglib工件位於AEMUber 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文檔可幫助設定環境：

本頁內容