.NET Tutorial 61: Jugando con GitHub e introducción a las pruebas unitarias (Parte I)

En este ‘tocho’ tutorial intentaré enseñaros dos cosas:

– Configurar un proyecto de Visual Studio para trabajar con GitHub

– Una muy breve introducción a las pruebas unitarias 

En esta entrada (Git para ‘pobres’) ya vimos como usar Git con una cuenta de DropBox. En la actualidad, el portal GitHub es probablemente el portal más ‘popular’ de repositorios de código abierto para proyectos colaborativos que utiliza Git para el control de versiones.

En las entradas anteriores ya hablamos como instalar Git, con lo cual os remito a dichas entradas para profundizar más en el tema.

Lo primero que deberíamos hacer es descargar las "Git Extensions": https://code.google.com/p/gitextensions/

Las "Git Extensions" funcionan como una software independiente con lo cual se podrá realizar todo lo comentado con respecto al tema de Git incluso en las versiones "Express" de Visual Studio.

En las versiones "Professional", "Premium" y/o "Ultimate" de Visual Studio es posible realizar acciones adicionales, pero que tampoco son "vitales".

 

GitHub

Lo primero que deberemos hacer es crearnos una cuenta en la página de GitHub para poder crear nuestros repositorios de código. Así que ya estás haciendo clic en esta dirección https://github.com/ y creandote una nueva cuenta.

Una vez creada la cuenta, ya podrás crear tus repositorios de código abierto. 


(Haz click para agrandar)

En esa pantalla deberás apuntarte la dirección SSH de tu repositorio. La necesitaremos más tarde para configurar por primera vez nuestro proyecto de Visual Studio.

También deberás añadir una "clave de publicación" (ahora veremos como se genera dicha clave, tranquilo). Para ello pulsa en el icono de opciones: 


(Haz click para agrandar)

Selecciona Deploy Keys. 


(Haz click para agrandar)

Y en Add deploy key pega tu clave pública. (repito, más tarde veremos como se genera esa clave)

Si tienes Visual Studio Professional o superior, es recomendable establecer el control de código fuente a Git:


(Haz click para agrandar)

El proveedor con control de código Git lo puedes instalar mediante el administrador de extensiones de Visual Studio (repito, solo versiones Professional o superior)

Para ello busca en Galería en línea:

 
(Haz click para agrandar)

y busca "git" (sin las comillas):


(Haz click para agrandar)

Deberás ver el "Git Source Control Provider". Simplemente seleccionalo y dale a instalar (es posible que te pida reiniciar Visual Studio)

Bien, empiezan los primeros pasos. Todo lo que explicaré a continuación sólo hay que hacerlo la primera vez que se crea el proyecto. 

Creamos nuestro proyecto en Visual Studio y sobre la solución pulsamos botón derecho y vemos lo siguiente:


(Haz click para agrandar)

Deberemos pulsar en la opción "Create Git Repository". Esto prepara el directorio de nuestro proyecto de Visual Studio con una serie de ficheros / carpetas que serán necesarias para las gitextensions.

A continuación pulsamos en este icono:

Esto nos mostrará la pantalla de configuración de las "git extensions":


(Haz click para agrandar)

Lo primero que deberemos hacer es generar nuestra clave pública/privada para poder acceder a GitHub. Para ello pulsaremos en Remotos >> PuTTY >> Generar o importar clave:


(Haz click para agrandar)

Se mostrará la siguiente pantalla. Pulsa en Generar: 

A continuación mueve el ratón por la pantalla para generar números "aleatorios" que se usarán en la generación de tu clave:

Una vez generada la clave verás la siguiente ventana:

Primero, copia toda la public key en el portapaples. Usaremos ese texto copiado para pegarlo en la página de la "Deploy key" de GitHub que vimos al principio.

Introduce una contraseña, la que quieras, pero recuerdala.

Puedes guardar tanto la public key como la private key (la private key tendras que guardarla si o si, ya que la necesitaremos para el siguiente paso)

Bien, siguiente paso. Iniciar el agente de autenticación:


(Haz click para agrandar)

Para ello pulsa en Remotos >> PuTTY >> Iniciar agente de autenticación

Verás que en tu barra de tareas de Windows se muestra el agente. Haz click con el botón derecho sobre él y selecciona Add Key:

A continuación busca el fichero con tu clave privada que guardaste antes.

Te pedirá que introduzcas la contraseña que pusiste cuando se generaron las claves.

Paso final. Configurar el repositorio remoto.


(Haz click para agrandar)

Pulsa en Remotos >> Adminstrar repositorios remotos

Se mostrará esta pantalla:

Cosas importates aquí:

En nombre, deberás usar el nombre con el que te has registrado en GitHub

En Url escribe la dirección SSH de tu repositorio (la que vimos en la primera imagen)

Estas direcciones siempre son del tipo:

git@github.com:TUNOMBRE/NombreRepositorio

En PuTTY SSH carga de nuevo tu clave privada, para ello pulsa en Examinar y busca el archivo.

Es importante probar la conexión. Es muy posible que veas una pantalla "negra" pidiendote guardar tus credenciales en una cache. Responde Yes.

Por último, pulsa en Guardar para guardar la configuración de este repositorio remoto.

Si todo es correcto, el primer "commit" debería completarse correctamente.


(Haz click para agrandar)

Para ello pulsa en Commit

Verás la siguiente pantalla: 


(Haz click para agrandar)

Selecciona todos los ficheros pulsado en la flecha indicada.

Finalmente, escribe el motivo del commit y pulsa en Commit y Push:


(Haz click para agrandar)

Si todo es correcto, ahora en tu página de GitHub verás todos los archivos que has subido a tu repositorio.

Si refrescas la solución de Visual Studio ahora veras los "típicos iconos de código de versiones" al lado de los archivos:

 

En la pantalla principal de las "gitextensions" ahora deberías ver que tu código está sincronizado con el código de la rama master que se encuentra en el repositorio de GitHub.


(Haz click para agrandar)

Si ahora por ejemplo, añadimos una nueva clase:

 

Nos vamos a las "gitextensions":


(Haz click para agrandar)

Pulsamos la tecla F5 (o en su defecto Archivo >> Actualizar) y veremos:


(Haz click para agrandar)

Vemos que tenemos un cambio pendiente (precisamente la clase que hemos añadido). Pulsamos en Commit


(Haz click para agrandar)

Pulsamos en la flecha para añadir nuestro archivo, escribimos el motivo del commit y finalmente pulsamos en Commit y Push. Con lo que "subiremos" ese cambio a nuestro repositorio de GitHub.

La única diferencia con respescto a Visual Studio Professional y superiores con respecto a las versiones Express son que como en las versiones Professionales es posible establecer el control de versiones integrado en el propio IDE, veremos esto:


(Haz click para agrandar)

Desde esa pantalla podremos hacer los commits.

Bien, pues esta la la primera parte de este tutorial.

En la segunda parte veremos como realizar pruebas unitarias y hablaremos un poco de la covertura de código.

Si alguien está interesado, el código completo está en el siguiente repositorio 🙂

git@github.com:kernelENREK/tutorial61.git

o bien

https://github.com/kernelENREK/tutorial61

 

 Tags: Git & GitHub, Git para torpes, tutorial Git, Git en Visual Studio, Desarrollo Social, Social Coding

 

Saludos.
mov eax,ollydbgInt 13h

 


Ollydbg ProSignature