Eclipse 適用的 AEM 開發人員工具

概觀

Eclipse適用的Experience Manager開發人員工具 是一個以擴充功能為基礎的Eclipse外掛程式， Apache Sling的Eclipse外掛程式 以Apache授權2發行。

它提供數項功能，讓AEM開發更容易：

• 透過Eclipse伺服器聯結器與AEM執行個體緊密整合
• 內容和OSGi套件組合的同步
• 使用程式碼熱交換功能提供除錯支援
• 透過特定專案建立精靈簡單BootstrapAEM專案
• 輕鬆編輯JCR屬性

要求

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

• 下載並安裝 適用於企業Java™開發人員的Eclipse IDE.
• 設定eclipse安裝，透過編輯您的檔案，確保您至少有1 GB的棧積記憶體 eclipse.ini 組態檔，如 Eclipse常見問題集.

如何安裝適用於Eclipse的AEM開發人員工具

當您已完成 需求 如上所示，您可以安裝外掛程式：

1. 開啟 AEM開發人員工具網站.

2. 複製 安裝連結.

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

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

4. 按一下 安裝新軟體.

5. 按一下 新增…….

6. 在 名稱 欄位，輸入 AEM Developer Tools.

7. 在 位置 欄位，複製安裝URL。

8. 按一下 新增.

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

10. 按一下​下一步。

11. 在 安裝詳細資料 視窗，按一下 下一個 再來一次。

12. 接受授權合約，然後按一下 完成.

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

AEM觀點

在Eclipse中，「透視」可決定視窗中可用的動作和檢視，並可與Eclipse中的資源進行以工作為導向的互動。 如需有關「透視」的詳細資訊，請參閱 Eclipse檔案。

Eclipse的Experience Manager開發工具 提供AEM觀點，讓您可完全控制AEM專案和執行個體。 若要開啟「AEM透視」：

1. 從Eclipse功能表列中，選取 視窗 -> 透視 -> 開啟透視 -> 其他.
2. 選取 AEM 在對話方塊中，然後按一下 開啟.

多模組專案範例

此 Eclipse適用的Experience Manager開發人員工具 隨附範例、多模組專案，可協助您快速上手Eclipse中的專案設定。 它也是幾項AEM功能的最佳實務指南。 進一步瞭解專案原型.

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

1. 在 檔案 > 新增 > 專案 功能表，瀏覽至 AEM 區段並選取 AEM範例多模組專案.

   

2. 按一下​下一步。

   注意

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

3. 選擇 com.adobe.granite.archetypes : sample-project-archetype : <highest-number> 在功能表中，然後按一下 下一個.

   

4. 為範例專案提供下列欄位：

   • 名稱
   • 群組ID
   • 成品ID
   • appId — 您可能需要展開 進階 選項以設定此值。
   • appTitle — 您可能需要展開 進階 選項以設定此值。
   • 封裝 — 您可能需要展開 進階 選項以設定此值。

   

5. 按一下​下一步。

6. 然後，您可以設定Eclipse連線的AEM伺服器。

   若要使用偵錯工具功能，您必須在偵錯模式下啟動AEM — 這可以透過將下列專案新增到命令列來實現：

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

   

7. 按一下 完成. 專案結構隨即建立。

   注意

   在全新安裝中（更具體地說，當從未下載maven相依性時），您可能會收到建立專案時出現的錯誤。 在這種情況下，請遵循中所述的程式 解析無效的專案定義.

如何匯入現有的專案

您可以使用 新增專案 特徵來為您建立正確的結構：

1. 依照指示建立 多模組專案範例 而且您已為您建立下列專案，這些專案可讓您健康地分離疑慮：

   • PROJECT.ui.apps 的 /apps 和 /etc 內容
   • PROJECT.ui.content 的 /content 已編寫的內容
   • PROJECT.core 適用於Java™的套裝(當您想要新增Java™程式碼時，這些套裝就會變得有趣起來)
   • PROJECT.it.launcher 和 PROJECT.it.tests 用於整合測試

2. 取代的內容 PROJECT.ui.apps 專案與 apps 和 etc 封裝的資料夾：

   1. 在「專案總管」面板中，展開 PROJECT.ui.apps > src > main > content > jcr_root > apps.
   2. 以右鍵按一下 apps 資料夾並選擇 顯示位置 > 系統總管.
   3. 刪除 apps 和 etc 您現在應該看到的資料夾，並放置在這裡 apps 和 etc 內容封裝的資料夾。
   4. 在Eclipse中，以滑鼠右鍵按一下 PROJECT.ui.apps 專案並選擇 重新整理.

3. 然後對 PROJECT.ui.content 並將其內容資料夾取代為您的其中一個套件：

   1. 在「專案總管」面板中，展開 PROJECT.ui.content > src > main > content > jcr_root > content.
   2. 以滑鼠右鍵按一下較深入的內容資料夾，然後選擇 顯示位置 -> 系統總管.
   3. 刪除您現在應該看到的內容資料夾，並在此處放置內容封裝的內容資料夾。
   4. 在Eclipse中，以滑鼠右鍵按一下 PROJECT.ui.content 專案並選擇 重新整理.

4. 現在您必須更新 filter.xml 這兩個專案的檔案，以對應至內容封裝的內容。 為此，請開啟 META-INF/vault/filter.xml 在個別文字/程式碼編輯器中的內容套件檔案。

   • 以下範例說明 filter.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>
   

5. 至於已分割成兩個專案的套件內容，您也必須將這些篩選規則分割成兩個並相應地更新 filter.xml 兩個專案的檔案。

   1. 在Eclipse中，開啟 PROJECT.ui.apps/src/main/content/META-INF/filter.xml.

   2. 取代 <workspaceFilter> 元素的開頭為您的套件規則 /apps 和 /etc

      • 例如：

        <?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>
        

   3. 然後開啟 PROJECT.ui.content/src/main/content/META-INF/filter.xml.

   4. 將規則取代為您的套件中以開頭的規則 /content.

      • 例如：

        <?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>
        

6. 請務必儲存所有變更。 您現在可以將新內容同步至您的AEM執行個體。

7. 在「伺服器」面板中，確定您的連線已啟動，若未啟動，則確定已啟動連線。

8. 按一下 清理並發佈 圖示。

完成後，您應該在執行個體上執行套件，並在儲存時，任何變更都會自動同步到執行個體。

如果您想要從專案重新建置套件，請在 PROJECT.ui.apps 或 PROJECT.ui.content 並選擇 執行身分 -> Maven安裝.

您現在已建立目標資料夾，並在其中加入您的套件(例如，稱為 PROJECT.ui.apps-0.0.1-SNAPSHOT.zip)。

疑難排解

解析無效的專案定義

若要解決無效的相依性和專案定義，請依照下列步驟進行：

1. 選取所有已建立的專案。
2. 按一下滑鼠右鍵。
3. 在內容功能表中，選取 Maven -> 更新專案.
4. 檢查 強制更新快照/版本.
5. 按一下​「確定」。

Eclipse會下載必要的相依性。 這可能需要一段時間。

詳細資訊

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

• 此 適用於Eclipse的Apache Sling IDE工具 使用手冊，本檔案會引導您瞭解AEM開發工具支援的整體概念、伺服器整合和部署功能。
• 此 疑難排解章節.
• 此 已知問題清單.

下列官方 Eclipse 說明檔案有助於設定您的環境：

• Eclipse快速入門
• Eclipse Luna說明系統
• Maven整合(m2eclipse)

Business.Adobe.com 資源