지속 가능한 업그레이드 sustainable-upgrades

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

관리자

사용자 지정 프레임워크 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은 고객이 AEM 기능을 확장하고 사용자 정의할 수 있도록 하기 위해 오랫동안 오버레이 및 Sling 리소스 병합의 주도권을 사용했습니다. AEM 콘솔 및 UI를 구동하는 사전 정의된 기능이 /libs 에 저장됩니다. 고객은 /libs 아래의 내용을 수정하지 않지만 /apps 아래에 컨텐츠를 추가하여 오버레이하고 /libs 에 정의된 기능을 확장할 수 있습니다(자세한 내용은 오버레이를 사용하여 개발 참조). 이로 인해 /libs 의 콘텐츠가 변경되어 오버레이 기능이 예기치 않은 방식으로 중단될 수 있으므로 AEM을 업그레이드할 때 여전히 많은 문제가 발생합니다. 고객은 상속을 통해 sling:resourceSuperType을(를) 통해 AEM 구성 요소를 확장하거나 sling:resourceType을 통해 직접 /libs 의 구성 요소를 참조할 수도 있습니다. 참조 및 재정의 사용 사례와 관련하여 유사한 업그레이드 문제가 발생할 수 있습니다.

고객이 /libs 의 영역을 보다 안전하고 쉽게 이해할 수 있도록 /libs 의 컨텐츠를 다음 mixin으로 분류했습니다.

공개(granite:PublicArea) - 노드를 오버레이하거나 상속하거나(sling:resourceSuperType) 직접 사용하거나(sling:resourceType) 사용할 수 있도록 공개로 정의합니다. 공용으로 표시된 /libs 아래의 노드는 호환성 패키지를 추가하여 안전하게 업그레이드할 수 있습니다. 일반적으로 고객은 공개로 표시된 노드만 사용해야 합니다.
추상(granite:AbstractArea) - 노드를 추상으로 정의합니다. 노드를 오버레이하거나 상속할 수 있지만(sling:resourceSupertype) 직접 사용할 수는 없습니다(sling:resourceType).
Final(granite:FinalArea) - 노드를 final로 정의합니다. 최종으로 분류된 노드는 이상적으로 오버레이 또는 상속되지 않아야 합니다. 최종 노드는 sling:resourceType을(를) 통해 직접 사용할 수 있습니다. 최종 노드 아래의 하위 노드는 기본적으로 내부로 간주됩니다.
내부(granite:InternalArea) *- *노드를 내부로 정의합니다. 내부로 분류된 노드는 이상적으로 오버레이되거나 상속되거나 직접 사용되어서는 안 됩니다. 이러한 노드는 AEM의 내부 기능만을 위한 것입니다
주석이 없음 - 노드는 트리 계층 구조에 따라 분류를 상속합니다. / 루트는 기본적으로 공용입니다. 부모가 Internal 또는 Final로 분류된 노드도 Internal로 처리됩니다.

NOTE

이러한 정책은 Sling 검색 경로 기반 메커니즘에 대해서만 적용됩니다. 클라이언트측 라이브러리와 같은 /libs 의 다른 영역은 Internal(으)로 표시될 수 있지만, 여전히 표준 clientlib 포함에 사용할 수 있습니다. 이러한 경우 고객이 내부 분류를 계속 준수하는 것이 중요합니다.

CRXDE Lite 컨텐츠 유형 표시기 crxde-lite-content-type-indicators

CRXDE Lite에 적용된 Mixin에는 INTERNAL(으)로 표시된 콘텐츠 노드 및 트리가 흐리게 표시됩니다(회색으로 표시됨). FINAL의 경우 아이콘만 흐리게 표시됩니다. 이러한 노드의 자 피쳐도 흐리게 표시됩니다. 이 두 경우 모두에서 오버레이 노드 기능이 비활성화됩니다.

공개

image2018-2-8_23-34-5