AEMas a Cloud Service 용 AEM Commerce 개발 develop
AEMas a Cloud Service 용 CIF(Commerce Integration Framework)를 기반으로 하는 AEM Commerce 프로젝트를 개발하는 경우 AEM as a Cloud Service의 다른 AEM 프로젝트와 동일한 규칙 및 모범 사례를 따릅니다. 먼저 다음을 검토하십시오.
AEM as a Cloud Service SDK를 사용한 로컬 개발 local
CIF 프로젝트로 작업하려면 로컬 개발 환경이 권장됩니다. AEM as a Cloud Service으로 제공되는 CIF 추가 기능은 로컬 개발에도 사용할 수 있습니다. 다음에서 다운로드할 수 있습니다. 소프트웨어 배포 포털.
CIF 추가 기능은 Sling 기능 아카이브로 제공됩니다. 소프트웨어 배포 포털에서 사용할 수 있는 zip 파일에는 두 개의 Sling 기능 아카이브 파일이 포함되어 있습니다. 하나는 AEM 작성자용 이고 다른 하나는 AEM 게시 인스턴스용 입니다.
AEM을 as a Cloud Service으로 처음 사용하십니까? 체크아웃 AEM as a Cloud Service SDK를 사용한 로컬 개발 환경 설정에 대한 자세한 안내서.
필수 소프트웨어
다음은 로컬에 설치해야 합니다.
CIF 추가 기능 액세스
CIF 추가 기능은에서 zip 파일로 다운로드할 수 있습니다. 소프트웨어 배포 포털. zip 파일에는 다음과 같이 CIF 추가 기능이 포함되어 있습니다. Sling 기능 아카이브: AEM 패키지가 아닙니다. SDK 목록은 AEM as a Cloud Service 라이선스로 액세스할 수 있습니다.
로컬 설정
AEM as a Cloud Service SDK를 사용한 로컬 CIF 추가 기능 개발의 경우 다음 단계를 따르십시오.
-
최신 AEM as a Cloud Service SDK 받기
-
AEM .jar의 압축을 풀고
crx-quickstart
폴더, 실행:code language-bash java -jar <jar name> -unpack
-
만들기
crx-quickstart/install
폴더 -
CIF 추가 기능의 올바른 Sling 기능 아카이브 파일을
crx-quickstart/install
폴더를 삭제합니다.CIF 추가 기능 zip 파일에는 두 개의 Sling 기능 아카이브가 포함되어 있습니다
.far
파일. 로컬 AEM as a Cloud Service SDK를 실행하는 방법에 따라 AEM 작성자 또는 AEM 게시용으로 올바른 SDK를 사용해야 합니다. -
이름이 인 로컬 OS 환경 변수 만들기
COMMERCE_ENDPOINT
Adobe Commerce GraphQL 끝점 유지 중macOS X 예:
code language-bash export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
예제 Windows:
code language-bash set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
이 변수는 AEM에서 상거래 시스템에 연결하는 데 사용됩니다. 또한 CIF 추가 기능에는 Commerce GraphQL 끝점을 로컬에서 사용할 수 있도록 하는 로컬 역방향 프록시가 포함되어 있습니다. 이 프록시는 CIF 작성 도구(제품 콘솔 및 선택기) 및 직접 GraphQL 호출을 수행하는 CIF 클라이언트측 구성 요소에 사용됩니다.
이 변수는 AEM as a Cloud Service 환경에도 설정해야 합니다. 변수에 대한 자세한 내용은 AEM에 대한 OSGi 구성 as a Cloud Service.
-
(선택 사항) 스테이징된 카탈로그 기능을 활성화하려면 Adobe Commerce 인스턴스에 대한 통합 토큰을 만들어야 합니다. 다음 단계를 수행합니다. 시작 토큰을 만듭니다.
이름으로 OSGi 암호 설정
COMMERCE_AUTH_HEADER
다음 값으로:code language-xml Authorization: Bearer <Access Token>
비밀에 대한 자세한 내용은 AEM에 대한 OSGi 구성 as a Cloud Service.
-
AEM as a Cloud Service SDK 시작
OSGI 콘솔을 통해 설정을 확인합니다. http://localhost:4502/system/console/osgi-installer
. 목록에는 기능 모델 파일에 정의된 대로 CIF 추가 기능 관련 번들, 콘텐츠 패키지 및 OSGI 구성이 포함되어야 합니다.
프로젝트 설정 project
AEMas a Cloud Service 에 CIF 프로젝트를 Bootstrap 하는 두 가지 방법이 있습니다.
AEM Project Archetype 사용
다음 AEM Project Archetype 는 CIF를 시작하기 위해 미리 구성된 프로젝트를 Bootstrap 하는 기본 도구입니다. CIF 코어 구성 요소 및 모든 필수 구성은 하나의 추가 옵션과 함께 생성된 프로젝트에 포함될 수 있습니다.
AEM 프로젝트 원형 을 참조하십시오. 사용 지침 AEM 프로젝트를 생성하는 방법에 대해 설명합니다. 프로젝트에 CIF를 포함하려면 includeCommerce
옵션을 선택합니다.
예:
mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
-D archetypeGroupId=com.adobe.aem \
-D archetypeArtifactId=aem-project-archetype \
-D archetypeVersion=35 \
-D appTitle="My Site" \
-D appId="mysite" \
-D groupId="com.mysite" \
-D includeCommerce=y
제공된 를 포함하여 모든 프로젝트에서 CIF 코어 구성 요소를 사용할 수 있습니다 all
cif 콘텐츠 패키지 및 관련 OSGI 번들을 사용하거나 개별적으로 패키징합니다. 프로젝트에 CIF 핵심 구성 요소를 수동으로 추가하려면 다음 종속성을 사용하십시오.
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-apps</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-config</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-core</artifactId>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>graphql-client</artifactId>
<version>x.y.z</version>
</dependency>
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>magento-graphql</artifactId>
<version>x.y.z</version>
</dependency>
AEM Venia 참조 저장소 사용
CIF 프로젝트를 시작하는 두 번째 옵션은 AEM Venia 참조 저장소. AEM Venia 참조 저장소는 AEM용 CIF 코어 구성 요소의 사용을 보여 주는 샘플 참조 상점 응용 프로그램입니다. 모범 사례 세트 및 고유한 기능을 개발하기 위한 잠재적인 시작점으로 설계되었습니다.
Venia 참조 저장소를 시작하려면 Git 저장소를 복제하고 필요에 따라 프로젝트 맞춤화를 시작합니다.