次の方法で共有


ビルド構成を理解する

異なる設定でプロジェクトをビルドする必要がある場合は、ビルド構成が必要です。 たとえば、 デバッグリリース はビルド構成であり、ビルド時にはさまざまなコンパイラ オプションが使用されます。 1 つの構成がアクティブであり、IDE の上部にあるコマンド バーに表示されます。

Visual Studio のメイン ツール バーのアクティブな構成を示すスクリーンショット。

ビルドされた出力ファイルが格納される構成とプラットフォーム コントロール。 通常、Visual Studio でプロジェクトをビルドすると、出力はアクティブな構成 ( bin/Debug/x86 など) で名前が付けられたプロジェクト サブフォルダーに配置されますが、変更することもできます。

ソリューションおよびプロジェクト レベルで独自のビルド構成を作成できます。 ソリューション構成によって、その構成がアクティブになったときにビルドに含まれるプロジェクトが決まります。 アクティブなソリューション構成で指定されているプロジェクトのみがビルドされます。 Configuration Manager で複数のターゲット プラットフォームが選択されている場合、そのプラットフォームに適用されるすべてのプロジェクトがビルドされます。 プロジェクト構成によって、プロジェクトのビルド時に使用されるビルド設定とコンパイラ オプションが決まります。

構成を作成、選択、変更、または削除するには、 Configuration Manager を使用できます。 これを開くには、メニュー バーで [ ビルド>構成マネージャー] を選択するか、検索ボックスに 「Configuration」 と入力します。 標準ツール バーの [ソリューション構成] リストを使用して、構成を選択したり、Configuration Manager を開いたりすることもできます。

Configuration Manager ダイアログのスクリーンショット。

ツール バーにソリューション構成設定が見つからない場合、 Configuration Manager にアクセスできない場合は、Visual Basic 開発設定を使用している可能性があります。 詳細については、「 方法: Visual Basic 開発者設定を適用して構成を管理する」を参照してください。

既定では、 デバッグ 構成と リリース 構成は、Visual Studio テンプレートを使用して作成されたプロジェクトに含まれます。 デバッグ構成ではアプリのデバッグがサポートされ、リリース構成ではデプロイ可能なバージョンのアプリがビルドされます。 詳細については、「 方法: デバッグ構成とリリース構成を設定する」を参照してください。 カスタム ソリューション構成とプロジェクト構成を作成することもできます。 詳細については、「方法: 構成を作成および編集する」を参照してください。

ソリューションの構成

ソリューション構成では、ソリューション内のプロジェクトをビルドおよびデプロイする方法を指定します。 ソリューション構成を変更したり、新しい構成を定義したりするには、 Configuration Manager の [ アクティブなソリューション構成] で [ 編集] または [新規] を選択します。

ソリューション構成の [ プロジェクト コンテキスト ] ボックスの各エントリは、ソリューション内のプロジェクトを表します。 アクティブ ソリューション構成アクティブ ソリューション プラットフォームの組み合わせごとに、各プロジェクトの使用方法を設定できます。

新しいソリューション構成を定義し、[ 新しいプロジェクト構成の作成 ] チェック ボックスをオンにすると、Visual Studio はすべてのプロジェクトに新しいプロジェクト構成を作成します。 同様に、新しいソリューション プラットフォームを定義し、[ 新しいプロジェクト プラットフォームの作成 ] チェック ボックスをオンにすると、Visual Studio によってすべてのプロジェクトに新しいプラットフォーム オプションが作成されます。 また、新しいプラットフォームを対象とするプロジェクトを追加すると、Visual Studio はそのプラットフォームをソリューション プラットフォームの一覧に追加し、すべてのプロジェクトでプラットフォームをオプションとして使用できるようにします。 プラットフォームが必要ない場合や、一部のプロジェクトでサポートされていない場合は、各プロジェクトの設定を変更できます。

アクティブなソリューション構成では、IDE にコンテキストも提供されます。 たとえば、プロジェクトで作業していて、構成でモバイル デバイス用にビルドすることが指定されている場合、 ツールボックス にはモバイル デバイス プロジェクトで使用できる項目のみが表示されます。

プロジェクトの構成

プロジェクトが対象とする構成とプラットフォームは、ビルド時に使用するビルド設定とコンパイラ オプションを指定するために一緒に使用されます。 プロジェクトは、構成とプラットフォームの組み合わせごとに異なる設定を持つことができます。 プロジェクトのプロパティを変更するには、 ソリューション エクスプローラーでプロジェクトのショートカット メニューを開き、[プロパティ] を選択 します。 プロジェクト デザイナーの [ ビルド ] タブの上部で、アクティブな構成を選択してビルド設定を編集します。

プロジェクト デザイナーの構成のスクリーンショット。

各構成の定義済みの定数は、独自に入力できるテキスト ボックスの下に表示されます。 これらの定義済みの定数は、プロジェクトで使用する SDK によって定義されます。 これらのプロパティが定義されている場所を確認するには、MSBuild プロパティ DefineConstants が定義され、 .props ファイルと .targets ファイルが配置されている .NET SDK インストール フォルダーで変更する方法を確認できます。 SDK には、定義済みの定義を無効にするためにプロジェクト ファイルで設定できる MSBuild プロパティが用意されています。たとえば、「 DisableImplicitFrameworkDefines」を参照してください。

Visual Studio がプロジェクト構成とソリューション構成を関連付ける方法

新しいソリューション構成を定義し、既存のソリューション構成から設定をコピーしない場合、Visual Studio では次の条件を使用して、既存のプロジェクト構成を新しいソリューション構成に関連付けます。 条件は、表示された順序で評価されます。

  1. プロジェクトに、新しいソリューション構成の名前と一致する構成名 (<構成名><プラットフォーム名>) がある場合、その構成が使用されます。 構成名では大文字と小文字は区別されません。

  2. プロジェクトに構成名パーツが新しいソリューション構成と一致する構成名がある場合、プラットフォーム部分が一致するかどうかに関係なく、その構成が使用されます。

  3. 一致するものがまだない場合は、プロジェクトに一覧表示されている最初の構成が使用されます。

Visual Studio でソリューション構成を新しいプロジェクト構成に関連付ける方法

プロジェクト構成を作成し (Configuration Manager で、そのプロジェクトの [構成] 列のドロップダウン メニューで [新規] を選択して) [新しいソリューション構成の作成] チェック ボックスをオンにすると、Visual Studio は、サポートされている各プラットフォームでプロジェクトをビルドするための、同じ名前のソリューション構成を探します。 場合によっては、Visual Studio によって既存のソリューション構成の名前が変更されたり、新しいソリューション構成が定義されたりします。

Visual Studio では、次の条件を使用して、ソリューション構成をプロジェクト構成に関連付けます。

  • プロジェクト構成でプラットフォームが指定されていない場合、またはプラットフォームが 1 つだけ指定されている場合は、新しいプロジェクト構成の名前と一致するソリューション構成が見つかるか追加されます。 このソリューション構成の既定の名前には、プラットフォーム名は含まれません。フォーム <project 構成名>を受け取ります。

  • プロジェクトが複数のプラットフォームをサポートしている場合は、サポートされているプラットフォームごとにソリューション構成が見つかるか、追加されます。 各ソリューション構成の名前には、プロジェクト構成名とプラットフォーム名の両方が含まれており、フォーム <プロジェクト構成名><プラットフォーム名>

構成がビルドに与える影響

Build> コマンドを使用してソリューションをビルドする場合、Visual Studio はアクティブな構成のみをビルドします。 そのソリューション構成で指定されているすべてのプロジェクトがビルドされ、ビルドされる唯一のプロジェクト構成は、Visual Studio のツール バーに表示されるアクティブなソリューション構成とアクティブなソリューション プラットフォームで指定されたプロジェクト構成だけです。 たとえば、 デバッグx86 です。 他の定義済みの構成とプラットフォームはビルドされません。

複数の構成とプラットフォームを 1 つのアクションでビルドする場合は、Visual Studio の [ビルド>Batch ビルド ] オプションを使用できます。 この機能にアクセスするには、 Ctrl+Q キーを押して検索ボックスを開き、「 Batch build」と入力します。 バッチ ビルドは、すべてのプロジェクトの種類で使用できるわけではありません。 「 方法: 複数の構成を同時にビルドする」を参照してください。