永續升級 sustainable-upgrades

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

主題：
Upgrading

建立對象：

Developer

CAUTION

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

定制框架 customization-framework

架構（功能/基礎架構/內容/應用程式） architecture-functional-infrastructure-content-application

自訂架構功能的設計目的，是協助減少升級不方便的程式碼（例如API）或內容（例如覆蓋）中不可擴充區域的違規情形。

自訂架構有兩個元件：the API Surface 和 內容分類.

API Surface api-surface

在舊版AEM中，許多API是透過Uber Jar公開。其中有些API並非打算供客戶使用，但是會接觸到不同套件的支援AEM功能。日後，Java API將標示為「公用」或「私人」，以向客戶指出哪些API在升級時可安全使用。其他具體內容包括：

標示為的Java API Public 可供自訂實作套件使用和參考。
公用API可回溯相容於相容性套件的安裝。
相容性套件將包含相容性Uber JAR，以確保回溯相容性
標示為的Java API Private 僅供AEM內部套件組合使用，不應供自訂套件組合使用。

NOTE

概念 Private 和 Public 在這方面，不應將Java概念與公共和私有類混淆。

image2018-2-12_23-52-48

內容分類 content-classifications

AEM長期以來都採用覆蓋和Sling Resource Merger的原則，讓客戶可擴充及自訂AEM功能。為AEM主控台和UI提供支援的預先定義功能會儲存在 /libs. 客戶絕不可修改下面的任何內容 /libs 但可以在 /apps 覆蓋並擴充中定義的功能 /libs （如需詳細資訊，請參閱使用覆蓋開發）。這仍會在將AEM升級為 /libs 可能會變更，導致覆蓋圖函式以非預期的方式中斷。客戶也可以透過繼承來擴充AEM元件 sling:resourceSuperType，或僅參考 /libs 直接透過sling:resourceType。參考和覆寫使用案例可能會發生類似的升級問題。

為了讓客戶更安全、更輕鬆地了解 /libs 可安全地使用和覆蓋 /libs 已與下列混合項目分類：

公用(granite:PublicArea) — 將節點定義為公用節點，以便其可重疊、繼承( sling:resourceSuperType)或直接使用( sling:resourceType)。標示為「公用」的/lib下的節點將可安全升級，並添加相容性包。一般客戶應僅運用標示為「公用」的節點。
摘要(granite:AbstractArea) — 將節點定義為抽象。節點可以重疊或繼承( sling:resourceSupertype)，但不得直接使用( sling:resourceType)。
最終(granite:FinalArea) — 將節點定義為最終節點。分類為最終節點無法重疊或繼承。最終節點可直接透過 sling:resourceType. 預設情況下，最終節點下的子節點視為內部節點
內部(Granite:InternalArea) — 將節點定義為內部。分類為內部的節點無法直接覆蓋、繼承或使用。這些節點的用途僅止於AEM的內部功能
無注釋 — 節點會根據樹狀結構繼承分類。 /根預設為公用。 父節點分類為「內部」或「最終」，節點也視為「內部」。