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 라이선스로 액세스할 수 있습니다.

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

로컬 설정

AEM as a Cloud Service SDK를 사용한 로컬 CIF 추가 기능 개발의 경우 다음 단계를 따르십시오.

  1. 최신 AEM as a Cloud Service SDK 받기

  2. AEM .jar의 압축을 풀고 crx-quickstart 폴더, 실행:

    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 게시용으로 올바른 SDK를 사용해야 합니다.

  5. 이름이 인 로컬 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.

  6. (선택 사항) 스테이징된 카탈로그 기능을 활성화하려면 Adobe Commerce 인스턴스에 대한 통합 토큰을 만들어야 합니다. 다음 단계를 수행합니다. 시작 토큰을 만듭니다.

    이름으로 OSGi 암호 설정 COMMERCE_AUTH_HEADER 다음 값으로:

    code language-xml
    Authorization: Bearer <Access Token>
    

    비밀에 대한 자세한 내용은 AEM에 대한 OSGi 구성 as a Cloud Service.

  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

AEMas a Cloud Service 에 CIF 프로젝트를 Bootstrap 하는 두 가지 방법이 있습니다.

AEM Project Archetype 사용

다음 AEM Project Archetype 는 CIF를 시작하기 위해 미리 구성된 프로젝트를 Bootstrap 하는 기본 도구입니다. CIF 코어 구성 요소 및 모든 필수 구성은 하나의 추가 옵션과 함께 생성된 프로젝트에 포함될 수 있습니다.

TIP
항상 최신 버전의 AEM Project Archetype 프로젝트를 생성할 수 있습니다.

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

NOTE
Venia 참조 스토어 프로젝트에는 AEM as a Cloud Service과 AEM 6.5용 빌드 프로필이 두 개 포함되어 있습니다. 확인 프로젝트 readme.md 어떻게 쓰이는지 보실 수 있습니다.

추가 리소스

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