跨平台命令行客户端 - 初学者指南

项目
06/09/2015

如果要在常用的 UNIX 平台上开发应用程序，则可以使用跨平台命令行客户端访问 Team Foundation Server 和执行版本控制操作。

这是利用命令行客户端开始的方法：

安装跨平台命令行客户端：
1. 解压缩包含该客户端的存档（.zip 文件）。
2. 配置 shell 或系统路径包括提取的存档文件的文件夹。确保路径中具有 Java 运行时环境或 Java 开发工具包或已设置 JAVA_HOME 环境变量。
3. 验证客户端是否工作，在命令提示符处键入 tf，然后选择**“输入“**键。
  
  如果正确安装客户端，则显示以 Team Explorer Everywhere 开头的输出。
  
  有关任何命令的信息，键入“tf help Command（命令），其中Command 是您想要了解相关信息命令的名称。例如，键入 tf help checkin。
查看并接收针对“跨平台命令行客户端”的“ Microsoft 软件许可证条款”。在您执行任何版本控制操作之前，必须运行下面的 EULA 命令。
```
tf eula
```
Microsoft 软件许可条款将随即显示。需要键入类型“是”或“y”方可接受条款。
运行 工作区 命令，以创建一个本地工作区。工作区包括本地磁盘上的客户端文件夹，这些文件夹映射到 Team Foundation server 上受版本控制的文件夹。

下面的示例在 TFS 集合“http://myserver:8080/tfs/DefaultCollection”创建名为 Beta1 的新工作区。
```
tf workspace -new Beta1 -collection:http://myserver:8080/tfs/DefaultCollection
```
备注

当您创建或编辑工作区时，可以指定其位置是否为本地或服务器上。本地是默认设置。在脱机时，它使您能够快速执行核心版本控制操作。
运行 workfold 命令可以在本地文件夹和服务器上的文件夹之间创建一个的工作区映射。默认情况下，工作区映射是递归应用的。在将本地文件夹映射到服务器文件夹时，系统将在其所有当前和将来的子文件夹之间隐式创建映射。

以下示例将工作区 Beta1 中文件夹/用户/示例映射到 Team Foundation 版本控制服务器文件夹 $/ScrumProject/JavaSample。
```
tf workfold -map $/ScrumProject/JavaSample -workspace:Beta1 /Users/Example
```
将目录更改为已映射的本地工作文件夹的路径。例如，
```
cd /Users/Example
```
运行获取命令，以从 Team Foundation Server 中检索文件的副本或使您的工作区与对服务器最近签入的更改进行同步。例如，
```
tf get
```
编辑文件。所做的更改将在本地工作区中标记为挂起的更改。
创建一个新文件并使其可执行。例如，
```
$ chmod u+x HelloWorld.sh
```
运行添加命令，以将新文件添加到 Team Foundation Server。例如，
```
tf add Helloworld.sh
```
运行状态命令，以查看有关对工作区中的项所做的挂起更改的信息。
```
tf status
```
运行签入命令，以从当前工作区将挂起的更改签入到 Team Foundation Server。

下面的示例将当前工作区中的关联工作项 11 的所有挂起的更改以及指定的注释一起提交到 Team Foundation 版本控制服务器，以创建新的变更集。
```
tf checkin -comment:"Fixed a bug” -associate:11 
```

备注

有关命令语法和连接到 Team Foundation Server 的更多信息，请参见命令行语法 (Team Explorer Everywhere) 和 Team Explorer Everywhere 的命令行身份验证。

现在您已使用命令行客户端完成最基本的版本控制操作。这是另一些您可能需要的操作：

运行 重命名 命令更改文件或文件夹的名称或路径。

下面的示例将 test1.txt 的名称更改为 NewTest.txt。
```
tf rename test1.txt NewTest.txt
```
运行删除命令，以从 Team Foundation Server 删除文件或文件夹，并从磁盘中将其删除。在您执行签入操作之前，其他工作区中无法看到此命令的结果。例如，
```
tf delete Test-new.txt
```
备注

如果您已删除了工作区中的某个项，但还未签入更改，则可以使用 undo 命令将该项还原到工作区，并将该删除从挂起的更改列表中移除。

无法删除存在其他挂起更改的项。例如，不能删除已签出的文件。要删除这种项，必须撤消当前挂起的更改。