Das Hinzufügen eines Merge-Moduls zu einem Packaging-Projekt wird über die Merge Module-Ansicht im Visual Designer-Modus von PackDesigner gestartet.
Um den Assistenten für die MSM-Verwaltung zu starten, verwenden Sie die Schaltfläche Add content from Merge Module in der oberen linken Ecke der Merge Modules-Ansicht.
Durchlaufen Sie die folgenden Assistentenschritte, um Ihr Projekt um Merge-Modul-Inhalte zu erweitern.
Schritt 1: Merge-Module
Merge-Module können entweder aus dem Lieferumfang der RayPack-Installationsressourcen oder aus benutzerdefinierten externen Ressourcen zum Import ausgewählt werden.
Um ein Modul aus der Liste der Standardmodule hinzuzufügen, aktivieren Sie das Kontrollkästchen in der äußersten linken Spalte der Standardliste der Merge-Module.
Die Liste ist recht umfangreich und daher mit Sortierung nach Spalten (einfach auf eine Spaltenüberschrift klicken, um aufsteigend oder absteigend nach diesem Kriterium zu sortieren) und Filterung nach Schlüsselwort (Strg + F zum Ein-/Ausblenden des Filters verwenden) ausgestattet. Nutzen Sie diese Funktionen, um schnell zum benötigten Merge-Modul zu navigieren.
Verwenden Sie die Schaltfläche Refresh oberhalb der Liste der vordefinierten Module, um deren Inhalt aus der internen Merge-Module-Bibliothek zu aktualisieren.
|
WARNUNG Sobald ein Merge-Modul zu einem Projekt hinzugefügt wurde, kann es nicht mehr über diesen Assistenten entfernt werden. Wenn der Assistent daher mehrfach für dasselbe Projekt ausgeführt wird, sind die bereits importierten Merge-Module aus der vordefinierten Liste markiert, und diese Markierung kann nicht entfernt werden. Um ein Merge-Modul aus einem Projekt zu entfernen, entfernen Sie den entsprechenden Inhalt der Installationsdatenbank über die TABLES-Ansicht. |
Um ein Modul aus einer externen Ressource hinzuzufügen, verwenden Sie die Schaltfläche From disk... oberhalb der Liste der vordefinierten Module.
Ein Systemdialog zum Durchsuchen wird geöffnet, über den der Benutzer auf lokalen und Netzlaufwerken nach einer MSM-Datei suchen kann.
Sobald die richtige MSM-Datei ausgewählt wurde, wird mit der Schaltfläche Open der Verweis auf die MSM-Datei zur Sammlung verfügbarer Module hinzugefügt. Sie ist bereits für den Import markiert, d. h. das Kontrollkästchen in der äußersten linken Spalte ist aktiviert.
Sobald die Sammlung eines oder mehrerer Merge-Module, die für das Packaging-Projekt verwendet werden sollen, markiert ist, muss die Schaltfläche Next verwendet werden, um mit dem nächsten Assistentenschritt fortzufahren.
Einschluss abhängiger Module bestätigen
Der Übergang zum nächsten Schritt enthält die Analyse der Merge-Modul-Sammlung, die für die Integration in das Packaging-Projekt vorgesehen ist. Wenn eines dieser Module Abhängigkeiten zu anderen Modulen aufweist, zeigt RayPack einen Bestätigungsdialog an, der eine Benutzerentscheidung bezüglich der Handhabung erfordert.
Der Bestätigungsdialog zeigt eine Liste der abhängigen Module, die mit der Schaltfläche MORE... ein- und ausgeblendet werden kann. Die Entscheidung, die erforderlichen Module einzuschließen, gilt entweder für alle oder für keine; es ist nicht möglich, nur eine Teilmenge der Abhängigkeiten zum Einschluss auszuwählen.
Benutzer haben drei Optionen zur Auswahl:
•Klicken Sie auf YES, um die abhängigen Module einzuschließen
•Klicken Sie auf NO, um ohne Einschluss der abhängigen Module fortzufahren
•Klicken Sie auf CANCEL, um zur Liste der Merge-Module zurückzukehren und die aktuelle Auswahl zu ändern.
Schritt 2: Ziel-Feature
Jedes Merge-Modul muss in ein Paket-Feature eingebettet werden. Daher müssen Benutzer ein Feature aus der angezeigten Baumansicht der bereits vorhandenen Features auswählen oder ein neues Feature hinzufügen.
Die Pfeile links neben einem Feature-Namen zeigen an, dass es untergeordnete Child-Features enthält. Mit einem Klick auf den Pfeil wird die nächste Ebene der untergeordneten Elemente angezeigt (oder wieder ausgeblendet).
Um ein Root-Feature hinzuzufügen, wird die Schaltfläche Create verwendet und die Option New root feature aus dem Optionsmenü ausgewählt.
Wenn Child-Features hinzugefügt werden müssen, verwenden Sie die erweiterte Feature-Verwaltungsoberfläche in der Features-Ansicht.
Sobald eines der Features ausgewählt ist, wird die Schaltfläche Next verfügbar. Verwenden Sie sie, um zum nächsten Assistentenschritt zu gelangen.
Schritt 3: Optionen
Wenn ein MSM zu einem RPP-Projekt hinzugefügt wird, ermöglicht RayPack zwei verschiedene Methoden für den MSM-Import. Module können entweder in einem einzigen Schritt importiert und zusammengeführt oder importiert und für eine spätere Zusammenführung beim Build zugewiesen werden.
Wenn ein MSM zu einem MSI hinzugefügt wird, wird die Zusammenführung immer sofort ausgeführt. Die Option "Merge at Build" ist in diesen Fällen nicht verfügbar, ebenso wenig wie der gesamte Assistentenschritt "Options".
Jetzt zusammenführen
Diese Option führt die Inhaltsobjekte der MSM-Datei sofort mit den bereits im Packaging-Projekt vorhandenen zusammen. Das bedeutet beispielsweise, dass jeder Registrierungsschlüssel, jede Datei, jeder Ordner usw. aus dem Merge-Modul in das Packaging-Projekt übernommen wird.
Das Hinzufügen eines MSM für die sofortige Zusammenführung beeinflusst die Menge der verfügbaren Installationsdatenbanktabellen sowie den Inhalt vorhandener. Auswirkungen sind voraussichtlich in den Tabellen Directory, File, Registry, Feature, Component, FeatureComponent, ModuleSignature, ModuleDependency, ModuleComponents, _Validation zu erwarten. Die genauen Änderungen hängen von der importierten MSM-Datei ab.
Verwenden Sie diese Option, um die Auswirkungen des MSM-Einschlusses sofort zu sehen und potenzielle Ressourcenkonflikte, z. B. pro einzelnem MSM, zu behandeln.
Beim Build zusammenführen
Diese Option fügt die Merge-Modul-Ressourcen zum Packaging-Projekt hinzu, führt jedoch die eigentlichen Inhalte (z. B. Dateien, Ordner, Registrierungsschlüssel usw.) nicht mit dem aktuellen Packaging-Projektinhalt zusammen.
Wenn das Paketprojekt gespeichert wird, werden die Merge-Modul-Quellen in das Verzeichnis <project name>.rpp.Sources kopiert. Der genaue Pfadverweis wird in der Installationsdatenbanktabelle RPModuleSignature, Spalte ModulePath, gespeichert. Dieser Pfad wird beim Build aufgelöst, um den eigentlichen Zusammenführungsprozess zu diesem Zeitpunkt auszuführen.
|
WARNUNG Wenn ein Packaging-Projekt von einem Speicherort an einen anderen übertragen wird, muss das Verzeichnis <project name>.rpp.Sources mitübertragen werden, da Pfadwerte, z. B. der Pfad zu Merge-Modul-Quelldateien, relative Pfade sind. Das alleinige Verschieben der .rpp-Datei führt zu Fehlern, wenn diese Kopie vom neuen Speicherort aus in RayPack zur Bearbeitung geöffnet wird. |
Das Hinzufügen eines MSM für die Zusammenführung beim Build wirkt sich auf folgende Installationsdatenbanktabellen aus:
•Feature
Nur wenn während der Assistentenausführung ein neues Feature/eine neue Komponente hinzugefügt wurde
•RPModuleSignature
Wurde mit neuen Einträgen ergänzt, einem für jedes importierte Merge-Modul. Die Spalte ModulePath verweist auf die MSM-Quelldatei.
•_Validation
Wenn die oben genannten Tabellen zuvor nicht vorhanden waren, erweitert RayPack diese Tabelle automatisch um zusätzliche interne Validierungsregeln.
Verwenden Sie diese Option, um zunächst alle erforderlichen Ressourcen für das gewünschte Zielpaket vorzubereiten und mögliche Konflikte später in einem (potenziell komplexen) Build-Validierungsverfahren zu behandeln.
Da MSM-Dateien von Zeit zu Zeit mit neuen Versionen aktualisiert werden, kann die Option "Merge at Build" eine nützliche Wahl für langfristige Packaging-Projekte sein.
Klicken Sie auf eine der beiden Methodenkacheln, um sie für die Ausführung dieses MSM-Importvorgangs anzuwenden.
Sobald eine der Methoden ausgewählt ist, wird die Schaltfläche NEXT verfügbar. Verwenden Sie sie, um zum nächsten Assistentenschritt zu gelangen.
Schritt 4: Zusammenfassung
Die Zusammenfassungsseite listet alle in den vorherigen Schritten definierten Einstellungen zur abschließenden Überprüfung auf, bevor der Modulimport tatsächlich ausgeführt wird.
Verwenden Sie die Schaltfläche Next, um den Import zu starten.
Verwenden Sie die Schaltfläche Back, um Änderungen an den aktuellen Einstellungen vorzunehmen.
Schritt 5: Fortschritt
Die Fortschrittsseite wird angezeigt, solange RayPack die Merge-Module aktiv importiert.
Naturgemäß dauert das sofortige Zusammenführen von Modulen länger als der Import für eine spätere Zusammenführung. Die Dauer des Importvorgangs hängt von der Komplexität und Größe der importierten MSMs sowie von der Leistung des zugrunde liegenden Packaging-Rechners ab.
Schritt 6: Abgeschlossen
Nachdem der Import erfolgreich abgeschlossen wurde, wird die Seite "Abgeschlossen" angezeigt. Verwenden Sie die Schaltfläche Finish, um den Assistenten zu schließen und die aktualisierte Liste der im aktuellen Projekt verwendeten Merge-Module anzuzeigen.