Instalace motivu Adventure Works
Tento článek popisuje, jak nainstalovat motiv Adventure Works do Microsoft Dynamics 365 Commerce.
Důležité
Motiv Adventure Works a moduly jsou k dispozici od Dynamics 365 Commerce verze 10.0.20. Jsou k dispozici v Microsoft AppSource.
Předpoklady
Před instalací motivu Adventure Works musíte mít prostředí Dynamics 365 Commerce (Commerce verze 10.0.20 nebo novější), které zahrnuje Retail Cloud Scale Unit (RCSU), Commerce online software development kit (SDK) a knihovnu modulů Commerce. Informace o tom, jak nainstalovat sadu Commerce SDK a knihovnu modulů, najdete v části Nastavení vývojového prostředí.
Instalační kroky
Nainstalujte si do aplikace motiv Adventure Works
Balíček motivů Adventure Works je k dispozici v kanálu dynamics365-commerce jako @msdyn365-commerce-theme/adventureworks-theme-kit. Ačkoli je balíček motivů Adventure Works součástí tohoto kanálu, je pod jiným oborem názvů. Proto musíte podle těchto pokynů přidat položky registru pro obor názvů.
Aktualizujte soubor .npmrc tak, aby obsahoval následující položku registru (pokud položka již není zahrnuta):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Aktualizujte soubor .yarnrc tak, aby obsahoval následující položku registru (pokud položka již není zahrnuta):
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
Chcete-li nainstalovat balíček ve vašem místním prostředí, z příkazového řádku spusťte příkaz yarn add THEME_PACKAGE@VERSION, kde THEME_PACKAGE je balíček témat (@msdyn365-commerce-theme/adventureworks-theme-kit) a VERSION je číslo verze používané knihovny modulů. Je důležité, aby se verze balíčku témat a knihovny modulů shodovaly. Chcete-li najít správné číslo verze knihovny modulů, kterou chcete použít, otevřete soubor package.json a vyhledejte hodnotu starter-pack v sekci dependencies. V následujícím příkladu používá soubor package.json knihovnu modulů verze 9.32, která se mapuje na vydání Dynamics 365 Commerce verze 10.0.22.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
Následující příklad ukazuje, jak spustit příkaz yarn add pro přidání verze 9.32 tématu Adventure Works. Příkaz automaticky aktualizuje soubor package.json tak, aby obsahoval závislost.
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
Další Informace o aktualizaci verze knihovny modulů najdete v části Aktualizace SDK a knihoven modulů.
Důležité
- Verze motivu by měla odpovídat verzi knihovny modulů, aby bylo zajištěno, že všechny funkce fungují podle očekávání.
- Minimální verze pro knihovnu modulů Commerce a SDK by měla být 10.0.20 (9.31).
Přidejte soubory písem pro motiv Adventure Works
Po instalaci motivu Adventure Works do aplikace musíte přidat soubory písem, které jsou pro něj vyžadovány. Chcete-li tento krok dokončit, zkopírujte všechny soubory písem z \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts do cesty veřejného adresáře aplikace partnera \public\webfonts.
Nastavte zdroje pro motiv Adventure Works
Dalším krokem je aktualizace požadovaného výchozího zdroje pro motiv. Chcete-li tento krok dokončit, zkopírujte obsah ze souboru global.json pod \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\rzdroje\moduly do souboru partnerské aplikace global.json pod \src\rzdroje\moduly. Pokud cílový adresář \ src\resources neexistuje, lze jej celý zkopírovat ze zdrojového adresáře \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks do cílového adresáře \src.
Vyžádejte aktualizace a ověřte motiv
Informace o tom, jak stáhnout nejnovější sadu SDK, knihovnu modulů a další aktualizace závislostí, najdete v části "Vyžádat aktualizace" v Aktualizaci SDK a knihoven modulů.
Po stažení nejnovějších závislostí můžete spustit příkaz yarn start pro spuštění serveru Node ve vývojovém prostředí a testování nového motivu Adventure Works. Procházejte aplikaci místně pomocí parametru řetězce dotazu ?theme=adventureworks (například https://localhost:4000/?theme=adventureworks).