方法 : インクリメンタル ビルド用に Team Foundation ビルドを構成する

更新 : 2007 年 11 月

インクリメンタル ビルドでは、Team Foundation ビルドによって保持されている以前のビルドの結果を再利用することで、前回のビルド以降の変更に基づいた最適化されたビルドを実行します。

インクリメンタル ビルドのビルド定義を作成したら、最初のビルドを実行します。必要なワークスペースが作成され、すべてのソース ファイルがビルド コンピュータ上に取得されます。

必要条件

このタスクを完了するには、次のものが必要です。

  • カスタマイズするビルドの種類に対応した TFSBuild.proj ファイルへのアクセス。

    各チーム ビルド定義は、関連付けられた TFSBuild.proj ファイルに定義されています。このファイルは、Team Foundation バージョン管理の $/MyTeamProject/TeamBuildTypes/MyBuildName フォルダにあります。MyTeamProject はチーム プロジェクトの名前です。これは、すべてのチーム プロジェクト ソースのルート ノードです。MyBuildName はビルド定義に付けた名前です。Team Foundation ビルドのビルドの種類を作成する方法の詳細については、「方法 : ビルド定義を作成する」を参照してください。

  • ローカル コンピュータ上にチーム プロジェクト ファイルとビルド ファイルが置かれたローカル ワークスペース。

    詳細については、「方法 : マップされたワークスペースを作成する」および「方法 : チーム プロジェクトのソースを取得する」を参照してください。

必要なアクセス許可

このタスクを完了するには、[ビルドを管理します] および [ワークスペースの管理] のアクセス許可が [許可] に設定されている必要があります。また、[チェックイン] および [チェックアウト] のアクセス許可も [許可] に設定されている必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。

TFSBuild.proj ファイルのローカル コピーの取得

ビルド定義を定義する TFSBuild.proj ファイルを変更する前に、そのローカル コピーを取得する必要があります。

TFSBuild.proj ファイルのローカル コピーを取得するには

  1. [表示] メニューの [その他のウィンドウ] をポイントし、[ソース管理エクスプローラ] をクリックします。

  2. ソース管理エクスプローラで、ツール バーの [ワークスペース] をクリックし、一覧から新しいワークスペースを選択します。

  3. ビルドの種類が含まれているチーム プロジェクト フォルダを開き、TeamBuildTypes フォルダを展開します。

  4. TFSBuild.proj ファイルを右クリックし、[最新バージョンの取得] をクリックして、最新バージョンのファイルをコピーします。

    詳細については、「方法 : チーム プロジェクトのソースを取得する」を参照してください。

TFSBuild.proj ファイルでのプロパティの設定

インクリメンタル ビルドを指定するには、TFSBuild.proj ファイルで IncrementalBuild プロパティを設定する必要があります。

TFSBuild.proj ファイルでプロパティを設定するには

  • IncrementalBuild プロパティは、SkipClean を true に、SkipInitializeWorkspace を true に、ForceGet を false に設定するのに便利です。

  • Team Foundation ビルドでフル ビルドを実行すると、Clean ターゲットにおいて、中間ビルド フォルダおよびソース フォルダ内のファイルが消去されます。インクリメンタル ビルドでは、これらのファイルは次のビルドでも必要になるため、このターゲットをスキップする必要があります。これを行うには、SkipClean を true に設定します。

  • フル ビルドでは、Team Foundation ビルドは古いワークスペースを削除し、新しいワークスペースを作成し直して、ソース ファイルをクリーンな状態で同期します。インクリメンタル ビルドでは、このターゲットもスキップする必要があります。これを行うには、SkipInitializeWorkspace を true に設定します。

  • Get タスクでは、Team Foundation ビルドは既定で新しいソース ファイルを取得し、ビルド ワークスペース内の既存のファイルを上書きします。変更されたファイルだけを取得するには、ForceGet プロパティを false に設定します。

    IncrementalBuild プロパティを true に設定するには、TFSBuild.proj ファイルの末尾で、</project> 終了タグの前に PropertyGroup の定義を追加します。

    </ItemGroup>
       <PropertyGroup>      <IncrementalBuild>true</IncrementalBuild>   </PropertyGroup>
    </Project>
    

参照

処理手順

チュートリアル : カスタム タスクを使って Team Foundation ビルドをカスタマイズする

概念

カスタマイズ可能な Team Foundation のビルド ターゲット

バージョン管理サーバーへの変更の送信

その他の技術情報

Team Foundation ビルドのカスタマイズ