用AEM於Eclipse的開發人員工具

概覽

Developer AEM Tools for Eclipse是基於 Apache Sling的Eclipse插件 已在Apache許可證2下發佈。

它提供了幾種使開發更AEM容易的功能:

  • 通過Eclipse Server Connector與AEM實例無縫整合
  • 內容和OSGi捆綁包的同步
  • 具有代碼熱交換功能的調試支援
  • 通過特定項AEM目建立嚮導簡單引導項目
  • 易於編輯JCR屬性

要求

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

注意

在macOS上,您需要右鍵 Eclipse.app ,然後選擇 顯示包內容 以便找到 eclipse.ini

如何安裝EclipseAEM開發人員工具

一旦你完成了 要求 在上面,可以按如下方式安裝插件:

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

  2. 複製 安裝連結

    請注意,您也可以下載存檔檔案,而不是使用安裝連結。 這允許離線安裝,但您會以這種方式錯過自動更新通知。

  3. 在Eclipse中,開啟 幫助 的子菜單。

  4. 按一下 安裝新軟體

  5. 按一下 添加……

  6. 名稱 輸入 AEM Developer Tools

  7. 位置 複製安裝URL。

  8. 按一下​「新增」

  9. 同時檢查 AEM吊帶 插件。

  10. 按一下​下一步

  11. 安裝詳細資訊 窗口,按一下 下一個 的雙曲餘切值。

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

  13. 按一下 立即重新啟動 來重新啟動Eclipse。

透AEM視

在Eclipse中,透視可確定窗口中可用的操作和視圖,並啟用面向任務的與Eclipse中資源的交互。 有關透視的詳細資訊,請參閱 Eclipse文檔。

Development AEM Tools for Eclipse提供了AEM一個透視,讓您能夠完全控制AEM項目和實例。 要開啟透AEM視:

  1. 從Eclipse菜單欄中選擇 窗口 -> 透視 -> 開放透視 -> 其他
  2. 選擇 AEM 中,按一下 開啟

《日蝕AEM》的透視

示例多模組項目

Developer AEM Tools for Eclipse附帶了一個示例、多模組項目,它幫助您快速完成Eclipse中的項目設定,並作為幾項功能的最佳實踐指AEM南。 瞭解有關項目原型的詳細資訊

按照以下步驟建立示例項目:

  1. 檔案 > 新建 > 項目 菜單,瀏覽至 AEM 選擇 多模AEM塊項目示例

    多模AEM塊項目示例

  2. 按一下​下一步

    注意

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

  3. 選擇 com.adobe.granite.archetypes : sample-project-archetype : <highest-number> ,然後按一下 下一個

    選擇原型版本

  4. 為示例項目提供以下欄位:

    • 名稱
    • 組ID
    • 項目ID
    • 應用ID — 您可能需要擴展 高級 選項來設定此值。
    • appTitle — 您可能需要擴展 高級 選項來設定此值。
    • — 您可能需要擴展 高級 選項來設定此值。

    定義原型屬性

  5. 按一下​下一步

  6. 然後配置EclipseAEM將連接到的伺服器。

    要使用調試器功能,您需要在調試AEM模式下啟動 — 這可以通過在命令行中添加以下內容來實現:

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

    連接到服AEM務器

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

    注意

    在新安裝(更具體地說,當從未下載過多個依賴項時),您可能會建立項目並出現錯誤。 在這種情況下,請按照中描述的過程操作 解析無效的項目定義

如何導入現有項目

您可以使用 新建項目 建立正確結構的特徵:

  1. 按照說明建立 示例多模組項目 您將為您建立以下項目,這將允許將關注事項進行健康分離:

    • PROJECT.ui.apps/apps/etc 內容
    • PROJECT.ui.content/content 創作
    • PROJECT.core 對於Java捆綁包(一旦要添加Java代碼,這些將會變得有趣)
    • PROJECT.it.launcherPROJECT.it.tests 用於整合test
  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. 在日蝕中,開啟 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工具正式為您提供了有用的資訊:

以下官員 日蝕 文檔可幫助設定環境:

本頁內容