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

CAUTION
AEM 6.4已結束延伸支援,本檔案不再更新。 如需詳細資訊,請參閱 技術支援期. 尋找支援的版本 此處.

概觀 overview

AEM Developer Tools for Eclipse是以 適用於Apache Sling的Eclipse外掛程式 依Apache授權2發行。

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

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

要求 requirements

使用AEM開發人員工具之前,您需要:

NOTE
在macOS上,您需要以滑鼠右鍵按一下 Eclipse.app 然後選取 顯示包內容 以便找到 eclipse.ini.

如何安裝AEM Developer Tools for Eclipse how-to-install-the-aem-developer-tools-for-eclipse

完成 需求 如上所述,您可以依照下列方式安裝外掛程式:

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

  2. 複製 安裝連結.

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

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

  4. 按一下 安裝新軟體.

  5. 按一下 添加…….

  6. 名稱 輸入AEM開發人員工具。

  7. 位置 複製安裝URL。

  8. 按一下 確定.

  9. 檢查兩者 AEMSling 外掛程式。

  10. 按一下​ 下一步

  11. 按一下​ 下一步

  12. 接受這些協定,然後按一下 完成.

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

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

AEM透視 the-aem-perspective

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

chlimage_1-2

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

AEM Developer Tools for Eclipse隨附範例多模組專案,可協助您快速上手設定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工件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. 按一下右鍵。 在功能表中 馬文 選取 更新專案.
  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
2315f3f5-cb4a-4530-9999-30c8319c520e