チュートリアル : Visual Studio セットアッププロジェクトをビルドするためにチームビルドを構成する

[アーティクル]
09/11/2008

更新 : 2007 年 11 月

Team Foundation ビルドをカスタマイズするには、カスタムタスクを追加するか、ビルド処理の特定の段階で実行される MSBuild タスクを使用します。ここでは、MSBuild の Exec タスクを使用して Visual Studio セットアッププロジェクトをビルドするように、ビルドの定義をカスタマイズする手順を説明します。

前提条件

このチュートリアルを完了するための要件は次のとおりです。

クライアントコンピュータが次の要件を満たしている。

Development Edition がインストールされている。
チームエクスプローラがインストールされている。
Team Foundation Server に接続できる。
ローカルディレクトリをワークスペースとして使用する。

次の要件を満たすチームプロジェクトがある。

ビルドの定義が作成されている。
ソース管理用のワークスペースがローカルディレクトリにマップされている。

詳細については、「方法 : マップされたワークスペースを作成する」を参照してください。このチュートリアルでは、ローカルワークスペースとして C:\DeploymentProjects を使用します。
ソース管理が有効になっている。
1. Team Foundation バージョン管理を使用できるように Visual Studio を構成するには、[ツール] メニューの [オプション] をクリックし、[ソース管理] をクリックします。
2. [現在のソース管理プラグイン] ボックスの [Visual Studio Team Foundation Server] を選択します。

Team Foundation ビルドがインストールされたビルドエージェントがある。

Visual Studio がビルドエージェントにインストールされている。これは、MSBuild の Exec タスクで、devenv.exe を呼び出してセットアッププロジェクトをビルドするために必要です。詳細については、「Exec タスク」および「Devenv コマンドラインスイッチ」を参照してください。

メモ :
ビルドエージェントは、ビルドを実行するコンピュータです。詳細については、「方法 : ビルドエージェントを作成および管理する」を参照してください。

必要なアクセス許可

このチュートリアルを完了するには、[ビルドの管理] および [ワークスペースの管理] のアクセス許可が [許可] に設定されている必要があります。また、[チェックイン] および [チェックアウト] のアクセス許可も [許可] に設定されている必要があります。

チームプロジェクトを作成するには、[新しいプロジェクトの作成] のアクセス許可が [許可] に設定され、Windows SharePoint Server の SharePoint サーバー管理グループのメンバであり、SQL Reporting Services で [コンテンツマネージャ] のアクセス許可を持っている必要があります。

Team Foundation ビルドによって作成されたインストーラを実行するコンピュータには、インストールを実行するアクセス許可が必要です。

Visual Studio プロジェクトの作成

このチュートリアルでは、Visual Studio セットアッププロジェクトをビルドする Team Foundation ビルドの構成で使用する例として、単純な C# Windows フォームアプリケーションを作成します。

Visual Studio Windows フォームアプリケーションを作成するには

[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
[新しいプロジェクト] ダイアログボックスの [プロジェクトの種類] ペインで、[Visual C#] を選択します。[テンプレート] ペインで [Windows フォームアプリケーション] をクリックします。
[プロジェクト名] ボックスに「HelloWorldTest」と入力します。[場所] ボックスに「C:\DeploymentProjects」と入力するか、チームプロジェクト用に選択したローカルワークスペースを開きます。
[OK] をクリックします。

HelloWorldTest がソリューションエクスプローラに表示され、Form1.cs が Windows フォームデザイナに表示されます。
[表示] メニューの [ツールボックス] をクリックし、表示されるコントロールのリストを作成します。
ボタンコントロールをフォームにドラッグします。
新しいボタンをダブルクリックしてコードエディタを開きます。

Visual C# によって button1_Click というメソッドが挿入されます。

メソッドに次のコードを追加します。

private void button1_Click(object sender, EventArgs e)
        {
            MessageBox.Show("Hello World!");

        }

[ファイル] メニューの [すべてを保存] をクリックして、変更を保存します。
[ビルド] メニューの [HelloWorldTest のビルド] をクリックしてソリューションをビルドし、ビルドエラーがないことを確認します。

配置プロジェクトを作成するには

ソリューションエクスプローラで HelloWorldTest ソリューションを選択し、[ファイル] メニューの [追加] をポイントして、[新しいプロジェクト] をクリックします。
[新しいプロジェクトの追加] ダイアログボックスで、[プロジェクトの種類] ペインの [その他のプロジェクトの種類] ノードを展開し、[セットアップと配置] をクリックします。次に、[テンプレート] ペインの [セットアッププロジェクト] をクリックします。[プロジェクト名] ボックスに「HelloWorldTestInstaller」と入力します。
[OK] をクリックし、ダイアログボックスを閉じます。

プロジェクトがソリューションエクスプローラに追加され、ファイルシステムエディタが表示されます。

インストーラに HelloWorldTest アプリケーションを追加するには

ソリューションエクスプローラで HelloWorldTestInstaller を選択します。ファイルシステムエディタで、[アプリケーションフォルダ] ノードを右クリックし、[追加] をポイントして、[ファイル] をクリックします。
[ファイルの追加] ダイアログボックスで、HelloWorldTest.exe のある場所を開き、このファイルを選択して、[開く] をクリックします。

このチュートリアルで使用する場所は、C:\DeploymentProjects\HelloWorldTest\HelloWorldTest\obj\Debug\HelloWorldTest.exe です。ファイルパスは、使用するローカルワークスペースによって異なることがあります。
[ファイル] メニューの [すべてを保存] をクリックして、変更を保存します。

[ビルド] メニューの [HelloWorldTestInstaller のビルド] をクリックしてインストーラのローカルコピーをビルドし、ビルドエラーがないことを確認します。

セットアッププロジェクトによってインストーラがビルドされたことを確認するには、出力ファイルの場所を開きます。出力ファイルの場所に、HelloWorldTestInstaller.msi と setup.exe があることを確認してください。

メモ :
出力ファイルを見つけるには、ソリューションエクスプローラで HelloWorldTestInstaller プロジェクトを右クリックし、[プロパティ] をクリックします。[HelloWorldTestInstaller プロパティページ] ダイアログボックスの [出力ファイル名] ボックスに、インストーラファイルの場所が表示されます。

Team Foundation ビルドで動作するように vdproj ファイルを変更するには

ソリューションエクスプローラで HelloWorldTestInstaller プロジェクトを右クリックし、[プロパティ] をクリックします。[HelloWorldTestInstaller プロパティページ] ダイアログボックスで、[構成マネージャ] をクリックします。

HelloWorldTest と HelloWorldTestInstaller の両方の [ビルド] ボックスが選択されていることを確認します。
[閉じる] をクリックして [構成マネージャ] ダイアログボックスを閉じ、[OK] をクリックして [HelloWorldTestInstaller プロパティページ] ダイアログボックスを閉じます。
[ファイル] メニューの [すべてを保存] をクリックして、変更を保存します。
HelloWorldTestInstaller.vdproj ファイルを見つけます。

このチュートリアルで使用する場所は、C:\DeploymentProjects\HelloWorldTest\HelloWorldTestInstaller です。ファイルパスは、使用するローカルワークスペースによって異なることがあります。
HelloWorldTestInstaller.vdproj を右クリックし、[ファイルを開くアプリケーションの選択] をポイントして、[プログラムの選択] をクリックします。[ファイルを開くアプリケーションの選択] ダイアログボックスで、[プログラム] ペインの [メモ帳] を選択し、[OK] をクリックして、メモ帳で HelloWorldTestInstaller を開きます。
すべてのファイルパスが、HelloWorldTestInstaller.vdproj ファイルの場所への相対パスとして表示されていることを確認します。

絶対パスは含めないでください。

HelloWorldTest を Team Foundation ソース管理に追加してチェックインするには

ソリューションエクスプローラで HelloWorldTest ソリューションを右クリックし、[ソリューションをソース管理に追加] をクリックします。

すべてのファイルの横に黄色のプラス記号が表示されます。これは、ソース管理への追加が保留中であることを示します。

ソリューションエクスプローラで HelloWorldTest ソリューションを右クリックし、[チェックイン] をクリックします。[チェックイン - ソースファイル - ワークスペース: <ワークスペース名] ダイアログボックスで、選択中のファイルの位置までスクロールします。HelloWorldTest.exe の [名前] ボックスをクリアし、[チェックイン] をクリックします。

ファイルが Team Foundation バージョン管理にチェックインされます。

重要 :
Team Foundation ビルドは、新しい実行可能ファイルをビルドするように構成されているため、実行可能ファイルはチェックインしないようにします。

TFSBuild.proj ファイルの変更

Team Foundation ビルドを使用して HelloWorldTestInstaller プロジェクトをビルドする前に、新しいビルドの定義を作成するか、既存のビルドの定義を変更する必要があります。詳細については、「方法 : ビルド定義を作成する」を参照してください。セットアッププロジェクトのビルドを指示するビルドの定義に関連付けられている、TFSBuild.proj プロジェクトファイルを変更します。

セットアッププロジェクトをビルドするように TFSBuild.proj ファイルを変更するには

[表示] メニューの [その他のウィンドウ] をポイントし、[ソース管理エクスプローラ] をクリックします。
ソース管理エクスプローラの [フォルダ] ペインでチームプロジェクトを展開し、作成した TFSBuild.proj ファイルを見つけます。既定の場所は、チームプロジェクトフォルダの下にある TeamBuildTypes フォルダです。
表示ペインで、HelloWorldTest と HelloWorldTestInstaller をビルドするために使用するビルドの種類を選択します。ローカルワークスペースにファイルのコピーが存在しない場合は、TeamBuildType フォルダを右クリックし、[最新バージョンの取得] をクリックします。

この操作によって、使用可能なファイルが編集用にチェックアウトされます。
表示ペインで、ビルドの種類をダブルクリックし、TFSBuild.proj を右クリックして、[編集用にチェックアウト] をクリックします。[チェックアウト] ダイアログボックスで、[なし - 共有チェックアウトを許可します] を選択し、[チェックアウト] をクリックします。

TFSBuild.proj ファイルの横に赤いチェックマークが表示され、ファイルのソース管理状態を示します。
TFSBuild.proj ファイルをダブルクリックして、このファイルを Visual Studio XML エディタで開きます。
TFSBuild.proj ファイルの末尾の </Project> 終了タグの前に、次の太字で示したコードを追加します。
```
<Target Name="AfterCompile">     <Exec Command="&quot;$(ProgramFiles)\Microsoft Visual Studio 9.0\Common7\IDE\devenv&quot; &quot;$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj&quot; /Build &quot;Debug|Any CPU&quot;"/>     <Copy SourceFiles="$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\HelloWorldTestInstaller.msi; SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\setup.exe" DestinationFolder="$(OutDir)" /> </Target> 
```
ここでは、MSBuild の exec タスクを使用して HelloWorldTestInstaller セットアッププロジェクトをビルドするために、devenv.exe プログラムを呼び出します。詳細については、「Exec タスク」を参照してください。MSBuild の copy タスクは、.msi ファイルおよび .exe ファイルを Team Foundation ビルド出力ディレクトリにコピーするために使用されます。詳細については、「Copy タスク」を参照してください。

AfterCompile ターゲットは、HelloWorldTest アプリケーションのコンパイル先で、Team Foundation ビルドによる CoreCompile ターゲットの実行完了後に実行されます。ターゲット名の詳細については、「Team Foundation ビルドの構成ファイルについて」を参照してください。
[ファイル] メニューの [上書き保存] をクリックして変更を保存し、TFSBuild.proj を閉じます。
ソース管理エクスプローラで、TFSBuild.proj ファイルを右クリックし、[保留中の変更をチェックイン] をクリックします。必要に応じて、[チェックイン - ソースファイル - ワークスペース: <ワークスペース名>] ダイアログボックスでコメントを追加することもできます。[チェックイン] をクリックして、TFSBuild.proj をソース管理にチェックインします。

ビルドの定義の実行

TFSBuild.proj ファイルを変更し、Team Foundation バージョン管理に変更を保存したら、ビルドの定義を実行して配置プロジェクトをビルドします。

チームビルドの定義を実行するには

[ビルド] メニューの [新しいビルドをキューに配置] をクリックします。
[ビルド "チームプロジェクト名" をキューに配置] ダイアログボックスで、使用するビルドの定義、ビルドエージェント、キュー内の優先度を選択し、[キューに登録] をクリックします。

詳細については、「方法 : ビルド定義をキューに配置する/ビルド定義を開始する」を参照してください。

ビルド処理はビルドエクスプローラで監視できます。詳細については、「方法 : ビルドの進行状況を監視する」を参照してください。

ビルドエクスプローラの [概要] 見出しの下で、ログファイルをクリックします。ログファイルを調べてエラーを確認します。

メモ :
警告 "MSB4078: プロジェクトファイル "HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj" は MSBuild ではサポートされていないため、ビルドできません。" は無視してかまいません。このファイルは、MSBuild の Exec タスクを使用する devenv.exe プログラムによってビルドされます。

生成されたセットアップファイルをインストールするには

ビルドの格納場所である \\<drop location>\Public_build\HelloWorldTestBuild_<build number>\Release を見つけます。

格納場所はログファイルの場所と同じファイル共有であり、ビルドエクスプローラの [概要] 見出しの下に表示されます。
HelloWorldTestInstaller.msi ファイルと setup.exe ファイルを、Windows の管理者セキュリティグループのメンバになっているコンピュータ、または [インストール] のアクセス許可が [許可] に設定されているコンピュータにコピーします。
setup.exe ファイルをダブルクリックし、インストールウィザードの指示に従って操作します。

HelloWorldTestInstaller.exe が、パス <root>:\Program Files\Microsoft\HelloWorldTestInstaller にインストールされます。
<root>:\Program Files\Microsoft\HelloWorldTestInstaller に移動します。
.exe ファイルをダブルクリックしてアプリケーションを実行します。

次の手順

Visual Studio セットアッププロジェクトを変更して、インストールウィザードに手順を追加できます。詳細については、「Windows インストーラでの配置の概念」を参照してください。

参照

処理手順

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

その他の技術情報

Team Foundation ビルドでのビルド定義の操作

Team Foundation ビルドによるビルドの管理

次の方法で共有

チュートリアル : Visual Studio セットアッププロジェクトをビルドするためにチームビルドを構成する

前提条件

必要なアクセス許可

Visual Studio プロジェクトの作成

Visual Studio Windows フォームアプリケーションを作成するには

配置プロジェクトを作成するには

インストーラに HelloWorldTest アプリケーションを追加するには

Team Foundation ビルドで動作するように vdproj ファイルを変更するには

HelloWorldTest を Team Foundation ソース管理に追加してチェックインするには

TFSBuild.proj ファイルの変更

セットアッププロジェクトをビルドするように TFSBuild.proj ファイルを変更するには

ビルドの定義の実行

チームビルドの定義を実行するには

生成されたセットアップファイルをインストールするには

次の手順

参照

処理手順

その他の技術情報

その他のリソース

次の方法で共有

チュートリアル : Visual Studio セットアップ プロジェクトをビルドするためにチーム ビルドを構成する

前提条件

必要なアクセス許可

Visual Studio プロジェクトの作成

Visual Studio Windows フォーム アプリケーションを作成するには

配置プロジェクトを作成するには

インストーラに HelloWorldTest アプリケーションを追加するには

Team Foundation ビルドで動作するように vdproj ファイルを変更するには

HelloWorldTest を Team Foundation ソース管理に追加してチェックインするには

TFSBuild.proj ファイルの変更

セットアップ プロジェクトをビルドするように TFSBuild.proj ファイルを変更するには

ビルドの定義の実行

チーム ビルドの定義を実行するには

生成されたセットアップ ファイルをインストールするには

次の手順

参照

処理手順

その他の技術情報

その他のリソース

チュートリアル : Visual Studio セットアッププロジェクトをビルドするためにチームビルドを構成する

Visual Studio Windows フォームアプリケーションを作成するには

セットアッププロジェクトをビルドするように TFSBuild.proj ファイルを変更するには

チームビルドの定義を実行するには

生成されたセットアップファイルをインストールするには