Freigeben über

Plattformübergreifender Befehlszeilenclient – Leitfaden für Einsteiger

  • Artikel

Wenn Sie Anwendungen auf allgemeinen UNIX-Plattformen entwickeln, können Sie mit dem plattformübergreifenden Befehlszeilenclient auf Team Foundation Server zuzugreifen und Versionskontrollvorgänge ausführen.

Im Folgenden werden die ersten Schritte mit dem Befehlszeilenclient gezeigt:

  1. Installieren Sie den plattformübergreifenden Befehlszeilenclient:

    1. Entzippen Sie das Archiv (ZIP-Datei), das den Client enthält.

    2. Konfigurieren Sie die Shell oder den Systempfad so, dass der Ordner eingeschlossen wird, in dem die entzippten Dateien archiviert werden.Stellen Sie sicher, dass sich die Java-Laufzeitumgebung oder das Java Development Kit im Pfad befindet oder dass Sie die JAVA_HOME-Umgebungsvariable festgelegt haben.

    3. Überprüfen Sie, ob der Client funktioniert, indem Sie an einer Eingabeaufforderung tf eingeben und dann die EINGABETASTE drücken.

      Wenn der Client ordnungsgemäß installiert ist, wird eine Ausgabe angezeigt, die mit Team Explorer Everywhere beginnt.

      Wenn Sie Informationen zu einem der Befehle anzeigen möchten, geben Sie tf help Befehlein, wobei Befehl der Name des Befehls ist, für den Sie Informationen abrufen möchten.Beispiel: tf help checkin.

  2. Zeigen Sie die Microsoft-Softwarelizenzbedingungen für den plattformübergreifenden Befehlszeilenclient an und akzeptieren Sie sie.Sie müssen den nachfolgenden Befehl für die Lizenzbedingungen ausführen, bevor Sie Versionskontrollvorgänge ausführen können.

    tf eula

    Die Microsoft-Softwarelizenzbedingungen werden angezeigt.Sie müssen "ja" oder "j" eingeben, um die Bedingungen zu akzeptieren.

  3. Führen Sie den Befehl workspace aus, um einen lokalen Arbeitsbereich zu erstellen.Ein Arbeitsbereich enthält einen Satz clientseitiger Ordner auf dem lokalen Datenträger, die den der Versionskontrolle unterliegenden Ordnern in Team Foundation Server zugeordnet sind.

    Im folgenden Beispiel wird ein neuer Arbeitsbereich namens Beta1 in der TFS-Auflistung "http://myserver:8080/tfs/DefaultCollection" erstellt.

    tf workspace -new Beta1 -collection:http://myserver:8080/tfs/DefaultCollection
    HinweisHinweis

    Wenn Sie einen Arbeitsbereich erstellen oder bearbeiten, können Sie angeben, ob er sich an einem lokalen Speicherort oder einem Speicherort auf einem Server befindet.Die Standardeinstellung ist der lokale Speicherort.So können Sie schnell Kontrollvorgänge für die Kernversion ausführen, auch wenn Sie offline arbeiten.

  4. Führen Sie den Befehl workfold aus, um Arbeitsbereichszuordnungen zwischen lokalen Ordnern und Ordnern auf dem Server zu erstellen.In der Standardeinstellung werden Arbeitsbereichszuordnungen rekursiv angewendet.Wenn Sie einen lokalen Ordner einem Ordner auf dem Server zuordnen, werden im System implizit Zuordnungen zwischen allen aktuellen und zukünftigen Unterordnern erstellt.

    Im folgenden Beispiel wird der Ordner /Users/Example im Arbeitsbereich Beta1 dem Serverordner $/ScrumProject/JavaSample der Team Foundation-Versionskontrolle zugeordnet.

    tf workfold -map $/ScrumProject/JavaSample -workspace:Beta1 /Users/Example

  5. Ändern Sie den Pfad in den lokalen Pfad des Arbeitsordners, den Sie zugeordnet haben.Beispiel:

    cd /Users/Example

  6. Führen Sie den Befehl get aus, um eine Kopie einer Datei von Team Foundation Server abzurufen oder den Arbeitsbereich mit den zuletzt eingecheckten Änderungen auf dem Server zu synchronisieren.Beispiel:

    tf get

  7. Bearbeiten Sie eine Datei.Änderungen werden im lokalen Arbeitsbereich als ausstehende Änderungen markiert.

  8. Erstellen Sie eine neue Datei und machen Sie daraus eine ausführbare Datei.Beispiel:

    $ chmod u+x HelloWorld.sh

  9. Führen Sie den Befehl add aus, um Team Foundation Server die neue Datei hinzuzufügen.Beispiel:

    tf add Helloworld.sh

  10. Führen Sie den Befehl status aus, um Informationen zu ausstehenden Änderungen an Elementen im Arbeitsbereich zu überprüfen.

    tf status

  11. Führen Sie den Befehl checkin aus, um ausstehende Änderungen vom aktuellen Arbeitsbereich in Team Foundation Server einzuchecken.

    Im folgenden Beispiel werden die ausstehenden Änderungen für die Arbeitsaufgabe 11 im aktuellen Arbeitsbereich zusammen mit dem angegebenen Kommentar auf den Server für die Team Foundation-Versionskontrolle übermittelt, um ein neues Changeset zu erstellen.

    tf checkin -comment:"Fixed a bug” -associate:11
HinweisHinweis

Weitere Informationen zur Befehlssyntax und dem Herstellen der Verbindung mit Team Foundation Server finden Sie unter Befehlszeilensyntax (Team Explorer Everywhere) und Befehlszeilenauthentifizierung für Team Explorer Everywhere.

Sie haben nun die grundlegenden Versionskontrollvorgänge mit dem Befehlszeilenclient abgeschlossen.Im Folgenden finden Sie einige weitere Vorgänge, die Sie unter Umständen ebenfalls benötigen:

  • Führen Sie den Befehl rename aus, um den Namen oder den Pfad einer Datei oder eines Ordners zu ändern.

    Im folgenden Beispiel wird der Name von test1.txt in NewTest.txt geändert.

    tf rename test1.txt NewTest.txt

  • Führen Sie den Befehl delete aus, um eine Datei oder einen Ordner von Team Foundation Server zu entfernen und vom Datenträger zu löschen.Die Ergebnisse dieses Befehls sind in anderen Arbeitsbereichen erst dann sichtbar, wenn Sie einen Eincheckvorgang ausführen.Beispiel:

    tf delete Test-new.txt
    HinweisHinweis

    Wenn Sie ein Element aus Ihrem Arbeitsbereich gelöscht haben, die Änderung aber noch nicht eingecheckt wurde, können Sie das Element mit dem Befehl undo im Arbeitsbereich wiederherstellen und den Löschvorgang aus der Liste der ausstehenden Änderungen entfernen.

    Sie können kein Element löschen, für das eine weitere ausstehende Änderung vorhanden ist.Beispielsweise können ausgecheckte Dateien nicht gelöscht werden.Zum Löschen solcher Elemente müssen Sie die aktuell ausstehende Änderung rückgängig machen.
HinweisHinweis

Wenn Sie nicht Befehle nicht zeilenweise eingeben möchten, können Sie ein Skript schreiben, um alle oben aufgeführten Aufgaben zu automatisieren.Siehe Erstellen von Skripts auf dem plattformübergreifenden Befehlszeilenclient für Team Foundation Server.

Siehe auch

Konzepte

Befehlszeilenauthentifizierung für Team Explorer Everywhere

Festlegen von Umgebungsvariablen (Team Explorer Everywhere)

Erstellen von Skripts auf dem plattformübergreifenden Befehlszeilenclient für Team Foundation Server

Application Lifecycle Management mit Visual Studio und Team Foundation Server

Weitere Ressourcen

Einsetzen von Team Explorer Everywhere

Befehlszeilensyntax (Team Explorer Everywhere)