Eclipse 適用的 AEM 開發人員工具

Experience ManagerEclipse標誌開發人員工具

概觀

Experience ManagerEclipse開發人員工具 是以 適用於Apache Sling的Eclipse外掛程式 依Apache授權2發行。

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

  • 透過Eclipse Server Connector與AEM執行個體緊密整合
  • 內容和OSGi套件組合的同步
  • 具有程式碼熱交換功能的除錯支援
  • 透過特定專案建立精靈輕鬆BootstrapAEM專案
  • 輕鬆編輯JCR屬性

要求

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

注意

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

如何安裝AEM Developer Tools for Eclipse

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

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

  2. 複製 安裝連結.

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

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

  4. 按一下 安裝新軟體.

  5. 按一下 添加…….

  6. 名稱 欄位,輸入 AEM Developer Tools.

  7. 位置 欄位,複製安裝URL。

  8. 按一下​「新增」

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

  10. 按一下​下一步

  11. 安裝詳細資訊 按一下 下一個

  12. 接受許可協定,然後按一下 完成.

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

AEM透視

在Eclipse中,透視可決定視窗中可用的動作和檢視,並啟用以任務為導向的與Eclipse中的資源互動。 如需「透視」的詳細資訊,請參閱 Eclipse檔案。

Experience ManagerEclipse開發工具 提供AEM透視,讓您能夠完全控制AEM專案和例項。 要開啟AEM透視:

  1. 從Eclipse菜單欄中,選擇 視窗 -> 透視 -> 開放透視 -> 其他.
  2. 選擇 AEM 在對話方塊中,然後按一下 開啟.

Eclipse中的AEM透視

多模組專案範例

Experience ManagerEclipse開發人員工具 隨附範例多模組專案,可協助您快速上手,完成Eclipse中的專案設定。 此外,也是數種AEM功能的最佳實務指南。 深入了解專案原型.

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

  1. 檔案 > 新增 > 專案 菜單,瀏覽到 AEM 區段,然後選取 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
    

    連線至AEM伺服器

  7. 按一下 完成. 項目結構隨即建立。

    注意

    在全新安裝中(更具體地說,當從未下載過maven相依性時),您可能會收到建立有錯誤的專案。 在此情況下,請依照 解決無效的項目定義.

如何匯入現有專案

您可以使用 新增專案 為您建立正確結構的功能:

  1. 依照指示建立 多模組專案範例 您為自己建立了以下項目,從而可以健康地分離關注點:

    • PROJECT.ui.apps for /apps/etc 內容
    • PROJECT.ui.content for /content
    • PROJECT.core (當您想要新增Java™程式碼時,這些會變得有趣)
    • PROJECT.it.launcherPROJECT.it.tests 整合測試
  2. 取代 PROJECT.ui.apps 專案 appsetc 包的資料夾:

    1. 在「項目資源管理器」面板中,展開 PROJECT.ui.apps > src > main > content > jcr_root > apps.
    2. 以滑鼠右鍵按一下 apps 資料夾和選擇 顯示於 > 系統資源管理器.
    3. 刪除 appsetc 您現在應該看到的資料夾,並放置在此處 appsetc 內容包的資料夾。
    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.appsPROJECT.ui.content 選擇 執行方式 -> Maven安裝.

您現在已建立目標資料夾,且內含您的套件(例如 PROJECT.ui.apps-0.0.1-SNAPSHOT.zip)。

疑難排解

解決無效的項目定義

要解析無效的依賴項,項目定義將按以下步驟進行:

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

Eclipse下載所需的相依性。 這可能需要一些時間。

詳細資訊

適用於Eclipse網站的官方Apache Sling IDE工具可提供您實用的資訊:

以下官員 Eclipse 說明檔案可協助您設定環境:

本頁內容