Установка темы Adventure Works
В этой статье описывается, как установить тему Adventure Works в Microsoft Dynamics 365 Commerce.
Важно
Тема 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 Online (SDK) и библиотеку модуля Commerce. Сведения об установке пакета SDK и библиотеки модулей Commerce см. в разделе Настройка среды разработки.
Этапы установки
Установка темы 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 в разделе dependencies. В следующем примере файл package.json использует версию 9.32 библиотеки модулей, которая сопоставляется с выпуском Dynamics 365 Commerce версии 10.0.22.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
В следующем примере показано, как выполнить команду yarn add для добавления версии 9.32 темы Adventure Works. Команда автоматически обновляет файл 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
Следующим шагом является обновление необходимого для темы ресурса по умолчанию. Чтобы выполнить этот шаг, скопируйте содержимое из файла global.json в папке \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules в файл global.json партнерского приложения по пути \src\resources\modules. Если каталог назначения \src\resources не существует, его можно полностью скопировать из исходного каталога \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks в целевой каталог \src.
Извлечение обновлений и проверка темы
Сведения о том, как извлечь последнюю версию пакета SDK, библиотеки модулей и других обновлений зависимостей, см. в разделе "Извлечение обновлений" из обновлений пакета SDK и библиотеки модулей.
После извлечения последних зависимостей можно выполнить команду yarn start, чтобы запустить сервер узла в среде разработки и протестировать новую тему Adventure Works. Просмотрите локально приложение, используя параметр строки запроса ?theme=adventureworks (например, https://localhost:4000/?theme=adventureworks).