Visual Studio .NET によるアプリケーションと .NET Framework の配布

Microsoft Corporation

January 2002
日本語版最終更新日 2002 年 5 月 20 日

要約: この記事では、Microsoft Visual Studio .NET を使って、Microsoft .NET Framework アプリケーションを、.NET Framework 再頒布パッケージの Dotnetfx.exe とともに配置する方法について説明します。

注   これらのホワイトペーパーでは、dotnetfx.exe のことを、.NET Framework 用のランタイム要素を含んでいるセットアップ ファイルと呼んでいます。MSDN から "再頒布パッケージ" をダウンロードすると、dotnetredist.exe という名前のファイルが得られます。このファイルに dotnetfx.exe が含まれています。dotnetfx.exe を取り出すには、dotnetredist.exe をダブルクリックします。すると、展開したファイルをコンピュータ上に保存するよう求められます。この展開されたファイルが dotnetfx.exe です。配置の際には、この dotnetfx.exe を使用します。

自分で作成したアプリケーションと共に dotnetfx.exe を配布する場合には、Microsoft .NET Framework SDK の正規コピーを入手し、Microsoft .NET Framework SDK 使用許諾契約 ("EULA") で定義されている「本ライセンス製品」に関する全ての条件に従って、dotnetfx.exe を使用または配布することに同意する必要があります。Microsoft .NET Framework SDK の正規コピーを持っていないか、これらの条件に従うことに同意しない場合には、dotnetfx.exe を配布する許可は与えられず、dotnetfx.exe の使用は dotnetredist.exe に含まれているエンドユーザー用の使用許諾契約の条件に従うことになります。

目次

はじめに
.NET Framework 再頒布パッケージの入手方法
Visual Studio .NET の配置シナリオ
ローカライズ バージョンの Dotnetfx.exe のインストール
最小構成要件

はじめに

Microsoft® .NET Framework には、.NET Framework アプリケーションを実行するために必要な共通言語ランタイム (CLR) と Microsoft .NET Framework コンポーネントを含んでいる再配布可能なインストーラが付属しています。.NET Framework 再頒布パッケージは、スタンドアロンの実行可能ファイル Dotnetfx.exe として提供されています。.NET Framework では、Dotnetfx.exe を再配布する権利を許諾するライセンス契約が必要とされます。以前に .NET Framework SDK または Microsoft Visual Studio .NET をインストールしたか、Web から Dotnetfx.exe をダウンロードした人は、すでに Dotnetfx.exe のライセンス契約を承諾しています。

Dotnetfx.exe は、コンピュータ上で手動で起動し、インストールすることもできますし、.NET Framework アプリケーションのセットアップ プログラムの一部として起動し、インストールすることもできます。Dotnetfx.exe をインストールするためには管理者権限が必要であることに注意してください。すでに .NET Framework SDK または Microsoft Visual Studio .NET をインストールしている人は、Dotnetfx.exe をインストールする必要はありません。

この資料では、Visual Studio .NET ユーザーのための配置シナリオを扱います。Dotnetfx.exe の配置に関する詳しい情報は、「.NET Framework アプリケーション配布ガイド」 を参照してください。この Web サイトでは、.NET Framework SDK ユーザーと Visual Studio .NET ユーザーのための具体的な配置シナリオを扱ったホワイト ペーパーを含めて、配置に関する詳しい情報を提供しています。

Dotnetfx.exe をインストールするためには、最低限の構成要件が満たされている必要があります。ソフトウェアとハードウェアの要件と勧告については、「最小構成要件」を参照してください。

.NET Framework 再頒布パッケージの入手方法

Dotnetfx.exe は、Microsoft .NET Framework ダウンロード から dotnetredist.exe をダウンロードすることにより入手できます。

ユーザーにインターネットから .NET Framework をインストールさせたい場合は、.NET Framework 再頒布パッケージをポストするのではなく、Microsoft Windows Update Web サイトにアクセスするようユーザーに指示してください。

Visual Studio .NET の配置機能を使った .NET Framework の再配布

このセクションでは、Visual Studio .NET を使って、.NET Framework 再頒布パッケージ Dotnetfx.exe を配布するいくつかのシナリオについて説明します。Dotnetfx.exe は重要なランタイム コンポーネントなので、これをコンピュータにインストールするためには管理者権限が必要です。また、Dotnetfx.exe を使って .NET Framework を再配布するときには、サイレント インストールを実行することをお勧めします。

Visual Studio .NET で作成された、.NET Framework に依存するアプリケーションを配置するときには、.NET Framework がすでに対象コンピュータ上に存在している必要があります。.NET Framework は、Visual Studio .NET の配置ツールを使って作成された Windows インストーラ セットアップ パッケージに含めることはできません。これは別途インストールする必要があります。

.NET Framework アプリケーションの配置方法には、3 つの選択肢があります。

• ユーザーに対し、.NET Framework 実行可能ファイルを手動でインストールするように指示します。
• Setup.exe Bootstrapper サンプルを使って .NET Framework 再頒布パッケージ (Dotnetfx.exe) をインストールし、その後、アプリケーションのための Windows インストーラ パッケージを起動します。
• ネットワーク管理者は、電子的ソフトウェア配布ツールを使って Dotnetfx.exe を再配布することができます。詳細については、ホワイト ペーパー「.NET Framework の再配布」の「電子的ソフトウェア配布ツールを使った Dotnetfx.exe の配布」を参照してください。

注意   .NET Framework を参照するアプリケーションのデプロイメント プロジェクトは、検出された依存関係のフォルダに、自動的にマージ モジュール (dotnetfxredist_x86_xxx.msm。xxx は言語コード) を追加します。このマージ モジュールを再配布することはできません。これは、個々の .NET アセンブリがリストに表示されるのを防ぐために、プロジェクトが内部的に使用しているモジュールです。このマージ モジュールは既定で除外されており、インクルードしようと試みるとビルド エラーが発生します。

.NET Framework の手動でのインストール

.NET Framework 再頒布パッケージ Dotnetfx.exe は、.NET Framework のインストールに使用できるスタンドアロンの実行可能ファイルです。この再頒布パッケージはいくつかのソースから入手することができます (詳細については、「.NET Framework 再頒布パッケージの入手方法」を参照してください)。ただし、アプリケーションのユーザーが再頒布パッケージの入手方法とインストール方法を知っていると仮定するべきではありません。このため、デプロイメント プロジェクトを変更して、ユーザーに対する指示を追加する必要があります。

Visual Studio .NET の配置ツールを使って作成されたインストーラには、対象コンピュータ上の .NET Framework をチェックする既定の起動条件 (MsiNetAssemblySupport) が含まれています。これが見つからなかった場合、インストールは停止し、ダイアログ ボックスが次の既定のメッセージをユーザーに対して表示します: "This setup requires the .NET Framework. Please install the .NET Framework and run this setup again"。このメッセージを、アプリケーションのユーザーのためにカスタマイズされたメッセージに置き換える必要があります。

たとえば、アプリケーションが CD-ROM の形で配布される場合には、メッセージを次のように変更します: 「このセットアップには .NET Framework が必要です。この CD の NetInstall ディレクトリにあるファイル Dotnetfx.exe を実行して .NET Framework をインストールし、もう一度のこのセットアップを実行してください」

起動条件メッセージをカスタマイズするには

1. ソリューション エクスプローラで、デプロイメント プロジェクトを選択します。
2. [表示] メニューの [エディタ] をクリックし、[起動条件] をクリックします。
3. 起動条件エディタで、MsiNetAssemblySupport ノードを選択します。
4. [プロパティ] ウィンドウで、[Message] を選択し、カスタム メッセージ テキストに置き換えます。

   注   既定のメッセージは、インストーラのローカライズ バージョンに合わせて自動的に翻訳されます。テキストをカスタマイズする場合には、自分でローカライズ バージョンに翻訳する必要があります。

.NET Framework では、データ アクセスを含んでいるすべてのアプリケーションで、MDAC 2.6 またはそれ以降が必要となります。.NET Framework と同様に、MDAC はデプロイメント プロジェクトの一部としてインストールすることはできません。Microsoft は、MDAC をインストールするためのスタンドアロンの実行可能ファイル、MDAC_typ.exe を用意しています。MDAC 再頒布パッケージは Universal Data Access Web サイトから入手することができますが、アプリケーションのユーザーがこのパッケージの入手方法やインストール方法を知っていると仮定してはなりません。このため、デプロイメント プロジェクトを変更して、ユーザーのための指示を追加する必要があります。MDAC のインストールを Windows インストーラ (MSI) パッケージにカプセル化したサンプルの実行可能ファイルは、Microsoft Product Support Services Web サイトの Install DCOM and MDAC Through a Windows Installer Package からダウンロードすることができます。

アプリケーションにデータ アクセスが含まれている場合には、MDAC 2.6 以降の存在をチェックする起動条件も追加する必要があります。

MDAC のための起動条件を追加するには

1. ソリューション エクスプローラで、デプロイメント プロジェクトを選択します。[表示] メニューの [エディタ] をクリックし、[起動条件] を選択します。
2. 対象コンピュータ上の必要条件 ノードを選択します。[操作] メニューから [レジストリ起動条件の追加] を選択します。
3. RegistryEntry1 の検索 ノードを選択します。[プロパティ] ウィンドウで、RegKey プロパティを選択し、Software\Microsoft\DataAccess と入力します。
4. Root プロパティを選択し、vsdrrHKLM を選択します。
5. Value プロパティを選択し、FullInstallVer と入力します。
6. Property プロパティを選択し、MDACSEARCH と入力します。
7. 起動条件エディタ で、条件1 ノードを選択します。[プロパティ] ウィンドウで、Condition プロパティを選択し、MDACSEARCH>="2.6" を選択します。
8. Message プロパティを選択し、このアプリケーションをインストールするには、MDAC 2.6 またはそれ以降のバージョンがインストールされていなければなりません。 と入力します。MDAC は Universal Data Access Web サイトからダウンロードすることができます。

   注   メッセージ テキストは状況に合わせて変更します。たとえば、MDAC が置かれているネットワーク共有ディレクトリをポイントすることもできます。

Setup.exe Bootstrapper サンプルを使った .NET Framework のインストール

Setup.exe Bootstrapper サンプルは、.NET Framework 再頒布パッケージをインストールした後に、.NET Framework アプリケーションのための Windows インストーラ パッケージ (.msi ファイル) を起動するアプリケーションです。編集可能な設定ファイル、settings.ini が、再頒布パッケージとインストーラの位置を指定します。

Setup.exe Bootstrapper サンプルのコンパイル済みバージョンをダウンロードすることができます。これは自由に再配布してかまいません。

Setup.exe Bootstrapper サンプルを、Visual Studio .NET の配置ツールを使って作成したインストーラと組み合わせるときには、まずデプロイメント プロジェクトを変更する必要があります。デプロイメント プロジェクトには、既定で Windows インストーラ ブートストラッパが含まれています。.NET Framework 再頒布パッケージにも Windows インストーラ ブートストラッパが含まれているので、この既定のインストーラは削除することができます。

データ アクセスを含んでいる .NET Framework アプリケーションでは、Setup.exe Bootstrapper サンプルを拡張し、MDAC 再頒布パッケージ MDAC_typ.exe のサイレント インストールを行うように変更することができます。レジストリ キー HKLM\SOFTWARE\Microsoft\DataAccess の、FullInstallVer の値が 2.6 以上であるかどうかをチェックするコードを追加する必要があります。MDAC のインストールを Microsoft インストーラ (MSI) パッケージにカプセル化したサンプルの実行可能ファイルは、Install DCOM and MDAC Through a Windows Installer Package からダウンロードすることができます。

Setup.exe Bootstrapper サンプルで使用できるようにデプロイメント プロジェクトを変更するには

1. ソリューション エクスプローラで、デプロイメント プロジェクトを選択します。
2. [プロジェクト] メニューの [プロパティ] をクリックします。
3. [プロパティ ページ] ダイアログ ボックスで、Bootstrapper プロパティを選択し、これを None に設定します。

次のステップでは、デプロイメント プロジェクトをビルドし、結果として得られた.msi ファイルを配置位置 (たとえば CD-ROM 上のディレクトリやネットワーク共有ディレクトリ) にコピーします。Setup.exe Bootstrapper サンプルと設定ファイルも配置位置にコピーする必要があり、設定ファイルは配置位置を反映させて変更する必要があります。

配置位置を反映させて設定ファイルを編集するには

1. ファイル settings.ini をメモ帳などのテキスト エディタで開きます。
2. Msi=mySetup.msi エントリを探し、既定のパスを.msi ファイルへのパスに置き換えます。たとえば、mySetup.msi がローカル コンピュータ上の Setup.exe と同じフォルダに置かれている場合、パスは Msi=mySetup.msi となります。mySetup.msi がネットワーク共有ディレクトリ上の myProjectFolder という名前のフォルダに置かれている場合、パスの例は Msi=\\myNetworkShare\myProjectFolder\mySetup.msi となります。mySetup.msi が、Setup.exe と同じ CD 上の myInstallerFiles という名前のフォルダに置かれている場合、パスの例は Msi=myInstallerFiles/mySetup.msi となります。
3. FxInstallerPath=c: エントリを探し、既定のパスを、.NET Framework 再頒布パッケージ Dotnetfx.exe の正しいパスに置き換えます。たとえば、Dotnetfx.exe がローカル コンピュータ上の myProjectFolder という名前のフォルダに置かれている場合、パスは FxInstallerPath=c:\myProjectFolder\ となります。Dotnetfx.exe がネットワーク共有ディレクトリの myProjectFolder という名前のフォルダに置かれている場合、パスの例は FxInstallerPath=\\myNetworkShare\myProjectFolder\ となります。Dotnetfx.exe が、Setup.exe と同じ CD 上の myExecutables という名前のフォルダに置かれている場合、パスの例は FxInstallerPath=myExecutables/となります。
4. settings.ini ファイルを保存します。

Setup.exe Bootstrapper サンプルは、対象コンピュータにインストールされている .NET Framework のビルド番号と、インストールされるアプリケーションがホストしている .NET Framework のビルド番号を比較します。ビルド番号がマッチしなかった場合、Setup.exe はアプリケーションによってホストされているバージョンの .NET Framework をインストールします。Setup.exe に .NET Framework のビルド番号と言語バージョンをチェックさせたい場合には、settings.ini ファイルでチェックする言語を指定する必要があります。LanguageDirectory 変数で言語を指定しなかった場合、Setup.exe は既定で英語バージョンをチェックします。

次の表は、言語バージョンと、settings.ini ファイルで指定できるカルチャー名のリストを示しています。

設定ファイルを編集して、特定の言語バージョンをチェックするには

1. ファイル settings.ini をメモ帳などのテキスト エディタで開きます。
2. 'LanguageDirectory= エントリを探します。エントリのコメントを外し、チェックしたい正しい言語バージョンを指定します。たとえば、Setup.exe に .NET Framework のフランス語バージョンをチェックさせたい場合には、LanguageDirectory=fr と指定します。
3. settings.ini ファイルを保存します。

ローカライズ バージョンの Dotnetfx.exe のインストール

Dotnetfx.exe は 8 つの言語にローカライズされています。使用可能な言語の一覧については、前のセクションの表を参照してください。ローカライズ バージョンの Dotnetfx.exe は、Microsoft .NET Framework ダウンロード から dotnetredist.exe をダウンロードすることにより入手できます。

.NET Framework 再頒布パッケージの Dotnetfx.exe を Windows 98 オペレーティング システムを実行しているコンピュータにインストールするときには、そのコンピュータ上で実行されている Windows 98 のローカライズ バージョンに対応する、ローカライズ バージョンの Dotnetfx.exe をインストールする必要があります。たとえば、ドイツ語バージョンの Windows 98 を実行しているコンピュータには、ドイツ語バージョンの Dotnetfx.exe をインストールする必要があります。この制限は Windows 98 のみに適用されます。Windows Me、Windows 2000、Windows NT® 4.0、Windows XP、または Windows Server 2003 ファミリでは、どの言語バージョンであっても、任意の言語バージョンの Dotnetfx.exe をインストールすることができます。

最小構成要件

このセクションでは、.NET Framework 再頒布パッケージをインストールするコンピュータの最小構成要件について説明します。最小構成要件が満たされていない場合、Dotnetfx.exe セットアップは再頒布パッケージのインストールをブロックします。特に、Microsoft Windows 95 オペレーティング システムを実行しているコンピュータに .NET Framework 再頒布パッケージをインストールすることはできない点に注意してください。

プラットフォームとソフトウェアの要件

最小要件

Dotnetfx.exe をインストールするためには、コンピュータ上に以下のいずれかのオペレーティング システムと Microsoft Internet Explorer 5.01 以降がインストールされている必要があります。

• Microsoft Windows 98
• Microsoft Windows 98 Second Edition
• Microsoft Windows Millennium Edition (Windows Me)
• Microsoft Windows NT 4 (Workstation または Server) と Service Pack 6a
• Microsoft Windows 2000 (Professional, Server, または Advanced Server) と最新の Windows Service Pack、および Microsoft Security Web サイトから入手可能な重要なアップデート
• Microsoft Windows XP (Home または Professional)
• Microsoft Windows Server 2003 ファミリ

注意   Windows Server 2003 Beta 3 に Dotnetfx.exe をインストールすると、オペレーティング システムとともにインストールされている .NET Framework のバージョンが上書きされてしまいます。Windows Server 2003 Beta 3 は .NET Framework のバージョン 1.0.3215 をインストールします。これよりも新しいバージョンの .NET Framework をインストールすると、バージョン 1.0.3215 は上書きされます。新しいバージョンをインストールした場合には、そのバージョンを実行し、使用することができます。ただし、新しいバージョンをアンインストールしても、バージョン 1.0.3215 を使用することはできません。

推奨されるソフトウェア

アプリケーションの要件に応じて、以下のソフトウェアの 1 つまたは複数をインストールしなければならないことがあります。

• データ アクセス用の MDAC 2.6 またはそれ以降。Universal Data Access Web サイトから入手可能です。
• Windows 計測のためのコア WMI。ダウンロードセンターから入手可能です。

注   推奨されるソフトウェア要件が満たされていなくても、セットアップはインストールをブロックしたり、警告を発したりすることはありません。

推奨されるサーバー ソフトウェア

アプリケーションの要件に応じて、以下のサーバー ソフトウェアも必要になる場合があります。

• サーバー上のデータ用の MDAC 2.7。Universal Data Access Web サイトから入手可能です。
• Windows 2000、Windows XP (Professional)、および Windows Server 2003 のサーバー上の Internet Information Services (IIS)。これは ASP.NET アプリケーションを使用するときに必要となります。

ハードウェア要件

最小ハードウェア要件

* または、オペレーティング システムの実行に必要な最低限の CPU とのどちらか高い方

** または、オペレーティング システムの実行に必要な最低限の RAM とのどちらか大きい方

推奨ハードウェア要件