Exemplarische Vorgehensweise: Installieren von freigegebenen Komponenten mithilfe von Mergemodulen

Aktualisiert: November 2007

Mergemodule (MSM) werden zum Installieren von Komponenten verwendet, die von mehreren Anwendungen gemeinsam genutzt werden, z. B. von Entwicklern in Anwendungen verwendete Komponenten (beispielsweise DLL-Dateien, Steuerelemente, Ressourcen). Im Gegensatz dazu werden Windows-Installationsprogramme (MSI) zum Installieren von Anwendungen und Dateien (z. B. ausführbare Dateien, Dokumente, HTML-Seiten) verwendet. Diese werden in der Regel vom Endbenutzer der Anwendung verwendet.

Mithilfe von Mergemodulen kann sichergestellt werden, dass freigegebene Komponenten zur konsistenten Bereitstellung gepackt und verteilt werden. Weitere Informationen über Mergemodule erhalten Sie unter Installationsprogramm und Mergemodulempfehlungen.

Diese exemplarische Vorgehensweise veranschaulicht das Verpacken einer Komponente in einem Mergemodul und die Verwendung dieses Mergemoduls in einem Setupprojekt.

Hinweis:

Je nach den aktiven Einstellungen oder der verwendeten Version können sich die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen unterscheiden. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen hierzu finden Sie unter Visual Studio-Einstellungen.

So erstellen Sie eine Komponente

  1. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  2. Wählen Sie im Dialogfeld Neues Projekt aus dem Bereich Projekttyp den Eintrag Visual C#-Projekte. Wählen Sie anschließend aus dem Bereich Vorlagen den Eintrag Klassenbibliothek. Geben Sie im Feld Name die Zeichenfolge MyComponent ein.

  3. Klicken Sie auf OK, um das Dialogfeld zu schließen.

  4. Wählen Sie im Menü Erstellen die Option MyComponent erstellen, um die Klassenbibliothek zu erstellen.

So erstellen Sie ein Mergemodulprojekt

  1. Zeigen Sie im Menü Datei auf Hinzufügen, und wählen Sie Neues Projekt.

  2. Wählen Sie im Dialogfeld Neues Projekt hinzufügen aus dem Bereich Projekttyp den Eintrag Setup- und Bereitstellungsprojekte. Wählen Sie anschließend aus dem Bereich Vorlagen den Eintrag Mergemodulprojekt. Geben Sie im Feld Name die Zeichenfolge Sample ein.

  3. Klicken Sie auf OK, um das Dialogfeld zu schließen.

  4. Wählen Sie im Dateisystem-EditorAlternativer Modulzielordner aus. Zeigen Sie im Menü Aktion auf Hinzufügen, und wählen Sie anschließend Projektausgabe.

  5. Wählen Sie im Dialogfeld Projektausgabegruppe hinzufügen die Primäre Ausgabe für das Projekt Eigene Komponente. Klicken Sie auf OK, um das Dialogfeld zu schließen.

  6. Wählen Sie im Menü Erstellen die Option Sample erstellen, um das Mergemodul zu erstellen.

So fügen Sie ein Setupprojekt hinzu, das das Mergemodul verwendet

  1. Zeigen Sie im Menü Datei auf Hinzufügen, und klicken Sie auf Neues Projekt.

  2. Wählen Sie im Dialogfeld Neues Projekt hinzufügen aus dem Bereich Projekttyp den Eintrag Setup- und Bereitstellungsprojekte. Wählen Sie anschließend aus dem Bereich Vorlagen den Eintrag Setup-Projekt. Geben Sie im Feld Name die Zeichenfolge Merge Module Installer ein.

  3. Klicken Sie auf OK, um das Dialogfeld zu schließen.

  4. Wählen Sie im Dateisystem-Editor den Anwendungsordner aus. Zeigen Sie im Menü Aktion auf Hinzufügen, und wählen Sie anschließend Projektausgabe.

  5. Wählen Sie im Dialogfeld Projektausgabegruppe hinzufügen das Projekt Beispiel aus, und wählen Sie dann Mergemodul aus.

  6. Klicken Sie auf OK, um das Dialogfeld zu schließen.

    Beachten Sie, dass das Mergemodul (Mergemodul aus Beispiel (Aktiv)) nicht zum Ordner hinzugefügt wird. Es wird dem Mergemodul-Installationsprogramm-Projekt im Projektmappen-Explorer hinzugefügt. Dies hat den Grund, dass Mergemodule nicht direkt installiert werden können; sie müssen mit einem Installationsprogramm zusammengeführt werden.

  7. Wählen Sie das Mergemodul im Projektmappen-Explorer aus. Erweitern Sie im Eigenschaftenfenster den KeyOutput-Knoten, erweitern Sie dann den (Mergemoduleigenschaften)-Knoten, und wählen Sie die Module Retargetable Folder-Eigenschaft aus.

    Hinweis:

    Die Eigenschaften unter der KeyOutput-Eigenschaft sind dynamische Eigenschaften, die erst in Erscheinung treten, wenn das Mergemodul erstellt worden ist.

  8. Klicken Sie auf die Dropdownliste für die Module Retargetable Folder-Eigenschaft, wählen Sie (Durchsuchen…) aus, um das Dialogfeld Ordner auswählen anzuzeigen.

  9. Wählen Sie im Dialogfeld Ordner auswählen den Eintrag Anwendungsordner aus. Klicken Sie auf OK, um das Dialogfeld zu schließen.

  10. Wählen Sie im Menü Erstellen die Option Merge Module Installer erstellen.

So installieren Sie auf dem Entwicklungscomputer

  • Wählen Sie das Mergemodul-Installationsprogramm-Projekt im Projektmappen-Explorer aus. Klicken Sie im Menü Projekt auf Installieren.

    Dadurch wird das Installationsprogramm ausgeführt und das Mergemodul-Installationsprogramm auf dem Entwicklungscomputer installiert. Das Installationsprogramm installiert die im Mergemodul enthaltene Komponente im Anwendungsverzeichnis.

    Hinweis:

    Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Computer.

So geben Sie an einen anderen Computer weiter

  1. Navigieren Sie im Windows Explorer zu dem Projektverzeichnis, und suchen Sie das erstellte Installationsprogramm. Der Standardpfad lautet \Dokumente und Einstellungen\Ihr Anmeldename\Eigene Dateien\Visual Studio 2005\Projects\Name des Projektmappenordners\My Notepad Installer\Projektkonfiguration\My Notepad Installer.msi. Die standardmäßige Projektkonfiguration lautet entweder Debug oder Release.

  2. Kopieren Sie Merge Module Installer.msi, Setup.exe und alle anderen Dateien und Unterverzeichnisse im Verzeichnis auf einen anderen Computer.

    Hinweis:

    Wenn Sie die Installation auf einem Computer durchführen möchten, der nicht mit einem Netzwerk verbunden ist, kopieren Sie die Dateien auf ein Medium, beispielsweise eine CD-ROM.

    Doppelklicken Sie auf dem Zielcomputer auf die Datei Setup.exe, um das Installationsprogramm auszuführen.

    Hinweis:

    Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Zielcomputer.

So deinstallieren Sie die Anwendung

  1. Doppelklicken Sie in der Windows-Systemsteuerung auf das Symbol Software.

  2. Wählen Sie im Dialogfeld Software die Anwendung Mergemodul-Installationsprogramm aus, und klicken Sie auf Entfernen.

  3. Klicken Sie auf OK, um das Dialogfeld zu schließen.

    Tipp:

    Für die Deinstallation auf dem Entwicklungscomputer klicken Sie im Menü Projekt auf Visual Studio und wählen Deinstallieren.

Siehe auch

Konzepte

Einführung in Mergemodule

Installationsprogramm und Mergemodulempfehlungen

Alternative Mergemodule