Die Abgleichliste für "Änderungspaket anwenden" verwenden
Wenn die Änderungspakete, die Sie anwenden, von anderen Änderungspaketen abhängig sind, bietet der Befehl "Änderungspaket anwenden" Ihnen eine Abgleichliste, die alle erforderlichen Änderungspakete enthält. Die folgenden Beispiele veranschaulichen, wie die Abgleichliste im Befehl "Änderungspaket anwenden" funktioniert.
Bei der "Änderungspaket anwenden"-Operation, müssen Sie die gesamte Abgleichliste akzeptieren, denn andernfalls schlägt die Operation fehl. Wenn Sie nicht die gesamte Abgleichliste akzeptieren möchten, müssen Sie stattdessen "Änderungspaket erneut synchronisieren" ausführen. Mit dem Befehl "Änderungspaket erneut synchronisieren" können Sie unerwünschte Revisionen in Ihrer Sandbox zusammenführen.
|
|
Die Abgleichliste wird nicht verwendet, wenn Sie Unterprojektoperationen anwenden. Sie müssen explizit alle Änderungspakete angeben, die Unterprojektoperationen enthalten, die Sie Implizit für die Option Propagierung von Unterprojekten anwenden oder auswählen möchten.
|
Die Abgleichliste verwenden, um erforderliche vorherige Revisionen einzuschließen
In diesem Beispiel enthält das Hauptprojekt f:/Aurora_Project/project.pj zwei Programmierfehlerkorrekturen. Element 21 bezieht sich auf die erste Programmierfehlerkorrektur und ist der Datei main.c (Revision 1.2) über das Änderungspaket (CP) 21.1 zugeordnet. Element 22 bezieht sich auf die zweite Programmierfehlerkorrektur und ist der Datei main.c (Revision 1.3) über CP 22:1 zugeordnet.
Der Ersteller möchte die Änderungen übernehmen, die sich auf die Programmierfehlerkorrektur beziehen, und diese auf das Variantenprojekt Aurora_Variant_1_0 anwenden. In dem Variantenprojekt befindet sich main.c in Revision 1.1.
Vor der Anwendung eines Änderungspaketes, das einen Abgleich erfordert
Um die Programmierfehlerkorrektur in das Variantenprojekt zu übernehmen, wendet der Ersteller mithilfe des Befehls si applycp das Änderungspaket 22:1 an. Standardmäßig wird die Abgleichoption auf Alle Änderungspakete (--backfill=cp) gesetzt. Der Ersteller gibt den Befehl ein:
si applycp -P f:/Aurora_Project/project.pj --devPath Aurora_Variant_1_0 22:1
Der Befehl wird wie folgt ausgeführt:
Applying change packages...
22:1
The following warnings have occurred:
-------------------
The change package(s)
21:1 -- main.c(1.2)
are required in order to apply this list of change packages.
They will be automatically added to the list, since the backfill
option is set to Entire Change Package(cp).
--------------------
*** The following set of operations will be performed:
Project: f:/Aurora_Project/project.pj[Aurora_Variant_1_0]
Member main.c: update member revision to Revision 1.3
Are you sure you wish to proceed? [yn](n): y
Wenn Sie sich entscheiden fortzufahren, erhalten Sie eine Benachrichtigung, die die Aktualisierungen, die verarbeitet wurden, sowie diejenigen, die nicht verarbeitet wurden, auflistet.
"Änderungspaket anwenden" aktualisiert die Revision für main.c von 1.1 auf 1.3 im Variantenprojekt. Revision 1.2 wird automatisch zum Variantenprojekt hinzugefügt, weil es als Teil der Abgleichliste (CP 21:1) akzeptiert wurde.
Nach Anwendung eines Änderungspaketes, das einen Abgleich erfordert
Die Abgleichliste verwenden, um eine neue Datei einzuschließen
Dieses Beispiel veranschaulicht, wie "Änderungspaket anwenden" auf ein komplexeres Änderungspaket mit Codeänderungen wirkt, die von einer neuen Datei abhängig sind. In diesem Beispiel wird main.c überarbeitet, um einen Wert in der neuen Datei main.h aufzurufen.
Der Entwickler, der am Code arbeitet, hat all diese Änderungen eingecheckt und beide Dateien CP 22:1 zugeordnet. Im Rahmen der Entwicklungsarbeit wird anschließend eine weitere Revision in main.c eingeschlossen, in Revision 1.3 eingecheckt und CP 23:1 zugeordnet. Das Hauptprojekt enthält deshalb main.c bei Revision 1.3 und main.h bei Revision 1.1.
Vor der Anwendung eines Änderungspakets, das eine zugeordnete Datei enthält
Der Ersteller möchte jetzt die Änderungen in das Variantenprojekt einarbeiten. Daher verwendet er den Befehl "Änderungsprojekt anwenden", um CP 23:1 auf Aurora_Variant_1_0 anzuwenden. Dadurch wird main.c auf Revision 1.3 aktualisiert und main.h zu Revision 1.1 hinzugefügt.
Nach Anwendung eines Änderungspaketes, das eine zugeordnete Datei enthält
Die Abgleichliste verwenden, um nur Abgleichsrevisionen anzuwenden
Die Standard-Abgleichsoption für "Änderungspaket anwenden" propagiert alle Einträge, die für das angegebene Änderungspaket erforderlich sind, einschließlich aller Einträge in sämtlichen Änderungspaketen in der Abgleichliste. Es gibt jedoch einen speziellen Fall, in dem Sie Abgleiche durch Nur Abgleichsrevisionen durchführen sollten. Diese Option aktualisiert nur die auf den direkt zugeordneten Revisionen basierende Zielumgebung. Es werden keine Änderungspakete verarbeitet, die Zwischen-Revisionen zugeordnet sind.
Wenn Sie z.B. die Option Nur Abgleichsrevisionen im vorherigen Beispiel ("Die Abgleichliste verwenden, um eine neue Datei einzuschließen") wählen, wird main.c nach wie vor auf 1.3 aktualisiert, aber main.h wird nicht propagiert, da es sich bei diesem um einen Eintrag in einem Abgleichsänderungspaket handelt.
Diese Option ist dann nützlich, wenn Sie eine Datei propagieren, die Informationen sammelt und deshalb tendenziell von allen Änderungen betroffen ist. In diesem Fall ist nur die letzte Revision von Interesse, nicht die zugrunde liegenden Änderungen, die infolge aller Änderungen an zugehörigen Dateien auftreten.
