핵심 구성 요소 사용

마지막 업데이트: 2025년 5월 5일

작성 대상:

  • 개발자
  • 관리자
  • 사용자

“자체 프로젝트에서 핵심 구성 요소를 시작하고 실행하려면 아래 섹션에 자세히 설명된 4가지 단계를 따르십시오.”

팁
프로젝트 설정, 핵심 구성 요소, 편집 가능한 템플릿, 클라이언트 라이브러리 및 구성 요소 개발 등을 최초 시작하는 방법에 대한 자세한 지침은 다음 멀티 파트 튜토리얼을 참조하십시오.
AEM Sites 시작하기 - WKND 튜토리얼
팁
AEM Project Archetype을 사용하는 경우 핵심 구성 요소는 Adobe의 모범 사례 및 권장 사항에 따라 프로젝트에 자동으로 포함됩니다.

다운로드 및 설치

핵심 구성 요소를 주도하는 아이디어는 유연성입니다. 새 버전의 핵심 구성 요소가 자주 출시되는 경우 Adobe는 보다 유연하게 새로운 기능을 제공할 수 있습니다. 결과적으로 개발자는 보다 유연하게 프로젝트로의 통합과 프로젝트의 업데이트 빈도를 선택할 수 있습니다. 그 결과 AEM과 핵심 구성 요소를 위한 릴리스 프로세스가 서로 분리됩니다.

따라서 AEM as a Cloud Service 또는 온프레미스의 실행 여부에 따라 설치 단계가 결정됩니다.

AEM as a Cloud Service

1단계는 없습니다. AEM as a Cloud Service에는 최신 버전의 핵심 구성 요소가 자동으로 제공됩니다. AEMaaCS가 AEM의 최신 기능을 제공하는 것과 마찬가지로 AEMaaCS는 자동으로 최신 버전의 핵심 구성 요소를 최신 상태로 유지합니다.

AEMaaCS에서 핵심 구성 요소 사용 시 유의해야 할 몇 가지 사항.

  • /libs에는 핵심 구성 요소가 포함됩니다.
  • 프로젝트 빌드 파이프라인에 핵심 구성 요소가 /apps의 일부로 포함되고 프로젝트의 일부로 임베디드 버전이 무시되는 경우 로그에 경고 메지지가 발생합니다.
    • 향후 릴리스에서 핵심 구성 요소가 포함되면 파이프라인 빌드에 오류가 발생합니다.
  • 이전에 /apps의 핵심 구성 요소가 프로젝트에 포함되면 프로젝트를 조정할 수 있습니다.
  • 핵심 구성 요소가 /libs에 있어도 /apps에서 동일한 경로의 오버레이를 만들지 않는 것이 좋습니다. 구성 요소의 모든 측면을 사용자 정의해야 할 경우 대신 프록시 구성 요소 패턴을 사용해야 합니다.
  • 목차 구성 요소가 콘텐츠를 렌더링하려면 OSGi에서 필터를 구성해야 합니다.

AEM 6.5 및 이전

프로덕션 모드(샘플 콘텐츠 없음)에서 시작할 때 핵심 핵심 구성 요소는 빠른 시작의 일부가 아닙니다. 따라서 첫 번째 단계는 GitHub에서 최신 릴리스된 콘텐츠 패키지를 다운로드하여 AEM 환경에 설치하는 것입니다.

몇 가지 방법으로 이 프로세스를 자동화할 수 있지만 패키지 관리자를 사용하면 인스턴스에서 콘텐츠 패키지를 빠르게 설치할 수 있습니다. 패키지 설치를 참조하십시오. 또한, 게시 인스턴스가 실행되면 해당 패키지를 복제해야 합니다. 패키지 복제를 참조하십시오.

프록시 구성 요소 제작

프록시 구성 요소 패턴 섹션에서 설명한 이유를 살펴보면 콘텐츠에서 바로 핵심 구성 요소를 참조해서는 안 됩니다. 이를 방지하기 위해 구성 요소 모두는 숨겨진 구성 요소 그룹(.core-wcm 또는 .core-wcm-form)에 속합니다. 이로써 구성 요소는 편집기에 바로 표시되지 않습니다.

대신 사이트별 구성 요소를 제작합니다. 페이지 작성자에게 표시하려는 원하는 구성 요소 이름 및 그룹을 정의하고 슈퍼타입으로 핵심 구성 요소에 조회할 수 있습니다. 이 사이트별 구성 요소는 “프록시 구성 요소”라고도 합니다. 이는 구성 요소에 아무것도 포함되지 않고 사이트에 사용할 구성 요소 버전을 정의할 수 없기 때문입니다. 단, 핵심 구성 요소를 사용자 정의하는 경우 해당 프록시 구성 요소는 마크업과 논리 사용자 정의에 중요한 역할을 수행합니다.

이에 각 핵심 구성 요소를 사이트에 사용할 경우 다음 작업을 수행해야 합니다.

  1. 사이트의 구성 요소 폴더에 해당 프록시 구성 요소를 만듭니다.

    예제: /apps/my-site/components에 유형의 제목 노드 제작 cq:Component

  2. 슈퍼타입으로 해당 핵심 구성 요소 버전을 지정합니다.

    예제: 다음 속성을 추가합니다.
    sling:resourceSuperType="core/wcm/components/title/v1/title"

  3. 구성 요소의 그룹, 제목 및 설명 (선택 사항)을 정의합니다. 해당 값은 프로젝트에 따라 다르고 구성 요소가 작성자에게 어떻게 노출되었는지 보여 줍니다.

    예제: 다음 속성을 추가합니다.

    componentGroup="My Site"
jcr:title="Title"
jcr:description="Section Heading"

예를 들어 WKND 사이트의 제목 구성 요소를 살펴봅니다. 이러한 식으로 빌드된 프록시 구성 요소의 좋은 사례입니다.