AEM Brackets延伸功能

概覽

AEM Brackets Extension提供順暢的工作流程來編輯AEM元件和用戶端程式庫，並運用 Brackets程式碼編輯器的強大功能，讓您從程式碼編輯器存取Photoshop檔案和圖層。擴充功能提供的簡易同步化功能（不需Maven或File Vault）可提高開發人員的效率，並協助具備有限AEM知識的前端開發人員參與專案。此擴充功能也提供 HTML範本語言(HTL)支援，這可免除JSP的複雜性，讓元件開發更輕鬆且更安全。

chlimage_1-53

功能

AEM Brackets Extension的主要功能有：

將變更的檔案自動同步至AEM開發例項。
手動雙向同步檔案和資料夾。
項目的完整內容包同步。
運算式和區塊陳述式的HTL data-sly-* 程式碼完成。

此外，Brackets還為AEM字型端開發人員提供許多實用功能：

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

安裝

括弧

AEM Brackets延伸功能支援Brackets 1.0版或更新版本。

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

擴充功能

要安裝擴展，請按如下步驟進行：

開啟Brackets。在菜單檔案，選擇 擴展管理器……
在搜 尋列中輸入 AEM，並尋找 AEM Brackets延伸功能。
按一 下安裝。
安裝完成後，關閉對話框和Extension Manager。

快速入門

內容封裝專案

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

項目至少必須包含：

資料 jcr_root 夾(例如 myproject/jcr_root)
檔 filter.xml 案(例如 myproject/META-INF/vault/filter.xml); 如需檔案結構的詳細資訊，請 filter.xml 參閱工作區篩選定義。

在Brackets的「檔案」菜單中，選擇「開啟資料夾…… 」(Open Folder… .)並選擇 jcr_root 資料夾或父項項目資料夾。

注意

如果您沒有包含內容套件的專案，則可試用 HTL TodoMVC範例。在GitHub上，按一 下「下載ZIP」，在本機解壓縮檔案，並依照上述指示，在Brackets中 jcr_root 開啟檔案夾。然後依照下列步驟設定 Project Settings，最後依照「完整內容套件同步化」區段的進一步指示，執行 Export Content Package ，將整個套件上傳至您的AEM開發執行個體。

在執行這些步驟後，您應該可以存取AEM開發例項上的 /content/todo.html URL，而且您可以開始在Brackets中修改程式碼，並查看在網頁瀏覽器中重新整理後，變更會立即同步到AEM伺服器。

專案設定

若要將內容同步化至AEM開發執行個體，您必須定義您的「專案設定」。若要這麼做，請前往 AEM 功能表並選 擇「專案設定……」

chlimage_1-55

「專案設定」可以定義：

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

同步內容

AEM Brackets Extension為下列類型的檔案和檔案夾提供內容同步化，這些檔案和檔案夾皆可依下列定義的篩選規則進行 filter.xml:

自動同步更改的檔案

這只會同步從Brackets到AEM例項的變更，但絕不會相反。

手動雙向同步

在「項目瀏覽器」中，按一下右鍵任何檔案或資料夾以開啟上下文菜單，並可以訪問「導出到伺服器」或「從伺服器導入」選項。

chlimage_1-56

注意

如果選定條目位於資料夾外， jcr_root 則禁用「 導出到伺服器」( Export to Server )和「從服 務器導入」(Import from Server)上下文菜單條目。

完整內容包同步

在 AEM 功能表中，「匯出內容套件 」或「匯入內容套件 」選項可讓整個專案與伺服器同步。

chlimage_1-57

同步狀態

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

綠色——所有檔案都已成功同步
藍色——正在進行同步操作
黃色——部分檔案未同步
紅色——未同步任何檔案

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

chlimage_1-58

注意

不論使用何種同步方法，都只會同 filter.xml 步被篩選規則標籤為包含的內容。

此外， .vltignore 支援檔案將內容排除在與儲存庫同步和從儲存庫同步時。

編輯HTL程式碼

AEM Brackets延伸功能也包含一些自動完成功能，以簡化HTL屬性和運算式的編寫。

屬性自動完成

在HTML屬性中，鍵入 sly。屬性自動完成 data-sly-。
在下拉式清單中選取HTL屬性。

運算式自動完成

在運算式 ${}中，公用變數名稱會自動完成。