チュートリアル: セットアップ プロジェクトを使用した Visual C++ アプリケーションの配置
このチュートリアルでは、Visual Studio でサンプル アプリを作成し、アプリを別のコンピューターに展開するセットアップ プロジェクトを作成します。
新しいプロジェクトを作成する手順は、インストールした Visual Studio のバージョンによって異なります。 優先するバージョンの Visual Studio のドキュメントを表示するには、 [バージョン] セレクター コントロールを使用します。 このページの目次の一番上にあります。
前提条件
このチュートリアルを実行するには、次のコンポーネントが必要です。
Visual Studio 2022 がインストールされているコンピューター。 インストールには、C++ ワークロードを使用した Desktop 開発と、最新の v143 ビルド ツール (x86 および x64) 用の C++ MFC オプション コンポーネントが含まれている必要があります。
Microsoft Visual Studio インストーラー Projects 拡張機能。 この拡張機能は、Visual Studio 開発者向けの無料版であり、Visual Studio にセットアップおよび配置プロジェクト テンプレートの機能を追加するものです。
デプロイをテストするために、Visual C++ ライブラリがインストールされていない別のコンピューター。
Visual Studio 2022 で C++ と MFC をインストールするには
Visual Studio がインストールされていても、C++ または MFC コンポーネントがインストールされていない場合は、ここで追加できます。
Windows スタート メニューからVisual Studio インストーラー プログラムを起動します。
Visual Studio インストーラーで、インストールされているバージョンの Visual Studio の横にある Modify ボタンを選択します。
[Modifying] ダイアログの [Workloads タブで、C++ による Desktop Development] タイルまで下にスクロールします。 タイルのチェック ボックスがオンになっていない場合は、チェック ボックスをオンにします。
ダイアログの [ インストールの詳細の下にある Desktop Development with C++ ノードを展開し、 Optional ノードを展開します。 まだチェックされていない場合は、最新の v143 ビルド ツール (x86 および x64) コンポーネントのチェックを C++ MFC に追加します。
Modify ボタンを選択して、Visual Studio のインストールを変更します。 インストールが完了したら、Visual Studio インストーラーを終了します。
インストーラー プロジェクト拡張機能をインストールするには
Visual Studio で、 Extensions>Manage Extensions メニュー項目を選択します。
[拡張機能の管理] ダイアログで、 Online>Visual Studio Marketplace>Tools を展開し、 Setup と展開を選択します。
拡張機能の一覧で Microsoft Visual Studio インストーラー Projects 2022 を選択します。 [ ダウンロード ボタンを選択します。
ダイアログの下部に、すべての Microsoft Visual Studio ウィンドウが閉じられたときに変更が開始されることを示す通知が表示されます。 ダイアログを閉じます。
Visual Studio を閉じます。 ダウンロードとインストールのプロセスが開始されます。 インストーラーで Visual Studio を変更できるようにするには、ユーザー アカウント制御の昇格プロンプトを受け入れる必要がある場合があります。
VSIX インストーラー ダイアログで、 Modify を選択して拡張機能をインストールします。 変更が完了したら、 Close を選択してダイアログを閉じます。
Visual Studio 2019 がインストールされているコンピューター。 インストールには、C++ ワークロードを使用した Desktop 開発と、最新の v142 ビルド ツール (x86 および x64) 用の C++ MFC オプション コンポーネントが含まれている必要があります。
Microsoft Visual Studio インストーラー Projects 拡張機能。 この拡張機能は、Visual Studio 開発者向けの無料版であり、Visual Studio にセットアップおよび配置プロジェクト テンプレートの機能を追加するものです。
デプロイをテストするために、Visual C++ ライブラリがインストールされていない別のコンピューター。
Visual Studio 2019 で C++ と MFC をインストールするには
Visual Studio がインストールされていても、C++ または MFC コンポーネントがインストールされていない場合は、ここで追加できます。
Windows スタート メニューからVisual Studio インストーラー プログラムを起動します。
Visual Studio インストーラーで、インストールされているバージョンの Visual Studio の横にある Modify ボタンを選択します。
[Modifying] ダイアログの [Workloads タブで、C++ による Desktop Development] タイルまで下にスクロールします。 タイルのチェック ボックスがオンになっていない場合は、チェック ボックスをオンにします。
ダイアログの [ インストールの詳細の下にある Desktop Development with C++ ノードを展開し、 Optional ノードを展開します。 まだチェックされていない場合は、最新の v142 ビルド ツール (x86 および x64) コンポーネントのチェックを C++ MFC に追加します。
Modify ボタンを選択して、Visual Studio のインストールを変更します。 インストールが完了したら、Visual Studio インストーラーを終了します。
インストーラー プロジェクト拡張機能をインストールするには
Visual Studio で、 Extensions>Manage Extensions メニュー項目を選択します。
[拡張機能の管理] ダイアログで、 Online>Visual Studio Marketplace>Tools を展開し、 Setup と展開を選択します。
拡張機能の一覧で、[Microsoft Visual Studio インストーラー Projects を選択します。 [ ダウンロード ボタンを選択します。
ダイアログの下部に、すべての Microsoft Visual Studio ウィンドウが閉じられたときに変更が開始されることを示す通知が表示されます。 ダイアログを閉じます。
Visual Studio を閉じます。 ダウンロードとインストールのプロセスが開始されます。 インストーラーで Visual Studio を変更できるようにするには、ユーザー アカウント制御の昇格プロンプトを受け入れる必要がある場合があります。
VSIX インストーラー ダイアログで、 Modify を選択して拡張機能をインストールします。 変更が完了したら、 Close を選択してダイアログを閉じます。
Visual Studio 2017 がインストールされているコンピューター。 インストールには、C++ ワークロードを使用した Desktop 開発と、x86 および x64 用の Visual C++ MFCオプション コンポーネントが含まれている必要があります。
Microsoft Visual Studio インストーラー Projects 拡張機能。 この拡張機能は、Visual Studio 開発者向けの無料版であり、Visual Studio にセットアップおよび配置プロジェクト テンプレートの機能を追加するものです。
デプロイをテストするために、Visual C++ ライブラリがインストールされていない別のコンピューター。
Visual Studio 2017 で C++ と MFC をインストールするには
Visual Studio 2017 がインストールされていても、C++ または MFC コンポーネントがインストールされていない場合は、ここで追加できます。
Windows スタート メニューからVisual Studio インストーラー プログラムを起動します。
Visual Studio インストーラーで、インストールされているバージョンの Visual Studio 2017 の横にある Modify ボタンを選択します。
[Modifying] ダイアログの [Workloads タブで、C++ による Desktop Development] タイルまで下にスクロールします。 タイルのチェック ボックスがオンになっていない場合は、チェック ボックスをオンにします。
ダイアログの [ インストールの詳細の下にある Desktop Development with C++ ノードを展開し、 Optional ノードを展開します。 まだチェックされていない場合は、x86 および x64 コンポーネントの Visual C++ MFC にチェックを追加します。
Modify ボタンを選択して、Visual Studio のインストールを変更します。 インストールが完了したら、Visual Studio インストーラーを終了します。
インストーラー プロジェクト拡張機能をインストールするには
Visual Studio で、 Tools>Extensions および Updates メニュー項目を選択します。
[拡張機能と更新プログラム] ダイアログで、 Online>Visual Studio Marketplace>Tools を展開し、 Setup と展開を選択します。 [ Sort by ドロップダウンを Most Downloads に設定します。
拡張機能の一覧で、[Microsoft Visual Studio インストーラー Projects を選択します。 [ ダウンロード ボタンを選択します。
ダイアログの下部に、すべての Microsoft Visual Studio ウィンドウが閉じられたときに変更が開始されることを示す通知が表示されます。 ダイアログを閉じます。
Visual Studio を閉じます。 ダウンロードとインストールのプロセスが開始されます。 インストーラーで Visual Studio を変更できるようにするには、ユーザー アカウント制御の昇格プロンプトを受け入れる必要がある場合があります。
VSIX インストーラー ダイアログで、 Modify を選択して拡張機能をインストールします。 変更が完了したら、 Close を選択してダイアログを閉じます。
Visual Studio がインストールされているコンピューター。 インストールには、 Visual C++ プログラミング言語ツールと、 Microsoft Foundation Classes for C++ オプション コンポーネントが含まれている必要があります。
Microsoft Visual Studio インストーラー Projects 拡張機能。 この拡張機能は、Visual Studio 開発者向けの無料版であり、Visual Studio にセットアップおよび配置プロジェクト テンプレートの機能を追加するものです。
デプロイをテストするために、Visual C++ ライブラリがインストールされていない別のコンピューター。
Visual Studio 2015 で C++ と MFC をインストールするには
Visual Studio 2015 セットアップ プログラムでは、Visual C++ と MFC は既定ではインストールされません。 Visual Studio 2015 がインストールされていても、C++ または MFC コンポーネントがインストールされていない場合は、今すぐ追加できます。
Windows スタート メニューを開き、「プログラムの追加削除」と入力します。 結果一覧からコントロール パネル アプリを開きます。
インストールされているプログラムの一覧で、Microsoft Visual Studio 2015 のインストールを見つけます。 Microsoft Visual Studio 2015 の Modify オプションを見つけて選択し、Visual Studio セットアップ プログラムを起動します。
Visual Studio セットアップ プログラムで、 Modify ボタンを選択します。
[Features] タブで、[プログラミング言語>Visual C++ を展開します。 Common Tools for Visual C++ 2015 と Microsoft Foundation Classes for C++ を選択します。 [次へ] をクリックして続行します。
[選択した機能] ページで、 UPDATE ボタンを選択して、必要なコンポーネントをインストールします。 更新が完了したら、 Close を選択してセットアップ プログラムを閉じます。
インストーラー プロジェクト拡張機能をインストールするには
Visual Studio で、 Tools>Extensions および Updates メニュー項目を選択します。
[拡張機能と更新プログラム] ダイアログで、 Online>Visual Studio Gallery>Tools を展開し、 Setup と配置を選択します。 [ Sort by ドロップダウンを Most Downloads に設定します。
拡張機能の一覧で Microsoft Visual Studio 2015 インストーラー プロジェクトを選択します。 [ ダウンロード ボタンを選択します。
ダウンロードが完了したら、[拡張機能と更新プログラム] ダイアログを閉じ、Visual Studio を閉じます。
ダウンロードした
VSI_bundle.exe
ファイルを開きます。 Visual Studio セットアップ プログラムで Install を選択します。 インストーラーで Visual Studio を変更できるようにするには、ユーザー アカウント制御の昇格プロンプトを受け入れる必要がある場合があります。 インストーラーが完了してダイアログを閉じるときにClose を選択します。
サンプル アプリ プロジェクトを作成する
デプロイ可能なアプリケーションのセットアップを作成するには、まず、デプロイするサンプル アプリを作成します。
Visual Studio 2022 でアプリ プロジェクトを作成するには
Visual Studio を起動します。 既定では、 [新しいプロジェクトの作成 ] ダイアログ ボックスが開きます。 Visual Studio が既に開いている場合は、メニュー バーの File>New>Project を選択して、 [新しいプロジェクトの作成 ] ダイアログ ボックスを開きます。
ダイアログの上部にある検索ボックスに「
MFC
」と入力し、結果リストから [MFC アプリ] を選択します。 (MFC アプリ テンプレートが見つからない場合は、 を参照してくださいVisual Studio 2022 で C++ と MFC をインストールするには。 [次へ ] ボタンを選択して続行します。新しいプロジェクトの構成 ページで、プロジェクトの名前 (MyMFCApp など) を入力します。 [作成] を選択します。
MFC アプリケーション ウィザードダイアログで、Finish を選択して、既定の MFC アプリ プロジェクトを作成します。 ウィザードによって MFC アプリが作成され、Visual Studio でプロジェクトが開きます。
Visual Studio で、アクティブなソリューション構成を Release に変更し、アクティブ ソリューション プラットフォームを x86 に変更します。 [ビルド] メニューの [構成マネージャー] を選択します。 [構成マネージャー] ダイアログ ボックスで、[アクティブ ソリューション構成ドロップダウン ボックスから Release を選択します。 Close を選択して変更を保存します。
Build>Build Solution メニュー項目を選択してソリューションをビルドします。 セットアップ プロジェクトでは、この MFC アプリケーション プロジェクトの出力が使用されます。
Visual Studio 2019 でアプリ プロジェクトを作成するには
メニューバーで、 [ファイル]>[新規作成]>[プロジェクト] の順に選択して、 [新しいプロジェクトの作成] ダイアログ ボックスを開きます。
ダイアログの上部にある検索ボックスに「
MFC
」と入力し、結果リストから [MFC アプリ] を選択します。 (MFC アプリ テンプレートが見つからない場合は、 を参照してくださいVisual Studio 2019 で C++ と MFC をインストールするには)。 [次へ ] ボタンを選択して続行します。新しいプロジェクトの構成 ページで、プロジェクトの名前 (MyMFCApp など) を入力します。 [作成] を選択します。
MFC アプリケーション ウィザードダイアログで、Finish を選択して、既定の MFC アプリ プロジェクトを作成します。 ウィザードによって MFC アプリが作成され、Visual Studio でプロジェクトが開きます。
Visual Studio で、アクティブなソリューション構成を Release に変更します。 [ビルド] メニューの [構成マネージャー] を選択します。 [構成マネージャー] ダイアログ ボックスで、[アクティブ ソリューション構成ドロップダウン ボックスから Release を選択します。 Close を選択して変更を保存します。
Build>Build Solution メニュー項目を選択してソリューションをビルドします。 セットアップ プロジェクトでは、この MFC アプリケーション プロジェクトの出力が使用されます。
Visual Studio 2017 でアプリ プロジェクトを作成するには
メニューバーで、[ファイル]>[新規作成]>[プロジェクト] の順に選択して、[新しいプロジェクト] ダイアログ ボックスを開きます。
New Project ダイアログ ツリー ビュー コントロールで、Installed>Visual C++>MFC/ATL を選択します。
中央のウィンドウで、 MFC アプリ テンプレートを選択します。 (MFC アプリ テンプレートが見つからない場合は、 を参照してくださいVisual Studio 2017 で C++ と MFC をインストールするには)。 Name を MyMFCApp に変更します。 [
OK を選択して MFC アプリケーション ウィザードを起動します。MFC アプリケーション ウィザードダイアログで、Finish を選択して、既定の MFC アプリ プロジェクトを作成します。 ウィザードによって MFC アプリが作成され、Visual Studio でプロジェクトが開きます。
Visual Studio で、アクティブなソリューション構成を Release に変更します。 [ビルド] メニューの [構成マネージャー] を選択します。 [構成マネージャー] ダイアログ ボックスで、[アクティブ ソリューション構成ドロップダウン ボックスから Release を選択します。 Close を選択して変更を保存します。
Build>Build Solution メニュー項目を選択してソリューションをビルドします。 セットアップ プロジェクトでは、この MFC アプリケーション プロジェクトの出力が使用されます。
Visual Studio 2015 でアプリ プロジェクトを作成するには
メニューバーで、[ファイル]>[新規作成]>[プロジェクト] の順に選択して、[新しいプロジェクト] ダイアログ ボックスを開きます。
New Project ダイアログ ツリー ビュー コントロールで、Installed>Templates>Visual C++>MFC を選択します。
中央のウィンドウで、 MFC アプリケーション テンプレートを選択します。 (MFC アプリケーション テンプレートがない場合は、 を参照してくださいVisual Studio 2015 で C++ と MFC をインストールするには。 Name を MyMFCApp に変更します。 [
OK を選択して MFC アプリケーション ウィザードを起動します。MFC アプリケーション ウィザードダイアログで、Finish を選択して、既定の MFC アプリ プロジェクトを作成します。 ウィザードによって MFC アプリが作成され、Visual Studio でプロジェクトが開きます。
Visual Studio で、アクティブなソリューション構成を Release に変更します。 [ビルド] メニューの [構成マネージャー] を選択します。 [構成マネージャー] ダイアログ ボックスで、[アクティブ ソリューション構成ドロップダウン ボックスから Release を選択します。 Close を選択して変更を保存します。
Build>Build Solution メニュー項目を選択してソリューションをビルドします。 セットアップ プロジェクトでは、この MFC アプリケーション プロジェクトの出力が使用されます。
アプリ セットアップ プロジェクトを作成する
デプロイするサンプル アプリを作成したので、次に、アプリのデプロイ パッケージをビルドするためのセットアップ プロジェクトを作成します。
Visual Studio 2022 でセットアップ プロジェクトを作成するには
Visual Studio で、サンプル アプリ ソリューションを読み込んだ状態で File>New>Project を選択して、 [新しいプロジェクトの作成 ] ダイアログ ボックスを開きます。
テンプレートリストの上にある検索ボックスに、「 Setup」と入力します。 テンプレートの結果の一覧で、 Setup Project を選択します。 (セットアップ プロジェクト テンプレートがない場合は、 を参照してください。インストーラー プロジェクト拡張機能をインストールするには。
Name ボックスにセットアップ プロジェクトの名前を入力します (例: MyMFCAppSetup。 [ソリューション] ドロップダウン リストで [ソリューションに追加] をクリックします。 [OK] をクリックすると、セットアップ プロジェクトが作成されます。 File System (MyMFCAppSetup) タブがエディター ウィンドウに開きます。
Visual Studio 2019 でセットアップ プロジェクトを作成するには
Visual Studio で、サンプル アプリ ソリューションを読み込んだ状態で File>New>Project を選択して、 [新しいプロジェクトの作成 ] ダイアログ ボックスを開きます。
テンプレートリストの上にある検索ボックスに、「 Setup」と入力します。 テンプレートの結果の一覧で、 Setup Project を選択します。 (セットアップ プロジェクト テンプレートがない場合は、 を参照してください。インストーラー プロジェクト拡張機能をインストールするには。
Name ボックスにセットアップ プロジェクトの名前を入力します (例: MyMFCAppSetup。 [ソリューション] ドロップダウン リストで [ソリューションに追加] をクリックします。 [OK] をクリックすると、セットアップ プロジェクトが作成されます。 File System (MyMFCAppSetup) タブがエディター ウィンドウに開きます。
Visual Studio 2017 でセットアップ プロジェクトを作成するには
Visual Studio で、サンプル アプリ ソリューションを読み込んだ状態で File>New>Project を選択して、 New Project ダイアログ ボックスを開きます。
[新しいプロジェクト] ダイアログ ボックスで、[Installed>その他のプロジェクトの種類>Visual Studio インストーラー ノードを選択します。 中央のウィンドウで、[Setup Project]\(セットアップ プロジェクト\) を選択します。 (セットアップ プロジェクト テンプレートがない場合は、 を参照してください。インストーラー プロジェクト拡張機能をインストールするには。
Name ボックスにセットアップ プロジェクトの名前を入力します (例: MyMFCAppSetup。 [ソリューション] ドロップダウン リストで [ソリューションに追加] をクリックします。 [OK] をクリックすると、セットアップ プロジェクトが作成されます。 File System (MyMFCAppSetup) タブがエディター ウィンドウに開きます。
Visual Studio 2015 でセットアップ プロジェクトを作成するには
Visual Studio で、サンプル アプリ ソリューションを読み込んだ状態で File>New>Project を選択して、 New Project ダイアログ ボックスを開きます。
[新しいプロジェクト] ダイアログ ボックスで、[Installed>Templates>その他のプロジェクトの種類>Visual Studio インストーラー ノードを選択します。 中央のウィンドウで、[Setup Project]\(セットアップ プロジェクト\) を選択します。 (セットアップ プロジェクト テンプレートがない場合は、 を参照してください。インストーラー プロジェクト拡張機能をインストールするには。
Name ボックスにセットアップ プロジェクトの名前を入力します (例: MyMFCAppSetup。 [ソリューション] ドロップダウン リストで [ソリューションに追加] をクリックします。 [OK] をクリックすると、セットアップ プロジェクトが作成されます。 File System (MyMFCAppSetup) タブがエディター ウィンドウに開きます。
セットアップ プロジェクトに項目を追加する
セットアップ プロジェクトを使用すると、ターゲット コンピューターにデプロイするときにアプリのコンポーネントをインストールする場所を指定できます。
セットアップ プロジェクトにアプリ コンポーネントを追加するには
File System (MyMFCAppSetup) エディター ウィンドウで、File System または Target Machine>Application Folder ノードを選択します。
メニュー バーで Project>Add>Project Output を選択して、[プロジェクト出力グループの 追加 ] ダイアログ ボックスを開きます。
ダイアログ ボックスで、 [Primary Output を選択し、 OK を選択します。 [ファイル システム] ウィンドウに Primary Output from ProjectName (Active) という名前の新しい項目が表示されます。
[アプリケーション フォルダー] ノードを右クリックし、[追加]>[アセンブリ] を選択して、[コンポーネントの選択] ダイアログボックスを開きます。 プログラムで必要な DLL を選択して追加します。 必要なライブラリを識別する方法の詳細については、「 再配布する DLL を決定するを参照してください。
Application フォルダー内のアイテムの一覧でPrimary Output from ProjectName (Active)を右クリックし、[ ショートカットを ProjectName からプライマリ出力に作成する (アクティブ)) を選択します。 [Shortcut to Primary Output from ProjectName (Active)]\(<プロジェクト名> (アクティブ) のプライマリ出力へのショートカット\) という名前の新しい項目が表示されます。 ショートカット項目の名前を変更し、ウィンドウの左側にある [ユーザーのプログラム メニュー] ノードに項目をドラッグ アンド ドロップすることもできます。 この項目により、セットアップによって、スタート メニュー内のアプリへのショートカットが作成されます。
メニュー バーで Build>Configuration Manager を選択して Configuration Manager ダイアログを開きます。
Configuration Manager ダイアログの Project テーブルの Build 列で、展開プロジェクトのチェック ボックスをオンにします。 Closeを選択して変更を保存し、ダイアログを閉じます。
メニュー バーで [ビルド]>[ソリューションのビルド] の順に選択して、MFC プロジェクトと配置プロジェクトをビルドします。
ソリューション フォルダーで、配置プロジェクトによってビルドされた
setup.exe
プログラムを見つけます。 このファイル (および.msi
ファイル) をコピーして、アプリケーションとその必要なライブラリ ファイルを別のコンピューターにインストールできます。
デプロイのテスト
配置をテストするには、Visual C++ ライブラリがインストールされていない 2 台目のコンピューターに配置ファイルをコピーします。 セットアップ プログラムを実行します。 アプリが正常に読み込んで実行され、不足しているライブラリまたはコンポーネントに関するランタイム エラーが発生しない場合、デプロイは成功します。
アプリケーション テスト用に、アプリのデバッグ バージョンとデバッグ ライブラリを制御するマシンにインストールするデプロイ セットアップ プログラムを作成できます。 デバッグ アプリとデバッグ ライブラリは再配布のライセンスを取得せず、顧客のマシンに展開することはできません。 詳細については、「 デバッグ実行可能ファイルを実行するためのテスト マシンの準備を参照してください。