永續升級 sustainable-upgrades

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可在升級環境中安全使用。 其他細節包括:

  • Java™ API標示為 Public 可供自訂實作套件使用和參考。

  • 公用API會回溯相容性套件的安裝。

  • 相容性套件包含相容性Uber JAR,以確保回溯相容性

  • Java™ API標示為 Private 僅供AEM內部套件組合使用,而非自訂套件組合。

NOTE
的概念 PrivatePublic 在此情況下,不應混淆公用和私有類別的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 已經過分類,包含下列mixin:

  • 公用(granite:PublicArea) — 將節點定義為公開,以便可以覆蓋、繼承( sling:resourceSuperType)或直接使用( sling:resourceType)。 標示為Public的/libs底下的節點可以安全升級,並加入相容性套件。 一般而言,客戶應僅使用標示為「公用」的節點。

  • 摘要(granite:AbstractArea) — 將節點定義為抽象。 節點可以覆蓋或繼承( sling:resourceSupertype)但不直接使用( sling:resourceType)。

  • 最後(granite:FinalArea) — 將節點定義為最終節點。 最好是分類為最終節點的節點不應覆蓋或繼承。 可直接透過以下方式使用最終節點: sling:resourceType. 依預設,最終節點下的子節點會視為內部。

  • 內部(granite:InternalArea) *- *將節點定義為內部。 最好是分類為內部的節點不應重疊、繼承或直接使用。 這些節點僅適用於AEM的內部功能

  • 無註解 — 節點會根據樹狀階層繼承分類。 /根預設為「公用」。 將父項歸類為「內部」或「最終」的節點也將被視為「內部」。

NOTE
這些政策僅針對Sling搜尋路徑型機制強制執行。 的其他領域 /libs 例如使用者端程式庫可能會標籤為 Internal,但仍可與標準clientlib包含搭配使用。 在這些情況下,客戶必須繼續遵守內部分類。

CRXDE Lite內容型別指標 crxde-lite-content-type-indicators

CRXDE Lite中套用的Mixin會顯示標示為的內容節點和樹狀結構 INTERNAL 變暗(灰色)。 的 FINAL,只有圖示會變暗。 這些節點的子項也會呈現暗灰色。 在這兩種情況下,覆蓋節點功能都會停用。

公共

image2018-2-8_23-34-5

最後

image2018-2-8_23-34-56

內部

image2018-2-8_23-38-23

內容健康狀態檢查

NOTE
自AEM 6.5起,Adobe建議使用模式偵測器來偵測內容存取違規。 模式偵測器報告更詳細,可偵測更多問題,並降低誤報的可能性。
如需詳細資訊,請參閱 使用模式偵測器評估升級複雜性.

AEM 6.5隨附健康情況檢查,如果以與內容分類不一致的方式使用覆蓋或參考的內容,則會提醒客戶。

​ Sling/Granite Content Access Check ​是新的健康狀態檢查,可監視存放庫,以檢視客戶程式碼是否不適當地存取AEM中受保護的節點。

這個掃描 /apps 通常需要幾秒鐘才能完成。

若要存取這項新的健康情況檢查,請執行下列動作:

  1. 從AEM首頁,瀏覽至 工具>作業>健康狀態報表

  2. 按一下 Sling/Granite內容存取檢查.

    screen_shot_2017-12-14at55648pm

掃描完成後,會顯示警告清單,通知一般使用者受保護節點被不當參考:

熒幕擷圖–2018-2-5healthreports

修正違規後,它會回到綠色狀態:

熒幕擷圖–2018-2-5healthreports-violations

健康狀態檢查會顯示背景服務收集的資訊,這些資訊會在所有Sling搜尋路徑上使用覆蓋或資源型別時進行非同步檢查。 如果內容Mixin使用不正確,它會報告違規。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2