.NET 自動インストールパッケージプロジェクト (Visual Studio インストーラープロジェクト) で .NET Framework 環境を自動的にインストールするようにインストールパッケージを設定する方法

序文

Microsoft Visual Studio インストーラープロジェクトは、 Microsoft Visual Studio の拡張機能であるインストーラーを作成するためのツールのセットです。これらのツールを使用すると、開発者は Visual Studio 内でインストーラーを作成およびカスタマイズし、アプリケーションをパッケージ化してユーザーに配布できます。
Visual Studio インストーラープロジェクトを使用すると、開発者はビジュアルインターフェイスを通じてインストーラーのさまざまな設定を構成したり、カスタムスクリプトやカスタム操作を使用して特定のインストールニーズを満たすことができます。このツールは Visual Studio 開発環境に統合されているため、開発者は同じ環境でアプリケーションの開発とインストーラーの作成を行うことができます。
Visual Studio インストーラープロジェクトは、MSI (Microsoft インストーラー) や ClickOnce など、いくつかの種類のインストーラーの作成をサポートしています。MSI は、より複雑なインストール操作を実行するためのより高度な機能と柔軟性を提供する一般的なインストーラー形式です。ClickOnce はインストールが簡単な方法であり、小規模なアプリケーションの展開と更新に適しています。

この記事では、.NET 自動インストールパッケージプロジェクト (Visual Studio インストーラープロジェクト) で、.NET Framework 環境を自動的にインストールするためのインストールパッケージのセットアップ方法を主に紹介します。

新しい .NET WinForm プロジェクトを作成する

デモンストレーションの便宜上、ここでは新しい WinForm APP (.NET Framework) コンソールプログラムを作成します。写真が示すように:

画像-20230710101618708

そこにいくつかのコントロールを置くだけです。簡単に実証できる

画像-20230710101935565

インストーラープロジェクトプラグインをインストールする

VS -> 拡張機能 -> 拡張機能の管理 -> オンライン -> 「インストールプロジェクト」を検索 -> ダウンロードしてインストールする Microsoft Visual Studio インストーラープロジェクトを選択します。

画像-20230707141756448

新しいインストールプロジェクトを作成します（セットアッププロジェクト）

VS -> ソリューションを右クリック -> 追加 -> 新しいプロジェクト -> テンプレート「インストーラー」を検索

画像-20230707140740302

パッケージ型式	使用
プロジェクトのセットアップ	ファイルを追加できる Windows インストーラープロジェクトを作成する
Webセットアッププロジェクト	ファイルを追加できる Windows インストーラー Web プロジェクトを作成する
モジュールプロジェクトのマージ	ファイルを追加できる Windows インストーラーマージモジュールプロジェクトを作成する
セットアップウィザード	セットアップウィザードを使用して Windows インストーラープロジェクトを作成する

ここではを選択しますSetup Project。

画像-20230710102200057

WinForm プロジェクトの出力をセットアッププロジェクトに設定する

このステップでは、主に .net プロジェクトとインストーラーの間の関連付けを示します。ここでは、プロジェクトの出力を例として取り上げます。最終インストールパッケージのパッケージ化プロセス中に、.net プロジェクトによって生成された DLL や EXE などのリリース出力ファイルがインストールパッケージに自動的に出力されます。もちろん、ビジネスニーズに応じて、他の種類のファイル、アセンブリなどをインストールパッケージに追加することもできます。

VS -> 右クリック [セットアップ] -> [追加] -> [プロジェクト出力]

以下のように構成を設定し、出力タイプは Primary 出力 (メイン出力) を選択します。

画像-20230710102233371

NET Framework インストールパッケージ

VS -> [セットアップ] を右クリック -> [プロパティ] -> [セットアッププロパティページ] ダイアログボックスに入る -> [デバッグ] -> [前提条件] (前提条件)

画像-20230710102401703

注: エラーを回避するには、デバッグとリリースで同じ前提条件を設定する必要があります。

前提条件ダイアログに入る

画像-20230710102750422

必要な .Net 環境を選択します -> システム前提条件のインストール場所を指定します。アプリケーションと同じ場所からシステム前提条件をダウンロードします -> OK -> 適用 -> OK

インストールパッケージを生成する

VS -> リリースモードを選択 -> セットアップを右クリック -> 生成

エラーレポートと原因分析を生成します。

初回生成時は以下のエラーが表示されます。

画像-20230707145732498

ここには 2 つの主な問題があり、1 つは警告、もう 1 つはエラーです。個別に解決してみましょう。

1. 警告に対する解決策

警告メッセージは次のとおりです。

警告: .NET Framework の起動条件「.NET Framework 4.7.2」のバージョンは、選択した .NET Framework ブートストラップパッケージと一致しません。[前提条件] ダイアログボックスで選択した .NET Framework のバージョンと一致するように .NET Framework の起動条件を更新します。

解決：

VS -> [Setup] を右クリック -> ファイルエクスプローラーでフォルダーを開く -> テキストエディターで Setup.vdproj を開く -> 4.7.2 を検索し、4.8 に変更 -> 再生成すると警告が消えます

画像-20230707150357552

実行結果は以下の通り、Warningが消えてErrorだけが残っていることがわかります。

画像-20230707150552331

2. エラーの解決

エラーメッセージは次のとおりです。

エラー: [前提条件] ダイアログボックスで [アプリケーションと同じ場所から前提条件をダウンロードする] を有効にするには、項目 'Microsoft .NET Framework 4.8 (x86) のファイル 'DotNetFX48\NDP48-x86-x64-AllOS-ENU.exe' をダウンロードする必要があります。 x64)」をローカルマシンに送信します。詳細については、http://go.microsoft.com/fwlink/?LinkId=616018 を参照してください。
エラー: ブートストラップのビルド中に一般的なエラーが発生
しました。エラー: 回復不能なビルドエラー - 0x80004005

エラーの原因の分析:

Microsoft 公式説明:方法: ClickOnce アプリケーションに前提条件を含める

ClickOnce アプリケーションとともに前提条件ソフトウェアを配布するには、まずこれらの前提条件のインストーラーパッケージを開発用コンピューターにダウンロードする必要があります。アプリケーションを公開し、アプリケーションと同じ場所から前提条件をダウンロードすることを選択した場合、インストールパッケージがパッケージフォルダーにない場合は、エラーが発生します。