アプリケーションによる Setup.exe Bootstrapper サンプルの使用

  • [アーティクル]

更新 : 2007 年 11 月

Setup.exe Bootstrapper サンプルでは、処理が自動的に実行されます。ただし、Setup.exe でアプリケーションを使用できるようにするには、作成したアプリケーションに関する必要な情報を含むカスタム Settings.ini ファイルを作成する必要があります。また、セットアップ プログラムと共に Readme ファイルを配置して、アプリケーションと Dotnetfx.exe をインストールするための最小構成要件をユーザーが参照できるようにすることをお勧めします。Settings.ini ファイルと Readme ファイルの作成の詳細については、次のトピックを参照してください。

  • Settings.ini ファイルの作成

  • セットアップ プログラムの Readme ファイルの作成

Settings.ini ファイルの作成

Setup.exe Bootstrapper サンプルでは、外部ファイル Settings.ini を使用して、次の情報を特定します。

  • Dotnetfx.exe およびホスト アプリケーションの場所。

  • チェックする .NET Framework の言語バージョン。

  • Setup.exe のダイアログ ボックスで使用するカスタム文字列。

Settings.ini の既定の場所は Setup.exe が格納されているフォルダです。作成したアプリケーションを Setup.exe Bootstrapper サンプルで処理できるようにする Settings.ini ファイルを作成する必要があります。Setup.exe Bootstrapper サンプルに付属している Settings.ini ファイルをコピーし、アプリケーションに対して適切な値を指定して、必要に応じて Settings.ini ファイルを編集します。

Dotnetfx.exe およびホスト アプリケーションの場所の指定

Setup.exe Bootstrapper サンプルでは、Dotnetfx.exe と .NET Framework ホスト アプリケーションが、Setup.exe からの既知の相対的な場所に格納されていることを前提としています。Setup.exe Bootstrapper サンプルでは、外部ファイル Settings.ini を使用して、Dotnetfx.exe とホスト アプリケーションの場所を特定します。サンプルに付属している Settings.ini ファイルをコピーし、目的の .NET Framework ホスト アプリケーションと Dotnetfx.exe の場所を指すようにファイルを編集します。

以下に示す Settings.ini ファイルの例では、.NET Framework ホスト アプリケーション用の Windows インストーラ パッケージ (mySetup.msi) と Dotnetfx.exe がさまざまな場所にある場合を想定して、それぞれの場所を Setup.exe の場所から相対的に指定する方法を示しています。

次の Settings.ini ファイルの例では、Setup.exe と同じフォルダに mySetup.msi と Dotnetfx.exe があります。アポストロフィ (') は、カスタマイズしない行をコメント アウトするために使用されています。

[Bootstrap]
Msi=mySetup.msi
'LanguageDirectory=
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

次の Settings.ini ファイルの例では、Setup.exe の場所から離れたネットワーク共有に mySetup.msi と Dotnetfx.exe があります。

[Bootstrap]
Msi=\\myNetworkShare\myProjectFolder\mySetup.msi
'LanguageDirectory=
ProductName=My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=\\myNetworkShare\myProjectFolder\

次の Settings.ini ファイルの例では、mySetup.msi と Dotnetfx.exe は Setup.exe と同じコンピュータ上にありますが、フォルダが異なります。

[Bootstrap]
Msi=c:\myInstallerFiles\mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myExecutables\

次の Settings.ini ファイルの例では、mySetup.msi と Dotnetfx.exe は Setup.exe と同じ CD に収録されていますが、フォルダが異なります。

[Bootstrap]
Msi=myInstallerFiles/mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=myExecutables/

言語バージョンの指定

Setup.exe で .NET Framework のビルド番号と言語バージョンを確認する場合は、確認する言語のカルチャ名を Settings.ini ファイルで指定する必要があります。カルチャ名を指定しない場合、Setup.exe は既定で英語バージョンを確認します。

Settings.ini ファイルで指定するカルチャ名に対応する利用可能な言語バージョンの一覧を次の表に示します。カルチャ名では大文字と小文字は区別されません。

言語

カルチャ名

簡体字中国語

chs

繁体字中国語

cht

フランス語

fr

ドイツ語

de

イタリア語

it

日本語

ja

韓国語

ko

スペイン語

es

フランス語バージョンの Dotnetfx.exe をチェックするように Setup.exe に指示する Settings.ini ファイルの例を次に示します。

[Bootstrap]
Msi=mySetup.msi
LanguageDirectory=fr
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

Setup.exe のダイアログ ボックスの文字列のカスタマイズ

Settings.ini ファイルの次の変数を編集して、Setup.exe のダイアログ ボックスに表示される文字列をカスタマイズできます。

  • ProductName は、Setup.exe によってインストールされる .NET Framework アプリケーションの名前を指定します。指定した製品名は、Setup.exe の起動後に表示されるダイアログ ボックスのテキストをカスタマイズするために使用されます。たとえば、ProductName として My Application を指定すると、ダイアログ ボックスには "To start My Application Setup, click OK. To quit without installing, click Cancel." というテキストが表示されます。

    CaptionText 変数をカスタマイズしなかった場合は、Setup.exe の起動後に表示されるダイアログ ボックスのタイトル バーも ProductName によってカスタマイズされます。たとえば、ProductName として My Application を指定すると、タイトル バーに "My Application Setup" と表示されます。ProductName と CaptionText の両方をカスタマイズした場合は、CaptionText がダイアログ ボックスのタイトル バーのカスタマイズに使用されます。

    ProductName は、アプリケーションのインストールが完了したときに表示される、正常終了を示すダイアログ ボックスのタイトル バーをカスタマイズする場合にも使用されます。ProductName をカスタマイズしなかった場合は、既定のテキスト "Application Setup" が表示されます。

  • DialogText は、Setup.exe の起動後に表示されるダイアログ ボックスに表示するカスタム テキストを指定します。DialogText をカスタマイズしなかった場合は、既定のテキスト "To start Application Setup, click OK. To quit without installing, click Cancel." が表示されます。

  • CaptionText は、Setup.exe の起動後に表示されるダイアログ ボックスのタイトル バーに表示するカスタム テキストを指定します。CaptionText をカスタマイズしなかった場合は、ProductName が表示されます。ProductName をカスタマイズしない場合は、既定のテキスト "Application Setup" が表示されます。

  • ErrorCaptionText は、Setup.exe のエラー ダイアログ ボックスのタイトル バーに表示するカスタム テキストを指定します。ErrorCaptionText をカスタマイズしなかった場合は、既定のテキスト "Application Setup Error" が表示されます。

セットアップ プログラムの Readme ファイルの作成

セットアップ プログラムと共に、セットアップ プログラムを正常に実行するためのコンピュータの最小構成要件を示す Readme ファイルを配布することをお勧めします。インストールの最小構成要件として、Internet Explorer 5.01 以降がインストールされた Microsoft Windows 98 を指定します。また、MDAC (Microsoft Data Access Components) Version 2.6 以降も指定してください。これはインストールには必要ありませんが、データ アクセスを含む .NET Framework アプリケーションで必要になることを示す必要があります。Dotnetfx.exe をインストールするための最小構成要件の詳細については、「最低構成要件」を参照してください。

参照

概念

.NET Framework アプリケーションと Dotnetfx.exe をインストールするための単一のセットアップ プロジェクトの作成

Setup.exe Bootstrapper サンプルの操作

Dotnetfx.exe の最低構成要件

その他の技術情報

.NET Framework の再頒布