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 게시 인스턴스용 입니다.

필수 소프트웨어 required-software

다음은 로컬에 설치해야 합니다.

CIF 추가 기능 액세스 accessing-add-on

소프트웨어 배포 포털에서 CIF 추가 기능을 zip 파일로 다운로드할 수 있습니다. zip 파일에 Sling 기능 보관(으)로 CIF 추가 기능이 포함되어 있으며 AEM 패키지가 아닙니다. SDK 목록은 AEM as a Cloud Service 라이선스로 액세스할 수 있습니다.

TIP
항상 최신 CIF 추가 기능 버전을 사용하십시오.

로컬 설정 local-setup

AEM as a Cloud Service SDK을 사용하여 로컬 CIF 추가 기능 개발을 위한 다음 단계는

  1. 최신 AEM as a Cloud Service SDK을 다운로드하십시오.

  2. crx-quickstart 폴더를 만들 수 있도록 AEM .jar 압축을 풉니다. 다음 명령을 실행합니다.

    code language-bash
    java -jar <jar name> -unpack
    
  3. crx-quickstart/install 폴더를 만듭니다.

  4. CIF 추가 기능의 올바른 Sling 기능 보관 파일을 crx-quickstart/install 폴더에 복사합니다.

    • CIF 추가 기능 zip 파일에 두 개의 Sling 기능 보관 파일 .far이(가) 있습니다.
    • 로컬 AEM as a Cloud Service SDK을 실행하는 방법에 따라 AEM 작성자 또는 AEM 게시용으로 올바른 라이브러리를 사용해야 합니다.
  5. 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
      
  6. (선택 사항) 스테이징된 카탈로그 기능을 활성화하려면 Adobe Commerce 인스턴스에 대한 통합 토큰을 만들어야 합니다. 토큰을 만들려면 시작하기의 단계를 따르십시오.

    • 이름이 COMMERCE_AUTH_HEADER인 OSGi 암호를 다음 값으로 설정합니다.

      code language-xml
      Authorization: Bearer <Access Token>
      
    • 암호에 대한 자세한 내용은 AEM as a Cloud Service에 대한 OSGi 구성을 참조하십시오.

  7. AEM as a Cloud Service SDK을 시작합니다.

NOTE
환경 변수가 5단계에서 설정된 동일한 터미널 창에서 AEM as a Cloud Service SDK을 시작해야 합니다. 별도의 터미널 창에서 시작하거나 .jar 파일을 두 번 클릭하여 시작하는 경우 환경 변수가 표시되는지 확인합니다.

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 핵심 구성 요소와 필요한 모든 구성은 하나의 추가 옵션을 사용하여 생성된 프로젝트에 포함될 수 있습니다.

TIP
프로젝트를 생성할 수 있도록 항상 최신 버전의 AEM 프로젝트 원형을 사용하십시오.

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 저장소를 복제하고 필요에 따라 프로젝트 맞춤화를 시작합니다.

NOTE
Venia 참조 스토어 프로젝트에는 AEM as a Cloud Service 및 AEM 6.5용 빌드 프로필이 두 개 포함되어 있습니다. 사용 방법을 확인하려면 project readme.md을(를) 확인하십시오.

추가 리소스 additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab