概要

今回は、Visual Studioで作成したアプリのインストーラーを作成するために
[Microsoft Visual Studio Installer Projects 2022]
を使用したので、設定した内容をまとめました。

参考

以下のリンク先を主に参考にしました。
.NETと.NET Frameworkでオフラインインストール時の必要ファイルが違う様です。
当記事では、.NET Framework版を記載しますので、.NETでの設定方法が必要な方はそちらも参考にしてみてください。

〇 .NET Frameworkでオフラインインストール設定

〇 .NETでの設定

〇カスタム動作設定

環境

Visual Studio 2022
.NET Framework 4.8.1

Visual Studioの拡張機能のインストール

Visual Studioの[拡張機能]/[拡張機能の管理]から
『Microsoft Visual Studio Installer Projects 2022』
をインストールします。

インストール対象のアプリ準備

インストール対象のアプリを作成します。
今回は『.NET Framework 4.8.1』で作成したアプリを対象としました。

Setup Projectの設定

プロジェクト追加

新しいプロジェクトの追加から『Setup Project』を追加します。

プロパティ設定

『Setup Project』のプロパティウィンドウから各設定を更新します。

・Author : インストーラーの作成者
・InstallAllUsers : 全ユーザーを対象にインストールする場合は「True」にする
・Manufacturer : インストール対象のアプリケーションの製造者
・ProductName : インストール対象のアプリケーション名
・RemovePreviousVersions : 前のバージョンを削除する場合は｢True｣にする
・TargetPlatform : インストール対象のアプリケーションのPlatformに合わせる
・Title : インストーラーのタイトル
・Version : インストール対象のアプリケーションのバージョン

インストール対象のアプリ設定

『Setup Project』を右クリックし、[View] / [ファイルシステム]をクリックし、
『ApplicationFolder』を右クリックし、[Add] / [プロジェクト出力]をクリックします。
プロジェクト出力グループの追加ダイアログで、出力するプロジェクトを選択し、プライマリ出力を選択します。

設定が完了すると、『ApplicationFolder』に設定されます。

また、この設定ではdllファイルとexeファイルのみ出力されるので、他に必要なファイルがある場合は、『ApplicationFolder』を右クリックし、[Add] / [ファイル]から追加してください。(例 : appSettings.json)

デスクトップショートカットの設定

『Setup Project』を右クリックし、[View] / [ファイルシステム]をクリックし、
『User's Desktop』をクリック後、右側の空欄で右クリックし、[新しいショートカットの作成]をクリックします。

『Look in』を『Application Folder』に変更し、「インストール対象の出力設定」を選択します。

ショートカットが設定されるので、名称を変更してください。

スタートメニューの設定

デスクトップのショートカットの設定と同様に、『User's Programs Menu』で設定できます。

必須コンポーネント設定

アプリを実行するために必要となるコンポーネントを設定します。
Setup Projectのプロパティから「Prerequisites...」をクリックして、
必須コンポーネントの設定画面を開きます。

必須コンポーネントの設定画面で、使用するフレームワークに応じて必須コンポーネントを選択します。
今回は「4.8.1」を選択しました。

必須コンポーネントのインストール場所の設定は、
インストールさせたいPCがインターネットにつながっていない可能性があれば、
「アプリケーションと同じ場所から前提条件をダウンロードする」を選択します。
オフラインインストール設定をした場合のビルド時にファイル不足のエラーが出ることがあります。
後述のトラブルシューティング&QAを確認してください。

必須コンポーネントを設定後のビルドで、下記のエラーが出る場合は、
インストールアプリを設定した際に作成される依存パッケージの『Microsoft.NetFramework』のVersionを使用するフレームワークに更新します。

WARNING: The version of the .NET Framework launch condition '.NET Framework 4.7.2' does not match the selected .NET Framework bootstrapper package. Update the .NET Framework launch condition to match the version of the .NET Framework selected in the Prerequisites Dialog Box.
WARNING: The target version of the .NET Framework in the project does not match the .NET Framework launch condition version '.NET Framework 4.7.2'. Update the version of the .NET Framework launch condition to match the target version of the.NET Framework in the Advanced Compile Options Dialog Box (VB) or the Application Page (C#, F#).

ユーザーインターフェイスとインストール画面

ユーザーインターフェイス設定では、インストール前の確認ダイアログを設定することができます。

『Setup Project』を右クリックし、[View] / [ユーザーインターフェイス]をクリックします。

『Setup Project』を右クリックし、インストールをクリックすると、実際にインストーラーを使用してインストールできるので、それぞれの画面を確認してください。
[Install] / [Start]の中のダイアログに関する設定を変更することがあったので、それぞれ変更した箇所を記載します。

[Start] / [ようこそ]

「ProductName」の箇所を変更したい場合、『Setup Project』のプロパティから「ProductName」を更新してください。

[Start] / [インストールフォルダー]

この画面では、「インストール先のフォルダー」と「インストール対象のユーザー」を設定できます。

デフォルトで設定されるインストール先のフォルダーのパスを変更したい場合は、『ファイルシステム』Viewの『ApplicationFolder』のプロパティの「DefaultLocation」を更新してください。デフォルトで設定されている様に自動で変更される様にすることも、固定の絶対パスを指定することもできます。

インストール対象のユーザーの選択肢を非表示にしたい場合は、『ユーザーインターフェイス』Viewの『インストールフォルダー』のプロパティの「InstallAllUsersVisible」を変更してください。
デフォルトで選択されている項目を変更したい場合は、『Setup Project』のプロパティの「InstallAllUsers」を変更してください。

ユーザーインターフェイスとカスタム動作設定

ユーザーインターフェイス設定では、汎用的な確認ダイアログを追加設定することができ、その回答に応じて、カスタム動作を実行することができます。

確認ダイアログの追加

『ユーザーインターフェイス』Viewの『Start』で右クリックし、[ダイアログの追加]をクリックします。

追加したダイアログのプロパティの確認内容や選択肢、カスタム動作に渡すためのKeyとなる名称を更新します。
ダイアログの種類によって、Keyとなるプロパティは異なります。

(例)
オプションボタン(ラジオボタン) : ButtonProperty
チェックボックス : CheckboxProperty

カスタム動作プロジェクトの追加

新しいプロジェクトの追加から『C# クラスライブラリ』を追加します。

「System.Configuration.Install」と
Debug用に「System.Windows.Forms」の参照を追加します。

Installerクラスの派生クラスを作成し、Run Installer Attribute属性をtrueで追加します。

using System.Collections;
using System.Windows.Forms;

namespace CustomInstallAction
{
    [System.ComponentModel.RunInstaller(true)]
    public class CustomInstallAction : System.Configuration.Install.Installer
    {
        /// <inheritdoc/>
        public override void Install(IDictionary stateSaver)
        {
            base.Install(stateSaver);
            MessageBox.Show("Install");
        }

        /// <inheritdoc/>
        public override void Commit(IDictionary savedState)
        {
            base.Commit(savedState);
            MessageBox.Show("Commit");
        }

        /// <inheritdoc/>
        public override void Rollback(IDictionary savedState)
        {
            base.Rollback(savedState);
            MessageBox.Show("Rollback");
        }

        /// <inheritdoc/>
        public override void Uninstall(IDictionary savedState)
        {
            base.Uninstall(savedState);
            MessageBox.Show("Uninstall");
        }
    }
}

インストーラーにカスタム動作の追加

『Setup Project』を右クリックし、[View] / [カスタム動作]をクリックします。

Install・Commit・Rollback・Uninstallから追加したいタイミングを右クリックし、カスタム動作の追加を選択します。

『Application Folder』をクリックし、「Add Output...」からカスタム動作プロジェクトを追加します。

追加したプロジェクトを選択し、「OK」をクリックします。

カスタム動作へのデータの渡し方

ユーザーの選択した内容をカスタム動作に渡す設定を行います。

追加したカスタム動作のプロパティの「CustomActionData」に下記のルールで記載します。
・カスタム動作に渡すためのKeyとなる名称やWindowsInstallerのプロパティは[]で囲む
・値にスペースが含まれる時は""で囲む
・データが複数ある場合は、半角スペースで区切る

例
/ButtonResult1=[BUTTON1] /TextResult2="[TEXT2]"

カスタム動作側では、下記の様にデータを取得することができます。
この際、「AssemblyPath」の様な「CustinActionData」に設定していないが、デフォルトで設定されているデータも取得することができます。

        /// <inheritdoc/>
        public override void Install(IDictionary stateSaver)
        {
            base.Install(stateSaver);
            
            string buttonResult = this.Context.Parameters["ButtonResult1"];
            string textResult = this.Context.Parameters["TextResult2"];
            MessageBox.Show($"{buttonResult}:{textResult}");

            // インストール先ディレクトリを取得します。
            var destDirPath = System.IO.Path.GetDirectoryName(this.Context.Parameters["AssemblyPath"]);
            MessageBox.Show(destDirPath);

            MessageBox.Show("Install");
        }

取得したデータを用いて、実行したい処理を記載してください。

トラブルシューティング & QA

必須コンポーネントをオフラインインストールする設定の際に、ファイル不足のエラーが出る

必須コンポーネント設定で「アプリケーションと同じ場所から前提条件をダウンロードする」を選択後のビルドで、以下のエラーが出る場合、ファイルが不足しています。

ERROR: [必須コンポーネント] ダイアログ ボックスで [アプリケーションと同じ場所から必須コンポーネントをダウンロードする] を有効にするには、項目 'Microsoft .NET Framework 4.8.1 (x86 および x64)' のファイル 'DotNetFX481\NDP481-x86-x64-AllOS-ENU.exe' をローカル コンピューターにダウンロードする必要があります。詳細については、http://go.microsoft.com/fwlink/?LinkId=616018 を参照してください。
ERROR: [必須コンポーネント] ダイアログ ボックスで [アプリケーションと同じ場所から必須コンポーネントをダウンロードする] を有効にするには、項目 'Microsoft .NET Framework 4.8.1 (x86 および x64)' のファイル 'DotNetFX481\NDP481-x86-x64-AllOS-JPN.exe' をローカル コンピューターにダウンロードする必要があります。詳細については、http://go.microsoft.com/fwlink/?LinkId=616018 を参照してください。

不足ファイルのダウンロード

以下のサイトから使用している.NET Frameworkのオフラインインストーラーと言語パックのファイルをダウンロードします。
・オフラインインストーラー : NDP481-x86-x64-AllOS-ENU.exe
・言語パック : ndp481-x86-x64-allos-jpn.exe

ダウンロードしたファイルを配置

ダウンロードしたファイルを規定のフォルダに配置します。
※ .NETと.NET Frameworkでは規定のフォルダが異なる様です。

以下のフォルダを開き、オフラインインストーラーを配置します。
C:\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages\DotNetFX481
※ .Net Frameworkのバージョンにより「DotNetFX～～」の部分が変わります。

「DotNetFX481」フォルダ内の「ja」フォルダを開き、言語パックを配置します。

再度ビルドした際にエラーが出ないことを確認してください。

ユーザーインターフェイスViewで波線がついたままになる

この状態でもビルドは成功しますが、警告が出ます。

WARNING: All custom dialogs must precede the 'Installation Folder' dialog.

カスタムダイアログは『インストールフォルダー』より前に配置する必要があるとのことなので、その様にダイアログの位置を調整してください。

再度ビルドした際に警告が出ないことを確認してください。

ユーザーインターフェイスの確認ダイアログを調整したい

汎用のダイアログは多くないので、レイアウトを調整したい場合、カスタム動作中に自作のダイアログを表示するという方法があります。
また、確認ダイアログを表示するかどうかを調整したい場合（例初回インストール時のみ表示したい）等でも、カスタム動作で表示の必要性を確認した後に表示する処理を実行する必要があるかと思われます。
（イマイチ表示するかどうかの調整ほうほがわかりませんでした。）