Eclipse 適用的 AEM 開發人員工具

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 說明檔案有助於設定您的環境:

本頁內容