Eclipse 適用的 AEM 開發人員工具 aem-developer-tools-for-eclipse

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

概觀 overview

適用於Eclipse的Experience Manager Developer Tools ​是根據在Apache License 2底下發行的Apache Sling🔗適用的Eclipse外掛程式,為Eclipse外掛程式。

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

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

要求 requirements

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

  • 下載並安裝適用於Enterprise Java™開發人員的Eclipse IDE
  • 依照Eclipse常見問答集所述,編輯您的eclipse.ini設定檔,設定Eclipse安裝,確保您至少有1 GB的棧積記憶體。
NOTE
在macOS上,您必須用滑鼠右鍵按一下​ Eclipse.app,然後選取​ 顯示封裝內容 ​以尋找您的​eclipse.ini

如何安裝適用於Eclipse的AEM開發人員工具 how-to-install-the-aem-developer-tools-for-eclipse

當您符合上述需求時,您可以依照下列方式安裝外掛程式:

  1. 開啟AEM Developer Tools網站

  2. 複製​ 安裝連結

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

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

  4. 按一下​ 安裝新軟體

  5. 按一下​ 新增……

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

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

  8. 按一下​ 新增

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

  10. 按一下「下一步」。

  11. 在​ 安裝詳細資料 ​視窗中,再按一下​ 下一步

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

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

AEM觀點 the-aem-perspective

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

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

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

Eclipse中的AEM觀點

多模組專案範例 sample-multi-module-project

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

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

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

    AEM範例多模組專案

  2. 按一下「下一步」。

    note note
    NOTE
    此步驟可能需要一些時間,因為m2eclipse必須掃描原型目錄。
  3. 從功能表選擇com.adobe.granite.archetypes : sample-project-archetype : <highest-number>,然後按一下​ 下一步

    選取原型版本

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

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

    定義原型屬性

  5. 按一下「下一步」。

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

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

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

    連線到AEM伺服器

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

    note note
    NOTE
    在全新安裝中(更具體地說,當從未下載maven相依性時),您可能會收到建立專案時出現的錯誤。 在此情況下,請依照解決無效的專案定義中說明的程式進行。

如何匯入現有的專案 how-to-import-existing-projects

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

  1. 請依照指示建立範例多模組專案,您已為您建立下列專案,這些專案允許健康地分離問題:

    • /apps/etc內容的PROJECT.ui.apps
    • 已編寫之/contentPROJECT.ui.content
    • 適用於Java™套件組合的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檔案外觀:
    code language-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開頭的封裝規則

      • 例如:

        code language-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"/>
        </workspaceFilter>
        
    3. 然後開啟PROJECT.ui.content/src/main/content/META-INF/filter.xml

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

      • 例如:

        code language-xml
        <?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. 按一下「清理和Publish」圖示。

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

如果您想要從專案重新建置套件,請在PROJECT.ui.appsPROJECT.ui.content上按一下滑鼠右鍵,然後選擇​ 執行身分 > Maven安裝

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

疑難排解 troubleshooting

解析無效的專案定義 resolving-invalid-project-definition

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

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

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

詳細資訊 more-information

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

下列正式Eclipse檔案可協助您設定環境:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab