チュートリアル : Windows ベースのアプリケーションの配置
更新 : 2007 年 11 月
このチュートリアルでは、メモ帳を開始する Windows ベース アプリケーションのインストーラの作成手順を示します。このチュートリアルでは、Windows ベースのアプリケーションを作成します。その後、ショートカットとファイルの関連付けのセットアップ、レジストリへのエントリの追加、カスタム ダイアログ ボックスの表示、および Internet Explorer のバージョン確認をインストール時に行うインストーラを作成します。
独自のインストーラを作成する場合、これらの手順の一部は必須ではありません。このチュートリアルは、便利な配置機能を紹介することを目的としています。基本的なインストーラを作成するには、最初の 4 段階の作業を行ってください。
.gif "メモ") メモ : |
|---|
使用している設定またはエディションによっては、ヘルプの記載と異なるダイアログ ボックスやメニュー コマンドが表示される場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「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 のビルド] をクリックしてアプリケーションをビルドします。
配置プロジェクトを作成するには
[ファイル] メニューの [追加] をポイントし、[新しいプロジェクト] をクリックします。
[新しいプロジェクトの追加] ダイアログ ボックスで、[プロジェクトの種類] ペインの [その他のプロジェクトの種類] ノードを開き、[セットアップ/配置プロジェクト] をクリックします。次に、[テンプレート] ペインの [セットアップ プロジェクト] をクリックします。[プロジェクト名] ボックスに「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] を選択し、[変更と削除] ボタンをクリックします。
メモ :開発用コンピュータからアプリケーションをアンインストールするには、[プロジェクト] メニューの [アンインストール] をクリックします。
デスクトップからアイコンが削除され、インストールされたアプリケーションのファイルとフォルダがコンピュータから削除されます。