¿Qué aprenderá?

Al finalizar este tutorial el estudiante estará en capacidad de configurar el entorno de trabajo para el desarrollo del proyecto del curso.

¿Qué obtendrá?

1. Acceso al espacio de su equipo en GitHub.
2. Las herramientas instaladas y los elementos necesarios para la ejecución del front.

¿Qué necesita?

Es necesario que tenga:

1. Manejo básico de GitHub.
2. Manejo de consola de comandos.

Para comenzar, cree una cuenta en GitHub con su correo uniandes o asocie el correo uniandes a una cuenta existente. Para esto último, vaya al perfil de su usuario y seleccione la opción Settings.

Imagen 1. Selección de la opción Settings.

Luego seleccione la opción Emails y agregue su correo uniandes.

Imagen 2. Selección de la opción Emails.

Luego de esto recibirá un correo de GitHub para finalizar el proceso de asociar el correo a su cuenta.

En Github existe una organización para el curso donde se encuentran creados los grupos (teams) y los repositorios de los proyectos de cada equipo.

Para acceder a su repositorio:

1. Acepte la invitación que le llegó de GitHub en donde se le pide ser parte de un equipo.
2. Una vez que acepte la invitación, debe poder ver el repositorio de su equipo..

Se requiere configurar, desde la línea de comandos de su máquina, el usuario que hace los commits en Git.

Si esto no se hace todos los commits aparecerán realizados por un usuario no determinado, por tanto, no será posible argumentar la autoría de los commits y esto tendrá un impacto negativo en el seguimiento semanal del proyecto.

Una vez haya abierto la línea de comandos ingrese las siguientes instrucciones:

git config --global user.name "su nombre"
git config --global user.email sulogin@uniandes.edu.co

El siguiente paso consiste en la instalación y configuración de herramientas. Para ello, instale las herramientas que se mencionan a continuación. Las versiones fueron las usadas al momento de realizar y probar este tutorial.

Tabla 1. Herramientas necesarias para el desarrollo del proyecto.

Node.js

Después de la instalación de Node, se requiere instalar algunos paquetes. Para esto, vaya a una consola y ejecute los siguientes comandos:

npm install -g typescript

npm install -g @angular/cli

Visual Studio Code

Luego de la instalación de VSCode, se recomienda instalar las siguientes extensiones:

Angular Essentials V.9 de John Papa

Angular Files V. 1.2.2 por Alexander Ivanichev

Clone el repositorio asignado a su equipo. Tenga en cuenta que la URL del repositorio tendrá la forma https://github.com/MISW-4104-Web/202212_EquipoXX donde XX corresponde al número de su equipo.

Para clonar el repo tiene dos opciones: hacerlo mediante https o mediante ssh. Para clonar el repo con https debe usar un Personal Access Token. En el siguiente enlace se explica el proceso para obtenerlo:

https://docs.github.com/es/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token

Para clonar el repo con ssh siga las instrucciones de este documento:

https://docs.github.com/es/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account

Luego de clonar el repositorio abra una terminal y ubíquese en el directorio donde clonó el proyecto. Luego ejecute en la terminal el comando npm install.

En una terminal, en el directorio donde clonó el proyecto ejecute el comando ng serve. Esto lanzará un servidor web que escucha peticiones en el puerto 4200. Luego, abra un navegador y navegue a la URL http://localhost:4200. Si todo funcionó correctamente deberá aparecer una página similar a esta: