aem core cif components
CI
AEM CIF Core Components 프로젝트는 AEM, CIF 및 Adobe Commerce를 사용하는 프로젝트를 시작하는 가속기 역할을합니다. 이 프로젝트에는 동적 경험 / 데이터를 위해 서버 측 렌더링 AEM 구성 요소를 클라이언트 측 React Commerce Component (MPA)와 결합하는 재사용 가능한 상업 핵심 구성 요소가 포함되어 있습니다.
이 프로젝트는 AEM 사이트 핵심 구성 요소와 함께 사용되도록 고안되었습니다. AEM CIF 코어 구성 요소는 AEM 사이트 핵심 구성 요소를 가능한 한 기초로 사용하여 확장합니다.
새로운 프로젝트를 시작하려면 아키 타입 프로젝트를 살펴보십시오. 또한 WCM 및 CIF 코어 구성 요소를 사용하여 멋진 상점 전면 경험을 제공하는 Venia 샘플 프로젝트를 살펴보십시오.
AEM CIF 코어 구성 요소의 사용 및 구성 지침 및 AEM 구성 요소 개발 소개는 AEM Content & Commerce 설명서를 참조하십시오.
기술적 인 미리보기에있는 구성 요소는 언제든지 뒤로 호환되는 방식으로 변경 될 수 있습니다. 여기에는 모든 무증제, 특히 컨텐츠 구조, API, 마크 업 및 스타일이 포함됩니다. 생산에 이러한 구성 요소를 사용하지 마십시오.
AEM CIF 코어 구성 요소의 최신 버전에는 아래 최소 시스템 요구 사항이 필요합니다.
| CIF 핵심 구성 요소 | 클라우드 서비스로 AEM | AEM 6.5 | AEM 상거래 애드온 | Adobe Commerce | 자바 |
|---|---|---|---|---|---|
| 2.15.0 | 연속 | 6.5.18 | V2022.08.02.00 | 2.4.2 EE | 11 |
이전 버전에 대한 요구 사항 목록은 히스토리 시스템 요구 사항을 참조하십시오.
클라우드 서비스 배포로 AEM의 경우이 프로젝트에는 각 AEM에 클라우드 서비스 환경으로 프로비저닝 된 CIF 애드온이 필요합니다. CIF 애드온은 자동으로 설치되며 추가 배포가 필요하지 않습니다. CIF 애드온은 소프트웨어 배포 포털에서 AEM SDK를 사용하여 로컬 개발에도 사용할 수 있습니다.
AEM 온 프렘 설치의 경우이 프로젝트에는 AEM 6.5 용 AEM Commerce 애드온이 필요합니다. 제품 피커, 제품 자산보기 및 커넥터 패키지에서 제공하는 제품 콘솔을 활용하여 저작 경험을 향상시켜야합니다. AEM 6.5 용 AEM Commerce 애드온은 소프트웨어 배포 포털에서도 제공됩니다. 별도로 설치해야합니다.
이 프로젝트는 AEM 사이트 핵심 구성 요소에 의존합니다. 일반적으로 AEM의 일부로 설치됩니다. 샘플 컨텐츠 옵션없이 AEM을 설치하면 AEM CIF 코어 구성 요소를 사용하기 전에 수동으로 배포해야합니다.
2.3.2로 시작하여 Adobe Commerce는 캐시 가능 GraphQL 요청을 지원하고 버전 0.2.1로 시작하여 CIF 코어 구성 요소는 기본적으로이를 사용합니다. 구성 요소가 Adobe Commerce 2.3.1에서 작동하도록하려면 다음 위치 에서이 기능을 수동으로 비활성화 할 수 있습니다.
mvn clean install 실행하여 아티팩트를 로컬 Maven 저장소에 설치하십시오.all 프로젝트로 전환하고 mvn clean install content-package:install 실행하십시오.다음은 설정 프로세스의 전체 비디오 연습입니다.
모든 모듈을 직접 빌드하고 최신 (아직) 미공개 변경 사항을 얻으려면 리포지토리의 루트에 다음 명령으로 모든 모듈을 빌드하고 설치하려면 다음과 같습니다.
mvn clean install -PautoInstallAll
이것은 컨텍스트 경로없이 localhost:4502 에 기본적으로 모든 것을 설치합니다. 다음 Maven 속성으로 설치 위치를 구성 할 수도 있습니다.
aem.host : AEM 인스턴스의 이름aem.port : AEM 인스턴스의 포트 번호aem.contextPath : AEM 인스턴스의 컨텍스트 경로 ( / NOT / ) 이 프로젝트는 AEM 6.5.7 cq-quickstart Uberjar에 의존합니다. 이것은 https://repo.adobe.com에서 공개적으로 제공됩니다
Uberjar에 대한 자세한 내용은 Apache Maven 문서 페이지를 사용하여 AEM 프로젝트를 구축하는 방법으로 이동하십시오.
AEM CIF 코어 구성 요소의 릴리스 버전은 Maven Central 저장소에서 사용할 수 있습니다. AEM CIF Core 구성 요소 패키지를 자신의 프로젝트 Maven 빌드에 포함 시키려면 종속성을 추가 할 수 있습니다.
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
및 서브 패키지 섹션
<subPackage>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<filter>true</filter>
</subPackage>
content-package-maven-plugin 에게.
AEM CIF Core 구성 요소를 Adobe Commerce 환경에 연결하려면 구성 단계를 따릅니다. 멀티 스토어 / 사이트 설정의 경우 AEM 사이트를 Adobe Commerce Store View 구성에 연결하려면 추가 단계가 필요합니다.
CIF 핵심 구성 요소를 사용자 정의하기 위해 CIF 핵심 구성 요소를 사용자 정의 할 때 사용 사례 및 예제를 제공합니다.
구성 요소의 클라이언트 측 JavaScript 코드는 Karma로 실행 된 Mocha 장치 테스트를 사용하여 다루어집니다. 모든 기여에 대해 새로운 클라이언트 측 코드가 테스트로 덮여 있고 모든 테스트가 통과되는지 확인하십시오.
cd ui.apps
npm install
npm test카르마는 크롬과 파이어 폭스로 테스트합니다. 두 브라우저가 설치되어 있는지 확인하십시오.
eclipse-formatter.xml 파일에서 코드 형식 규칙을 찾을 수 있습니다. 코드 형식은 각 빌드에 대해 자동으로 확인됩니다. 코드를 자동으로 포맷하려면 다음을 실행하십시오.
mvn clean install -Pformat-code JavaScript 및 CSS를 포맷하기 위해 더 예쁘게 사용합니다. ui.apps 프로젝트에서 npm test 실행할 때 서식이 자동으로 확인됩니다. 코드를 자동으로 포맷하려면 ui.apps 에서 다음 명령을 실행하십시오.
npm run prettier:fix 이 프로젝트의 릴리스는 수동으로 mvn release:prepare release:clean 이 저장소의 루트 폴더의 master 브랜치에서 청소하십시오. 릴리스 및 다음 스냅 샷 버전을 선택하면 core-cif-components-reactor-xyz 와 같은 릴리스 GIT 태그와 함께 변경 사항을 제공합니다. 커밋은 자동으로 GIT 저장소로 밀리지 않으므로 변경 사항을 확인한 다음 수동으로 푸시 할 시간이 있습니다. 그런 다음 푸시는 태그 아티팩트를 Maven Central에 배치하는 전용 CircleCI 빌드를 트리거합니다.
중요 :이 프로젝트는 Maven Reactor 릴리스를 제공하며 서브 모듈에서 릴리스를 트리거하지 않습니다 !
참고 : API 변경 및 시맨틱 버전화로 인해 Java 번들 버전을 업데이트 해야하는 경우, 부모 POM 버전과 부모 프로젝트 폴더에서 다음 명령을 실행하여 부모 POM 버전을 참조하는 모든 POM을 쉽게 mvn versions:set -DnewVersion=xyz-SNAPSHOT 할 수 있습니다. 이렇게하면 모든 프로젝트에 동일한 버전이 있습니다.
기부금이 환영받습니다! 자세한 내용은 기고 가이드를 읽으십시오.
이 프로젝트는 Apache V2 라이센스에 따라 라이센스가 부여됩니다. 자세한 내용은 라이센스를 참조하십시오.
