備註
Dynamics 365 Commerce 的零售興趣群組已從 Yammer 移至 Viva Engage。 如果您無法存取新的Viva Engage社群，請填寫此表單 （https://aka.ms/JoinD365commerceVivaEngageCommunity） 以新增，並繼續參與最新的討論。
本文說明如何在 Microsoft Dynamics 365 Commerce 中安裝 Adventure Works 主題
重要
Adventure Works 主題和模組自 Dynamics 365 Commerce 版本 10.0.20 發行版本起提供。 這些產品可從 Microsoft Marketplace 取得。
必要條件
在安裝 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 檔案並在相依性區段底下找出初學者套件值。 在下面的範例中，package.json 檔案使用對應到 Dynamics 365 Commerce 版本 10.0.22 發行版本的模組庫版本 9.32。
"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)，在本機瀏覽應用程式。