Existen dos formas de descargar el código de Duckietown desde Github. La primera y más simple es vía HTTPS mientras que la segunda es vía SSH, método levemente más complejo pero por suerte algunos pasos se deben hacer una sola vez. Los siguientes pasos serán comunes para ambos métodos.
Aquí basta solo ingresar mediante el siguiente [enlace] (https://github.com/Duckietown-Chile/Software). Mientras, dejaremos la página abierta en el navegador.
Puedes buscarla o simplemente presionar Ctrl + ALt + T en tu teclado. Una abierta la terminal, debes asegurarte que estás en el directorio home de Ubuntu, para acceder a él basta con escribir el comando cd y luego clickear ENTER en tu terminal. Esto te llevará directamente al directorio si es que no estabas en él.
Ahora debemos volver a la pagina que habíamos abierto inicialmente en el navegador, donde en el extremo superior derecho de la lista de carpetas podemos hallar un botón verde que dice Clone or download, lo clickeamos y se desplegará una pequeña pestaña la que dirá Clone with SSH o bien Clone with HTTPS (el valor por defecto depende de si la habías abierto previamente). En esta pestaña, para ambas opciones aparece una casilla con un texto el cual deberemos copiar.
El siguiente paso es común para clonar via SSH o vía HTTPS, si nunca haz clonado vía SSH debes completar primero los pasos descritos aquí, si lo vas a hacer vía HTTPS o ya completaste los pasos descritos en el link alguna vez en tu computador puedes seguir con lo que viene a continuación. Una vez copiado el enlace de la casilla nos dirigimos nuevamente a la terminal donde asegurándonos de que estamos en la carpeta home escribimos:
git clone "TEXTOCOPIADO" duckietown
Donde git clone corresponde a un comando de git que le indíca al mismo git que debe clonar en el directorio actual algun repositorio en específico. En este caso el repositorio lo obtendrá del link que hemos copiado el cual debemos reemplazar en el comando descrito más arriba en donde dice "TEXTOCOPIADO" (incluyendo las comillas). Finalmente se escribe duckietown para asignar un nombre a la carpeta a crear (en el caso de no escribir un nombre para la carpeta, git, por defecto asigna el nombre del repositorio). Habiendo completado este paso podemos clickear ENTER, lo que dará inicio a la descarga del repositorio
Si realizaste el proceso vía HTTPS y no obtuviste ningún error durante la descarga, felicitaciones!, ya estás listo para utilizar el software de duckietown, pero si obtuviste alguna especie de error, deberás completar los pasos descritos en el link del punto 1.4 para luego repetir el proceso del mismo punto, pero con la diferencia de que ahora debes clickear la esquina superior derecha de la pestaña en Use SSH y copiar el texto de esa sección.
Una vez realizados los pasos de la sección anterior debemos proceder con la ejecución de ciertos scripts para utilizar el software de Duckietown. Si hemos completado correctamente los pasos anteriores, ahora dentro del directorio home debiera existir una carpeta llamada duckietown, lo puedes verificar escribiendo el comando ls en la terminal y luego presionando ENTER, donde se desplegará una lista de archivos y carpetas. Una vez hallas verificado esto, debes acceder a la carpeta escribiendo o directamente copiando lo siguiente:
cd duckietown
Primero que todo debemos inicializar el script environment.sh en la terminal, el que se encuentra en la misma carpeta duckietown, puedes verificar entre los archivos nuevamente utilizando el comando ls descrito más arriba (notar que este paso no es necesario, pero es bueno acostumbrarse a los comandos de Ubuntu). Ahora debes ejecutar el script, para ello basta con copiar y pegar la siguiente línea en tu terminal
source environment.sh
Donde el comando sourcesimplemente ejecuta el contenido del script en cuestión en la terminal actual.
Ahora, sin cambiarnos de directorio ejecutamos el siguiente comando
make build
Lo que hará una serie de cosas, entre ellas crear una carpeta dentro de catkin_ws llamada build. En el caso de tener problemas durante este proceso (que en general puede deberse a procesadores con pocos nucleos), puedes ejecutar el siguiente comando en vez del anterior:
make build-single
Si ninguno de los dos comandos no funciona, no dudes en contactar al equipo docente de Duckietown!