Exemplarische Vorgehensweise: Navigieren in der Team Foundation-Quellcodeverwaltung

Artikel
08/20/2007

Diese exemplarische Vorgehensweise veranschaulicht die Features der in Visual Studio 2005 integrierten Quellcodeverwaltung.

In dieser exemplarischen Vorgehensweise wird beschrieben, wie Sie die Quellcodeverwaltung in der integrierten Entwicklungsumgebung von Visual Studio 2005 Team System verwenden. Sie erfahren insbesondere, wie Sie die folgenden Aufgaben ausführen:

Legen Sie Team Foundation als Standard-Plug-In für die Quellcodeverwaltung von Visual Studio 2005 fest.
Erstellen Sie ein neues Projekt in Visual Studio.
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.
Checken Sie die Projektmappe ein.
Fügen Sie eine Datei dem der Quellcodeverwaltung unterliegenden Projekt hinzu, und bearbeiten Sie ein vorhandenes Projekt.
Führen Sie einen Commit für alle ausstehenden Änderungen im lokalen Arbeitsbereich auf dem Quellcodeverwaltungsserver 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.

Festlegen der Team Foundation-Quellcodeverwaltung als Quellcodeverwaltungs-Plug-In

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

Hinweis

Standardmäßig sollte die Quellcodeverwaltung in Team Foundation konfiguriert werden, wenn Team Explorer im Anschluss an Visual Studio installiert wird.

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

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.

Hinzufügen eines Projekts zur Quellcodeverwaltung

Vor dem Hinzufügen eines Projekts zur Quellcodeverwaltung in Team Foundation müssen Sie ein vorhandenes Teamprojekt öffnen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Herstellen einer Verknüpfung mit einem Teamprojekt. Wenn Sie über kein vorhandenes Projekt verfügen, finden Sie unter Exemplarische Vorgehensweise: Erstellen eines neuen Teamprojekts Informationen zum Erstellen eines Projekts.

Wenn Sie zum ersten Mal ein Projekt zur Quellcodeverwaltung hinzufügen, wird automatisch ein Arbeitsbereich für Sie erstellt. Ein Arbeitsbereich ist eine clientseitige Kopie der Dateien und Ordner auf dem Team Foundation-Server. Wenn Sie ein Element, das der Quellcodeverwaltung unterliegt, hinzufügen, bearbeiten, löschen, verschieben, umbenennen oder auf eine andere Weise verwalten, werden die Änderungen beibehalten oder im Arbeitsbereich auf dem lokalen Computer als ausstehende Änderungen gekennzeichnet.

Ein Arbeitsbereich bietet einen abgeschlossenen Bereich, in dem Sie Code schreiben und testen können, ohne die Auswirkungen der Änderungen auf die Stabilität eingecheckter Quellen oder die Auswirkungen der Änderungen anderer Teammitglieder auf Ihre Arbeit berücksichtigen zu müssen. 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 finden Sie unter Arbeiten mit Arbeitsbereichen der Quellcodeverwaltung.

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-Anwendung.
Geben Sie im Feld Name den Namen MyWindowsApp und im Feld Speicherort einen Pfad ein, und klicken Sie dann auf OK.

Im folgenden Verfahren wird das Hinzufügen der neuen Projektmappe zur Quellcodeverwaltung beschrieben. Dabei wird davon ausgegangen, dass eine Verbindung vom aktuellen Computer zum Team Foundation Server besteht. Weitere Informationen über Verbindungen finden Sie unter Gewusst wie: Herstellen einer Verbindung mit Team Foundation Server.

So fügen Sie die Projektmappe der Quellcodeverwaltung hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe, und wählen Sie Projektmappe zur Quellcodeverwaltung hinzufügen aus.
Wählen Sie im Dialogfeld Projektmappe zur Quellcodeverwaltung hinzufügen unter Teamprojekt-Speicherort die Position aus, an der Sie das Projekt oder die Projektmappe hinzufügen möchten. Sie können die Standardwerte übernehmen oder auf Neuen Ordner erstellen klicken und den gewünschten Ordnernamen eingeben. Sie können den Namen des Projektmappenordners auch im Textfeld Geben Sie einen Namen für den Projektmappenordner ein ändern.

Hinweis

Sie können optional auf Erweitert klicken und eine alternative Zuordnung für die Projektmappe auswählen. . Weitere Informationen finden Sie unter Gewusst wie: Auswählen einer alternativen Zuordnung für eine Projektmappe.
Klicken Sie auf OK.

Nachdem Sie einen Commit für die Hinzufügung ausgeführt haben, indem Sie die Änderungen einchecken, wird die Projektmappe auf dem Quellcodeverwaltungsserver hinzugefügt. Weitere Informationen finden Sie unter Senden von Änderungen an den Quellcodeverwaltungsserver.

Hinweis

Projektmappen und Projekte können auch über die Befehlszeile oder das Visual Studio-Menü hinzugefügt werden. Auf diese Weise hinzugefügte Projekte und Projektmappen werden jedoch nicht gebunden. Diese Bindung ist für die Funktionen der Quellcodeverwaltung erforderlich, einschließlich verschiedener Quellcodeverwaltungssymbole, die den Status im Projektmappen-Explorer 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 und Ordnern zur Quellcodeverwaltung, die keine Projekt- oder Projektmappendateien sind.
Klicken Sie im Menü Erstellen auf Projektmappe erstellen, um sicherzustellen, dass die Anwendung ohne Fehler erstellt wurde.

Warnung

Rufen Sie die aktuellen Versionen aller relevanten Quellen vom Server ab, und kompilieren Sie den Code, um sicherzustellen, dass diese ohne Fehler erstellt werden, bevor Sie die ausstehenden Änderungen einchecken. In diesem Fall sind sämtliche ausstehende Änderungen allerdings Hinzufügungen, die bisher noch nicht auf dem Server vorhanden sind. Sie müssen daher nicht zunächst die letzte Version abrufen.
Wenn das Fenster Ausstehende Änderungen derzeit nicht geöffnet ist, zeigen Sie im Menü Ansicht auf Weitere Fenster, und klicken Sie dann auf Ausstehende Änderungen. Klicken Sie im Dialogfeld Ausstehende Änderungen auf Einchecken, um die ausstehenden Änderungen auf dem Server hinzuzufügen. Weitere Informationen finden Sie unter Ausstehende Änderungen und Gewusst wie: Einchecken von ausstehenden Änderungen.

Fenster Ausstehende Änderungen

Sie können sich das Fenster Ausstehende Änderungen als die Befehlskonsole der Quellcodeverwaltung vorstellen. Darin sind die Informationen über den Status des Projekts zusammengefasst. Außerdem ermöglicht es den Zugriff auf die kontextbezogene Quellcodeverwaltung sowie auf Informationen und Befehle für die Verwaltung von Arbeitsaufgaben. Wenn Sie das Fenster Ausstehende Änderungen schließen, können Sie es im Menü Ansicht wieder öffnen. Weitere Informationen finden Sie unter Verwenden der Fenster Einchecken und Ausstehende Änderungen.

Bearbeiten des der Quellcodeverwaltung unterliegenden Projekts

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

Wenn Sie einem Projekt, das der Quellcodeverwaltung 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. Daher werden neu hinzugefügt Dateien nicht automatisch eingecheckt, sondern als ausstehende Änderungen behandelt, die in der Quellcodeverwaltung explizit eingecheckt werden müssen, wodurch auf dem Server eine neue Differenzmenge erstellt wird.

So fügen Sie einem Projekt, das der Quellcodeverwaltung 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. Außerdem wird neben Class1.cs ein Pluszeichen (+) angezeigt, dass das ausstehende Hinzufügen kennzeichnet.

Standardmäßig wird die Datei 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 Quellcodeverwaltung 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 ausgecheckt wird, wenn Sie mit der Bearbeitung beginnen. Das Signalsymbol im Projektmappen-Explorer wird in ein Häkchen geändert, und die Datei wird im Fenster Ausstehende Änderungen der Liste der Quelldateien hinzugefügt.

Synchronisieren des Arbeitsbereichs mit der letzten Serverversion

Führen Sie einen Vorgang für das Abrufen der letzten Version durch, um Ihren Arbeitsbereich mit der letzten Serverversion zu synchronisieren, und erstellen Sie dann das Projekt, bevor Sie es einchecken. Wenn Sie vor dem Einchecken immer synchronisieren und erstellen, vermeiden Sie Fehler bei Integrationsbuilds, wenn Sie und andere Benutzer Änderungen einchecken, die zwar keine Konflikte verursachen, aber inkompatibel sind und ein Kompilieren der Anwendung verhindern.

So synchronisieren Sie den Arbeitsbereich mit der letzten Serverversion und dem Build

Klicken Sie im Quellcodeverwaltungs-Explorer im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe, und klicken Sie dann auf Letzte Version abrufen.
Klicken Sie im Menü Erstellen auf Projekt erstellen, wobei Projekt der Name des Projekts ist. Dieser lautet in diesem Fall MyWindowsApp.

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 der Quellcodeverwaltung in Team Foundation einchecken und das Projekt für die anderen Teammitglieder sichtbar machen.

Hinweis

Wenn die Anwendung nicht erstellt wird und Sie noch keine weiteren Tests durchführen konnten, um die Ursache zu ermitteln, 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 Quellcodeverwaltungsshelvesets.

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 schnell alle ausstehenden Änderungen auf dem Server ein

Klicken Sie im Menü Ansicht auf Ausstehende Änderungen.
Geben Sie im Fenster Ausstehende Änderungen im Feld Kommentar einen Kommentar ein, der die Art der Änderungen, z. B. "Using-Direktive hinzugefügt", und den Grund für die Änderungen beschreibt, z. B. "Unterstützung für Aufrufe der Directory-Klasse".
Ö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 Differenzmengen.
Öffnen Sie den Channel Eincheckhinweise, und füllen Sie die Kommentare zu den Eincheckhinweisen für Codebearbeiter, Sicherheitsbearbeiter und Leistungsbearbeiter aus.

Hinweis

Eincheckhinweise können vom Administrator als erforderliche Felder konfiguriert werden und müssen während des Eincheckens ausgefüllt werden. Erforderliche Felder werden durch eine 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. Im Gegensatz dazu geht Visual Studio beim Einchecken im Projektmappen-Explorer und im Menü Datei davon aus, dass Sie nur das ausgewählte Element einchecken möchten, sofern es sich dabei nicht um einen Dateicontainer handelt, z. B. ein Projekt oder eine Projektmappe.

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 Produktfehler oder Featureanforderungen zu verfolgen und eine Arbeitsaufgabe einem bestimmten Projekt 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. Durch das Zuordnen von Arbeitsaufgaben zu Quellcodeänderungen ermöglichen Sie Verantwortlichkeiten und das Verfolgen des Arbeitsstatus.

Außerdem können Sie und die anderen Teammitglieder bei jedem Eincheckvorgang aussagekräftige und konsistente Hinweise einfügen. Die für das Erstellen des Teamprojekts verwendete Prozessvorlage legt die Form und den Inhalt der Eincheckhinweise fest. Sie kann vom Team Foundation Server-Administrator angepasst werden. 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 zusammengefasst, die Sie im Fenster Ausstehende Änderungen angegeben haben. Dieses Bündel wird dann auf den Team Foundation-Server geuploadet, auf dem für dieses ein Commit als neue Differenzmenge ausgeführt wird. Eine Differenzmenge ist ein Satz von Dateikorrekturen, Eincheckhinweisen, zugeordneten Arbeitsaufgaben und Metadaten für die Quellcodeverwaltung, der auf dem Server als eine einzelne leicht zu verwaltende Einheit gespeichert wird. Weitere Informationen finden Sie unter Arbeiten mit Differenzmengen der Quellcodeverwaltung.

Zum zweiten werden alle in der Differenzmenge enthaltenen Arbeitsaufgaben aktualisiert, indem ihnen Verknüpfungen mit der neu erstellten Differenzmenge 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 durch die Projektvorlage erstellten Verarbeitungsregeln und der Arbeitsablauf werden zum Erstellen des Teamprojekts verwendet, sie können aber vom Team Foundation Server-Administrator geändert und angepasst werden. Weitere Informationen finden Sie unter Anpassen von Prozessvorlagen.

Abschließend wird eine E-Mail-Benachrichtigung an alle Teammitglieder gesendet, die Eincheckbenachrichtigungen abonniert haben.

Sicherheit

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

Nächste Schritte

Nach Abschluss der Schritte in dieser exemplarischen Vorgehensweise können Sie einige komplexere Funktionen in der Quellcodeverwaltung in Team Foundation testen, indem Sie mit Exemplarische Vorgehensweise: Erweiterte Funktionalität der Quellcodeverwaltung fortfahren. In dieser exemplarischen Vorgehensweise werden Verzweigen, Zusammenführen und das Anwenden von Bezeichnungen auf Quellcodeverwaltungselemente beschrieben.

Siehe auch

Freigeben über