---
title: "ビルド時の自動アイテム同期"
slug: "automatic-item-synchronization-at-build-time"
abstract: "Visual Studioでビルド時にアイテム同期を自動化するためのSitecoreの使い方。"
---
# ビルド時の自動アイテム同期

ビルド時にアイテムのシリアライズやアイテムプッシュを自動化するために、ソリューション内でビルドプロジェクトを作成できます。ビルド [設定の詳細についてはMicrosoftのドキュメント](https://docs.microsoft.com/en-us/visualstudio/ide/understanding-build-configurations?view=vs-2019) を参照してください。

> !注ビルドプロジェクトプロパティは、DebugとReleaseビルド構成ごとに個別に編集できます。

## 開発者コレクションのNuGetフィードを設定してください

Visual Studioビルドプロジェクト用のSitecoreは、開発者コレクションのNuGetパッケージのコンポーネントに依存しています。ビルド時にパッケージを自動的にダウンロードするには、開発者コレクションフィードをパッケージソースに追加する必要があります。

開発者コレクションフィードのURLは以下の通りです https://nuget.sitecore.com/resources/v3/index.json

開発者コレクションフィードはNuGet.configファイルやパッケージソースにVisual Studio追加できます。

以下は開発者コレクションフィードを含むNuGet.configファイルの例です:

<configuration>
 <!--
 Used to specify the default Sources for list, install and update.
 -->
 <packageSources>
 <clear />
 <add key="Nuget" value="https://api.nuget.org/v3/index.json" />
 <add key="SitecorePreview" value="http://sitecore-nuget-preview:8010/index.json" />
 <add key="SVSComponents" value="https://nuget.sitecore.com/resources/v3/index.json"/>
 </packageSources>

 <activePackageSource>
 <!-- this tells that all of them are active -->
 <add key="All" value="(Aggregate source)" />
 </activePackageSource>
</configuration>

Visual Studioに開発者コレクションフィードを追加するには:

1.  Visual Studioで管理者権限を使い、「 **ツール**」「 **NuGetパッケージマネージャー**」「 **パッケージマネージャー設定**」をクリックします。
    
2.  **オプション**ウィンドウでNuGet Package Manager/Package Sourcesをクリックしてください。
    
3.  新しいパッケージソースを追加するには**「Add package source」をクリックしてください。**
    
    ![Illustration showing the Options window and how to add a package source.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/103/developer-tools/images/setup-dev-coll-nuget-feed.png)
    
4.  **名前**欄にSVSComponentsを入力してください。
    
5.  **ソース**欄にhttps://nuget.sitecore.com/resources/v3/index.jsonを入力してください。
    
6.  **「アップデート**」をクリックして**からOK**してください。
    

## ビルドプロジェクトを作成する

ビルドプロジェクトを作成するには:

1.  Solution Explorerで、自分のソリューションを右クリックして「 **追加**、**新しいプロジェクト**」をクリックします。
    
2.  「 **新しいプロジェクトを追加」** ウィンドウで「 Sitecore for Visual Studio Project 」を検索して選択し、「 **次へ**」をクリックします。
    
    ![Illustration showing how to add a build project to a solution.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/103/developer-tools/images/NewProject.png)
    
3.  「 **新しいプロジェクトの設定** 」ウィンドウで、ビルドプロジェクトの名前と場所を入力し、「 **作成**」をクリックします。
    
    あなたのソリューションでビルドプロジェクトを作成しました:
    
    ![Illustration showing your build project in your solution.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/103/developer-tools/images/NewBuildProject.png)
    
    > !注NuGetパッケージの復元とビルドプロジェクトがSolution Explorerに表示されるまでに数秒かかることがあります。
    
    ほとんどの場合、単一のビルドプロジェクトだけで十分ですが、より高度なシナリオでは、ビルドプロジェクトを作成し、ビルド時に異なる操作を行うように設定することも可能です。
    

## ビルドプロジェクトを編集する

ビルドプロジェクトを編集するには:

1.  Solution Explorerでビルドプロジェクトを右クリックし、 **プロパティ**をクリックします。ビルドプロジェクトウィンドウには3つのタブがあります:
    -   **一般** - プロパティタブに関する情報。
    -   **シリアル化アイテムパッケージ** - Sitecoreインスタンスのアイテムをローカルパッケージにシリアライズすること。
    -   **シリアライズアイテムプッシュ** - ファイルシステムからSitecoreインスタンスへのシリアライズ済みアイテムのプッシュ。
2.  関連する項目を編集してください。
3.  ビルドプロジェクトは保存してください。

## アイテムをローカルパッケージにシリアライズする

アイテムをローカルパッケージにシリアライズするには:

1.  Solution Explorerでビルドプロジェクトを右クリックし、「 **プロパティ**」をクリックします。
    
2.  シリアル **化されたアイテムパッケージ** タブで、「 **シリアル化されたアイテムパッケージを作る** 」チェックボックスを選択します。
    
3.  **パッケージ名**欄にパッケージ名を入力してください。
    
4.  **パッケージモジュール**セクションで、含めたいモジュールと除外したいモジュールを選択します。
    
    ![Illustration showing how to configure what items to serialize and package at build time.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/103/developer-tools/images/PackageProperties.png)
    
5.  ビルドプロジェクトは保存してください。
    

> !注アイテムのシリアライズを有効にするのは、ビルド時にsitecore package createコマンドを実行するのと同じです。

## アイテムをSitecoreインスタンスにプッシュしてください

アイテムをSitecoreインスタンスにプッシュするには:

1.  Solution Explorerでビルドプロジェクトを右クリックし、「 **プロパティ**」をクリックします。
    
2.  「 **Serialized Items Push** 」タブで「 **ビルド中に環境にPush Serialized items」** のチェックボックスを選択してください。
    
3.  プッシュ操作のみをシミュレートするには、「 **Do What-if」** チェックボックスを選択してください。これは、シリアライズされたアイテムがSitecoreインスタンスにプッシュされないことを意味します。
    
4.  プッシュ前にファイルシステム内のシリアル化されたアイテムの整合性を検証したい場合は、「 **ファイルシステム検証スキップ** 」チェックボックスを選択してください。
    
5.  **プッシュモジュール**セクションで、含めたいモジュールと除外したいモジュールを選択します。
    
    ![Illustration showing how to configure what items to push to your Sitecore instance at build time.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/103/developer-tools/images/PushProperties.png)
    
6.  ビルドプロジェクトは保存してください。
    

> !注プッシュ操作を有効にすることは、ビルド時にsitecore ser pushコマンドを実行するのと同じです。