ブートストラップ パッケージの作成
セットアップ プログラムは、Windows インストーラー (.msi) ファイルや実行可能プログラムなどの再頒布可能コンポーネントを検出およびインストールするように構成できる汎用的なインストーラーです。 インストーラーはブートストラップとも呼ばれます。 ブートストラップは、コンポーネントのインストールを管理するためのメタデータを指定する、一連の XML マニフェストによってプログラミングされます。 ClickOnce の [前提条件] ダイアログ ボックスに表示される各再頒布可能コンポーネント (前提条件) はブートストラップ パッケージです。 ブートストラップ パッケージは、必須コンポーネントのインストール方法を記述するマニフェスト ファイルを含むディレクトリおよびファイルのグループです。
ブートストラップでは、まず、既にインストールされている必須コンポーネントがあるかどうかが検出されます。 必須コンポーネントがインストールされていない場合、ライセンス条項が表示されます。 次に、エンド ユーザーがライセンス条項に同意すると、必須コンポーネントのインストールが開始されます。 すべての必須コンポーネントが検出された場合は、そのままアプリケーション インストーラーが開始されます。
カスタム ブートストラップ パッケージの作成
Visual Studio の XML エディターを使用してブートストラップ マニフェストを生成することができます。 ブートストラップ パッケージを作成する例については、「チュートリアル: プライバシー プロンプトを使用してカスタム ブートストラップを作成する」を参照してください。
ブートストラップ パッケージを作成するには、製品マニフェストを作成し、コンポーネントのローカライズされたバージョンごとにパッケージ マニフェストも作成する必要があります。
製品マニフェスト (product.xml) には、パッケージの言語的に中立なメタデータがすべて含まれます。 再頒布可能コンポーネントのすべてのローカライズ バージョンに共通するメタデータが含まれます。 このファイルを作成するには、「方法: 製品マニフェストを作成する」を参照してください。
パッケージ マニフェスト (package.xml) には、言語固有のメタデータが含まれます。通常、ローカライズされたエラー メッセージが含まれます。 コンポーネントの各ローカライズ バージョンに対して、少なくとも 1 つのパッケージ マニフェストが必要です。 このファイルを作成するには、「方法: パッケージ マニフェストを作成する」を参照してください。
これらのファイルが作成されたら、製品マニフェスト ファイルをカスタム ブートストラップ名のフォルダーに格納します。 パッケージ マニフェスト ファイルは、ロケール名のフォルダーに格納します。 たとえば、英語の再頒布用のパッケージ マニフェスト ファイルは、en というフォルダーに格納します。 日本語用は ja、ドイツ語用は de など、ロケールごとにこの手順を繰り返します。 最終的に、カスタム ブートストラップ パッケージは次のようなフォルダー構造になります。
CustomBootstrapperPackage
product.xml
CustomBootstrapper.msi
de
eula.rtf
package.xml
en
eula.rtf
package.xml
ja
eula.rtf
package.xml
次に、再頒布可能ファイルをブートストラップ フォルダーにコピーします。 詳細については、「方法: ローカライズされたブートストラップ パッケージを作成する」を参照してください。
*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*
or
*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*
Note
上の一覧の Visual Studio インストール パスは Visual Studio 2019 Update 7 リリース以降のものです。
ブートストラップ フォルダーの場所は、次のレジストリ キーの Path 値からも見つけることができます。
*HKLM\Software\Microsoft\GenericBootstrapper*
64 ビット システムでは、次のレジストリ キーを使用します。
*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*
再頒布可能コンポーネントは、パッケージのディレクトリの下の専用のサブフォルダーにそれぞれ表示されます。 製品マニフェスト ファイルと再頒布可能ファイルは、このサブフォルダーに格納される必要があります。 コンポーネントのローカライズ バージョンとパッケージ マニフェストは、カルチャ名に従って名前が付けられたサブフォルダーに格納される必要があります。
これらのファイルをブートストラップ フォルダーにコピーすると、Visual Studio の [必須コンポーネント] ダイアログ ボックスにブートストラップ パッケージが自動的に表示されます。 カスタム ブートストラップ パッケージが表示されない場合は、[必須コンポーネント] ダイアログ ボックスを閉じてから開き直してください。 詳細については、「[必須コンポーネント] ダイアログ ボックス」を参照してください。
ブートストラップによって自動的に設定されるプロパティを次の表に示します。
| プロパティ | [説明] |
|---|---|
| ApplicationName | アプリケーションの名前です。 |
| ProcessorArchitecture | 実行可能ファイルが対象とするプラットフォームのプロセッサと、ワードあたりのビット数。 次の値があります。 - Intel - IA64 - AMD64 |
| VersionNT | Windows オペレーティング システムのバージョン番号。 バージョンの構文は、Major.Minor.ServicePack です。 |
| VersionMSI | インストール中に実行する Windows インストーラーのアセンブリ (msi.dll) のバージョン。 |
| AdminUser | このプロパティは、ユーザーに管理者特権がある場合に設定されます。 値は true または false です。 |
| InstallMode | インストール モードは、コンポーネントのインストール元の場所を示します。 次の値があります。 - HomeSite - ベンダーの Web サイトから必須コンポーネントをインストールします。 - SpecificSite - 選択した場所から必須コンポーネントをインストールします。 - SameSite - アプリケーションと同じ場所から必須コンポーネントをインストールします。 |
再配布可能コンポーネントとアプリケーションのインストールの分離
再配布可能ファイルは、セットアップ プロジェクトで配置されないようにすることができます。 そのためには、.NET Framework ディレクトリの RedistList フォルダーに再頒布可能リストを作成します。
%ProgramFiles%\Microsoft.NET\RedistList
再頒布可能リストは XML ファイルです。これには、<会社名>.<コンポーネント名>.RedistList.xml という形式の名前を付けます。 たとえば、Acme 社製の DataWidgets というコンポーネントの場合は、Acme.DataWidgets.RedistList.xml にします。 再頒布可能リストの内容は、たとえば次のようになります。
<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>