Eclipse 適用的 AEM 開發人員工具 aem-developer-tools-for-eclipse
概觀 overview
AEM Developer Tools for Eclipse是以 適用於Apache Sling的Eclipse外掛程式 依Apache授權2發行。
它提供數種可讓AEM開發更輕鬆的功能:
- 透過Eclipse Server Connector與AEM執行個體緊密整合。
- 內容和OSGI套件組合的同步。
- 使用程式碼熱切換功能進行除錯支援。
- 透過特定專案建立精靈簡單引導AEM專案。
- 輕鬆編輯JCR屬性。
要求 requirements
使用AEM開發人員工具之前,您需要:
-
下載並安裝 適用於Java EE開發人員的Eclipse IDE. AEM開發人員工具目前支援Eclipse Kepler或更新版本
-
可與AEM 5.6.1版或更新版本搭配使用
-
通過編輯您的
eclipse.ini
組態檔,如 Eclipse常見問題集.
eclipse.ini
.如何安裝AEM Developer Tools for Eclipse how-to-install-the-aem-developer-tools-for-eclipse
完成 需求 如上所述,您可以依照下列方式安裝外掛程式:
-
瀏覽 AEM 開發人員工具網站.
-
複製 安裝連結.
請注意,您也可以下載封存檔,而不是使用安裝連結。 這允許離線安裝,但您會以這種方式遺漏自動更新通知。
-
在Eclipse中,開啟 說明 功能表。
-
按一下 安裝新軟體.
-
按一下 添加…….
-
在 名稱 輸入AEM開發人員工具。
-
在 位置 複製安裝URL。
-
按一下 確定.
-
檢查兩者 AEM 和 Sling 外掛程式。
-
按一下 下一步。
-
按一下 下一步。
-
接受這些協定,然後按一下 完成.
-
按一下 是 以重新啟動Eclipse。
如何匯入現有專案 how-to-import-existing-projects
AEM透視 the-aem-perspective
Eclipse適用的AEM開發工具隨附透視,可讓您完全控制AEM專案和例項。
多模組專案範例 sample-multi-module-project
AEM Developer Tools for Eclipse隨附範例多模組專案,可協助您快速上手設定Eclipse中的專案,並提供數種AEM功能的最佳實務指南。 深入了解專案原型.
請依照下列步驟建立範例專案:
-
在 檔案 > 新增 > 專案 菜單,瀏覽到 AEM 區段,然後選取 AEM範例多模組專案.
-
按一下 下一步。
note note NOTE 此步驟可能需要一些時間,因為m2eclipse需要掃描原型目錄。 -
選擇 com.adobe.granite.archetypes :sample-project-archetype :(最高數) 按一下功能表中的 下一個.
-
填入 名稱, 群組ID 和 工件ID ,以取得範例專案。 您也可以選擇設定一些進階屬性。
-
接著,您應設定Eclipse要連線的AEM伺服器。
若要使用除錯程式功能,您必須以除錯模式啟動AEM — 這可以透過將下列項目新增至命令列來達成:
code language-none -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
-
按一下 完成. 項目結構隨即建立。
note note NOTE 在全新安裝上(具體說明:從未下載maven相依性時),您可能會獲得建立的專案並發生錯誤。 在此情況下,請依照 解決無效的項目定義.
疑難排解 troubleshooting
解決無效的項目定義 resolving-invalid-project-definition
要解析無效的依賴項,項目定義將按以下步驟進行:
- 選取所有已建立的專案。
- 按一下右鍵。 在功能表中 馬文 選取 更新專案.
- 檢查 強制更新快照/版本.
- 按一下 「確定」。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的Apache Sling IDE工具 使用手冊,本檔案將引導您完成AEM開發工具支援的整體概念、伺服器整合和部署功能。
- 此 疑難排解區段.
- 此 已知問題清單.
以下官員 Eclipse 說明檔案可協助您設定環境: