安装 Adventure Works 主题
本文介绍如何在 Microsoft Dynamics 365 Commerce 中安装 Adventure Works 主题。
重要
Adventure Works 主题和模块从 Dynamics 365 Commerce 版本 10.0.20 发行版本开始提供。 它们通过 Microsoft AppSource 提供。
先决条件
在安装 Adventure Works 主题之前，您必须有一个 Dynamics 365 Commerce（Commerce 版本 10.0.20 或更高版本），其中包括 Retail Cloud Scale Unit (RCSU)、Commerce 联机软件开发套件 (SDK) 和 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 文件，找到 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）。