비고
Dynamics 365 Commerce의 소매 관심 그룹이 Yammer에서 Viva Engage로 이동했습니다. 새 Viva Engage 커뮤니티에 액세스할 수 없는 경우 이 양식(https://aka.ms/JoinD365commerceVivaEngageCommunity)을 작성하여 추가하고 최신 토론에 계속 참여하세요.
이 문서에서는 Microsoft Dynamics 365 Commerce에 Adventure Works 테마를 설치하는 방법을 설명합니다.
중요
Adventure Works 테마 및 모듈은 Dynamics 365 Commerce 버전 10.0.20 릴리스부터 사용할 수 있습니다. Microsoft AppSource에서 이용 가능합니다.
전제 조건
Adventure Works 테마를 설치하기 전에, RCSU(Retail Cloud Scale Unit), Commerce 온라인 소프트웨어 개발 키트(SDK) 및 Commerce 모듈 라이브러리를 포함하는 Dynamics 365 Commerce 환경(Commerce 버전 10.0.20 이상)이 반드시 구성되어 있어야 합니다. Commerce SDK 및 모듈 라이브러리 설치 방법에 대한 정보는 개발 환경 설정을 참조하세요.
설치 단계
응용 프로그램에 Adventure Works 테마 설치
Adventure Works 테마 패키지는 dynamics365-commerce 피드에서 @msdyn365-commerce-theme/adventureworks-theme-kit로 제공됩니다. 그러나 Adventure Works 테마 패키지는 해당 피드의 일부이지만 다른 네임스페이스 아래에 있습니다. 따라서 네임스페이스에 대한 레지스트리 항목을 추가하려면 다음 단계를 따라야 합니다.
.npmrc 파일을 업데이트하여 다음 레지스트리 항목이 포함되도록 하세요(해당 항목이 아직 포함되어 있지 않은 경우).
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/.yarnrc 파일을 업데이트하여 다음 레지스트리 항목이 포함되도록 하세요(해당 항목이 아직 포함되어 있지 않은 경우).
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
로컬 환경에 패키지를 설치하려면 명령 프롬프트에서 yarn add THEME_PACKAGE@VERSION 명령어를 실행합니다. 여기서 THEME_PACKAGE는 THEME_PACKAGE(@msdyn365-commerce-theme/adventureworks-theme-kit)이며, VERSION은 사용 중인 모듈 라이브러리의 버전 번호입니다. 테마 패키지와 모듈 라이브러리의 버전이 일치하는 것이 중요합니다. 사용할 올바른 모듈 라이브러리 버전 번호를 찾으려면 package.json 파일을 열고 dependencies 섹션 아래의 starter-pack 값을 찾습니다. 다음 예제에서 package.json 파일은 모듈 라이브러리 버전 9.32를 Dynamics 365 Commerce 사용하며, 이는 버전 10.0.22 릴리스에 매핑됩니다.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
다음 예에서는 yarn add 명령을 실행하여 Adventure Works 테마 버전 9.32를 추가하는 방법을 보여 줍니다. 이 명령은 종속성을 포함하도록 package.json 파일을 자동으로 업데이트합니다.
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
모듈 라이브러리 버전 업데이트에 대한 자세한 내용은 SDK 및 모듈 라이브러리 업데이트를 참조하세요.
중요
- 테마 버전은 모든 기능이 예상대로 작동하도록 모듈 라이브러리 버전과 일치해야 합니다.
- Commerce 모듈 라이브러리 및 SDK의 최소 버전은 10.0.20 (9.31)여야 합니다.
Adventure Works 테마의 글꼴 파일 추가
앱에 Adventure Works 테마를 설치한 후 테마에 필요한 글꼴 파일을 추가해야 합니다. 이 단계를 완료하려면 \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts 경로에 있는 모든 글꼴 파일을 파트너 애플리케이션의 공용 디렉터리 경로 \public\webfonts로 복사하세요.
Adventure Works 테마에 대한 리소스 설정
다음 단계는 테마에 필요한 기본 리소스를 업데이트하는 것입니다. 이 단계를 완료하려면 \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules 아래의 global.json 파일에서 콘텐츠를 \src\resources\modules 아래의 파트너 애플리케이션 global.json 파일로 복사합니다. \src\resources 대상 디렉터리가 없는 경우, \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks 소스 디렉터리에서 \src 대상 디렉터리로 전체를 복사할 수 있습니다.
업데이트 가져오기 및 테마 유효성 검사
최신 SDK, 모듈 라이브러리 및 기타 종속성 업데이트를 가져오는 방법에 대한 정보는 SDK 및 모듈 라이브러리 업데이트의 “ 업데이트 가져오기” 섹션을 참조하세요.
최신 종속성을 모두 다운로드한 후, yarn start 명령어를 실행하여 개발 환경에서 Node 서버를 시작하고 새로운 Adventure Works 테마를 테스트할 수 있습니다. 쿼리 문자열 매개 변수(?theme=adventureworks)를 사용하여 로컬에서 애플리케이션을 탐색합니다(예: https://localhost:4000/?theme=adventureworks).