安裝 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 線上軟體開發工具包(SDK)）和商務模組庫。 有關如何安裝 Commerce SDK 和模組庫的信息，請參閱 設定開發環境 。
安裝步驟
在您的應用程式中安裝 Adventure Works 主題
Adventure Works 主題包可在 dynamics365-commerce Feed 中獲取，如 @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 檔案使用模組庫的版本 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\ 下的 global.json 檔案中的內容 module 到 \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）在本機瀏覽應用程式。