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 SDK을 사용하여 로컬 개발 환경을 설정하는 방법에 대한 자세한 안내서를 확인하십시오.
필수 소프트웨어 required-software
다음은 로컬에 설치해야 합니다.
CIF 추가 기능 액세스 accessing-add-on
소프트웨어 배포 포털에서 CIF 추가 기능을 zip 파일로 다운로드할 수 있습니다. zip 파일에 Sling 기능 보관(으)로 CIF 추가 기능이 포함되어 있으며 AEM 패키지가 아닙니다. SDK 목록은 AEM as a Cloud Service 라이선스로 액세스할 수 있습니다.
로컬 설정 local-setup
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 게시용으로 올바른 라이브러리를 사용해야 합니다.
- CIF 추가 기능 zip 파일에 두 개의 Sling 기능 보관 파일
-
Adobe Commerce GraphQL 끝점을 포함하는 이름이
COMMERCE_ENDPOINT
인 로컬 OS 환경 변수를 만듭니다.-
이 변수는 AEM에서 상거래 시스템에 연결하는 데 사용됩니다. CIF 추가 기능에는 Commerce GraphQL 끝점을 로컬에서 사용할 수 있도록 하는 로컬 역방향 프록시가 포함되어 있습니다. 이 프록시는 CIF 작성 도구(제품 콘솔 및 선택기) 및 직접 GraphQL 호출을 수행하는 CIF 클라이언트측 구성 요소에 사용됩니다.
-
이 변수는 AEM as a Cloud Service 환경에도 설정해야 합니다. 변수에 대한 자세한 내용은 AEM as a Cloud Service에 대한 OSGi 구성을 참조하십시오.
-
macOS 아래의 예:
code language-bash export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
-
Windows의 예:
code language-bash set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
-
-
(선택 사항) 스테이징된 카탈로그 기능을 활성화하려면 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 사용 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 참조 스토어 사용 venia-reference
CIF 프로젝트를 시작하는 두 번째 옵션은 AEM Venia 참조 저장소를 복제하여 사용하는 것입니다. AEM Venia Reference Store는 AEM용 CIF 핵심 구성 요소의 사용을 보여 주는 샘플 참조 상점 첫 번째 애플리케이션입니다. 모범 사례 세트 및 고유한 기능을 개발하기 위한 잠재적인 시작점으로 설계되었습니다.
Venia 참조 저장소를 시작하려면 Git 저장소를 복제하고 필요에 따라 프로젝트 맞춤화를 시작합니다.