文件AEM 6.4Developing 指南

AEM Brackets擴充功能 aem-brackets-extension

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 開發人員
CAUTION
AEM 6.4已結束延伸支援，本檔案不再更新。 如需詳細資訊，請參閱 技術支援期. 尋找支援的版本 此處.

概觀 overview

AEM Brackets擴充功能提供順暢的工作流程，可編輯AEM元件和用戶端程式庫，並運用 方括弧 程式碼編輯器，可從程式碼編輯器記憶體取Photoshop檔案和層。 擴充功能提供的輕鬆同步化功能（不需要Maven或File Vault）可提高開發人員的效率，也有助於具備有限AEM知識的前端開發人員參與專案。 此擴充功能也提供 HTML範本語言(HTL)，這消除了JSP的複雜性，使元件開發更輕鬆、更安全。

chlimage_1-53

功能 features

AEM Brackets擴充功能的主要功能為：

  • 將變更的檔案自動同步至AEM開發例項。
  • 手動雙向同步檔案和資料夾。
  • 專案的完整內容套件同步。
  • 運算式和的HTL程式碼完成 data-sly-* 塊語句。

此外，Brackets還隨附許多對AEM字型端開發人員有用的功能：

  • Photoshop檔案支援從PSD檔案中擷取資訊，例如圖層、測量、顏色、字型、文字等。
  • 程式碼會從PSD提示，以便在程式碼中輕鬆重複使用這些擷取的資訊。
  • CSS預處理器支援，如LESS和SCSS。
  • 還有數以百計的額外擴充功能，可涵蓋更具體的需求。

安裝 installation

方括弧 brackets

AEM Brackets擴充功能支援Brackets 1.0版或更新版本。

從下載最新的Brackets版本 brackets.io.

擴充功能 the-extension

若要安裝擴充功能，請依下列步驟執行：

  1. 開啟括弧。 在功能表中 檔案，選取 Extension Manager…

  2. 輸入 AEM 在搜尋列中尋找 AEM Brackets擴充功能.

    chlimage_1-54

  3. 按一下 安裝.

  4. 安裝完成後，關閉對話方塊和Extension Manager。

快速入門 getting-started

內容套件專案 the-content-package-project

安裝擴充功能後，您可以使用Brackets從檔案系統開啟內容套件資料夾，以開始開發AEM元件。

專案必須至少包含：

  1. a jcr_root 資料夾(例如 myproject/jcr_root)

  2. a filter.xml 檔案(例如 myproject/META-INF/vault/filter.xml);以取得 filter.xml 檔案請參閱 工作區篩選器定義.

括弧內 檔案 菜單，選擇 開啟資料夾…… 然後選擇 jcr_root 或父項目資料夾。

NOTE
如果您沒有包含內容套件的專案，可以嘗試 HTL TodoMVC示例. 在GitHub上，按一下 下載ZIP，請在本機擷取檔案，並依照上述指示開啟 jcr_root 方括弧中的。 然後依照下列步驟，設定 專案設定，最後執行 匯出內容套件 如完整內容套件同步區段中進一步指示。
在這些步驟之後，您應該可以存取 /content/todo.html 在AEM開發執行個體上使用URL，您就可以開始對Brackets中的程式碼進行修改，並查看在Web瀏覽器中重新整理後，變更會立即同步至AEM伺服器。

專案設定 project-settings

若要將內容與AEM開發執行個體同步，您必須定義專案設定。 您可以前往 AEM 菜單和選擇 項目設定……

chlimage_1-55

「專案設定」可定義：

  1. 伺服器URL(例如 http://localhost:4502)
  2. 是否允許沒有有效HTTPS證書的伺服器（請取消選中，除非需要）
  3. 用於同步內容的使用者名稱(例如 admin)
  4. 使用者的密碼(例如 admin)

同步內容 synchronizing-content

AEM Brackets擴充功能針對下列定義的篩選規則所允許的檔案和資料夾，提供下列類型的內容同步： filter.xml:

自動同步已更改的檔案 automated-synchronization-of-changed-files

這只會將Brackets的變更同步至AEM例項，但絕不會以相反的方式同步。

手動雙向同步 manual-bidirectional-synchronization

在「專案總管」中，以滑鼠右鍵按一下任何檔案或資料夾，開啟內容功能表，並 導出到伺服器 或 從伺服器導入 可存取選項。

chlimage_1-56

NOTE
如果所選條目位於 jcr_root 資料夾， 導出到伺服器 和 從伺服器導入 內容功能表項目會停用。

完整內容包同步 full-content-package-synchronization

在 AEM , 匯出內容套件 或 匯入內容套件 選項可將整個項目與伺服器同步。

chlimage_1-57

同步狀態 synchronization-status

AEM Brackets Extension在Brackets視窗右側的工具列中顯示通知圖示，指出上次同步的狀態：

  • 綠色 — 已成功同步所有檔案
  • 藍色 — 正在執行同步操作
  • 黃色 — 某些檔案未同步
  • 紅色 — 未同步任何檔案

按一下通知表徵圖將開啟「同步狀態」報告對話框，其中列出每個已同步檔案的所有狀態。

chlimage_1-58

NOTE
僅限篩選規則所標示為包含的內容 filter.xml 會同步，無論使用的同步方法為何。
此外， .vltignore 支援將內容排除在與存放庫同步或與存放庫同步之外。

編輯HTL程式碼 editing-htl-code

AEM Brackets擴充功能也提供一些自動完成功能，以方便編寫HTL屬性和運算式。

屬性自動完成 attribute-auto-completion

  1. 在HTML屬性中，輸入 sly. 屬性自動完成為 data-sly-.
  2. 在下拉式清單中選取HTL屬性。

運算式自動完成 expression-auto-completion

運算式內 ${}，通用變數名稱會自動完成。

更多資訊 more-information

AEM Brackets擴充功能是開放原始碼專案，由 Adobe Marketing Cloud 組織，在Apache授權規範2.0版下：

Brackets程式碼編輯器也是開放原始碼專案，由 Adobe Systems Incorporated 組織：

歡迎貢獻內容！

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e