チュートリアル : Windows ベースのアプリケーションの配置
このチュートリアルでは、メモ帳を開始する Windows ベース アプリケーションのインストーラーの作成手順を示します。 このチュートリアルでは、Windows ベースのアプリケーションを作成します。 その後、ショートカットとファイルの関連付けのセットアップ、レジストリへのエントリの追加、カスタム ダイアログ ボックスの表示、および Internet Explorer のバージョン確認をインストール時に行うインストーラーを作成します。
独自のインストーラーを作成する場合、これらの手順の一部は必須ではありません。 このチュートリアルは、便利な配置機能を紹介することを目的としています。 基本的なインストーラーを作成するには、最初の 4 段階の作業を行ってください。
注意
お使いのマシンで、Visual Studio ユーザー インターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。 これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。 詳細については、「Visual Studio の設定」を参照してください。
注意
以下の手順は、Visual Basic プロジェクトを使用して配置プロジェクトを作成する方法を示しています。 この一般原則は、Windows ベースのアプリケーションの配置をサポートするすべての言語の Visual Studio プロジェクトに適用されます。
Basic アプリケーションの作成および配置
Windows ベースのアプリケーションを作成するには
[ファイル] メニューの [新しいプロジェクト] をクリックします。
[新しいプロジェクト] ダイアログ ボックスで、[プロジェクトの種類] ペインの [Visual Basic プロジェクト] をクリックし、[テンプレート] ペインの [Windows アプリケーション] をクリックします。 [プロジェクト名] ボックスに「My Notepad」と入力します。
[OK] をクリックし、ダイアログ ボックスを閉じます。
プロジェクトがソリューション エクスプローラーに追加され、Windows フォーム デザイナーが表示されます。
ツールボックスの [すべての Windows フォーム] タブをクリックし、Button コントロールをフォームにドラッグします。
Button コントロールをダブルクリックしてボタンのイベント ハンドラーを追加します。 イベント ハンドラーに次のコードを追加します。
Shell("Notepad.exe", AppWinStyle.NormalFocus)Notepad.exe が開始し、フォーカスが Notepad.exe に移ります。
[ビルド] メニューの [My Notepad のビルド] をクリックしてアプリケーションをビルドします。
配置プロジェクトを作成するには
[ファイル] メニューの [追加] をポイントし、[新しいプロジェクト] をクリックします。
[新しいプロジェクトの追加] ダイアログ ボックスで、[プロジェクトの種類] ペインの [その他のプロジェクトの種類] ノードを開き、[セットアップ/配置プロジェクト] をクリックします。次に、[Visual Studio インストーラー] をクリックし、[セットアップ プロジェクト] をクリックします。 [プロジェクト名] ボックスに「My Notepad Installer」と入力します。
[OK] をクリックし、ダイアログ ボックスを閉じます。
プロジェクトがソリューション エクスプローラーに追加され、ファイル システム エディターが表示されます。
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [プロパティ] ウィンドウで ProductName プロパティを選択し、「My Notepad」と入力します。
注意
ProductName プロパティは、フォルダー名および [アプリケーションの追加と削除] ダイアログ ボックスに表示されることになるアプリケーション名を指定します。
Windows ベースのアプリケーションをインストーラーに追加するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 ファイル システム エディターで、[アプリケーション フォルダー] ノードを右クリックします。
[プロジェクト] メニューの [追加] をポイントし、[プロジェクト出力] をクリックします。
[プロジェクト出力グループの追加] ダイアログ ボックスの [プロジェクト] ボックスの一覧から、[My Notepad] を選択します。
リストの [プライマリ出力] グループをクリックします。 [構成] ボックスの [(アクティブ)] をクリックします。 [OK] をクリックし、ダイアログ ボックスを閉じます。
[ビルド] メニューの [My Notepad Installer のビルド] をクリックします。
アプリケーション (基本的なインストーラー) を配置するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [プロジェクト] メニューの [インストール] をクリックします。
インストーラー (セットアップ ウィザード) が実行され、開発コンピューターに My Notepad がインストールされます。
注意
インストーラーを実行するには、コンピューター上でインストールを実行する権限が必要です。
オプションの配置機能
ここでは、インストール時にターゲット コンピューターのデスクトップ上に配置されるアプリケーションへのショートカットを作成する、オプションの配置機能について説明します。
Windows ベースのアプリケーションのショートカットを作成するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。
ファイル システム エディターで、[My Notepad の プライマリ出力] ノードを選択します。
[操作] メニューの [My Notepad のプライマリ出力へのショートカットを作成] をクリックします。
[My Notepad の プライマリ出力 へのショートカット] という名前のノードが追加されます。
ショートカットの名前を [My Notepad へのショートカット] に変更します。
[My Notepad へのショートカット] をクリックし、左ペインの [ユーザーのデスクトップ] フォルダーまでドラッグします。
ファイルの関連付けの作成
この手順では、.vbn ファイルをダブルクリックすると My Notepad アプリケーションが起動するように、My Notepad のファイルの関連付けを追加します。
Windows ベースのアプリケーションのファイルの関連付けを作成するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [表示] メニューの [エディター] をポイントし、[ファイルの種類] をクリックします。 ファイルの種類エディターが表示されます。
ファイルの種類エディターで、[対象コンピューター上のファイルの種類] ノードを選択します。 [操作] メニューの [ファイルの種類の追加] をクリックします。
[新しいドキュメントの種類 #1] という名前のノードが追加されます。このノードは、名前を変更できるように開かれています。
[新しいドキュメントの種類 #1] を [Vbn.doc] に変更します。
[プロパティ] ウィンドウで、ファイルの種類の Extensions プロパティを vbn に設定します。
Command プロパティを選択し、省略記号 ([...]) ボタンをクリックします。 [プロジェクトから項目を選択] ダイアログ ボックスで、[アプリケーション フォルダー] に移動し、[My Notepad の プライマリ出力] をクリックします。
[OK] をクリックし、ダイアログ ボックスを閉じます。
レジストリ エントリの追加
この手順では、レジストリにレジストリのキーと値を追加します。 アプリケーションのコードからこのレジストリ キーを参照し、実行時にユーザー固有の情報を取得できます。
Windows ベースのアプリケーションのレジストリ エントリを追加するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [表示] メニューの [エディター] をポイントし、[レジストリ] をクリックします。 レジストリ エディターが表示されます。
レジストリ エディターで、[HKEY_CURRENT_USER] ノードをクリックして展開し、次に [Software] ノードを展開して [Manufacturer] ノードを選択します。
注意
[Manufacturer] ノードは角かっこで囲まれて表示されますが、これは、プロパティであることを示しています。 これは、配置プロジェクトの Manufacturer プロパティに入力される値で置換されます。
[操作] メニューの [新規作成] をポイントし、[キー] をクリックします。
キーの名前を [UserChoice] に変更し、それを選択します。
[操作] メニューの [新規作成] をポイントし、[文字列の値] をクリックします。
文字列値を [TextColor] に変更します。
[プロパティ] ウィンドウで、Value プロパティを選択し、「Black」と入力します。
カスタム インストール ダイアログ ボックスの追加
この手順では、インストール時に表示するカスタムのユーザー インターフェイス ダイアログ ボックスを追加し、構成します。
カスタム インストール ダイアログ ボックスを追加するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [表示] メニューの [エディター] をポイントし、[ユーザー インターフェイス] をクリックします。 ユーザー インターフェイス エディターが表示されます。
ユーザー インターフェイス エディターで、[インストール] ノードの下の [開始] ノードを選択します。
[操作] メニューの [ダイアログの追加] をクリックします。
[ダイアログの追加] ダイアログ ボックスの [チェックボックス (A)] をクリックします。
[OK] をクリックし、ダイアログ ボックスを閉じます。
[チェックボックス (A)] ダイアログ ボックスを右クリックして**[上へ移動]** をクリックを 2 回行って、[インストール フォルダー] ダイアログ ボックスの上に配置します。
[プロパティ] ウィンドウで、BannerText プロパティを Samples に設定します。
BodyText プロパティを次のように設定します。
[Install Samples] チェック ボックスは、サンプル ファイルをインストールするかどうかを制御します。 オフの場合、サンプルはインストールされません。
CheckBox1Label プロパティを Install samples? に設定します。
Checkbox2Visible、Checkbox3Visible、および Checkbox4Visible プロパティを False に設定します。 これによって、追加のチェック ボックスが非表示になります。
サンプルの使用
この手順では、アプリケーション フォルダーの下にインストールされる Samples サブフォルダーを作成します。
Samples フォルダーを追加するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [表示] メニューの [エディター] をポイントし、[ファイル システム] をクリックします。 [アプリケーション フォルダー] が選択されていない場合は、選択します。
[アプリケーション フォルダー] を右クリックして [追加] をポイントし、[フォルダー] をクリックします。
[新しいフォルダー #1] を [Samples] に変更します。
この手順では、ユーザーがカスタム ダイアログ ボックスの [Install samples] オプションを選択するとインストールされる、2 つのサンプル テキスト ファイルを作成します。
アプリケーションのサンプル ファイルを作成するには
メモ帳などのテキスト エディターを使用して、"This is rules.vbn." というテキストが含まれるテキスト ファイルを作成します。 これを Rules.vbn という名前で保存します。
注意
メモ帳が .txt 拡張子を自動的に追加しないように、[ファイルの種類] リストの [すべてのファイル] をクリックします。
"This is memo.vbn." というテキストが含まれる別のテキスト ファイルを作成します。 これを Memo.vbn という名前で保存します。
この手順では、Samples フォルダーにサンプル ファイルを追加し、ファイルをインストールするかどうかを確認するための条件を設定します。
インストーラーにサンプルを追加するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [表示] メニューの [エディター] をポイントし、[ファイル システム] をポイントして [Samples] フォルダーをクリックします。
[操作] メニューの [追加] をポイントし、[ファイル] をクリックします。 Rules.vbn ファイルと Memo.vbn ファイルを [Samples] フォルダーに追加します。
ファイル システム エディターで Rules.vbn ファイルを選択します。
[プロパティ] ウィンドウで、Condition プロパティを CHECKBOXA1=1 に設定します。 インストーラーの実行時にカスタム チェック ボックスがオンの場合のみ、Rules.vbn ファイルがインストールされます。
ファイル システム エディターで Memo.vbn ファイルを選択します。
[プロパティ] ウィンドウで、Condition プロパティを CHECKBOXA1=1 に設定します。 インストーラーの実行時にカスタム チェック ボックスがオンの場合のみ、Memo.vbn ファイルがインストールされます。
起動条件の追加
この手順では、ターゲット コンピューターに Internet Explorer 5.0 以降のバージョンの Internet Explorer がインストールされているかどうかを確認し、該当するファイルがインストールされていなければインストールを中止します。
Internet Explorer のバージョンを確認する起動条件を追加するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [表示] メニューの [エディター] をポイントし、[起動条件] をクリックします。
注意
この手順は、起動条件の概念を示すためだけに用意されています。My Notepad アプリケーションは、実際には Internet Explorer に依存しません。
起動条件エディターで、[対象コンピューター上の必要条件] ノードを選択します。
[操作] メニューの [ファイルの起動条件の追加] をクリックします。
[対象コンピューターの検索] ノードの下に [ファイル 1 の検索] ノードが追加され、[起動条件] ノードの下に [条件 1] ノードが追加されます。
[ファイル 1 の検索] を [Internet Explorer の検索] に変更します。
[プロパティ] ウィンドウで、FileName プロパティを Iexplore.exe、Folder プロパティを [ProgramFilesFolder]、Depth プロパティを 2、MinVersion プロパティを 5.00 にそれぞれ設定します。
[条件 1] ノードを選択します。
Message プロパティを次のように設定します。
このプログラムを使用するには、Microsoft Internet Explorer 5.0 以降が必要です。 Internet Explorer をインストールして、メモ帳インストーラーを再実行してください。
必須コンポーネントのプロパティの設定
この手順では、ターゲット コンピューターに .NET Framework の正しいバージョンがない場合に、.NET Framework を自動的にインストールするためのプロパティを設定します。 .NET Framework 2.0 パッケージをインストールすると、Windows インストーラー 2.0 のファイルもインストールされます。
必須コンポーネントのプロパティが以下のように設定されている場合、setup.exe をクリックすると、.msi ファイルが実行される前に .NET Framework が自動的にインストールされます (これは既定で設定されています)。 必須コンポーネントの指定の詳細については、「[必須コンポーネント] ダイアログ ボックス」を参照してください。
配置プロジェクトの省略可能プロパティを設定するには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [表示] メニューの [プロパティ ページ] をクリックします。
[My Notepad Installer プロパティ ページ] ダイアログ ボックスの [インストールの URL] に、アプリケーションまたは必須コンポーネントのインストール元であるサーバーまたは Web サイトの URL を指定します。 [必須コンポーネント] をクリックします。
[必須コンポーネント] ダイアログ ボックスの [インストールする必須コンポーネントを選択する] で、[.NET Framework] がオンになっていることを確認します (これは既定で選択されているはずです)。 [必須コンポーネントのインストール場所を指定してください] の既定の設定値をそのまま使用します。
[ビルド] メニューの [My Notepad Installer のビルド] をクリックします。
開発用コンピューターへのインストール
インストーラーを実行し、開発用コンピューターに My Notepad をインストールします。
開発用コンピューターに My Notepad をインストールするには
ソリューション エクスプローラーで My Notepad Installer プロジェクトを選択します。 [プロジェクト] メニューの [インストール] をクリックします。
注意
インストーラーを実行するには、コンピューター上でインストールを実行する権限が必要です。
他のコンピューターへの配置
インストーラーを実行し、他のコンピューターに My Notepad をインストールします。
ほかのコンピューターに My Notepad を配置するには
Windows のエクスプローラーで、プロジェクト ディレクトリに移動し、ビルドされたインストーラーを探します。 既定のパスは \Documents and Settings\yourloginname\My Documents\Visual Studio 9.0\Projects\Solution Folder Name\My Notepad Installer\project configuration\My Notepad Installer.msi です。 (既定の project configuration は Debug または Release です。)
My Notepad Installer.msi、Setup.exe、およびディレクトリ内の他のファイルとサブディレクトリをすべて別のコンピューターにコピーします。
注意
ネットワークに接続していないコンピューターにインストールするには、ファイルを CD-ROM などの従来のメディアにコピーしてください。
ターゲット コンピューターで、Setup.exe をダブルクリックしてインストーラーを実行します。
注意
インストーラーを実行するには、ターゲット コンピューター上でインストールを実行する権限が必要です。
テスト
この手順では、デスクトップ ショートカットからのアプリケーションの起動をテストし、そのアンインストールもテストします。
インストールをテストするには
デスクトップにショートカットが作成され、ショートカットから My Notepad アプリケーションが正しく起動されるかどうかを確認します。
コントロール パネルの [プログラムの追加と削除] を使用して、アプリケーションをアンインストールします。 [プログラムの追加と削除] で、[My Notepad] を選択し、[変更と削除] ボタンをクリックします。
注意
開発用コンピューターからアプリケーションをアンインストールするには、[プロジェクト] メニューの [アンインストール] をクリックします。
デスクトップからアイコンが削除され、インストールされたアプリケーションのファイルとフォルダーがコンピューターから削除されます。