Exemplarische Vorgehensweise: Installieren von freigegebenen Komponenten mithilfe von Mergemodulen

  • Artikel

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. Mit dem alternativen Modulzielordner können Sie Dateien im gleichen Verzeichnis wie die Anwendung speichern. Sie können jedoch auch Dateien in anderen Verzeichnissen wie dem Startmenü speichern.

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

Tipp

Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen 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 die Option Andere Projekttypen und anschließend den Eintrag Setup- und Bereitstellungsprojekte aus. Wählen Sie dann Visual Studio Installer und im Bereich Vorlagen den Eintrag Mergemodulprojekt aus. 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-Editor Alternativer 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 Meine 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.

    Tipp

    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, und 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.

    Tipp

    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 zum Projektverzeichnis, und suchen Sie das erstellte Installationsprogramm. 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.

    Tipp

    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.

    Tipp

    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

Referenz

Dynamische Eigenschaften für Mergemodule

Weitere Ressourcen

Bereitstellung mit Visual Studio Installer

Anpassen von Windows Installer-Paketen