チュートリアル : マージ モジュールを使用した共有コンポーネントのインストール

マージ モジュール (.msm) は、複数のアプリケーションによって共有されるコンポーネントをインストールするときに使用します。このようなコンポーネントには、開発者がアプリケーションで使用する DLL、コントロール、リソースなどがあります。 これに対し、Windows インストーラー (.msi) は、アプリケーションおよびファイルをインストールするときに使用します。このようなファイルには、一般にアプリケーションのエンド ユーザーが使用する、実行可能ファイル、ドキュメント、HTML ページなどがあります。

マージ モジュールを使用して共有コンポーネントをパッケージ化し、配布すると、一貫性のある配置を行うことができます。 モジュールの再ターゲット可能フォルダーを使用すると、アプリケーションと同じディレクトリにファイルを配置できます。ただし、スタート メニューなどの別のディレクトリにファイルを配置することもできます。

このチュートリアルでは、コンポーネントをマージ モジュールにパッケージ化する方法と、セットアップ プロジェクトでそのマージ モジュールを使用する方法を示します。

注意

お使いのマシンで、Visual Studio ユーザー インターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。 これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。 詳細については、「Visual Studio の設定」を参照してください。

コンポーネントを作成するには

  1. [ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。

  2. [新しいプロジェクト] ダイアログ ボックスで、プロジェクトの種類ペインの [Visual C# プロジェクト] をクリックし、テンプレート ペインの [クラス ライブラリ] をクリックします。 [プロジェクト名] ボックスに「MyComponent」と入力します。

  3. [OK] をクリックし、ダイアログ ボックスを閉じます。

  4. [ビルド] メニューの [MyComponent のビルド] をクリックして、クラス ライブラリをビルドします。

マージ モジュール プロジェクトを作成するには

  1. [ファイル] メニューの [追加] をポイントし、[新しいプロジェクト] をクリックします。

  2. [新しいプロジェクトの追加] ダイアログ ボックスで、[その他のプロジェクトの種類] を選択し、プロジェクトの種類ペインの [セットアップ/配置プロジェクト] をクリックします。次に、[Visual Studio インストーラー] を選択し、テンプレート ペインの [マージ モジュール プロジェクト] をクリックします。 [プロジェクト名] ボックスに「Sample」と入力します。

  3. [OK] をクリックし、ダイアログ ボックスを閉じます。

  4. ファイル システム エディターで、[モジュールの再ターゲット可能フォルダー] を選択します。 [操作] メニューの [追加] をポイントし、[プロジェクト出力] をクリックします。

  5. [プロジェクト出力グループの追加] ダイアログ ボックスで、MyComponent プロジェクトの [プライマリ出力] を選択します。 [OK] をクリックし、ダイアログ ボックスを閉じます。

  6. [ビルド] メニューの [Sample のビルド] をクリックして、マージ モジュールをビルドします。

マージ モジュールを使用するセットアップ プロジェクトを追加するには

  1. [ファイル] メニューの [追加] をポイントし、[新しいプロジェクト] をクリックします。

  2. [新しいプロジェクトの追加] ダイアログ ボックスで、プロジェクトの種類ペインの [セットアップ/配置プロジェクト] をクリックし、テンプレート ペインの [セットアップ プロジェクト] をクリックします。 [プロジェクト名] ボックスに「Merge Module Installer」と入力します。

  3. [OK] をクリックし、ダイアログ ボックスを閉じます。

  4. ファイル システム エディターで、[アプリケーション フォルダー] を選択します。 [操作] メニューの [追加] をポイントし、[プロジェクト出力] をクリックします。

  5. [プロジェクト出力グループの追加] ダイアログ ボックスで、Sample プロジェクトを選択し、[マージ モジュール] を選択します。

  6. [OK] をクリックし、ダイアログ ボックスを閉じます。

    マージ モジュール ([Sample (アクティブ) のマージ モジュール]) はフォルダーには追加されません。 ソリューション エクスプローラーMerge Module Installer プロジェクトに追加されます。 これは、マージ モジュールを直接インストールできないためです。マージ モジュールは、インストーラーにマージする必要があります。

  7. ソリューション エクスプローラーでマージ モジュールを選択します。 [プロパティ] ウィンドウで、[KeyOutput] ノードを展開し、[(マージモジュールのプロパティ)] ノードを展開して、[モジュールの再ターゲット可能フォルダー] プロパティを選択します。

    注意

    [KeyOutput] プロパティの下のプロパティは、マージ モジュールがビルドされるまで表示されない動的プロパティです。

  8. [モジュールの再ターゲット可能フォルダー] プロパティのドロップダウン リストをクリックし、[(参照...)] をクリックして [フォルダーの選択] ダイアログ ボックスを表示します。

  9. [フォルダーの選択] ダイアログ ボックスの [アプリケーション フォルダー] を選択します。 [OK] をクリックし、ダイアログ ボックスを閉じます。

  10. [ビルド] メニューの [Merge Module Installer のビルド] をクリックします。

開発用コンピューターにインストールするには

  • ソリューション エクスプローラーで、Merge Module Installer プロジェクトを選択します。 [プロジェクト] メニューの [インストール] をクリックします。

    インストーラーが実行し、開発用コンピューターに Merge Module Installer をインストールします。 このインストーラーが、アプリケーション ディレクトリにマージ モジュールのコンポーネントをインストールします。

    注意

    インストーラーを実行するには、コンピューター上でインストールを実行する権限が必要です。

ほかのコンピューターに配置するには

  1. Windows エクスプローラーで、プロジェクト ディレクトリに移動し、ビルドされたインストーラーを探します。 既定の project configuration は、Debug または Release です。

  2. Merge Module Installer.msi ファイル、Setup.exe ファイル、およびディレクトリ内の他のファイルとサブディレクトリをすべて別のコンピューターにコピーします。

    注意

    ネットワークに接続していないコンピューターにインストールするには、ファイルを CD-ROM などの従来のメディアにコピーしてください。

    ターゲット コンピューターで、Setup.exe ファイルをダブルクリックしてインストーラーを実行します。

    注意

    インストーラーを実行するには、ターゲット コンピューター上でインストールを実行する権限が必要です。

アプリケーションをアンインストールするには

  1. Windows の [コントロール パネル][アプリケーションの追加と削除] をダブルクリックします。

  2. [アプリケーションの追加と削除] ダイアログ ボックスで [Merge Module Installer] をクリックし、[削除] をクリックします。

  3. [OK] をクリックし、ダイアログ ボックスを閉じます。

    ヒント

    開発用コンピューターからアンインストールするには、Visual Studio の [プロジェクト] メニューの [アンインストール] をクリックします。

参照

参照

マージ モジュールの動的プロパティ

その他の技術情報

Visual Studio インストーラーの配置

Windows インストーラー パッケージのカスタマイズ