Verwenden von Automatisierung zum Zusammenführen eines Mergemoduls in einer Datenbank
Mergemodule bieten eine Standardmethode, mit der Sie freigegebene Windows Installer-Komponenten und die Setuplogik für Anwendungen bereitstellen können.
Mergemodule müssen mithilfe eines Mergetools in einem Installationspaket zusammengeführt werden. Die empfohlene Vorgehensweise ist, ein frei verteilbares Mergetool zu erhalten oder eines der Mergetools von unabhängigen Softwareherstellern zu erwerben. Beispielsweise können Sie Mergemod.dll verwenden.
Das folgende Verfahren zeigt, wie Sie ein Mergemodul mithilfe der Mergemodulautomatisierung in einer Windows Installer-Datenbank zusammenführen.
So führen Sie ein Modul in einer Datenbank zusammen
Öffnen Sie eine Protokolldatei mit der OpenLog-Methode.
Dieser Schritt ist nur erforderlich, wenn Sie eine Protokolldatei erstellen oder eine vorhandene Protokolldatei für den Mergeprozess anfügen müssen.
Öffnen Sie die MSI-Installationsdatenbank mit der OpenDatabase-Methode des Merge-Objekts.
Dieser Schritt ist erforderlich.
Die geöffnete Datenbank ist die, die das Mergemodul aufnehmen soll.
Öffnen Sie das MSM-Mergemodul mit der OpenModule-Methode.
Dieser Schritt ist erforderlich.
Dies ist das Mergemodul, das in der Datenbank zusammengeführt wird. Ein Modul muss geöffnet werden, bevor es mit einer Installationsdatenbank zusammengeführt werden kann.
Führen Sie das Modul in der Installationsdatenbank zusammen, indem Sie die Merge-Methode oder die MergeEx-Methode aufrufen.
Dieser Schritt ist erforderlich.
Die Merge-Methode bzw. die MergeEx-Methode kann nur einmal aufgerufen werden, um eine bestimmte Kombination aus MSI- und MSM-Dateien zusammenzuführen.
Hinweis
Die MergeEx-Methode ist nur in Mergemod.dll Version 2.0 oder höher und nur bei Verwendung der IMsmMerge2-Schnittstelle verfügbar.
Rufen Sie die Errors-Eigenschaft ab, und untersuchen Sie die Sammlung der zurückgegebenen Error-Objekte auf Mergekonflikte oder andere Fehler.
Sie müssen alle Fehler beheben.
Der Abruf ist nicht destruktiv, und mehrere Instanzen der Fehlersammlung können durch wiederholtes Lesen der Errors-Eigenschaft abgerufen werden.
Ordnen Sie die Komponenten des Mergemoduls mit der Connect-Methode den Features zu.
Dieser Schritt ist nur erforderlich, wenn Sie bereits über Features verfügen und Features in der Installationsdatenbank zusammenführen möchten.
Bevor Sie diese Methode aufrufen, muss ein Feature vorhanden sein. Weitere Informationen finden Sie unter Verbinden eines Mergemoduls mit mehreren Features.
Extrahieren Sie bei Bedarf mithilfe der folgenden Aktionen Quelldateien aus dem Modul:
Verwenden Sie ExtractFiles oder ExtractFilesEx, um Dateien aus einer eingebetteten CAB-Datei zu extrahieren und dann in ein angegebenes Verzeichnis zu kopieren.
Hinweis
Für ExtractFilesEx ist Mergemod.dll Version 2.0 oder höher erforderlich.
Verwenden Sie ExtractCAB, um Dateien aus einer eingebetteten CAB-Datei zu extrahieren und dann in einer angegebenen Datei zu speichern.
Verwenden Sie CreateSourceImage, um Dateien aus einem Modul zu extrahieren und dann nach dem Zusammenführen in ein Quellimage auf dem Datenträger zu kopieren.
Hinweis
CreateSourceImage ist nur in Mergemod.dll Version 2.0 oder höher verfügbar.
Schließen Sie das derzeit geöffnete Mergemodul mit der CloseModule-Methode.
Dieser Schritt ist erforderlich.
Schließen Sie die geöffnete Installationsdatenbank mit der CloseDatabase-Methode.
Dieser Schritt ist erforderlich.
Beim Schließen einer Datenbank werden alle Abhängigkeitsinformationen gelöscht, es wirkt sich jedoch nicht auf nicht abgerufene Fehler aus.
Schließen Sie die aktuelle Protokolldatei mit der CloseLog-Methode.
Dieser Schritt ist erforderlich, wenn eine geöffnete Protokolldatei vorhanden ist.
Nachdem das Modul mit Mergemod.dll in der Datenbank zusammengeführt wurde, muss die Tabelle Media aktualisiert werden, um das gewünschte Quellbildlayout zu beschreiben. Der von „Mergemod.dll“ bereitgestellte Mergeprozess aktualisiert die Medientabelle nicht, da der Consumer des Mergemoduls verschiedene Möglichkeiten für das Layout des Quellimages auswählen kann.
Zugehörige Themen