Show Menu
主題×

使用CRXDE Lite進行開發

本節說明如何使用CRXDE Lite開發AEM應用程式。
請參閱概述檔案,以取得有關不同開發環境的詳細資訊。
CRXDE Lite已內嵌在AEM中,可讓您在瀏覽器中執行標準開發工作。 使用CRXDE Lite,您可以建立專案、建立和編輯檔案(例如。jsp和。java)、檔案夾、範本、元件、對話方塊、節點、屬性和組合,同時記錄和整合SVN。 當您無法直接存取AEM伺服器、透過擴充或修改現成可用的元件和Java套件來開發應用程式時,或當您不需要專用的除錯程式、程式碼完成和語法反白顯示時,建議使用CRXDE Lite。
依預設,所有AEM使用者都可存取CRXDE Lite。 如果需要, 請為以下節點配置ACL ,以便只有開發人員可以訪問CRX DE Lite:
/libs/granite/crxde

CRXDE Lite快速入門

要開始使用CRXDE Lite,請按如下步驟進行:
  1. 安裝AEM。
  2. 在瀏覽器中輸入 https://<host>:<port>/crx/de 。 預設為 https://localhost:4502/crx/de
  3. 輸入您的 使用者名 和密碼 。 預設為 admin admin
  4. 按一下 確定
CRXDE Lite使用者介面在您的瀏覽器中的外觀如下:
您現在可以使用CRXDE Lite來開發您的應用程式。

使用者介面概觀

CRXDE Lite提供下列功能:
頂端切換器列 可讓您快速切換CRXDE Lite、Package Manager和Package Share。
節點路徑Widget
顯示當前選定節點的路徑。
您也可以使用它跳至節點,方法是手動輸入路徑,或從其他位置貼上路徑,然後按Enter鍵。
它還支援查找具有特定節點名的節點。 輸入您要尋找的節點名稱,然後等待(或點擊右側的搜尋符號)。 您可以嘗試輸入,例如,將字串橡 ,進入介面工具集,以瞭解其運作方式。 如果某個給定節點或節點已載入到瀏覽器窗格中,則會顯示清單,您可以選擇路徑並按一下Enter以導航到該路徑。 請注意,它僅適用於當前在瀏覽器中載入到CRXDE客戶端應用程式中的節點。 如果要搜索整個儲存庫,請依次使用工具和查詢。
瀏覽器窗格
顯示儲存庫中所有節點的樹。
按一下節點,在「屬性」頁籤中顯示其 屬性 。 按一下節點後,可以在工具欄中選擇操作。 再次按一下該節點以將其更名。
樹狀導航濾鏡(雙目表徵圖):使您可以過濾名稱包含輸入文本的儲存庫中的節點。 它僅適用於已在本地載入的節點。
編輯窗格
「首頁 」頁籤:可讓您搜尋內容和/或檔案,並存取開發人員資源(檔案、開發人員部落格、知識庫)和支援(Adobe首頁和支援中心)。
連按兩下「檔案總管」窗格中 的檔案 ,以顯示其內容;例如,.jsp或。java檔案。 然後,您可以修改它並儲存變更。
在「編輯」窗格中編輯檔 案後 ,工具列上會提供下列工具:
-在 樹中顯示:顯 示儲存庫樹中的檔案。 -搜 尋/取代…… :進行搜尋或取代。 雙 擊「編輯」窗格的狀態行可開啟「 轉到行」對話框,以便輸入要轉到的特定行號。
「屬性」頁籤 顯示所選節點的屬性。 您可以新增屬性或刪除現有屬性。
「訪問控制」頁籤
根據當前路徑、儲存庫級別或承擔者顯示權限。
權限被劃分為
-適 用的訪問控制策略 :可套用至目前選擇的原則。
-本 地訪問控制策略 :當前策略在本地應用於當前選擇。
-有 效的訪問控制策略 :當前為當前選擇應用的策略可以設定為本地或繼承自父節點。
注意. 要能夠查看訪問控制資訊,登錄到CRXDE Lite的用戶必須具有讀取ACL項的權限。 匿名使用者依預設看不到此資訊——請以管理員等身分登入,以檢視資訊。
複製頁籤
顯示當前節點的複製狀態。 您可以複製和複製刪除當前節點。
控制台頁籤
伺服器日誌 :
顯示日誌消息。 您可以設定記錄檔層級、清除控制台、釘選選取的捲動位置,並啟用/停用訊息顯示。
版本控制 :
顯示版本控制消息。
「構建資訊」頁籤 顯示建立搭售時的資訊。
重新整理 刷新當前選擇。 其他用戶的更改將在儲存庫的視圖中更新。 您所做的變更不會受到影響。
儲存全部
儲存全部 :
儲存您所做的所有變更。 在按一下「保存」之前,更改是臨時的,當您退出控制台時將丟失。
回復 :
放棄自上次保存操作以來您在選定節點上所做的所有更改,然後重新載入選定節點的儲存庫的當前狀態。
全部回復 :
放棄自上次保存操作後在整個儲存庫中所做的所有更改,然後重新載入儲存庫的當前狀態。
建立 ...
下拉式功能表,在選取的節點下建立下列項目:
-節 :具有任意節點類型的節點
-文 :nt:檔案節點及其nt:資源子節點
-文 件夾 :nt:資料夾節點
-范 :AEM範本
-元 :AEM元件
-對 話框 :AEM對話方塊
刪除 刪除選定節點。
複製 複製選定節點。
貼上 將複製的節點貼上到選定節點下。
移動 ... 將選定節點移動到通過對話框設定的節點。
重新命名 ... 更名選定節點。
Mixin ... 允許您將混合類型添加到節點類型。 混合類型主要用於新增進階功能,例如版本控制、存取控制、參照和鎖定至節點。
團隊
下拉式功能表,以執行標準版本控制工作:
-從SVN服 務器更新儲存庫
-提 交對 SVN伺服器的本地更改
-查看當 前節點 的狀態
-查看當 前節點子樹 的遞歸狀態
-從 SVN伺服器 簽出工作副本
-從 SVN伺服器 (不建立工作副本)導出項目
-將項 目從儲存庫 導入到SVN伺服器
請注意,您必須以具有足夠權限的用戶身份登錄,才能執行某些任務(尤其是寫入本地儲存庫的任務)。
工具
下拉式選單,包含下列工具:
-服 務器配置…… :去Felix Console。
-查 詢…… :來查詢儲存庫。
-權 限…… :以開啟權限管理,您可在其中檢視和新增權限。
-測 試訪問控制…… :您可以在其中測試特定路徑和/或承擔者權限的位置。
-導 出節點類型 :將系統中的節點類型導出為cnd注釋。
-導 入節點類型…… :來導入節點類型。
-安 裝SiteCatalyst除錯程式…… :說明如何安裝Analytics除錯程式。
登入介面工具集
顯示當前登入的使用者及其登入的工作區,例如admin@crx.default。
按一下它以登入或重新登入為特定使用者。 如果您未指定要登入的工作區,則會登入預設工作區crx.default。
如果要以匿名用戶的身份瀏覽儲存庫,請使用 anonymous 作為登錄名和任何密碼(如空格或點)。
如果您的授權不再有效(例如,已過期),登入介面工具集會顯示「未授 權——登入…… 」。 按一下它以重新登入。

建立專案

有了CRXDE Lite,您只需按三下,就可以建立正常的專案。 專案精靈會在下方建立新專案, /apps 在t下方建立部 /conten 分內容,並在下方建立封裝所有專案的套件 /etc/packages 。 該項目可立即用於根據jsp指令碼(從儲存庫轉換屬性並調用Java類來轉換某些文本)來呈現顯示 Hello World ​的示例頁。
要使用CRXDE Lite建立項目:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導覽」窗格中,以滑鼠右鍵按一下節點,選 取「建立…… 」,然 後選取「建立專案……」 . 注意:您可以按一下右鍵樹導航中的任意節點,因為新項目節點按設計建立在以下和 /apps, /content /etc/packages
  3. 定義:
    • 項目名稱 -項目名稱用於建立新節點和包,如 myproject
    • Java Package - Java套件名稱首碼,例如 com.mycompany
  4. 按一下 建立
  5. 按一 下「全部儲存 」,將變更儲存在伺服器上。
若要存取顯示「Hello World」的 範例頁面 ,請將您的瀏覽器指向:
https://localhost:4502/content/<project-name>.html
Hello World 」頁基於內容節點,該節點通過屬性調用jsp腳 sling:resourceType 本。 指令碼從儲存庫 jcr:title 中讀取屬性,並通過調用項目包中可用的SampleUtil類的方法來獲取主體內容。
將建立以下節點:
  • /apps/<project-name> :應用程式容器。
  • /apps/<project-name>/components :包含用於呈現頁面的範例html.jsp檔案的元件容器。
  • /apps/<project-name>/src :包容器中,包含範例專案包。
  • /apps/<project-name>/install :已編譯的包容器,包含已編譯的示例項目包。
  • /content/<project-name> :內容容器。
  • /etc/packages/<java-suffix>/<project-name>.zip,封裝所有專案應用程式和內容的套件。 您可以使用它重建項目以進一步部署(例如,到其他環境),或通過包共用進行共用。
在CRXDE Lite中,此結構的外觀如下,其中包含名為 myproject 的項目和名為 mycompany的java包尾碼 :

建立資料夾

要使用CRXDE Lite建立資料夾:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導覽」窗格中,以滑鼠右鍵按一下您要建立新資料夾的資料夾,選取「建立……」 ,然 後選取「建立資料夾……」 .
  3. 輸入資料夾 名稱 ,然後按一下 確定
  4. 按一 下「全部儲存 」,將變更儲存在伺服器上。

Creating a Template

要使用CRXDE Lite建立模板,請:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導覽」窗格中,以滑鼠右鍵按一下您要建立範本的檔案夾,選取「建立……」 ,然 後選取「建立範本……」 .
  3. 輸入 Label 、Label Description 、Type Resource Ranking of the Label、Description、Oracle Type Ranking Of the Ranking Of the Label。 按一 下「下一步 」。
  4. 此步驟為可選步驟:設定允 許路徑 。 按「下一 步」
  5. 此步驟為可選步驟:設定「 允許父項 」。 按一 下「下一步 」。
  6. 此步驟為可選步驟:設定「允 許的子項 」。 按一下 確定
  7. 按一 下「全部儲存 」,將變更儲存在伺服器上。
它建立:
  • 具有模板屬性的類 cq:Template 型節點
  • 具有頁面內容屬性的 cq:PageContent 子節點類型
您可以將屬性新增至範本:請參閱「 建立屬性 」部分。

建立元件

此處所述的功能僅在安裝了CQ5(即在儲存庫中可用的節點類 cq:Component 型)時可用。
要使用CRXDE Lite建立元件:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導覽」窗格中,以滑鼠右鍵按一下您要建立元件的檔案夾,選取「建立……」 ,然 後選取「建立元件……」 .
  3. 輸入Label 、Title Description Super Type Type和Super Group Of the Label、Title、Description 和Super Type Group Of the Label。 按一 下「下一步 」。
  4. 此步驟為可選步驟:設定元件屬性 是容器、無裝飾 、單元 格名稱 ​和對 話路徑 。 按一 下「下一步 」。
  5. 此步驟為可選步驟:設定元件屬性「允 許父項」 。 按一 下「下一步 」。
  6. 此步驟為可選步驟:設定元件屬 性Allowed Children 。 按一下 確定
  7. 按一 下「全部儲存 」,將變更儲存在伺服器上。
它建立:
  • 類型節點 cq:Component
  • 元件屬性
  • 元件。jsp指令碼

建立對話框

要使用CRXDE Lite建立對話框:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導覽」窗格中,以滑鼠右鍵按一下您要建立對話方塊的元件,選取「建立……」 ,然 後選取「建立對話方塊……」 .
  3. 輸入「 標籤 」和「 標題」 。 按一下 確定
  4. 按一 下「 ​全部儲存」,將變更儲存在伺服器上。
它會建立具有下列結構的對話方塊:
dialog[cq:Dialog]/items[cq:Widget]/items[cq:WidgetCollection]/tab1[cq:Panel]
您現在可以修改屬性或建立新節點,以依您的需求調整對話方塊。
也可以使用對話框編輯器編輯對話框。 按兩下CRXDE Lite中的對話框節點將開啟編輯器。 有關對話框編輯器的詳細資訊,請 到此處

建立節點

要使用CRXDE Lite建立節點,請:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導航」窗格中,按一下右鍵要建立新節點的節點,選擇「建立……」 ,然後 選擇「建立節點……」 .
  3. 輸入「 名稱 」和「 類型」 。 按一下 確定
  4. 按一 下「全部儲存 」,將變更儲存在伺服器上。
您現在可以修改屬性或建立新節點,以因應您的需求來調整節點。
大多數編輯操作(包括「建立節點」)都保留記憶體中的所有更改,並且僅在保存時(通過「全部保存」按鈕)將其儲存到儲存庫中。 但是,移動等某些操作會自動保留。
在保存更改時,JCR儲存庫還會首先執行有關新建立的節點是否允許父節點的節點類型的驗證。 如果您在儲存節點時收到錯誤訊息,請檢查內容結構是否有效(例如,您無法將節 nt:unstructured 點建立為節點的子 nt:folder 系)。

建立屬性

要使用CRXDE Lite建立屬性:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導航」窗格中,選擇要添加新屬性的節點。
  3. 在底部窗 格的 「屬性」頁籤中,輸入「名稱」、「類型」和「值」(Value ) 。 按一下​ 「新增」
  4. 按一 下「全部儲存 」,將變更儲存在伺服器上。

建立指令碼

要建立新指令碼:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導覽」窗格中,以滑鼠右鍵按一下您要建立指令碼的元件,選取「建立……」 ,然 後選取「建立檔案……」 .
  3. 輸入「檔案 」(包括副檔名)。 按一下 確定
  4. 新檔案會在「編輯」窗格中以標籤的形式開啟。
  5. 編輯檔案。
  6. Click Save All to save the changes.

管理套件

有了CRXDE Lite,建立OSGI套件、新增Java類別並建立它就變得簡單明瞭。 然後,套裝會自動安裝並啟動在OSGI容器中。
本節說明如何使用顯 Test 示Hello World!的 HelloWorld Java類建立包 裝程式! 在瀏覽器中。

建立包

要使用CRXDE Lite建立Test包:
  1. 在CRXDE Lite中,使用 myapp 專案精靈建立 專案 。 建立的節點包括:
    • /apps/myapp/src
    • /apps/myapp/install
  2. 按一下右鍵將包 /apps/myapp/src 含該包的文 Test 件夾,選擇 建立…… , 然後建立包…… .
  3. 按如下方式設定包屬性:
    • 符號包名稱: com.mycompany.test.TestBundle
    • 組合包名稱: Test Bundle
    • Bundle說明:
      This is my Test Bundle
      
      
    • 封裝:
      com.mycompany.test
      
      
    按一下 確定
  4. 按一 下「全部儲存 」,將變更儲存在伺服器上。
精靈會建立下列元素:
  • 類型為 com.mycompany.test.TestBundle It的節 nt:folder. 點是捆綁容器節點。
  • 檔案 com.mycompany.test.TestBundle.bnd 。 它用作包的部署描述符,並由一組標頭組成。
  • 資料夾結構:
    • src/main/java/com/mycompany/test . 它將包含包和Java類。
    • src/main/resources . 它將包含捆綁包中使用的資源。
  • Activator.java 案。 It is optional listener class to be notified of bundle start and stop events.
下表列出。bnd檔案的所有屬性、其值和說明:
屬性 值(在建立搭售時) 說明
Export-Package:
*
注意:此值需要調整以反映套件的特異性。
Export-Package標題定義從包中導出的包(包的逗號分隔清單)。 導出的包構成包的公用視圖 。
Import-Package:
*
注意:此值需要調整以反映套件的特異性。
Import-Package標題定義包的導入包(包的逗號分隔清單)
私有包:
*
注意:此值需要調整以反映套件的特異性。
Private-Package標題定義包的專用包(包的逗號分隔清單)。 私人包裹構成內部實施。
Bundle-Name: 測試套件 定義套件的簡短、人類可讀名稱
Bundle-Description: 這是我的測試套件 定義套件的簡短、人類可讀的說明
Bundle-SymbolicName: com.mycompany.test.TestBundle 指定綁定的唯一、不可本地化名稱
Bundle-Version: 1.0.0-快照 指定包的版本
Bundle-Activator: com.mycompany.test.Activator 指定要通知綁定啟動和停止事件的可選監聽程式類的名稱
有關bnd格式的詳細資訊,請參閱CRXDE用 於建立 OSGI束的bnd實用程式。

建立Java類

要在測試包 HelloWorld 中建立Java類:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導覽」窗格中,以滑鼠右鍵按一下包含檔 Activator.java 案的節點( /apps/myapp/src/com.mycompany.test.TestBundle/src/main/java ),然後選 取「建立…… 」, 然後選取「建立檔案……」 .
  3. 命名檔案 HelloWorld.java 。 按一下 確定
  4. 檔案 HelloWorld.java 會在「編輯」窗格中開啟。
  5. 將下列行新增至 HelloWorld.java :
      package com.mycompany.test;
    
      public class HelloWorld {
      public String getString(){
      return "Hello World!";
      }
      }
    
    
  6. 按一 下「全部儲存 」,將變更儲存在伺服器上。

建立搭售

若要建立測試套件:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在「導覽」窗格中,以滑鼠右鍵按一下。bnd檔案,選取「工 具」,然 ​後選取​ 「Bundle」
「生成包」嚮導:
  • 編譯Java類。
  • 建立包含已編譯的Java類和資源的。jar檔案,並將其放入資料夾 myapp/install 中。
  • 在OSGI容器中安裝並啟動套件。
若要查看Test Bundle的效果,請建立使用Java方法HelloWorld.getString()的元件,以及此元件所呈現的資源:
  1. 在下面創 mycomp 建元件 myapp/components
  2. mycomp.jsp 輯代碼並用下列行替換:
      <%@ page import="com.mycompany.test.HelloWorld"%><%
      %><%@ include file="/libs/foundation/global.jsp"%><%
      %><% HelloWorld hello = new HelloWorld();%><%
      %>
      <html>
      <body>
      <b><%= hello.getString() %></b><br>
      </body>
      </html>
    
    
  3. 在下建立類 test_node 型的 nt:unstructured 資源 /content
  4. 對於 test_node ,請建立以下屬性:名稱= sling:resourceType ,類型= String ,值= myapp/components/mycomp
  5. 按一 下「全部儲存 」,將變更儲存在伺服器上。
  6. 在您的瀏覽器中,請求 test_node : https://<hostname>:<port>/content/test_node.html
  7. 顯示一個帶有「Hello World!」 的頁面。 message.

導出和導入節點類型

要導出節點類型定義,請執行以下操作:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 選擇所需的節點。
  3. 依次選擇 工具 、導 出節點類型
  4. 定義(以cnd表示法)將顯示在瀏覽器中。 視需要儲存資訊。
要導入節點類型定義,請執行以下操作:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 選擇 工具 , 然後選擇導入節點類型…… .
  3. 在文本框中輸入定義的CND符號。
  4. 如果 要更新現有定義 ,請勾選「允許更新」。
  5. 按一 下匯入

記錄

使用CRXDE Lite,您可以顯示位於 error.log 檔案系統上的檔案,並 <crx-install-dir>/crx-quickstart/server/logs 使用適當的記錄層級加以篩選。 按如下步驟進行:
  1. 在您的瀏覽器中開啟CRXDE Lite。
  2. 在窗口 底部的 「控制台」頁籤中,在右側的下拉菜單中,選擇「伺服器日 志」
  3. 按一下「 停止 」圖示以顯示訊息。
您可以:
  • 按一下「記錄設定」圖示,以調整Felix Console 中的記錄 參數。
  • 按一下「筆刷」圖示以清 除訊息
  • 按一下「釘選」圖示,將訊息釘選在目 前選取 範圍。
  • 按一下「停止」圖示,以啟用或停用訊息 顯示