Instalacja motywu Adventure Works
W tym artykule opisano sposób zainstalowania motywu Adventure Works w Microsoft Dynamics 365 Commerce.
Ważne
Motyw Adventure Works i moduły są dostępne od wersji Dynamics 365 Commerce 10.0.20. Są one dostępne w Microsoft AppSource.
Wymagania wstępne
Zanim zainstalujesz motyw Adventure Works, musisz mieć środowisko Dynamics 365 Commerce (Commerce w wersji 10.0.20 lub nowszej), które zawiera Retail Cloud Scale Unit (RCSU), Commerce Online Software Development Kit (SDK) i bibliotekę modułu Commerce. Aby uzyskać informacje o tym, jak zainstalować pakiet Commerce SDK i bibliotekę modułów, zobacz Konfigurowanie środowiska developmentu.
Kroki instalacji
Zainstaluj kompozycję Adventure Works w aplikacji
Pakiet motywów Adventure Works jest dostępny w pliku danych dynamics365-commerce jako @msdyn365-commerce-theme/adventureworks-theme-kit. Jednak mimo że pakiet motywów Adventure Works jest częścią tego źródła, znajduje się w innej przestrzeni nazw. Dlatego należy wykonać następujące kroki, aby dodać wpisy rejestru dla obszaru nazw.
Zaktualizuj plik .npmrc, aby zawierał następujący wpis rejestru (jeśli wpis nie jest jeszcze uwzględniony):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Zaktualizuj plik .yarnrc, aby zawierał następujący wpis rejestru (jeśli wpis nie jest jeszcze uwzględniony):
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
Aby zainstalować pakiet w środowisku lokalnym, uruchom polecenie yarn add THEME_PACKAGE@VERSION z wiersza polecenia, gdzie THEME_PACKAGE jest pakietem motywu (@msdyn365-commerce-theme/adventureworks-theme-kit), a VERSION jest numerem wersji używanej biblioteki modułów. Bardzo ważne jest, aby wersje pakietu motywu i biblioteki modułów były takie same. Aby znaleźć poprawny numer wersji biblioteki modułów do użycia, otwórz plik package.json i odszukaj wartość starter-pack w sekcji zależności. W poniższym przykładzie plik package.json używa biblioteki modułów w wersji 9.32, która mapuje się na wersję Dynamics 365 Commerce 10.0.22.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
W poniższym przykładzie pokazano, jak uruchomić polecenie yarn add, aby dodać wersję 9.32 motywu „Adventure Works”. Polecenie automatycznie aktualizuje plik package.json, aby zawierał zależność.
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
Aby uzyskać więcej informacji na temat aktualizacji wersji biblioteki modułów, zobacz Aktualizacje zestawu SDK i biblioteki modułów.
Ważne
- Wersja motywu powinna być zgodna z wersją biblioteki modułów, aby zapewnić, że wszystkie funkcje działają zgodnie z oczekiwaniami.
- Minimalna wersja dla biblioteki modułu Commerce i SDK powinna wynosić 10.0.20 (9.31).
Dodaj pliki czcionek do motywu Adventure Works
Po zainstalowaniu motywu Adventure Works w aplikacji należy dodać wymagane pliki czcionek. Aby wykonać ten krok, skopiuj wszystkie pliki czcionek z \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts do ścieżki katalogu publicznego aplikacji partnerskiej \public\webfonts.
Skonfiguruj zasoby dla motywu Adventure Works
Następnym krokiem jest aktualizacja wymaganego zasobu domyślnego dla motywu. Aby wykonać ten krok, skopiuj zawartość z pliku global.json z folderu \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules do aplikacji partnerskiej global Plik .json w folderze \src\resources\modules. Jeśli katalog docelowy \src\resources nie istnieje, można go skopiować w całości z katalogu źródłowego \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks do katalogu docelowego \src.
Ściągnij aktualizacje i sprawdź poprawność motywu
Aby uzyskać informacje o tym, jak pobrać najnowsze pakiety SDK, bibliotekę modułów i inne aktualizacje zależności, zobacz sekcję „Wyciągnij aktualizacje” w SDK i aktualizacje biblioteki modułów.
Po ściągnięciu najnowszych zależności możesz uruchomić polecenie yarn start, aby uruchomić serwer Node w swoim środowisku programistycznym i przetestować nowy motyw Adventure Works. Przeglądać aplikację lokalnie przy użyciu parametru ciągu zapytania ?theme=adventureworks (na przykład https://localhost:4000/?theme=adventureworks).