Adventure Works 테마 설치
이 문서에서는 Adventure Works 테마를 설치하는 방법을 설명합니다 Microsoft Dynamics 365 Commerce.
중요
Adventure Works 테마 및 모듈은 Dynamics 365 Commerce 버전 10.0.20 릴리스부터 사용할 수 있습니다. 그들은에서 구할 수 있습니다 Microsoft AppSource.
전제 조건
Adventure Works 테마를 설치하기 전에 Commerce 온라인 소프트웨어 개발 키트(SDK)인 Dynamics 365 Commerce (RCSU)가 포함된 Retail Cloud Scale Unit 환경(Commerce 버전 10.0.20 이상)이 있어야 합니다. ) 및 Commerce 모듈 라이브러리. 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 는 테마 패키지(@msdyn365-commerce- theme/adventureworks-theme-kit) 및 VERSION 은 사용 중인 모듈 라이브러리의 버전 번호입니다. 테마 패키지와 모듈 라이브러리의 버전이 일치하는 것이 중요합니다. 사용할 올바른 모듈 라이브러리 버전 번호를 찾으려면 package.json 파일을 열고 종속성 에서 starter-pack 값을 찾으세요. 섹션. 다음 예에서 package.json 파일은 Dynamics 365 Commerce 버전 10.0.22 릴리스에 매핑되는 모듈 라이브러리 버전 9.32를 사용합니다.
"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\ 아래에 있는 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)를 사용하여 로컬에서 애플리케이션을 찾아보세요.