Eclipse 適用的 AEM 開發人員工具

上次更新: 2023-12-05

Eclipse標誌的Experience Manager開發人員工具

概觀

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

它提供數項功能,讓AEM開發更容易:

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

要求

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

注意

在macOS上,您需要按一下右鍵 Eclipse.app,然後選取 顯示封裝內容 以尋找您的 eclipse.ini.

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

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

  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檔案。

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

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

Eclipse中的AEM視角

多模組專案範例

Eclipse適用的Experience Manager開發人員工具 隨附範例、多模組專案,可協助您快速上手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/apps/etc 內容
    • PROJECT.ui.content/content 已編寫的內容
    • PROJECT.core 適用於Java™的套裝(當您想要新增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. 在內容功能表中,選取 Maven > 更新專案.
  4. 檢查 強制更新快照/版本.
  5. 按一下​「確定」

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

詳細資訊

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

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

本頁內容