Sitecore アセンブリ リスト NuGet パッケージ

概要

このトピックでは、sc-packages NuGet フィードのバージョン固有のパッケージについて説明します。

sc-packages NuGet フィードには、ソリューションを構築するときに Sitecore が提供するアセンブリを簡単に検証または除外するために使用できるバージョン固有のパッケージが含まれています。 TDS は、ターゲットとする Sitecore のバージョンに対して参照を検証するためのこれらのパッケージの使用をサポートしています。カスタム MSBuild ロジックを使用して Sitecore が提供するアセンブリをパブリッシュから除外することもできます。どちらの場合でも、これらのアセンブリを誤って上書きして Sitecore インスタンスが破壊されてしまうことを防止できます。これらのパッケージを使用して組み込みアセンブリをデプロイから除外すると、デプロイ アーティファクトのサイズが縮小されてローカル ビルドを高速化できる可能性があります。

利用可能なパッケージ

アセンブリ パッケージは、現在、次の表に記載されているロールとデプロイ ターゲットで使用できます。

名前

バージョン

説明

Sitecore.Assemblies.Platform

9.0+

メインの Sitecore プラットフォームに基づいたすべてのロール (CM、CD、レポートなど) 。

Sitecore.Assemblies.XConnect.Web

9.0+

プライマリ XConnect (コレクション) ロール。

Sitecore.Assemblies.XConnect.IndexWorker

9.0+

XConnect Search Indexer ロール。

Sitecore.Assemblies.XConnect.MarketingAutomationEngine

9.0+

XConnect Marketing Automation Engine 処理ロール。

Sitecore.Assemblies.XConnect.ProcessingEngine

9.1+

Sitecore Cortex™ データ処理ロール。

Sitecore.Assemblies.SitecoreHeadlessServicesServer

17.0.0+

Sitecore ヘッドレス サービス。

Sitecore.Assemblies.SitecoreExperienceAccelerator

10.0.1+

Sitecore Experience Accelerator ロール。

この NuGet コマンドを使用して利用可能なすべての Sitecore.Assemblies.* パッケージのリストを取得します。

nuget list Sitecore.Assemblies -Source https://sitecore.myget.org/F/sc-packages/api/v3/index.json -AllVersions

パッケージのコンテンツ

すべてのアセンブリ リスト パッケージには、参照時に Visual Studio プロジェクトに自動的にインポートされる MSBuild ターゲット ファイルが含まれています。このターゲット ファイルには、SitecoreAssemblies と呼ばれる ItemGroup が含まれています。関連するロールに対して Sitecore が出荷するすべてのアセンブリのファイル名とメタデータを使用しています。

<SitecoreAssemblies Include="Sitecore.Kernel.dll">
    <Name>Sitecore.Kernel.dll</Name>
    <Version>13.0.0.0</Version>
    <FileVersion>13.0.0.0</FileVersion>
    <InfoVersion>13.0.0-r00729</InfoVersion>
    <Source>Platform</Source>
</SitecoreAssemblies>

使用方法

Sitecore TDS を使用する場合、TDS ドキュメントの指示に従って、適切な TDS プロジェクトのアセンブリ パッケージを参照します。他のサードパーティの Sitecore ビルド ツールについては、そのツールのドキュメントをお読みください。

すぐに使用できる MSBuild Publish 設定を使用する場合は、これをプロジェクト内の .wpp.targets ファイルに配置してデプロイからファイルを除外します。

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <!-- Delay evaluating this item group to ensure nuget package has been evaluated. -->
  <Target Name="ExcludeSitecoreAssemblies" AfterTargets="Compile">
    <ItemGroup>
      <ExcludeFromPackageFiles Include="@(SitecoreAssemblies -> 'bin\%(Filename)%(Extension)')" />
      <ExcludeFromPackageFiles Include="@(SitecoreAssemblies -> 'bin\%(Filename).pdb')" />
      <ExcludeFromPackageFiles Include="@(SitecoreAssemblies -> 'bin\%(Filename).xml')" />
    </ItemGroup>
  </Target>
</Project>

アセンブリ リストの値を上書きする必要がある場合は、Exclude 属性を ExcludeFromPackageFiles 要素に追加します。