Adventure Works 테마 설치
이 문서에서는 Adventure Works 테마를 설치하는 방법에 대해 설명합니다 Microsoft Dynamics 365 Commerce.
중요
Adventure Works 테마 및 모듈은 버전 10.0.20 릴리스부터 Dynamics 365 Commerce 사용할 수 있습니다. 다음에서 사용할 수 있습니다 Microsoft AppSource.
전제 조건
Adventure Works 테마를 설치하기 전에 RCSU, Commerce 온라인 SDK(소프트웨어 개발 키트) 및 Commerce 모듈 라이브러리가 포함된 Dynamics 365 Commerce 환경(Commerce 버전 10.0.20 이상)이 있어야 Retail Cloud Scale Unit 합니다. Commerce SDK 및 모듈 라이브러리를 설치하는 방법에 대한 자세한 내용은 개발 환경 설정을 참조하십시오 .
설치 단계
응용 프로그램에 Adventure Works 테마 설치
Adventure Works 테마 패키지는 dynamics365-commerce 피드(as @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 파일은 버전 10.0.22 릴리스에 매핑되는 모듈 라이브러리 버전 9.32를 Dynamics 365 Commerce 사용합니다.
"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 테마를 설치한 후 테마에 필요한 글꼴 파일을 추가해야 합니다. 이 단계 완료하려면 ode_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts \n의 모든 글꼴 파일을 파트너 애플리케이션 공용 디렉터리 path \public\webfonts에 복사합니다.
Adventure Works 테마에 대한 리소스 설정
다음 단계는 테마에 필요한 기본 리소스를 업데이트하는 것입니다. 이 단계 완료하려면 ode_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks \nesources\modules\r아래의 global.json 파일에서 \src esources\modules 아래의\r 파트너 응용 프로그램 global.json 파일로 콘텐츠를 복사합니다. \src esources 대상 디렉터리가\r 없는 경우 ode_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks 원본 디렉터리에서 \n\src 대상 디렉터리로 전체를 복사할 수 있습니다.
업데이트 가져오기 및 테마 유효성 검사
최신 SDK, 모듈 라이브러리 및 기타 종속성 업데이트를 가져오는 방법에 대한 자세한 내용은 SDK 및 모듈 라이브러리 업데이트 의"끌어오기 업데이트" 섹션을 참조하세요.
최신 종속성을 풀다운한 후 yarn start 명령을 실행하여 개발 환경에서 노드 서버를 시작하고 새 Adventure Works 테마를 테스트할 수 있습니다. 쿼리 문자열 매개 변수 ?theme=adventureworks (예:, https://localhost:4000/?theme=adventureworks)를 사용하여 로컬로 응용 프로그램을 찾아봅니다.