Exemplarische Vorgehensweise: Navigieren in der Team Foundation-Versionskontrolle

Artikel
09/02/2008

Aktualisiert: November 2007

Diese exemplarische Vorgehensweise veranschaulicht die Features der in Visual Studio Team System Team Foundation Server integrierten Versionskontrolle.

Sie beschreibt, wie die Versionskontrolle in der Visual Studio Team System Team Foundation Server-IDE verwendet wird. Sie erfahren insbesondere, wie Sie die folgenden Aufgaben ausführen:

Legen Sie Team Foundation-Versionskontrolle als Standard-Plug-In für die Versionskontrolle von Visual Studio Team System Team Foundation Server fest.
Erstellen Sie ein neues Projekt in Visual Studio.
Fügen Sie das Projekt der Versionskontrolle hinzu, und erstellen Sie somit einen lokalen Arbeitsbereich, in dem Sie die Dateien, die der Versionskontrolle unterliegen, speichern, bearbeiten und testen können.
Checken Sie die Projektmappe ein.
Fügen Sie eine Datei dem der Versionskontrolle unterliegenden Projekt hinzu, und bearbeiten Sie ein vorhandenes Projekt.
Führen Sie einen Commit für alle ausstehenden Änderungen im lokalen Arbeitsbereich auf dem Versionskontrollserver aus.

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 über das Herstellen einer Verbindung mit einem Team Foundation Server finden Sie unter Gewusst wie: Herstellen einer Verbindung mit Team Foundation Server.
Erstellen Sie ein Teamprojekt, oder öffnen Sie ein vorhandenes Teamprojekt. Weitere Informationen hierzu finden Sie unter Exemplarische Vorgehensweise: Erstellen eines neuen Teamprojekts oder Exemplarische Vorgehensweise: Herstellen einer Verknüpfung mit einem Teamprojekt.

Erforderliche Berechtigungen

Zum Abschließen dieser exemplarischen Vorgehensweise sind die Berechtigungen Read und Checkin erforderlich.

Festlegen der Team Foundation-Versionskontrolle als Versionskontroll-Plug-In

Bevor Sie die Team Foundation-Versionskontrolle verwenden können, müssen Sie Visual Studio für die Verwendung des Team Foundation-Versionskontrolle-Plug-Ins konfigurieren. Dies wird im folgenden Verfahren beschrieben. Weitere Informationen hierzu finden Sie unter Gewusst wie: Konfigurieren von Visual Studio für die Verwendung der Team Foundation-Versionskontrolle.

Hinweis:
Visual Studio wird für die automatische Verwendung des Team Foundation-Versionskontrolle-Plug-Ins konfiguriert, wenn Visual Studio nach der Installation von Visual Studio installiert wird.

So konfigurieren Sie Visual Studio für die Verwendung der Team Foundation-Versionskontrolle

Klicken Sie im Menü Extras auf Optionen.
Suchen Sie im Dialogfeld Optionen den Eintrag Quellcodeverwaltung, erweitern Sie diesen, und klicken Sie dann auf Plug-In-Auswahl.
Wählen Sie im Dropdown-Listenfeld Aktuelles Quellcodeverwaltungs-Plug-In die Option Visual Studio Team Foundation Server aus.
Klicken Sie auf OK.

So fügen Sie ein Projekt der Versionskontrolle hinzu

Beim Erstellen von Projekten können Sie diese der Versionskontrolle hinzufügen, um sie in Team Foundation-Versionskontrolle zu verwalten. Wenn Sie der Versionskontrolle zum ersten Mal ein Projekt hinzufügen, erstellt Team Foundation-Versionskontrolle einen Arbeitsbereich für Sie. Ein Arbeitsbereich ist eine clientseitige Kopie der Dateien und Ordner auf dem Team Foundation-Server. Wenn Sie ein Element unter Versionskontrolle hinzufügen, bearbeiten, löschen, verschieben, umbenennen oder auf andere Weise verwalten, isoliert das System die Änderungen im Arbeitsbereich. Sie werden als anstehende Änderungen im Arbeitsbereich auf dem lokalen Computer verfolgt.

Ein Arbeitsbereich bietet einen abgeschlossenen Bereich, in dem Sie Code schreiben und testen können. Die Änderungen haben keine Auswirkungen auf die Stabilität der eingecheckten Quellen. Sie sind von den Änderungen anderer Teammitglieder isoliert. Ausstehende Änderungen gelten solange für einen Arbeitsbereich, bis Sie einen Commit auf dem Team Foundation-Server ausführen, indem Sie sie einchecken.

Sie können auf dem Computer für jeden Team Foundation-Server mehrere Arbeitsbereiche erstellen. Weitere Informationen hierzu finden Sie unter Arbeiten mit Versionskontrollarbeitsbereichen.

So erstellen Sie eine neue Projektmappe und ein neues Projekt

Klicken Sie im Menü Datei auf Neu und dann auf Projekt.
Wählen Sie im Dialogfeld Neues Projekt im Bereich Projekttypen die Option Visual C# aus.
Klicken Sie im rechten Bereich auf Windows Forms-Anwendung.
Geben Sie im Feld Name den Namen MyWindowsApp ein, und geben Sie dann im Feld Speicherort einen Pfad ein.
Wählen Sie das Feld Zur Quellcodeverwaltung hinzufügen aus, und klicken Sie auf OK.
Wählen Sie im Feld Projektmappe zur Quellcodeverwaltung hinzufügen das Teamprojekt aus, das Sie für diese exemplarische Vorgehensweise verwenden möchten.
Klicken Sie auf OK.

Sie können auch Projektmappen und Projekte über die Befehlszeile oder das Menü Visual Studio hinzufügen. Wenn Sie Projekte und Projektmappen auf diese Weise hinzufügen, werden Sie jedoch nicht gebunden. Durch die Bindung wird Versionskontrollfunktionalität bereitgestellt. Hierzu zählen verschiedene Versionskontrollsymbole, die im Projektmappen-Explorer den Status angeben. Weitere Informationen finden Sie unter Gewusst wie: Binden und Aufheben der Bindung von Projekten und Projektmappen, Befehl Add und Gewusst wie: Hinzufügen von Dateien, die keine Projektdateien oder Projektmappendateien sind, und von Ordnern zur Versionskontrolle.

Fenster Ausstehende Änderungen

Das Fenster Ausstehende Änderungen enthält Informationen über den Status ausstehender Änderungen im Arbeitsbereich. Mithilfe dieses Fensters können Sie Informationen über Änderungen verfolgen. Dazu gehören relevante Arbeitselemente und Eincheckhinweise. Über das Menü Ansicht können Sie auf das Fenster Ausstehende Änderungen zugreifen. Weitere Informationen hierzu finden Sie unter Verwenden der Fenster Einchecken und Ausstehende Änderungen.

Hinweis:
Rufen Sie die aktuellen Versionen aller relevanten Quellen vom Server ab, und kompilieren Sie den Code, um sicherzustellen, dass dieser ohne Fehler erstellt wird, bevor Sie die ausstehenden Änderungen einchecken.

Danach müssen Sie mithilfe des Fensters Ausstehende Änderungen die neuen Projektmappendateien in die Versionskontrolle einchecken.

So checken Sie ausstehende Änderungen für die Projektmappe in die Versionskontrolle ein

Klicken Sie im Menü Erstellen auf Projektmappe erstellen, um sicherzustellen, dass die Anwendung ohne Fehler erstellt wurde.
Wenn das Fenster Ausstehende Änderungen nicht geöffnet ist, klicken Sie im Menü Ansicht auf Weitere Fenster, und klicken Sie dann auf Ausstehende Änderungen.

Im Fenster Ausstehende Änderungen werden die Projektmappendateien als hinzufügen aufgelistet. Das heißt, dass die Dateien im Arbeitsbereich erstellt sind, aber noch nicht zum Server hinzugefügt wurden.
Geben Sie im Dialogfeld Ausstehende Änderungen im Feld Kommentar den Kommentar "Neues Projekt wird in Versionskontrolle eingecheckt" ein.
Klicken Sie auf Einchecken, um die ausstehenden hinzuzufügenden Änderungen auf dem Server einzuchecken.

Weitere Informationen finden Sie unter Ausstehende Änderungen und unter Gewusst wie: Einchecken von ausstehenden Änderungen. Weitere Informationen hierzu finden Sie unter Senden von Änderungen an den Versionskontrollserver.

Bearbeiten des Projekts, das der Versionskontrolle unterliegt

Die Versionskontrolle ist vollständig in die Visual Studio-Entwicklung integriert. Wenn Sie z. B. einem Projekt, das der Versionskontrolle unterliegt, eine Datei hinzufügen, checkt Visual Studio die Projektdatei im Hintergrund aus und aktualisiert sie automatisch.

Wenn Sie einem Projekt, das der Versionskontrolle unterliegt, eine Datei hinzufügen, geht Visual Studio davon aus, dass Sie die Datei bearbeiten möchten, bevor Sie sie für die anderen Teammitglieder verfügbar machen. Deshalb werden neu hinzugefügte Dateien nicht automatisch eingecheckt. Sie werden als ausstehende Hinzufügungen zur Versionskontrolle behandelt. Wenn Sie die Änderungen, für die kein Commit ausgeführt wurde, explizit einchecken, erstellen Sie ein neues Changeset im Server.

So fügen Sie einem Projekt, das der Versionskontrolle unterliegt, eine Datei hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, klicken Sie auf Hinzufügen und dann auf Klasse.
Klicken Sie im Dialogfeld Neues Element hinzufügen auf Hinzufügen, um die Datei Class1.cs zum Projekt hinzuzufügen.

Class1.cs wird zusammen mit den anderen Projektdateien im Fenster Ausstehende Änderungen angezeigt, wobei Typ ändern den Wert Hinzufügen hat. Im Projektmappen-Explorer wird als Signalsymbol anstelle eines blauen Schlosses ein rotes Häkchen angezeigt. Dieses Symbol gibt an, dass die Projektdatei ausgecheckt wurde. Beachten Sie, dass Class1.cs mit einem Plussymbol (+) angezeigt wird. Dies gibt eine ausstehende Hinzufügung an.

Dateien werden automatisch und im Hintergrund ausgecheckt, wenn Sie eine eingecheckte Projektdatei für die Bearbeitung auswählen.

So bearbeiten Sie eine vorhandene Datei in einem der Versionskontrolle unterliegenden Projekt

Doppelklicken Sie im Projektmappen-Explorer im Ordner Eigenschaften auf AssemblyInfo.cs.
Fügen Sie der Datei im Code-Editor eine neue Using-Direktive wie using System.IO.Ports; hinzu.

Beachten Sie, dass AssemblyInfo.cs automatisch von Team Foundation ausgecheckt wird, wenn Sie mit der Bearbeitung beginnen. Im Projektmappen-Explorer wird das zugehörige Signalsymbol in ein Häkchen geändert. Das System fügt die Datei im Fenster Ausstehende Änderungen zur Liste der Quelldateien hinzu.

Synchronisieren des Arbeitsbereichs mit der letzten Serverversion

Führen Sie einen Vorgang für das Abrufen der letzten Version durch, um die Dateien im Arbeitsbereich mit der letzten Serverversion zu synchronisieren. Wenn Sie vor dem Einchecken immer eine Synchronisierung und Erstellung durchführen, vermeiden Sie eine Unterbrechung des Integrationsbuilds. Ein Build wird unterbrochen, wenn Sie und ein anderer Benutzer Änderungen einchecken, die zwar keine Konflikte verursachen, aber inkompatibel sind und ein Kompilieren der Anwendung verhindern.

So rufen Sie die letzte Version für Arbeitsbereich und Build vom Server ab

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste, und klicken Sie dann auf Letzte Version abrufen (rekursiv).
Klicken Sie im Menü Erstellen auf Projektmappe erstellen, um sicherzustellen, dass die Anwendung ohne Fehler erstellt wurde.

Einchecken der ausstehenden Änderungen auf dem Server

Nachdem Sie sichergestellt haben, dass die Anwendung mit der letzten Version erstellt werden kann, können Sie die Änderungen in Team Foundation-Versionskontrolle einchecken und das Projekt für die anderen Teammitglieder sichtbar machen.

Hinweis:
Wenn die Anwendung nicht erstellt wird, weil Sie noch keine Tests durchführen konnten oder wenn Sie den Code für die Überprüfung durch einen anderen Entwickler freigeben möchten, können Sie die Änderungen ablegen anstatt diese einzuchecken. Weitere Informationen finden Sie unter Arbeiten mit Versionskontrollshelvesets.

Sie können ausstehende Änderungen folgendermaßen einchecken:

Mithilfe des Untermenüs Quellcodeverwaltung im Menü Datei.
Klicken Sie im Projektmappen-Explorer oder im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf eine ausgecheckte Datei.
Klicken Sie im Fenster Ausstehende Änderungen auf Einchecken.

So checken Sie alle ausstehenden Änderungen auf dem Server ein

Klicken Sie im Menü Ansicht auf Weitere Fenster, und klicken Sie auf Ausstehende Änderungen.
Geben Sie im Fenster Ausstehende Änderungen im Feld Kommentar einen Kommentar ein, der die Art der Änderungen beschreibt.

Sie können z. B. "Using-Direktive hinzugefügt" und als Grund "Unterstützung für Aufrufe der Directory-Klasse" eingeben.
Öffnen Sie den Channel Arbeitsaufgaben, und wählen Sie alle Arbeitsaufgaben aus, die für die ausstehenden Änderungen relevant sind.

Weitere Informationen finden Sie unter Gewusst wie: Zuordnen von Arbeitsaufgaben zu Changesets.

Öffnen Sie den Channel Eincheckhinweise, und fügen Sie die Kommentare zu den Eincheckhinweisen für Codebearbeiter, Sicherheitsbearbeiter und Leistungsbearbeiter hinzu.

Hinweis:
Eincheckhinweise können von einem Administrator als Pflichtfelder konfiguriert werden. Sie müssen während des Eincheckprozesses vervollständigt werden. Pflichtfelder werden durch die Schattierung des Textfeldhintergrunds angezeigt.

Weitere Informationen zum Erstellen von Eincheckhinweisen und benutzerdefinierten Arbeitsaufgabenübergängen finden Sie unter Exemplarische Vorgehensweise: Anpassen von Eincheckrichtlinien und -hinweisen.

Klicken Sie auf Einchecken.

Der Eincheckprozess von Team Foundation Server wurde für eine einfache Verwendung und die Erweiterbarkeit durch das Team entwickelt. Zur Optimierung der einfachen Handhabung wird im Fenster Ausstehende Änderungen implizit davon ausgegangen, dass Sie alle Änderungen einchecken möchten. Sie können aber auch sehr einfach einzelne ausstehende Änderungen vom Einchecken ausschließen. Das Einchecken wird normalerweise auf Gruppen verwandter Änderungen angewendet, nicht auf einzelne Änderungen. Umgekehrt geht Visual Studio beim Einchecken im Projektmappen-Explorer oder im Menü Datei davon aus, dass Sie nur die Änderungen am ausgewählten Element einchecken möchten. Wenn Sie einen Dateicontainer wie ein Projekt oder eine Projektmappe auswählen, wählen Sie dieses Element und alle darin enthaltenen Elemente zum Einchecken aus.

Team Foundation Server-Administratoren können einem Teamprojekt einen Satz benutzerdefinierter Eincheckrichtlinien zuordnen, um sicherzustellen, dass bestimmte Richtlinien oder Anforderungen bei allen Eincheckvorgängen erfüllt werden.

Einzelne Teammitglieder können Arbeitsaufgaben erstellen, um Produktdefekte oder Featureanforderungen zu verfolgen. Sie können einem bestimmten Projekt eine Arbeitsaufgabe zuordnen. Wenn Sie eine Arbeitsaufgabe abschließen, können Sie diese den Quellcodeänderungen zuordnen, indem Sie sie im Fenster Ausstehende Änderungen im Channel Arbeitsaufgaben entsprechend kennzeichnen. Wenn Sie den Quelländerungen Arbeitsaufgaben zuordnen, garantieren Sie Verantwortlichkeit und sorgfältiges Verfolgen des Arbeitsstatus.

Schließlich können Sie und Ihre Teammitglieder jedem Auscheckvorgang aussagekräftige und konsistente Hinweise hinzufügen. Die Prozessvorlage, die zum Erstellen des Teamprojekts verwendet wurde, bestimmt Form und Inhalt der Eincheckhinweise. Der Team Foundation Server-Administrator kann die Vorlage für das Team anpassen. Kategorien von Eincheckhinweisen können Folgendes beinhalten: Auswirkungen auf die Leistung, Dokumentationsanforderungen, Testanweisungen und Buildanweisungen.

Der Eincheckvorgang

Wenn Sie auf Einchecken klicken, werden die ausgewählten Quellcodedateien mit den Eincheckhinweisen und Arbeitsaufgaben, die Sie im Fenster Ausstehende Änderungen angegeben haben, vom System zusammengefasst. Team Foundation-Versionskontrolle lädt diese Bündel dann auf den Team Foundation-Server hoch und führt ein Commit für das Bündel als neues Changeset aus. Ein Changeset ist ein Satz von Dateirevisionen, Eincheckhinweisen, zugeordneten Arbeitsaufgaben und Metadaten für die Versionskontrolle, der auf dem Server als eine einzelne leicht zu verwaltende Einheit gespeichert wird. Weitere Informationen hierzu finden Sie unter Arbeiten mit Changesets der Versionskontrolle.

Zum zweiten werden alle im Changeset enthaltenen Arbeitsaufgaben aktualisiert, indem ihnen Links mit dem neu erstellten Changeset hinzugefügt werden.

Anschließend durchlaufen die Arbeitsaufgaben einen Arbeitsablauf, der auf den bereits vorhandenen, vordefinierten Verarbeitungsregeln basiert. Das Team könnte beispielsweise eine Regel definieren, nach der automatisch der Status eines Fehlers von "Aktiv" in "Gelöst" geändert wird, wenn der Substatus beim Einchecken des Fehlers "Korrektur verfügbar" lautet. Die Verarbeitungsregeln und der Workflow werden von der Prozessvorlage erstellt, die zum Erstellen des Teamprojekts verwendet wurde. Der Team Foundation Server-Administrator kann die Regeln und den Workflow jedoch anpassen. Weitere Informationen hierzu finden Sie unter Anpassen von Prozessvorlagen.

Schließlich generiert Team Foundation-Versionskontrolle eine E-Mail-Benachrichtigung an alle Teammitglieder, die Eincheckbenachrichtigungen erhalten möchten.

Nächste Schritte

Nachdem Sie die Schritte in dieser exemplarischen Vorgehensweise ausgeführt haben, können Sie mehr über die erweiterte Funktionalität in Team Foundation-Versionskontrolle erfahren. Weitere Informationen hierzu finden Sie unter Exemplarische Vorgehensweise: Erweiterte Funktionalität der Versionskontrolle. In dieser exemplarischen Vorgehensweise wird das Verzweigen, Zusammenführen und das Anwenden von Bezeichnungen auf Elemente, die der Versionskontrolle unterliegen, beschrieben.

Siehe auch

Freigeben über