Para poder realizar este taller ud debe:
- Tener aprovisionada su máquina virtual para el curso ISIS2603. Si aún no lo ha hecho, por favor, vaya al curso en BS y siga las instrucciones para obtener su máquina virtual y para acceder a ella.
- Tener su cuenta de GitHub asociada con su correo @uniandes
- Haber aceptado la invitación a la organización GitHub Uniandes-isis2603. Revise su correo con la invitación y no olvide revisar la bandeja de spam.
Temas a tratar
- Verificar que puede acceder a la organización
- Clonar el repositorio
- Abrir los proyectos
- Compilar la aplicación
- Visualizar la aplicación
Organización github del curso
En GitHub existe la organización https://github.com/Uniandes-isis2603 donde se encuentran creados los grupos (teams) y los repositorios de los proyectos de cada equipo.
El repositorio de su grupo para el proyecto front es AñoSemestre_SX_EY_NombreProyecto_Front, donde Año es el año actual, semestre es el semestre actual, X es el número de su sección, Y el número de su equipo y NombreProyecto es el nombre de su proyecto.
Abra una nueva terminal, vaya a la ruta C:\Users\Estudiante (cd C:\Users\Estudiante) e ingrese el comando npm install -g @angular/cli
Esto instalará Angular y solo será necesario hacerlo una vez.
Para garantizar que pueda tener acceso a los comandos de Angular, debe incluir la ruta de instalación en las variables de entorno del sistema. Para esto, vaya a Panel de control > Sistema y seguridad > Sistema > Configuración avanzada del sistema. Luego seleccione Variables de entorno. En el panel Variables de usuario para estudiante seleccione la variable Path y haga clic en editar. Sin borrar los datos que están allí, vaya al final de la línea, coloque punto y coma y agregue la ruta "C:\Users\Estudiante\AppData\Roaming\npm".
Instrucciones básicas
Para clonar un repositorio de GitHub, es decir crear una copia en su máquina del repositorio en GitHub y guardar información para su posterior sincronización, ud debe:
- Estar logueado en la máquina virtual con el usuario estudiante
- Estar ubicado en una carpeta donde va a crear la copia del repositorio.
- La carpeta debe estar ubicada en el directorio raíz en una ruta que no contenga espacios
- Tener la url del repositorio front que va a clonar
- Tener instalado en la máquina donde va a clonar un cliente de git.
Para el caso del proyecto del curso, en su máquina virtual ya está instalado un cliente de git (en la línea de comandos).
URL del repo que se va a clonar
En GitHub.com localice el repositorio que va a clonar, seleccione "Clone or download" y copie la url.
Clonar desde línea de comandos
Desde una línea de comandos vaya a la carpeta de su preferencia e ingrese el comando:
git clone url
donde url corresponde a la dirección del repositorio (por ejemplo, git@github.com:Uniandes-isis2603/202110_S1_E4_Kindergarten_Front.git)
Luego aparecerá una ventana emergente en la que se le pedirán las credenciales de GitHub.
Para abrir el proyecto se sugiere tener instalado Visual Studio Code, el cual lo puede descargar desde esta dirección: https://code.visualstudio.com/
Una vez haya instalado Visual Studio Code, abra la carpeta en donde clonó el proyecto.
En Visual Studio Code, abra una nueva terminal y asegúrese de que está en la raíz de su proyecto. Luego, ingrese el comando npm install. Esto instalará las dependencias necesarias.
Para ejecutar la aplicación, desde la misma terminal e ingrese el comando ng serve.
Vaya a un navegador e ingrese la dirección http://localhost:4200
