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