Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Quellcodeverwaltung über die Befehlszeile

Artikel
08/20/2007

In dieser exemplarischen Vorgehensweise wird beschrieben, wie Quellcodeverwaltungsvorgänge mit dem Visual Studio 2005-Befehlszeilenclient tf ausgeführt werden.

Im Verlauf dieser exemplarischen Vorgehensweise führen Sie folgende Aufgaben aus:

Erstellen des Arbeitsbereichs, in dem sich Ihre Kopie der Dateien auf dem Quellcodeverwaltungsserver befindet
Abrufen einer Kopie der Quelle vom Server
Hinzufügen einer Datei zum Server
Auschecken der Datei vom Server und Bearbeiten der Datei im Arbeitsbereich
Einchecken von ausstehenden Änderungen und Erstellen einer Differenzmenge
Wiederherstellen einer zu einem bestimmten Zeitpunkt vorhandenen Version des Arbeitsbereichs durch Abrufen der Quelldateien vom Server, die dem Zustand des Arbeitsbereichs zum Zeitpunkt der Erstellung einer bestimmten Differenzmenge entsprechen

Vorbereitungsmaßnahmen

Wenn Sie eine Verbindung mit einem Team Foundation Server herstellen können und über die entsprechenden Berechtigungen verfügen, können Sie Quellcodeverwaltungsbefehle an einer Eingabeaufforderung, in einer Batchdatei oder einer Skriptdatei ausführen. Hierzu müssen Sie entweder das Dienstprogramm Visual Studio 2005-Eingabeaufforderung verwenden oder an der aktuellen Eingabeaufforderung mithilfe von vsvars32 verschiedene Umgebungsvariablen festlegen, wie im folgenden Beispiel beschrieben. Weitere Informationen über das Beitreten zu einem Teamprojekt finden Sie unter Exemplarische Vorgehensweise: Herstellen einer Verknüpfung mit einem Teamprojekt.

So aktivieren Sie Team Foundation-Befehle an einer Eingabeaufforderung

Klicken Sie auf Start, zeigen Sie auf Alle Programme, auf Microsoft Visual Studio 2005 und auf Visual Studio-Tools, und klicken Sie anschließend auf Visual Studio 2005-Eingabeaufforderung.

Stattdessen können Sie auch vsvars32 im Visual Studio-Installationspfad ausführen. Dieser lautet i. d. R. Laufwerkbuchstabe:\Programme\Microsoft Visual Studio 8\Common7\Tools.

Erstellen eines Arbeitsbereichs

Bevor Sie mit der Quellcodeverwaltung arbeiten können, müssen Sie einen Arbeitsbereich einrichten. Ein Arbeitsbereich ist eine lokale Kopie der Dateien und Ordner auf dem Server. Wenn Sie Elemente, die der Quellcodeverwaltung unterliegen, hinzufügen, bearbeiten, löschen, verschieben, umbenennen oder auf sonstige Weise ändern, werden die Änderungen im Arbeitsbereich isoliert, in dem Sie sie sicher erstellen und testen können. Wenn Sie einen Eincheckvorgang ausführen, werden diese Änderungen an den Server übergeben und sind außerhalb des Arbeitsbereichs verfügbar.

Ein Arbeitsbereich besteht aus einer Reihe von Zuordnungen. Mit jeder Zuordnung wird ein Ordner auf dem Server zugeordnet, der über einen lokalen Ordner auf dem Datenträger verfügt. Um eine lokale Kopie der Dateien auf dem Server abzurufen, erstellen Sie einen neuen Arbeitsbereich, geben die Zuordnungen für den Arbeitsbereich an und füllen anschließend mithilfe des get-Befehls den Arbeitsbereich mit Quelldateien auf.

Bevor Sie auf dem lokalen Computer Befehle der Quellcodeverwaltung in Team Foundation ausführen können, müssen Sie einen Arbeitsbereich erstellen, in dem die Ausgabe der Operationen gespeichert werden kann und aus dem Sie sie an den Server übergeben können, indem Sie sie einchecken.

So erstellen Sie einen Arbeitsbereich, um die Quellcodeverwaltungsdateien zu verwalten

Klicken Sie auf Start, zeigen Sie auf Alle Programme, auf Microsoft Visual Studio 2005 und auf Visual Studio-Tools, und klicken Sie anschließend auf Visual Studio 2005-Eingabeaufforderung.
Geben Sie mkdir c:\projects ein.
Geben Sie cd c:\projects ein.
Geben Sie tf workspace /new /s:servername ein, wobei servername für den Namen von Team Foundation Server, z. B. tf workspace /new /s://team1server, steht, und drücken Sie dann die EINGABETASTE.

Hinweis

Wenn der Standardarbeitsbereichsname bereits vorhanden ist, müssen Sie einen anderen Namen, z. B. "cmdwalkthrough", eingeben.
Erstellen Sie im Dialogfeld Arbeitsbereich erstellen eine Zuordnung zum gewünschten Teamprojekt, und klicken Sie dann auf OK. Weitere Informationen finden Sie unter Arbeiten mit Arbeitsbereichen der Quellcodeverwaltung.

Wenn Sie an der Eingabeaufforderung tf workspaces eingeben, werden alle Arbeitsbereiche angezeigt, die Sie auf dem aktuellen Computer erstellt haben. Weitere Informationen finden Sie unter Befehl Workspaces.

Auf dem Team Foundation Server wird eine Arbeitsbereichsdefinition gespeichert, in der alle Dateien im Arbeitsbereich, die Version, auf der der Arbeitsbereich basiert, sowie sein aktueller Status aufgelistet werden. Weil Arbeitsbereichsdefinitionen auf dem Server gespeichert werden, kann jeder Benutzer mit den entsprechenden Berechtigungen Ihre Arbeitsumgebung auf seinem Computer duplizieren, jedoch ohne ausstehende Änderungen. Weitere Informationen hierzu finden Sie unter Befehl Get.

Hinweis

Sie können ausstehende Änderungen aus einem anderen Arbeitsbereich abrufen, indem Sie die Änderungen im Quellarbeitsbereich zurückstellen und sie anschließend in den Zielarbeitsbereich aufnehmen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Zurückstellen von Elementen, die der Quellcodeverwaltung unterliegen, Gewusst wie: Zurückstellen und Aufnehmen ausstehender Änderungen und Befehl Unshelve.

Hinzufügen und Bearbeiten einer Datei

Nachdem Sie einen Arbeitsbereich erstellt haben, können Sie die Dateien angeben, die Sie der Quellcodeverwaltung hinzufügen möchten, und sie anschließend bearbeiten, bevor Sie die Änderungen einchecken.

So bereiten Sie eine Datei zum Hinzufügen zur Quellcodeverwaltung vor

Geben Sie an der Eingabeaufforderung notepad 314.cs ein, und drücken Sie dann die EINGABETASTE.
In Editor wird die Frage Möchten Sie eine neue Datei erstellen? angezeigt. Klicken Sie auf Ja..
Geben Sie in Editor using System.IO; ein, speichern Sie die Änderungen, und schließen Sie dann Editor.
Geben Sie an der Eingabeaufforderung tf add 314.cs ein, um der Liste ausstehender Änderungen die Datei hinzuzufügen.
Geben Sie tf status ein, um die ausstehende Hinzufügung von 314.cs zu bestätigen. Mit diesem Befehl können Sie alle ausstehenden Änderungen im aktuellen Arbeitsbereich anzeigen.

In Team Foundation können Sie der Quellcodeverwaltung ein Element nicht in einem einzigen Schritt hinzufügen. Stattdessen fügen Sie dem Satz ausstehender Änderungen im Arbeitsbereich eine Datei hinzu, nehmen die gewünschten Änderungen vor, und senden anschließend alle ausstehenden Änderungen als Einheit an die Quellcodeverwaltung.

Team Foundation erzwingt das Hinzufügen in zwei Schritten, um sicherzustellen, dass Sie den Code im Kontext testen und kompilieren können, bevor Sie ihn auf dem Server einchecken. Dies bedeutet auch, dass keine Änderungen übergeben werden, wenn eine der Änderungen aus irgendeinem Grund nicht an den Server übergeben werden kann.

Einchecken von ausstehenden Änderungen

Wenn Sie einen Satz ausstehender Änderungen einchecken, erstellt Team Foundation eine Differenzmenge.

So checken Sie alle ausstehenden Änderungen im Arbeitsbereich ein

Geben Sie an der Eingabeaufforderung tf checkin ein.
Geben Sie im Dialogfeld Einchecken im Feld Kommentar einen Kommentar ein, der die Art der Änderungen beschreibt, und klicken Sie dann auf Einchecken.

Eine Differenzmenge ist ein logischer Container, in dem Team Foundation alle Elemente für einen einzelnen Eincheckvorgang zusammengefasst werden. Die meisten Eincheckvorgänge umfassen mehr Revisionen als das hier angegebene einfache Beispiel. Häufig umfasst ein Eincheckvorgang Änderungen an mehreren Dateien und Ordnern. Daher stellt eine Differenzmenge einen vollständigen Satz von Aufgaben dar, den Sie als Einheit in den Arbeitsbereich abrufen können.

Eine Differenzmenge besteht aus folgenden Elementen:

Revisionen von Quelldateien und -ordnern, z. B. Hinzufügungen, Umbenennungen, Bearbeitungen, Löschungen und Verschiebungen
Zugehörige Arbeitsaufgaben, z. B. Fehler
Systemmetadaten, z. B. Differenzmengennummer, Autor, Datum/Uhrzeit usw.
Eincheckhinweise und Kommentare

In dieser exemplarischen Vorgehensweise müssen Sie auf dem Quellcodeverwaltungsserver eine zweite Version der Datei 314.cs erstellen.

So erstellen Sie eine neue Version einer der Quellcodeverwaltung unterliegenden Datei

Geben Sie an der Eingabeaufforderung tf checkout 314.cs ein.
Geben Sie notepad 314.cs ein.
Fügen Sie in Editor nach using System.IO; eine neue Zeile hinzu, und geben Sie dann using System.Windows; ein.

Hinweis

Mit diesem Schritt wird absichtlich ein Fehler erzeugt. In einem späteren Schritt wird gezeigt, wie die fehlerfreie Version der Datei wiederhergestellt wird.
Speichern Sie die Änderungen, und schließen Sie Editor.
Geben Sie an der Eingabeaufforderung tf checkin ein.
Geben Sie im Dialogfeld Einchecken im Feld Kommentar einen Kommentar ein, klicken Sie auf Einchecken, um die ausstehenden Änderungen als neue Differenzmenge an den Server zu übergeben, und erstellen Sie gleichzeitig auf dem Quellcodeverwaltungsserver Version 2 von 314.cs.

Wiederherstellen des zu einem bestimmten Zeitpunkt vorhanden Zustands

Softwareentwickler werden häufig gebeten, den Zustand ihrer Arbeitsumgebung wiederherzustellen, der vor zwei Monaten vorhanden war, und eine zielgerichtete Korrektur an einem bestimmten Build vorzunehmen. Manchmal kennen sie nicht den genauen Zeitpunkt, zu dem sie eine einzelne Codezeile eingefügt haben, doch sie erinnern sich an die Aufgabe, für die dies erfolgt ist.

Für einen Entwickler ist eine Differenzmengennummer ein eindeutiger Bezeichner für einen Satz zusammengehöriger Datei- und Ordnerrevisionen. In Team Foundation Server ist eine Differenzmengennummer jedoch eine Versionsnummer für den gesamten Quellcodeverwaltungsserver zu einem bestimmten Datum und einer bestimmten Uhrzeit.

Daher können Sie den Arbeitsbereich genau auf den Zustand des Servers zurücksetzen, in dem sich dieser befand, als Sie die problematische Codezeile using System.Windows; eingecheckt haben.

So synchronisieren Sie einen Arbeitsbereich mit einer Differenzmenge

Geben Sie an der Befehlszeile tf get /version:C<##> ein, wobei <##> für die Nummer der Differenzmenge steht, die Version 1 von 314.cs enthält.

Hinweis

Sie können die richtige Differenzmenge mit dem history-Befehl für die Datei 314.cs abrufen. Geben Sie z. B. in der Befehlszeile tf history 314.cs ein.

Mit diesem Befehl wird eine Arbeitskopie aller zugeordneten Dateien und Unterordner vom Server in den lokalen Arbeitsbereich abgerufen und zwar in dem Zustand, den sie zum Zeitpunkt der Erstellung von Differenzmenge <##> aufgewiesen haben. Wenn Sie jetzt 314.cs in Editor öffnen, wird nur die Zeile "using System.IO;" angezeigt.

Sicherheit

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

Siehe auch