AEM as a Cloud Service용 AEM Commerce 개발 develop
AEM as a Cloud Service용 Commerce integration framework(CIF)를 기반으로 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 파일에 Sling 기능 보관 파일(으)로 CIF 추가 기능이 포함되어 있습니다. AEM 패키지가 아닙니다. SDK 목록은 AEM as a Cloud Service 라이선스로 액세스할 수 있습니다.
로컬 설정
AEM as a Cloud Service SDK를 사용하여 로컬 CIF 추가 기능을 개발하는 경우 다음 단계를 따르십시오.
-
최신 AEM as a Cloud Service SDK 다운로드
-
crx-quickstart
폴더를 만들 수 있도록 AEM .jar 압축을 풀고 다음을 실행합니다.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 Publish에 대해 올바른 SDK를 사용해야 합니다. -
Adobe Commerce GraphQL 끝점을 포함하는 이름이
COMMERCE_ENDPOINT
인 로컬 OS 환경 변수를 만듭니다.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 as a Cloud Service에 대한 OSGi 구성을 참조하십시오.
-
(선택 사항) 스테이징된 카탈로그 기능을 활성화하려면 Adobe Commerce 인스턴스에 대한 통합 토큰을 만들어야 합니다. 토큰을 만들려면 시작하기의 단계를 따르십시오.
이름이
COMMERCE_AUTH_HEADER
인 OSGi 암호를 다음 값으로 설정합니다.code language-xml Authorization: Bearer <Access Token>
암호에 대한 자세한 내용은 AEM as a Cloud Service에 대한 OSGi 구성을 참조하십시오.
-
AEM as a Cloud Service SDK 시작
OSGI 콘솔을 통해 설정을 확인합니다. http://localhost:4502/system/console/osgi-installer
. 목록에는 기능 모델 파일에 정의된 대로 CIF 추가 기능 관련 번들, 콘텐츠 패키지 및 OSGI 구성이 포함되어야 합니다.
프로젝트 설정 project
AEM as a Cloud Service용 CIF 프로젝트 Bootstrap 방법에는 두 가지가 있습니다.
AEM Project Archetype 사용
AEM Project Archetype은(는) CIF을 시작하기 위해 미리 구성된 프로젝트를 Bootstrap 하는 기본 도구입니다. CIF 코어 구성 요소 및 필요한 모든 구성은 하나의 추가 옵션과 함께 생성된 프로젝트에 포함될 수 있습니다.
AEM 프로젝트를 생성하는 방법은 AEM Project Archetype 사용 지침을 참조하십시오. 프로젝트에 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 저장소를 복제하고 필요에 따라 프로젝트 맞춤화를 시작합니다.