Cliente de línea de comandos multiplataforma - Guía para principiantes

Artículo
02/19/2013

Si está desarrollando aplicaciones en plataformas UNIX comunes, puede usar el Cliente de línea de comandos para varias plataformas para tener acceso a Team Foundation Server y realizar operaciones de control de versiones.

Aquí se describe cómo comenzar a usar el cliente de la línea de comandos:

Instale el Cliente de línea de comandos para varias plataformas:
1. Descomprima el archivo (archivo .zip) que contiene el cliente.
2. Configure la ruta de acceso del shell o del sistema para que incluya la carpeta donde se almacenan los archivos descomprimidos. Asegúrese de que tiene Java Runtime Environment o Java Development Kit en la ruta o que ha establecido la variable de entorno JAVA_HOME.
3. Para comprobar que el cliente está funcionando, en el símbolo del sistema, escriba tf y, a continuación, elija la tecla Entrar.
  
  Si el cliente está correctamente instalado, la salida que se inicia con Team Explorer Everywhere aparece.
  
  Para obtener información sobre cualquiera de los comandos, escriba tf help Comando, donde Comando es el nombre del comando para el que desea obtener la información. Por ejemplo, escriba tf help checkin.
Ver y aceptar los Términos de licencia del software de Microsoft para el cliente multiplataforma de línea de comandos. Debe ejecutar el comando EULA siguiente antes realizar cualquier operación de control de versiones.
```
tf eula
```
Aparecerán los Términos de licencia de software de Microsoft. Debe escribir “yes” o “y” para aceptar los términos.
Ejecute el comando workspace para crear un área de trabajo local. Un área de trabajo incluye carpetas del lado cliente del disco local asignadas a carpetas con control de versiones en Team Foundation Server.

El ejemplo siguiente crea una nueva área de trabajo denominada Beta1 en la colección de TFS “http://myserver:8080/tfs/DefaultCollection”.
```
tf workspace -new Beta1 -collection:http://myserver:8080/tfs/DefaultCollection
```
Nota

Cuando crea o modifica un área de trabajo, puede especificar si su ubicación es local o está en un servidor. Local es el valor predeterminado. Permite realizar rápidamente operaciones básicas del control de versiones incluso cuando está sin conexión.
Ejecute el comando workfold para crear asignaciones del área de trabajo entre carpetas locales y carpetas del servidor. De forma predeterminada, las asignaciones de área de trabajo se aplican de forma recursiva. Cuando asigna una carpeta local a una carpeta de servidor, el sistema crea implícitamente una asignación entre todas sus subcarpetas actuales y futuras.

El ejemplo siguiente asigna la carpeta /Users/Example del área de trabajo Beta1 a la carpeta del servidor control de versiones de Team Foundation $/ScrumProject/JavaSample.
```
tf workfold -map $/ScrumProject/JavaSample -workspace:Beta1 /Users/Example
```
Cambie el directorio para la ruta de acceso de la carpeta de trabajo local asignada. Por ejemplo,
```
cd /Users/Example
```
Ejecute el comando get para recuperar una copia de un archivo de Team Foundation Server o sincronizar el área de trabajo con los cambios protegidos más recientes en el servidor. Por ejemplo,
```
tf get
```
Modificar un archivo. Los cambios se marcan como cambios pendientes en el área de trabajo local.
Cree un nuevo archivo y haga que sea ejecutable. Por ejemplo,
```
$ chmod u+x HelloWorld.sh
```
Ejecute el comando add para agregar el nuevo archivo a Team Foundation Server. Por ejemplo,
```
tf add Helloworld.sh
```
Ejecute el comando status para ver información sobre los cambios pendientes en los elementos del área de trabajo.
```
tf status 
```
Ejecute el comando checkin para proteger los cambios pendientes del área de trabajo actual en Team Foundation Server.

El ejemplo siguiente envía todos los cambios pendientes asociados con el elemento de trabajo 11 del área de trabajo actual al servidor control de versiones de Team Foundation, junto con el comentario especificado, para crear un nuevo conjunto de cambios.
```
tf checkin -comment:"Fixed a bug” -associate:11 
```

Nota

Para obtener más información sobre la sintaxis de comandos y conectar con Team Foundation Server, vea Sintaxis de línea de comandos (Team Explorer Everywhere) y Autenticación de la línea de comandos de Team Explorer Everywhere.

Ahora que ha completado las operaciones más básicas del control de versiones usando el cliente de la línea de comandos. Aquí se muestran algunas operaciones más que puede que también necesite:

Ejecute el comando rename para cambiar el nombre o la ruta de acceso de un archivo o carpeta.

El ejemplo siguiente se cambia el nombre de test1.txt por NewTest.txt.
```
tf rename test1.txt NewTest.txt
```
Ejecute el comando delete para quitar un archivo o una carpeta de Team Foundation Server y eliminarlos del disco. Los resultados de este comando no se ven en otras áreas de trabajo hasta que realice una operación de protección. Por ejemplo,
```
tf delete Test-new.txt
```
Nota

Si ha eliminado un elemento de su área de trabajo pero no ha protegido el cambio, puede restaurar el elemento en su área de trabajo y quitar la eliminación de la lista de cambios pendientes con el comando undo.

No puede eliminar un elemento para el que existe otro cambio pendiente. Por ejemplo, un archivo desprotegido no se puede eliminar. Para eliminar tales elementos, debe deshacer el cambio pendiente actual.