Exemplarische Vorgehensweise: Erweiterte Funktionalität der Quellcodeverwaltung

Artikel
08/20/2007

Diese exemplarische Vorgehensweise veranschaulicht Verzweigungen, Zusammenführungen und Bezeichnungen in der Quellcodeverwaltung in Team Foundation.

Bevor Sie mit dieser exemplarischen Vorgehensweise fortfahren, müssen Ihnen die Grundlagen von Verzweigungen, Zusammenführungen und des Anwendens von Bezeichnungen auf Quellcodeverwaltungselemente bekannt sein:

Verzweigungen Bei Verzweigungen in der Quellcodeverwaltung in Team Foundation wird ein bestimmter Satz von Dateien und Ordnern auf dem Team Foundation-Server an einen neuen Speicherort kopiert, der als Verzweigung bezeichnet wird. Im Wesentlichen erstellt eine Verzweigung neue Ordner oder Dateien auf der Grundlage der vorhandenen. Bei der Verzweigung wird die Versionsgeschichte der Ordner und Dateien beibehalten, für die die Verzweigung durchgeführt wird. Außerdem können Änderungen an den alten Dateien mit den neuen zusammengeführt werden. Verzweigungen können im Quellcodeverwaltungs-Explorer oder über die Befehlszeile mit dem Befehl Branch ausgeführt werden. Weitere Informationen finden Sie unter Grundlagen von Verzweigungen.
Zusammenführungen Beim Zusammenführen werden zwei separate Datei-, Ordner- oder Teamprojektversionen zusammengeführt, die sich in separaten Verzweigungen befinden. Eine Verzweigung ist die Quellverzweigung, die andere die Zielverzweigung. Die Quellverzweigung enthält die Elemente, die mit der Zielverzweigung zusammengeführt werden sollen. Diese Ordner- und Dateiversionen können auf Differenzmengen, Daten, Bezeichnungen, Arbeitsbereichen oder der aktuellen Version beruhen. Weitere Informationen finden Sie unter Grundlagen von Verzweigungen. Zusammenführungen können im Quellcodeverwaltungs-Explorer oder über die Befehlszeile mit dem Befehl Merge ausgeführt werden.
Bezeichnungen Eine Bezeichnung ist eine Markierung, die Sie fallweise einer Gruppe ansonsten in keinem Zusammenhang stehender Dateien und Ordner auf dem Quellcodeverwaltungsserver zuweisen können, um deren gemeinsamen Abruf in einen Arbeitsbereich für Zwecke der Entwicklung oder Erstellung zu erleichtern.

Die folgenden Verfahren führen Sie durch den Vorgang einer Verzweigung und der anschließenden Bearbeitung von Dateien eines Teammitglieds in der resultierenden sowie in der ursprünglichen Verzweigung. Diese Bearbeitungen werden dann eingecheckt, und es wird eine Zusammenführung ausgeführt. Die Zusammenführung erkennt Konflikte, die anschließend aufgelöst werden. Außerdem führen Sie im letzten Vorgang die Schritte aus, die erforderlich sind, um Bezeichnungen auf eine Differenzmenge anzuwenden.

Vorbereitungsmaßnahmen

Bevor Sie diese exemplarische Vorgehensweise durchführen können, müssen Sie folgende Aktionen ausführen:

Geben Sie einen Team Foundation-Server an. Weitere Informationen zum Herstellen einer Verbindung mit einem Team Foundation-Server finden Sie unter Gewusst wie: Herstellen einer Verbindung mit Team Foundation Server.
Öffnen Sie ein vorhandenes Teamprojekt. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Herstellen einer Verknüpfung mit einem Teamprojekt.
Fügen Sie das Projekt der Quellcodeverwaltung hinzu, und erstellen Sie somit einen lokalen Arbeitsbereich, in dem die Dateien, die der Quellcodeverwaltung unterliegen, gespeichert, bearbeitet und getestet werden.
Erstellen Sie eine Visual Studio-Projektmappe, und checken Sie diese in die Quellcodeverwaltung ein. Weitere Informationen finden Sie unter Hinzufügen von Projekten und Projektmappen zur Quellcodeverwaltung über den Projektmappen-Explorer.
Führen Sie die Schritte in Exemplarische Vorgehensweise: Navigieren in der Team Foundation-Quellcodeverwaltung aus.
Zum Durchführen dieser exemplarischen Vorgehensweise müssen Sie über die folgenden Berechtigungen verfügen:
- PendChange
- Checkin
Weitere Informationen über die Sicherheitsberechtigungen der Quellcodeverwaltung in Team Foundation finden Sie unter Übersicht über die Team Foundation-Sicherheit.

Verzweigen von Quellcodeverwaltungselementen

Im folgenden Verfahren wird die Durchführung eines Verzweigungsvorgangs beschrieben. Die Verzweigung ist eine Funktion der Quellcodeverwaltung in Team Foundation zum Erstellen neuer Ordner oder Dateien auf der Grundlage vorhandener. Weitere Informationen finden Sie unter Grundlagen von Verzweigungen und Gewusst wie: Verzweigen von Dateien und Ordnern.

Warnung

Bei den folgenden Verfahren wird davon ausgegangen, dass Sie die Schritte in Exemplarische Vorgehensweise: Navigieren in der Team Foundation-Quellcodeverwaltung bereits ausgeführt haben.

So führen Sie eine Verzweigung von Elementen in der Quellcodeverwaltung aus

Wählen Sie im Menü Ansicht die Option Quellcodeverwaltungs-Explorer aus, um ihn zu öffnen.
Wenn der Quellcodeverwaltungs-Explorer noch nicht bereits geöffnet ist, wählen Sie dazu im Menü Ansicht die Option Weitere Fenster und dann Quellcodeverwaltungs-Explorer aus.
Wechseln Sie im Quellcodeverwaltungs-Explorer zum Ordner MyWindowsApp mit der in Exemplarische Vorgehensweise: Navigieren in der Team Foundation-Quellcodeverwaltung erstellen Projektmappendatei MyWindowsApp.sln, klicken Sie mit der rechten Maustaste darauf, und wählen Sie Verzweigen aus.
Ändern Sie im Dialogfeld Verzweigen im Textfeld Ziel den Speicherort und den Namen der neuen Verzweigung, indem Sie am Ende den Text Test Branch anfügen. Sie können auch zu dem Speicherort wechseln, indem Sie auf Durchsuchen klicken.

Hinweis

An Zielverzweigungen wird automatisch die Zeichenfolge "-Verzweigung" angehängt.
Wählen Sie im Abschnitt Verzweigen aus Version im Dropdown-Listenfeld Von die Option Letzte Version aus.
Klicken Sie auf OK. Die neue Verzweigung wird erstellt und im Quellcodeverwaltungs-Explorer angezeigt.
Klicken Sie auf den neuen Verzweigungsordner mit dem Namen MyWindowsApp Test Branch. In der Spalte Ausstehende Änderung besitzt jedes Element in der neuen Verzweigung den Status verzweigen.
Da eine Verzweigung eine ausstehende Änderung ist, müssen Sie einen Eincheckvorgang ausführen, um die Verzweigung zu übernehmen. Klicken Sie mit der rechten Maustaste auf den Ordner MyWindowsApp Test Branch, und wählen Sie Ausstehende Änderungen einchecken aus.
Geben Sie im Dialogfeld Einchecken im Textfeld Kommentar den Text Test branch ein, und klicken Sie auf Einchecken.

Hinweis

Wenn für das Teamprojekt Eincheckrichtlinien festgelegt wurden, müssen Sie möglicherweise Arbeitsaufträge oder Eincheckhinweise zuordnen, bevor Sie fortfahren können. Weitere Informationen finden Sie unter Gewusst wie: Zuordnen von Arbeitsaufgaben zu Differenzmengen und Gewusst wie: Zuordnen von Eincheckhinweisen zu Differenzmengen.
Die Einträge in der Spalte Ausstehende Änderung im Quellcodeverwaltungs-Explorer sind nach dem Einchecken der neuen Verzweigung leer.

Sie haben nun erfolgreich eine neue Verzweigung erstellt und eingecheckt. Im folgenden Verfahren nehmen Sie Änderungen an Dateien in der ursprünglichen und der neuen Verzweigung vor.

Übernehmen einiger Änderungen an den Verzweigungen

Nachdem Sie die Schritte im vorhergehenden Verfahren zum Verzweigen ausgeführt haben, müssen Sie einige Änderungen an einer Datei in beiden Verzweigungen vornehmen, damit Sie die beiden Verzweigungen zusammenführen und die resultierenden Zusammenführungskonflikte auflösen können. Im folgenden Verfahren werden Sie durch das Auschecken und Bearbeiten von Dateien in beiden Verzweigungen geführt.

Auschecken und Bearbeiten von Dateien in den Quellcodeverwaltungsverzweigungen

Erweitern Sie in der im vorhergehenden Schritt erstellten Verzweigung den Ordner MyWindowsApp Test Branch, und klicken Sie im rechten Bereich mit der rechten Maustaste auf die Datei Class1.cs, die in Exemplarische Vorgehensweise: Navigieren in der Team Foundation-Quellcodeverwaltung erstellt wurde, und wählen Sie Auschecken zum Bearbeiten aus.
Klicken Sie im Dialogfeld Auschecken auf Auschecken. Es wird wieder der Quellcodeverwaltungs-Explorer angezeigt, in dem der Status von Ausstehende Änderung in bearbeiten geändert wurde.
Doppelklicken Sie auf die Datei Class1.cs, um sie zur Bearbeitung zu öffnen.

Fügen Sie in der Datei Class1.cs die Zeichenfolge "New branch" hinzu:

using System;
using System.Collections.Generic;
using System.Text;

namespace MyWindowsApp
{
      class Class1
      {
            string SourceControlMerge = "New branch";
      }
}

Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf die Datei Class1.cs, und wählen Sie Ausstehende Änderungen einchecken aus.
Geben Sie im Dialogfeld Einchecken im Textfeld Kommentar den Text New branch changes ein, und klicken Sie auf Einchecken.

Hinweis

Wenn für das Teamprojekt Eincheckrichtlinien festgelegt wurden, müssen Sie möglicherweise Arbeitsaufträge oder Eincheckhinweise zuordnen, bevor Sie fortfahren können. Weitere Informationen finden Sie unter Gewusst wie: Zuordnen von Arbeitsaufgaben zu Differenzmengen und Gewusst wie: Zuordnen von Eincheckhinweisen zu Differenzmengen.
Der Eintrag in der Spalte Ausstehende Änderung im Quellcodeverwaltungs-Explorer ist für die Datei Class1.cs leer, um anzuzeigen, dass die Bearbeitung eingecheckt wurde.
Jetzt müssen Sie Änderungen an der ursprünglichen Verzweigung vornehmen. Die Schritte entsprechen den soeben ausgeführten. Wechseln Sie im Quellcodeverwaltungs-Explorer zu dem Ordner, der die ursprüngliche Verzweigung mit dem Namen MyWindowsApp enthält.
Erweitern Sie in der ursprünglichen Verzweigung den Ordner MyWindowsApp, und klicken Sie im rechten Bereich mit der rechten Maustaste auf die in Exemplarische Vorgehensweise: Navigieren in der Team Foundation-Quellcodeverwaltung erstellte Datei, und wählen Sie Auschecken zum Bearbeiten aus.
Klicken Sie im Dialogfeld Auschecken auf Auschecken. Es wird wieder der Quellcodeverwaltungs-Explorer angezeigt, in dem der Status von Ausstehende Änderung in bearbeiten geändert wurde.
Doppelklicken Sie auf die Datei Class1.cs, um sie zur Bearbeitung zu öffnen.

Fügen Sie in der Datei Class1.cs die Zeichenfolge "Original branch" hinzu:

using System;
using System.Collections.Generic;
using System.Text;

namespace MyWindowsApp
{
      class Class1
      {
            string SourceControlMerge = "Original branch";
      }
}

Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf die Datei Class1.cs, und wählen Sie Ausstehende Änderungen einchecken aus.
Geben Sie im Dialogfeld Einchecken im Textfeld Kommentar den Text Original branch changes ein, und klicken Sie auf Einchecken.

Hinweis

Wenn für das Teamprojekt Eincheckrichtlinien festgelegt wurden, müssen Sie möglicherweise Arbeitsaufträge oder Eincheckhinweise zuordnen, bevor Sie fortfahren können. Weitere Informationen finden Sie unter Gewusst wie: Zuordnen von Arbeitsaufgaben zu Differenzmengen und Gewusst wie: Zuordnen von Eincheckhinweisen zu Differenzmengen.
Der Eintrag in der Spalte Ausstehende Änderung im Quellcodeverwaltungs-Explorer ist für die Datei Class1.cs leer, um anzuzeigen, dass die Bearbeitung eingecheckt wurde.

Nachdem Sie erfolgreich eine Verzweigung erstellt und Änderungen an der ursprünglichen und der neuen Verzweigung vorgenommen haben, führen Sie die Änderungen aus beiden Verzweigungen im folgenden Verfahren zusammen.

Zusammenführen von Quellcodeverwaltungselementen

Nachdem Sie Änderungen an Dateien in den Verzweigungen vorgenommen haben, können Sie eine Zusammenführung ausführen. Im folgenden Verfahren wird das Zusammenführen mit dem Quellcodeverwaltungs-Explorer veranschaulicht. Weitere Informationen finden Sie unter Grundlagen des Zusammenführens und Gewusst wie: Zusammenführen von Dateien und Ordnern.

So führen Sie Verzweigungen in der Quellcodeverwaltung zusammen

Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf den Ordner MyWindowsApp Test Branch, und wählen Sie Zusammenführen aus.
Im Quellcodeverwaltungs-Assistenten für das Zusammenführen wird im Textfeld Quellverzweigung der Pfad und der Name für den Ordner MyWindows App Test Branch angezeigt.
Wählen Sie im Dropdown-Listenfeld Zielverzweigung den Ordner MyWindowsApp aus.
Wählen Sie unter Wählen Sie die Quellverzweigungsänderungen aus, die Sie zusammenführen möchten die Option Alle Änderungen bis zu einer bestimmten Version aus, und klicken Sie auf Weiter.
Wählen Sie im Schritt Quellelementversionen auswählen in der Dropdownliste Versionstyp die Option Letzte Version aus, und klicken Sie auf Weiter.
Klicken Sie im Schritt Zusammenführungsvorgang ausführen auf Fertig stellen.

Da zwischen Quell- und Zielverzweigung Unterschiede bestehen, wird das Dialogfeld Konflikte lösen angezeigt. Fahren Sie anhand der Schritte im folgenden Verfahren mit dem Lösen der Konflikte fort. Wenn beim Ausführen einer Zusammenführung keine Konflikte vorhanden sind, wird das Dialogfeld Versionskonflikt lösen nicht angezeigt.

Lösen von Zusammenführungskonflikten

Da zwischen den Dateien in beiden Verzweigungen Unterschiede bestehen, werden Sie aufgefordert, Schritte zum Lösen der Konflikte zwischen den beiden Verzweigungen vorzunehmen. Weitere Informationen finden Sie unter Gewusst wie: Auflösen von Konflikten. Um die Zusammenführungskonflikte zu lösen, führen Sie die Schritte in der folgenden Prozedur aus.

So lösen Sie Zusammenführungskonflikte

Klicken Sie im Dialogfeld Konflikte lösen auf Auflösen. Das Dialogfeld Versionskonflikt lösen wird angezeigt.
Wählen Sie im Dialogfeld Versionskonflikt lösen unter Auflösungsoptionen die Option Änderungen im Tool zusammenführen aus, und klicken Sie auf OK.
Suchen Sie im Zusammenführungstool den Konflikt zwischen den beiden Dateien, indem Sie auf Nächste Änderung klicken. Die Dateien werden nebeneinander mit den beiden Zeichenfolgen (Original branch und New branch) angezeigt, die Sie im vorhergehenden Verfahren eingegeben haben.
Klicken Sie auf den Code mit der Zeichenfolge New branch. Die Änderung wird im unteren Bereich angezeigt.
Klicken Sie auf OK.
Klicken Sie zum Speichern der Datei im Dialogfeld Microsoft Visual Studio auf Ja.
Wenn Sie die zusammengeführte Datei beibehalten möchten, klicken Sie im Dialogfeld Zusammengeführtes Ergebnis akzeptieren auf Ja.
Klicken Sie im Dialogfeld Konflikte lösen auf Schließen.
Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf den Ordner MyWindowsApp, und wählen Sie Ausstehende Änderungen einchecken aus. Das Dialogfeld Einchecken wird angezeigt.
Klicken Sie im Dialogfeld Einchecken auf Einchecken.

Hinweis

Wenn für das Teamprojekt Eincheckrichtlinien festgelegt wurden, müssen Sie möglicherweise Arbeitsaufträge oder Eincheckhinweise zuordnen, bevor Sie fortfahren können. Weitere Informationen finden Sie unter Gewusst wie: Zuordnen von Arbeitsaufgaben zu Differenzmengen und Gewusst wie: Zuordnen von Eincheckhinweisen zu Differenzmengen.

Sie haben nun erfolgreich eine Verzweigung erstellt, Änderungen an der ursprünglichen und der neuen Verzweigung vorgenommen, beide zusammengeführt und resultierende Konflikte gelöst. Im nächsten Verfahren wird das Verwenden von Bezeichnungen in der Quellcodeverwaltung in Team Foundation veranschaulicht.

Bezeichnungen für Quellcodeverwaltungselemente

Eine Bezeichnung in Quellcodeverwaltung in Team Foundation ist ein Name, der einem bestimmten Satz von Überarbeitungen zugewiesen wird, der häufig als Snapshotbuild bezeichnet wird. Bezeichnungen können nur auf eine einzelne Überarbeitung einer Datei angewendet werden. Bei folgenden Überarbeitungen der Datei muss entweder die Bezeichnung entfernt oder eine neue Bezeichnung angewendet werden. Bezeichnungen stellen eine einfache Möglichkeit dar, einen Satz von Dateien in einer Überarbeitung zu organisieren. Weitere Informationen finden Sie unter Arbeiten mit Bezeichnungen und Gewusst wie: Anwenden von Bezeichnungen.

So verwenden Sie Bezeichnungen in der Quellcodeverwaltung

Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf den im vorhergehenden Verfahren erstellten Ordner MyWindowsApp Test Branch, und wählen Sie Bezeichnung anwenden aus.
Geben Sie im Dialogfeld Bezeichnung anwenden im Textfeld Name den Namen MyWindowsApp label test ein.
Geben Sie im Textfeld Kommentar den Text Testing walkthrough ein.
Klicken Sie unter Elemente auf Hinzufügen.
Stellen Sie sicher, dass im Dialogfeld Elementversion auswählen im Listenfeld Suchen in das Teamprojekt aufgeführt ist, das Sie derzeit verwenden.
Suchen Sie im Ordner MyWindowsApp Test Branch die Datei Class1.cs, und wählen Sie diese aus.
Wählen Sie im Listenfeld die Option Letzte Version aus.
Klicken Sie auf OK. Das Dialogfeld Bezeichnung anwenden wird angezeigt und enthält die entsprechenden Elemente.
Klicken Sie auf OK.

Sicherheit

Zum Abschließen dieser exemplarischen Vorgehensweise sind die Berechtigungen PendChange und Checkin erforderlich. Weitere Informationen finden Sie unter Sicherheitsrechte und Berechtigungen für die Quellcodeverwaltung.

Siehe auch

Freigeben über