永續升級 sustainable-upgrades

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

管理員

Customization Framework customization-framework

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

自訂架構功能的設計目的，是為了協助減少程式碼（如API）或內容（如覆蓋圖）不可擴充區域中不利於升級時的違規。

自訂架構有兩個元件： API表面 和 內容分類。

API表面 api-surface

在舊版Adobe Experience Manager (AEM)中，許多API是透過Uber Jar公開。其中部分API並非打算供客戶使用，而是公開支援跨套件組合的AEM功能。日後，Java™ API會標示為「公用」或「私用」，以向客戶指出哪些API可在升級環境中安全使用。其他細節包括：

標示為Public的Java™ API可供自訂實作套件組合使用和參考。
公用API會回溯相容性套件的安裝。
相容性套件包含相容性Uber JAR，以確保回溯相容性
標示為Private的Java™ API僅供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 中的內容可能會變更，導致覆蓋功能以非預期的方式中斷。客戶也可以透過sling:resourceSuperType的繼承擴充AEM元件，或直接透過sling：resourceType參考 /libs 中的元件。在參考和覆寫使用案例時可能會發生類似的升級問題。

為了讓客戶更安全輕鬆地瞭解 /libs 的哪些區域可安全使用和覆蓋，/libs 中的內容已使用下列mixin進行分類：

公用(granite：PublicArea) — 將節點定義為公用，以便可以重疊、繼承(sling:resourceSuperType)或直接使用(sling:resourceType)。標示為Public的/libs底下的節點可以安全升級，並加入相容性套件。一般而言，客戶應僅使用標示為「公用」的節點。
抽象(granite：AbstractArea) — 將節點定義為抽象。節點可以覆蓋或繼承( sling:resourceSupertype)，但不能直接使用( sling:resourceType)。
最終(granite：FinalArea) — 將節點定義為最終。最好是分類為最終節點的節點不應覆蓋或繼承。可透過sling:resourceType直接使用最終節點。依預設，最終節點下的子節點會視為內部。
內部(granite：InternalArea) *- *將節點定義為內部。最好是分類為內部的節點不應重疊、繼承或直接使用。這些節點僅適用於AEM的內部功能
沒有附註 — 節點會根據樹狀結構階層繼承分類。 /根預設為「公用」。 父項分類為Internal或Final的節點也會被視為內部。