Eclipse 適用的 AEM 開發人員工具 aem-developer-tools-for-eclipse
概觀 overview
適用於Eclipse的Experience Manager Developer Tools 是根據在Apache License 2底下發行的Apache Sling🔗適用的Eclipse外掛程式,為Eclipse外掛程式。
它提供數項功能,讓AEM開發更容易:
- 透過Eclipse伺服器聯結器與AEM執行個體緊密整合
- 內容和OSGi套件組合的同步
- 使用程式碼熱交換功能提供除錯支援
- 透過特定專案建立精靈簡單BootstrapAEM專案
- 輕鬆編輯JCR屬性
要求 requirements
使用AEM開發人員工具之前,您需要:
- 下載並安裝適用於Enterprise Java™開發人員的Eclipse IDE。
- 依照Eclipse常見問答集所述,編輯您的
eclipse.ini
設定檔,設定Eclipse安裝,確保您至少有1 GB的棧積記憶體。
eclipse.ini
。如何安裝適用於Eclipse的AEM開發人員工具 how-to-install-the-aem-developer-tools-for-eclipse
當您符合上述需求時,您可以依照下列方式安裝外掛程式:
-
複製 安裝連結。
您也可以下載封存,而不使用安裝連結。 此方法允許離線安裝,但您不會以這種方式收到遺漏自動更新通知。
-
在Eclipse中,開啟 說明 功能表。
-
按一下 安裝新軟體。
-
按一下 新增……。
-
在 名稱 欄位中,輸入
AEM Developer Tools
。 -
在 位置 欄位中,複製安裝URL。
-
按一下 新增。
-
檢查 AEM 和 Sling 外掛程式。
-
按一下「下一步」。
-
在 安裝詳細資料 視窗中,再按一下 下一步。
-
接受授權合約,然後按一下 完成。
-
按一下 立即重新啟動 以重新啟動Eclipse。
AEM觀點 the-aem-perspective
在Eclipse中,「透視」可決定視窗中可用的動作和檢視,並可與Eclipse中的資源進行以工作為導向的互動。 如需透視的詳細資訊,請參閱Eclipse檔案。
Eclipse的Experience Manager開發工具 提供AEM Perspective,讓您完全控制您的AEM專案和執行個體。 若要開啟「AEM透視」:
- 從Eclipse功能表列選取 視窗 > 透視 > 開啟透視 > 其他。
- 在對話方塊中選取 AEM,然後按一下 開啟。
多模組專案範例 sample-multi-module-project
適用於Eclipse的 Experience Manager開發人員工具 隨附範例、多模組專案,可協助您快速上手Eclipse中的專案設定。 它也是幾項AEM功能的最佳實務指南。 進一步瞭解專案原型。
請依照下列步驟建立範例專案:
-
在 檔案 > 新增 > 專案 功能表中,瀏覽至 AEM 區段並選取 AEM範例多模組專案。
-
按一下「下一步」。
note note NOTE 此步驟可能需要一些時間,因為m2eclipse必須掃描原型目錄。 -
從功能表選擇
com.adobe.granite.archetypes : sample-project-archetype : <highest-number>
,然後按一下 下一步。 -
為範例專案提供下列欄位:
- 名稱
- 群組識別碼
- 成品ID
- appId — 您可能需要展開 進階 選項才能設定此值。
- appTitle — 您可能需要展開 進階 選項以設定此值。
- 封裝 — 您可能需要展開 進階 選項以設定此值。
-
按一下「下一步」。
-
然後,您可以設定Eclipse連線的AEM伺服器。
若要使用偵錯工具功能,您必須在偵錯模式下啟動AEM — 這可以透過將下列專案新增到命令列來實現:
code language-text -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
-
按一下 完成。 專案結構隨即建立。
note note NOTE 在全新安裝中(更具體地說,當從未下載maven相依性時),您可能會收到建立專案時出現的錯誤。 在此情況下,請依照解決無效的專案定義中說明的程式進行。
如何匯入現有的專案 how-to-import-existing-projects
您可以使用 新專案 功能來建立正確的結構:
-
請依照指示建立範例多模組專案,您已為您建立下列專案,這些專案允許健康地分離問題:
/apps
和/etc
內容的PROJECT.ui.apps
- 已編寫之
/content
的PROJECT.ui.content
- 適用於Java™套件組合的
PROJECT.core
(當您想要新增Java™程式碼時,這些套件組合會變得有趣起來) - 整合測試的
PROJECT.it.launcher
和PROJECT.it.tests
-
將
PROJECT.ui.apps
專案的內容取代為您的封裝的apps
和etc
資料夾:- 在「專案總管」面板中,展開
PROJECT.ui.apps
>src
>main
>content
>jcr_root
>apps
。 - 在
apps
資料夾上按一下滑鼠右鍵,然後選擇 顯示於 > 系統總管。 - 刪除您現在應該看到的
apps
和etc
資料夾,並將內容封裝的apps
和etc
資料夾放置在這裡。 - 在Eclipse中,以滑鼠右鍵按一下
PROJECT.ui.apps
專案,然後選擇 重新整理。
- 在「專案總管」面板中,展開
-
然後對
PROJECT.ui.content
執行相同操作,並將其內容資料夾取代為您其中一個封裝:- 在「專案總管」面板中,展開
PROJECT.ui.content
>src
>main
>content
>jcr_root
>content
。 - 用滑鼠右鍵按一下較深的內容資料夾,然後選擇 顯示於 > 系統總管。
- 刪除您現在應該看到的內容資料夾,並在此處放置內容封裝的內容資料夾。
- 在Eclipse中,以滑鼠右鍵按一下
PROJECT.ui.content
專案,然後選擇 重新整理。
- 在「專案總管」面板中,展開
-
現在您必須更新這兩個專案的
filter.xml
個檔案,以對應至您內容封裝的內容。 為此,請在個別的文字/程式碼編輯器中開啟內容封裝的META-INF/vault/filter.xml
檔案。- 以下範例說明您的
filter.xml
檔案外觀:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/apps/foo"/> <filter root="/apps/foundation/components/bar"/> <filter root="/etc/designs/foo"/> <filter root="/content/foo"/> <filter root="/content/dam/foo"/> <filter root="/content/usergenerated/content/foo"/> </workspaceFilter>
- 以下範例說明您的
-
至於您分割為兩個專案的套件內容,您也必須將這些篩選規則分割為兩個並相應地更新兩個專案的
filter.xml
檔案。-
在Eclipse中,開啟
PROJECT.ui.apps/src/main/content/META-INF/filter.xml
。 -
將
<workspaceFilter>
元素的內容取代為您以/apps
和/etc
開頭的封裝規則-
例如:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/apps/foo"/> <filter root="/apps/foundation/components/bar"/> <filter root="/etc/designs/foo"/> </workspaceFilter>
-
-
然後開啟
PROJECT.ui.content/src/main/content/META-INF/filter.xml
。 -
將規則取代為您以
/content
開頭的套件規則。-
例如:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/content/foo"/> <filter root="/content/dam/foo"/> <filter root="/content/usergenerated/content/foo"/> </workspaceFilter>
-
-
-
請務必儲存所有變更。 您現在可以將新內容同步至您的AEM執行個體。
-
在「伺服器」面板中,確定您的連線已啟動,若未啟動,則確定已啟動連線。
-
按一下「清理和Publish」圖示。
完成後,您應該在執行個體上執行套件,並在儲存時,任何變更都會自動同步到執行個體。
如果您想要從專案重新建置套件,請在PROJECT.ui.apps
或PROJECT.ui.content
上按一下滑鼠右鍵,然後選擇 執行身分 > Maven安裝。
您現在已建立目標資料夾,內含套件(例如PROJECT.ui.apps-0.0.1-SNAPSHOT.zip
)。
疑難排解 troubleshooting
解析無效的專案定義 resolving-invalid-project-definition
若要解決無效的相依性和專案定義,請依照下列步驟進行:
- 選取所有已建立的專案。
- 按一下滑鼠右鍵。
- 在內容功能表中,選取 Maven > 更新專案。
- 檢查 強制更新快照/版本。
- 按一下 「確定」。
Eclipse會下載必要的相依性。 這可能需要一段時間。
詳細資訊 more-information
Eclipse網站的官方Apache Sling IDE工具提供您實用資訊:
- 適用於Eclipse **的** Apache Sling IDE工具使用手冊,此檔案會引導您瞭解AEM開發工具支援的整體概念、伺服器整合和部署功能。
- 疑難排解區段。
- 已知問題清單。
下列正式Eclipse檔案可協助您設定環境: