AEM Project Archetype

AEM Project Archetype은 사용자 자신의 AEM 프로젝트의 시작점으로서 모범 사례 기반 Adobe Experience Manager 프로젝트를 생성합니다. 이 Archetype 사용 시 제공되는 속성을 사용하여 이 프로젝트의 전체 이름을 지정하고 특정 옵션 기능을 제어할 수 있습니다.

이 Archetype을 사용하는 이유

AEM Project Archetype을 사용하여 몇 번의 키 입력만으로 모범 사례 기반 AEM 프로젝트를 빌드할 수 있습니다. Archetype을 사용하여, 결과 프로젝트가 최소화되도록 모든 콘텐츠를 활용하고 맨 위에서 프로젝트를 빌드하고 확장하도록 AEM의 주요 기능을 모두 구현합니다.

여러 요소들이 성공적인 AEM 프로젝트에 투입되지만 AEM Project Archetype 사용은 AEM 프로젝트에서 적극 권장되는 매우 기초적인 방법입니다.

시작하기

Project Archetype을 통해 AEM에서 개발 시작하기가 수월해집니다. 여러 방식으로 첫 단계를 수행할 수 있습니다.

• WKND 튜토리얼 - Archetype을 활용하는 방법 등 도입된 AEM 개발에 대한 실용적인 예제(Archetype 사용을 통한 간단한 프로젝트 구현하기에 대한 안내)를 알아보려면 AEM Sites 시작하기 - WKND 튜토리얼을 참조하십시오.
• WKND 이벤트 튜토리얼 - AEM에서 단일 페이지 애플리케이션(SPA) 개발에 관심이 있다면 전용 WKND 이벤트 튜토리얼에 대해 자세히 알아보십시오.
• 다운로드 후 바로 시작해 보십시오. - GitHub에 제공하는 현재 Project Archetype을 간편하게 다운로드하고 아래의 간소한 단계에 따라 첫 번째 프로젝트를 제작할 수 있습니다.

Archetype을 통해 누릴 수 있는 혜택

AEM Project Archetype은 모듈로 구성됩니다.

• core: 모든 핵심 기능(OSGi 서비스, 리스너 및 스케줄러 등)과 구성 요소 관련 Java 코드(서블릿 및 요청 필터 등)가 포함된 Java 번들입니다.
• it.tests: Java 기반 통합 테스트입니다.
• ui.apps: 일부 프로젝트 /apps 및 /etc(예: JS 및 CSS Clientlib, 구성 요소 및 템플릿)가 포함됩니다.
• ui.content: ui.apps 모듈에서 구성 요소를 사용하는 샘플 콘텐츠가 포함됩니다.
• ui.config: 프로젝트의 실행 모드별 OSGi configs가 포함됩니다.
• ui.frontend.general: (선택 사항) 일반 Webpack 기반 프론트엔드 빌드 모드 사용에 필요한 아티팩트가 포함됩니다.
• ui.frontend.react: (선택 사항) React에 따라 Archetype을 사용하여 SPA 프로젝트를 만들 때 필요한 아티팩트가 포함됩니다.
• ui.frontend.react: (선택 사항) Angular에 따라 Archetype을 사용하여 SPA 프로젝트를 만들 때 필요한 아티팩트가 포함됩니다.
• ui.tests: Selenium 기반 UI 테스트가 포함됩니다.
• all: 공급업체 종속성 등 컴파일된 모든 모듈(번들 및 콘텐츠 패키지)을 임베드하는 단일 콘텐츠 패키지입니다.
• analyse: 프로젝트에서 AEM as a Cloud Service 배포를 다시 확인하는 분석을 실행합니다.

애플리케이션, 콘텐츠와 필요한 OSGi 번들을 표시하는 콘텐츠 패키지로서 Maven에 표시된 AEM Archetype 모듈을 AEM으로 배포합니다.

Archetype을 사용하는 방법

Archetype을 사용하려면 먼저 이전에 설명한 로컬 파일의 모듈을 생성하는 프로젝트를 만들어야 합니다. 프로젝트 생성의 일부로 프로젝트 이름, 버전 등 다수의 프로젝트 속성을 정의할 수 있습니다.

Maven과 함께 프로젝트를 빌드하면 AEM으로 배포 가능한 아티팩트(패키지 및 OSGi 번들)를 제작할 수 있습니다. 추가 Maven 명령 및 프로필을 사용하여 프로젝트 아티팩트를 AEM으로 배포할 수 있습니다.

프로젝트 제작

시작하려면 AEM Eclipse 확장 기능을 최대한 활용하고, 새 프로젝트 마법사를 따라 AEM 샘플 멀티 모듈 프로젝트를 선택하여 릴리스된 Archetype 버전을 사용할 수 있습니다.

Maven을 바로 호출할 수도 있습니다.

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=XX \
 -D aemVersion=cloud \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n

• XX를 최신 AEM Project Archetype의 버전 번호로 설정합니다.
• AEM as a Cloud Service에 대해 aemVersion=cloud를 설정합니다.
  Adobe 관리 서비스 또는 온프레미스를 위한 aemVersion=6.5.0를 설정합니다.
  AEM as a Cloud Service용 OOTB에 핵심 구성 요소가 제공되므로 AEM이 아닌 버전에는 핵심 구성 요소 종속성만 추가됩니다.
• appTitle="My Site"를 조정하여 웹 사이트 제목과 구성 요소 그룹을 정의합니다.
• appId="mysite"를 조정하여 Maven artifactId, 구성 요소 config 및 콘텐츠 폴더 이름과 클라이언트 라이브러리 이름을 정의합니다.
• groupId="com.mysite"를 조정하여 Maven groupId 및 Java 소스 패키지를 정의합니다.
• 조정할 추가 속성이 있는지 확인하려면 사용 가능한 속성 목록을 조회합니다.

속성

Archetype을 사용하여 프로젝트를 제작할 때 다음 속성을 사용할 수 있습니다.

프로필

mvn install 실행 시 생성된 Maven 프로젝트는 서로 다른 배포 프로필을 지원합니다.

빌드 및 설치

모든 모듈을 빌드하려면 프로젝트 루트 디렉터리를 실행하고 다음 Maven 명령을 따릅니다.

mvn clean install

AEM 인스턴스가 실행 중인 경우 다음 Maven 명령을 사용하여 전체 프로젝트를 빌드 및 패키징하고 AEM에 배포할 수 있습니다.

mvn clean install -PautoInstallPackage

게시 인스턴스로 배포하려면 이 명령을 실행합니다.

mvn clean install -PautoInstallPackagePublish

또는 게시 인스턴스로 배포하려면 이 명령을 실행합니다.

mvn clean install -PautoInstallPackage -Daem.port=4503

또는 번들만 작성자로 배포하려면 이 명령을 실행합니다.

mvn clean install -PautoInstallBundle

상위 POM

프로젝트 루트(<src-directory>/<project>/pom.xml)의 pom.xml는 상위 POM이라고 합니다. 이는 프로젝트 구조를 유도하고 프로젝트에 대한 종속성 및 특정 전역 속성을 관리합니다.

전역 프로젝트 속성

상위 POM의 <properties> 섹션은 AEM 인스턴스에서 프로젝트를 구현하는 데 중요한 몇 가지 전역 속성(예: 사용자 이름/암호, 호스트 이름/포트 등)을 정의합니다.

이 속성을 설정하여 로컬 AEM 인스턴스로 배포합니다. 이는 개발자가 수행할 수 있는 가장 일반적인 빌드입니다. 작성자 인스턴스와 게시 인스턴스에 배포되는 속성이 있습니다. 여기서 자격 증명을 설정하여 AEM 인스턴스를 인증합니다. 기본 admin:admin 자격 증명을 사용합니다.

상위 수준의 환경에 배포할 때 이러한 속성이 재정의될 수 있도록 설정합니다. 이러한 방식으로 POM 파일은 변경될 수 없지만 aem.host 및 sling.password와 같은 변수는 다음 명령줄 인수를 통해 재정의될 수 있습니다.

mvn -PautoInstallPackage clean install -Daem.host=production.hostname -Dsling.password=productionpasswd

모듈 구조

상위 POM의 <modules> 섹션은 프로젝트가 빌드할 모듈을 정의합니다. 기본적으로 프로젝트는 이전에 정의된 표준 모듈(ore, ui.apps, ui.content, ui.tests 및 it.launcher 등)을 빌드합니다. 프로젝트가 커지면 언제든지 모듈을 추가할 수 있습니다.

종속성

상위 POM의 <dependencyManagement> 섹션은 프로젝트에 사용되는 종속성과 API 버전을 모두 정의합니다. 상위 POM에서 버전을 관리해야 합니다. core 및 ui.apps 등 하위 모듈에는 버전 정보가 제외되어야 합니다.

Uber-Jar

주요 종속성 중 하나는 AEM Java API Jar입니다. AEM 버전용 단일 종속성 목록이 있는 모든 AEM API가 여기에 포함됩니다.

핵심 구성 요소

AEM Project Archetype은 핵심 구성 요소를 활용합니다.

기본 실행 모드에서 AEM에 핵심 구성 요소를 자동으로 설치하고 샘플 WKND 사이트에서 사용합니다. 제작 실행 모드(nosamplecontent)에서는 핵심 구성 요소를 사용할 수 없습니다.

따라서 모든 배포에서 핵심 구성 요소를 활용하려면 Maven 프로젝트의 일부로 포함시키는 것이 좋습니다.

테스트

세 가지 수준의 테스트가 프로젝트에 포함되어 있습니다. 테스트의 유형이 서로 다르기 때문에 실행 방법 및 위치가 각각 다릅니다.

• core의 단위 테스트: 번들에 포함된 코드에 대한 클래식 단위 테스트를 보여 줍니다. 테스트를 하려면 다음을 실행합니다.
  • mvn clean test
• 서버측 통합 테스트: AEM 환경(AEM 서버)에서 유사 단위 테스트를 실행할 수 있습니다. 테스트를 하려면 다음을 실행합니다.
  • mvn clean verify -PintegrationTests
• 클라이언트측 Hobbes.js 테스트: 브라우저측 비헤이비어를 확인하는 JavaScript 기반 브라우저측 테스트입니다. 테스트를 수행하려면
  1. 페이지를 작성하는 경우 AEM을 브라우저에 로드합니다.
  2. 페이지를 개발자 모드에서 엽니다
  3. 왼쪽 패널을 열고 테스트 탭으로 전환합니다.
  4. 생성된 MyName 테스트​를 검색하고 실행합니다.

다음 단계

AEM Project Archetype을 빌드하고 설치했습니다. 이제 무엇을 합니까? Archetype의 규모는 작지만 권장 모범 사례에 따라 강력한 AEM 기능에 대한 여러 예제들로 구성됩니다. 이를 통해 이러한 기능이 프로젝트에서 어떻게 활용되는지 나타냅니다. 프로젝트의 경우 다음 작업을 수행해야 합니다.

• 기본 핵심 구성 요소를 확장하여 구성 요소를 사용자 정의합니다.
• 템플릿 추가
• 현지화 구조 조정
• 프론트엔드 빌드 모듈에 대해 알아보기