軟體包允許導入和導出儲存庫內容。 例如,您可以使用包來安裝新功能、在實例之間傳輸內容以及備份儲存庫內容。
可從下列頁面存取和/或維護套件:
您可以在包管理器、包共用和檔案系統之間傳輸包。
套件是郵遞區號檔案,以檔案系統序列化(稱為「保管庫」序列化)的形式儲存存放庫內容。 這提供了檔案和資料夾的易於使用和編輯的表示法。
套件包含使用篩選條件選取的頁面內容和專案相關內容。
包中還包含保管庫元資訊,包括篩選器定義和導入配置資訊。 套件中可包含其他內容屬性(不用於套件擷取),例如說明、視覺影像或圖示;這些屬性僅供內容套件使用者使用,僅供參考之用。
套件代表建置套件時的內容目前版本。 其中不包含AEM保留在存放庫中的任何舊版內容。
您可以對套件或搭配套件執行下列動作:
包定義由各種類型的資訊組成:
您可以編輯各種包設定來定義包說明、相關錯誤、依賴項和提供程式資訊等方面。
當建立或編輯包時,包設定對話框可通過編輯按鈕使用,並提供三個頁簽用於配置。 進行任何變更後,按一下「確定」以儲存這些變更。
欄位 | 說明 |
---|---|
名稱 | 包的名稱。 |
群組 | 要添加包的組的名稱,用於組織包。 鍵入新組的名稱,或選擇現有組。 |
版本 | 用於自訂版本的文字。 |
說明 | 套件的簡短說明。 HTML標籤可用於格式化。 |
縮圖 | 隨包清單一起顯示的表徵圖。 按一下「瀏覽」以選取本機檔案。 |
欄位 | 說明 | 格式/範例 |
---|---|---|
名稱 | 提供程式的名稱。 | AEMGeometrixx |
URL | 提供程式的URL。 | https://www.aem-geometrixx.com |
連結 | 提供程式頁面的包特定連結。 | https://www.aem-geometrixx.com/mypackage.html |
需要 |
|
|
AC 處理 | 指定導入包時如何處理包中定義的訪問控制資訊:
預設值為Ignore。 |
|
欄位 | 說明 | 格式/範例 |
---|---|---|
已測試 | 此套件的目標產品名稱和版本為或相容。 | AEM6 |
修正錯誤/問題 | 一個文本欄位,用於列出此包修正的錯誤的詳細資訊。 請在另一行列出每個錯誤。 | bug-nr摘要 |
取決於 | 列出當需要其他包時需要遵守的依賴項資訊,以便當前包按預期運行。 使用Hotfix時,此欄位很重要。 | groupId:name:version |
取代 | 此包替換的已棄用包的清單。 安裝之前,請檢查此套件是否包含過時套件中的所有必要內容,以免覆寫任何內容。 | groupId:name:version |
篩選器可識別要包含在套件中的存放庫節點。 篩選器定義指定以下資訊:
篩選器可以包含零個或多個規則。 未定義規則時,套件會包含根路徑下方的所有內容。
您可以為套件定義一或多個篩選器定義。 使用多個篩選器來包含來自多個根路徑的內容。
下表說明這些規則並提供範例:
規則類型 | 說明 | 範例 |
---|---|---|
加入 | 您可以定義路徑,或使用規則運算式來指定要包含的所有節點。 包含目錄將:
|
/libs/sling/install(/)*)? |
排除 | 您可以指定路徑或使用規則運算式來指定要排除的所有節點。 排除目錄將排除該目 錄以及該目錄中的所有檔案和資料夾(即整個子樹)。 |
/libs/wcm/foundation/components(/)*)? |
一個包可以包含多個篩選器定義,因此來自不同位置的節點可以輕鬆地組合為一個包。
在您首次建立包時,最常定義包過濾器,但以後也可以編輯它們(在此之後應重建包)。
您可以將螢幕擷取畫面附加至套件,以視覺化呈現內容外觀;例如,提供新功能的螢幕擷取畫面。
您也可以將圖示附加至套件,以提供套件所含內容的快速參考視覺表示。 然後,這會顯示在包清單中,可幫助您輕鬆識別包或包的類。
由於套件可包含圖示,因此官方套件會使用下列慣例:
若要避免混淆,請為套件使用描述性圖示,而不要使用其中一個官方圖示。
官方Hotfix套件:
官方AEM安裝或擴充功能套件:
官方功能套件:
套件管理器會管理您本機AEM安裝上的套件。 在您獲派了必要的權限後,您就可以使用套件管理器執行各種動作,包括設定、建立、下載和安裝您的套件。 要設定的關鍵元素為:
若要授予使用者建立、修改、上傳和安裝套件的權利,您必須在下列位置為他們提供適當的權限:
有關更改權限的說明,請參閱設定權限。
要建立新包定義,請執行以下操作:
在AEM歡迎螢幕上,按一下封裝(或從工具控制台按兩下封裝)。
然後選擇包管理器。
按一下「建立包」。
如果您的執行個體有許多套件,則可能會有一個資料夾結構,因此您可以在建立新套件之前導覽至所需的目標資料夾。
在對話方塊中:
輸入:
群組名稱
目標組(或資料夾)名稱。 群組的用途是協助您組織套件。
如果組尚未存在,則會為其建立資料夾。 如果將組名留空,則它將在主包清單(首頁>包)中建立包。
封裝名稱
新包的名稱。 選取描述性名稱,以協助您(和其他人)輕鬆識別套件的內容。
版本
用於指示版本的文本欄位。 這會附加至套件名稱,以形成zip檔案的名稱。
按一下OK以建立包。
AEM會在適當的群組資料夾中列出新套件。
按一下圖示或封裝名稱以開啟。
您可以在稍後階段視需要返回此頁面。
按一下編輯以編輯包設定。
您可以在此新增資訊及/或定義特定設定;例如,這些錯誤包括說明、圖示、相關錯誤,以及新增提供者詳細資訊。
完成設定的編輯後,按一下「確定」。
視需要將螢幕擷取畫面新增至套件。 建立套件時有一個例項可用,如有需要,可使用sidekick的套件螢幕擷取新增更多。
按兩下螢幕擷取畫面區域中的影像元件,新增影像,然後按一下確定以新增實際影像。
定義封裝篩選器,方法是將篩選器定義的例項從sidekick拖曳,然後連按兩下以開啟以進行編輯:
指定下列設定:
根
路徑要打包的內容;這可以是子樹的根。
RulesRules為選用;對於簡單的套件定義,不需要指定包含或排除規則。
如有需要,您可以定義Include或Exclude規則以精確定義套件內容。
使用+符號添加規則,或使用-符號刪除規則。 系統會根據規則的順序套用規則,以便使用Up和Down按鈕,視需要放置規則。
然後按一下OK以儲存篩選器。
您可以視需要使用任意數量的篩選器定義,但請務必小心,以確保它們不會衝突。 使用預覽確認包內容。
若要確認封裝會保留什麼,您可以使用預覽。 這會執行建置程式的乾式執行,並列出實際建置套件時要新增到套件的所有項目。
您現在可以建立您的套件。
此時不強制建置套件,可在稍後時間點完成。
程式包通常與建立程式包定義同時構建,但您可以在稍後時間點返回生成或重建程式包。 如果儲存庫內的內容已變更,這個功能會很實用。
在建立套件之前,預覽套件內容會很實用。 要執行此操作,請按一下「預覽」。
從包管理器開啟包定義(按一下包表徵圖或名稱)。
按一下Build。 對話方塊會要求確認您確實要建立套件。
當您重建包時,當包內容將被覆蓋時,這尤其重要。
按一下「確定」。AEM會建立套件,並列出新增至套件的所有內容。 完成AEM後,會顯示已建置套件的確認,並(當您關閉對話方塊時)會更新套件清單資訊。
套件建置完成後,如有需要,可重新包裝。
重新包裝會變更套件資訊 — 而不變更套件內容。包資訊是縮圖、說明等,換言之,您可以使用包設定對話方塊(以開啟此按一下編輯)編輯的所有內容。
重新包裝的主要使用案例是準備套件共用的套件時。 例如,您可能有現有的套件,並決定與其他人共用。 您想要新增縮圖並新增說明。 您不必使用其所有功能重新建立整個包(這可能需要一些時間,並承擔包不再與原始包相同的風險),而是可以重新包裝,只添加縮圖和說明。
從包管理器開啟包定義(按一下包表徵圖或名稱)。
按一下「編輯」,然後視需要更新「封裝設定」。 按一下OK以儲存。
按一下重新包裝,對話方塊會要求確認。
要查看或編輯包定義的資訊,請執行以下操作:
在套件管理器中,導覽至您要檢視的套件。
按一下您要檢視之套件的套件圖示。 這會開啟套件頁面,列出套件定義的相關資訊:
您也可以從此頁面編輯及執行套件上的特定動作。
可用的按鈕將取決於包是否已構建。
如果包已建置,請按一下Contents,將會開啟一個窗口並列出包的整個內容:
建置套件後,您可以檢視內容:
在套件管理器中,導覽至您要檢視的套件。
按一下您要檢視之套件的套件圖示。 這會開啟套件頁面,列出套件定義的相關資訊。
要查看內容,請按一下Contents,將會開啟一個窗口並列出包的整個內容:
要執行安裝的乾式運行,請按一下「測試安裝」。確認動作後,視窗會開啟,並列出結果,就像執行安裝一樣:
本節說明如何使用套件管理器從AEM下載套件至您的檔案系統。
如需從公共區域和您公司內部的套件共用區域下載Hotfix、功能套件和套件的相關資訊,請參閱套件共用。
從包共用,您可以:
從「封裝共用」直接下載封裝至您的本機AEM執行個體。
下載時,軟體包將導入您的儲存庫,然後,您可以使用軟體包管理器立即將其安裝到本地實例。 這些套件包括Hotfix和其他共用套件。
在「AEM歡迎」螢幕上,按一下「包」,然後選擇「包管理器」。
導覽至您要下載的套件。
按一下您要下載的包的zip檔案名稱(帶下划線)形成的連結;例如export-for-offline.zip
。
AEM會將套件下載至您的電腦(使用標準瀏覽器下載對話方塊)。
套件上傳可讓您將套件從檔案系統上傳至AEM套件管理器。
請參閱將套件上傳至公司內部套件共用 ,以將套件上傳至公司的封裝共用私人區域。
上傳套件:
導航到包管理器。 接著,前往您要上傳套件的群組資料夾。
按一下「上傳套件」。
檔案
您可以直接鍵入檔案名,或使用Browse…對話方塊,從您的本機檔案系統選取所需的套件(選取後,按一下「確定」)。
強制上傳
如果已存在具有此名稱的包,您可以按一下此名稱以強制上載(並覆蓋現有包)。
按一下OK ,以便上載新包並將其列在「包管理器」清單中。
若要讓內容可供AEM使用,請務必安裝套件。
安裝套件之前,您可能想驗證其內容。 由於軟體包可以修改/apps
下覆蓋的檔案和/或添加、修改和刪除ACL,因此在安裝前驗證這些更改通常非常有用。
驗證機制可檢查套件的下列特性:
以下詳細說明這些選項。
驗證 OSGi 封裝匯入
已核取的項目
此驗證會檢查所有JAR檔案(OSGi套件組合)的套件,提取其manifest.xml
(其中包含所述OSGi套件組合所依賴的版本化相依性),並驗證AEM執行個體將所述相依性導出為正確版本。
報告方式
AEM執行個體無法滿足的任何版本化相依性會列在套件管理器的活動記錄中。
錯誤狀態
如果不滿足相依性,則包中包含這些相依性的OSGi套件組合將不會啟動。 這會導致應用程式部署中斷,因為任何依賴未啟動的OSGi套件組合的程式,都會無法正常運作。
錯誤解決
要解決由於未滿足要求的OSGi套件組合而導致的錯誤,需要調整套件中具有未滿足要求的導入的依賴項版本。
驗證覆蓋
已核取的項目
此驗證會判斷所安裝的套件是否包含已覆蓋在目標AEM例項中的檔案。
例如,在/apps/sling/servlet/errorhandler/404.jsp
處給定包含/libs/sling/servlet/errorhandler/404.jsp
的包,這樣它就會在/libs/sling/servlet/errorhandler/404.jsp
處更改現有檔案。
報告方式
任何此類覆蓋均在套件管理器的活動記錄中說明。
錯誤狀態
錯誤狀態表示套件嘗試部署已覆蓋的檔案,因此套件中的變更將被覆蓋覆蓋(因此「隱藏」),而不會生效。
錯誤解決
若要解決此問題,/apps
中覆蓋檔案的維護者必須檢閱/libs
中覆蓋檔案的變更,並視需要將變更併入覆蓋(/apps
)中,然後重新部署覆蓋檔案。
請注意,如果覆蓋內容已正確整合至覆蓋檔案,驗證機制便無法調解。 因此,即使進行了必要的變更,此驗證仍會繼續報告衝突。
驗證 ACL
已核取的項目
此驗證會檢查要新增哪些權限、處理方式(合併/取代),以及目前權限是否會受到影響。
報告方式
這些權限在包管理器的活動日誌中描述。
錯誤狀態
無法提供明確錯誤。 驗證只會指出安裝套件是否會新增或影響任何新ACL權限。
錯誤解決
使用驗證提供的資訊,您可以在CRXDE中查看受影響的節點,並視需要在套件中調整ACL。
作為最佳實務,建議軟體包不要影響AEM提供的ACL,因為這可能會導致意外的產品行為。
可透過兩種不同方式驗證套件:
上傳套件後但安裝之前,一律應進行驗證。
透過套件管理器進行套件驗證
在https://<server>:<port>/crx/packmgr
開啟包管理器
在清單中選取套件,然後從標題中選取More下拉式清單,然後從下拉式選單中選取Validate。
這應在上傳內容套件之後,但在安裝套件之前完成。
在隨後出現的強制回應對話方塊中,使用核取方塊來選取驗證的類型,並按一下Validate以開始驗證。 或者,按一下取消。
選取的驗證會/會執行。 結果會顯示在套件管理器的活動記錄中。
透過HTTPPOST要求進行套件驗證
POST請求會採用下清單單。
https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls
type
參數可以是任何以逗號分隔的無序清單,包含:
osgiPackageImports
overlays
acls
若未傳遞,type
值則預設為osgiPackageImports
。
以下是使用cURL執行套件驗證的範例。
如果使用cURL,則執行類似以下的語句:
curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'
請求的驗證會執行,並以JSON物件傳回回應。
驗證HTTPPOST要求的回應將是具有驗證結果的JSON物件。
上傳套件後,您需要安裝內容。 若要安裝套件內容並使其正常運作,必須同時具備下列兩項功能:
安裝套件可能會覆寫或刪除現有內容。 只有在您確定套件不會刪除或覆寫您需要的內容時,才上傳套件。
若要查看套件的內容或影響,您可以:
執行軟體包的測試安裝,而不修改任何內容:
開啟包(按一下包表徵圖或名稱),然後按一下測試安裝。
請參閱套件內容清單:
開啟包,然後按一下Contents。
在安裝軟體包之前,將立即建立一個快照軟體包,以包含將被覆蓋的內容。
如果/當卸載軟體包時,將重新安裝此快照。
如果您要安裝數位資產,您必須:
首先,停用WorkflowLauncher。
使用OSGi控制台的「元件」菜單選項可停用com.day.cq.workflow.launcher.impl.WorkflowLauncherImpl
。
接下來,安裝完成後,重新激活WorkflowLauncher。
停用WorkflowLauncher可確保資產匯入工具架構在安裝時不會(無意中)操控資產。
在套件管理器中,導覽至您要安裝的套件。
安裝按鈕顯示在尚未安裝的軟體包的側面。
或者,您也可以按一下包的表徵圖開啟包,以訪問Install按鈕。
按一下Install以開始安裝。 對話方塊會要求確認,並列出所有正在進行的變更。 完成後,按一下對話方塊上的關閉。
安裝軟體包後,該軟體包旁會出現「Installed」這個字。
您可以透過其他方式將套件上傳並安裝至執行個體。 在檔案系統中,您的jar和license.properties
檔案旁邊有crx-quicksart
資料夾。 您需要在crx-quickstart
下建立名為install
的資料夾。 之後您會有類似的項目:<aem_home>/crx-quickstart/install
在此安裝中,可以直接添加包。 這些檔案會自動上傳並安裝在您的執行個體上。 完成後,您可以在套件管理器中看到套件。
如果執行個體執行中,將套件新增至install
資料夾會直接啟動上傳並在執行個體上安裝。 如果實例未運行,則您放在install
資料夾中的軟體包將按字母順序在啟動時安裝。
您也可以在首次啟動執行個體之前執行此操作。 要執行此操作,您需要手動建立crx-quickstart
資料夾,在其下建立install
資料夾,並將資料夾放在那裡。 然後,當您首次啟動執行個體時,套件會依字母順序安裝。
AEM可讓您解除安裝套件。 此操作會還原受到在軟體包安裝前立即生成的快照影響的儲存庫內容。
安裝時,將建立包含將被覆蓋內容的快照包。
卸載該包時,將重新安裝該包。
要從包管理器清單中刪除包:
軟體包中安裝的檔案/節點為not。
在Tools控制台中,展開Packages資料夾,在右側窗格中顯示您的包。
按一下您要刪除的套件,以反白顯示該套件,然後:
AEM要求確認您要刪除套件。 按一下OK以確認刪除。
如果此軟體包已安裝,則installed內容將not被刪除。
複製套件的內容以將其安裝至發佈執行個體:
在包管理器中,導航到要複製的包。
按一下要複製的包的表徵圖或名稱以展開它。
在工具列的More下拉式選單中,選取Replicate。
Package Share是一個集中的伺服器,可公開用於共用內容包。
已由軟體分發替換。
Software Distribution是新的使用者介面,用來簡化AEM Packages的搜尋和下載。
如需詳細資訊,請參閱Software Distribution檔案。
AEM套件管理器目前無法用於Software Distribution。 您將軟體包下載到本地磁碟。