Normas para la realización de las Prácticas

Transcripción

1 Normas para la realización de las Prácticas Ingeniería del Software I 4º IINF. Plan Carácter de las Prácticas La realización y entrega de las prácticas son obligatorias. Las prácticas se realizarán en grupos de dos ó tres alumnos. Los componentes de cada grupo quedarán definidos en la entrega de la primera práctica. No se permite la modificación de los integrantes de un grupo. No se guardan las prácticas de años anteriores para el curso actual o cursos sucesivos. La calificación de cada práctica se realizará y publicará en la Web en el periodo máximo de las dos semanas posteriores a su entrega. Ingeniería del Software I 4º IINF. Plan

2 Material requerido La prácticas se realizarán en un entorno operativo Linux con kernel 2.6.x., en los laboratorios de La Escuela. Se recomienda utilizar una distribución Linux del tipo Live-CD (KNOPPIX, ) ó instalación fija (UBUNTU, Debian,...) En este caso se tendrá la facilidad de proseguir la realización las prácticas en cualquier otro lugar. Se recomienda disponer de una memoria ó disco USB para el almacenamiento y transporte del código de la práctica. El profesor desplegará la descripción de la práctica en la Web del curso como muy tarde el día anterior a la realización de la misma. El nº de Aula se notifica en la misma Web. Se aconseja llevar impresa la descripción de la práctica al laboratorio. Ingeniería del Software I 4º IINF. Plan Fecha y Lugar de las Prácticas Ingeniería del Software I 4º IINF. Plan

3 Formato de Entrega (I) Las prácticas se entregarán por correo electrónico a la dirección javmar@arrakis.es. Toda el conjunto de la práctica (documentación, programas,...) se entregará, en un único archivo comprimido en formato tar.gz, adjunto a dicho correo electrónico: Es obligatorio incluir un archivo de mantenimiento GNU Make Makefile con los targets all, clean y dist como mínimo. Ingeniería del Software I 4º IINF. Plan Formato de Entrega (II) Ejemplo de Makefile # Example of Makefile for all the practices (i.e. lab1) LAB = lab1 GROUP = g01 DISTFILES = Makefile lab1a.c lab1b.c PROGRAMS = lab1a lab1b all: $(PROGRAMS) lab1a: lab1a.c $(CC) -Wall -O2 -o $@ $^ lab1b: lab1b.c $(CC) -Wall -O2 -o $@ $^ run: lab1a lab1b./lab1a./lab1b clean: dist: rm -f $(PROGRAMS) *.o *.bak clean mkdir $(NAME)-$(GROUP) cp $(DISTFILES) $(LAB)-$(GROUP) tar cvzf $(LAB)-$(GROUP).tar.gz $(LAB)-$(GROUP) rm -rf $(LAB)-$(GROUP) Ingeniería del Software I 4º IINF. Plan

4 Formato de Entrega (III) Además de los targets anteriores pueden existir los siguientes targets : lib, deploy, doc, run, install, remove,... Para las prácticas en Java se acepta como alternativa a GNU Make el programa Apache Ant con archivo de construcción build.xml. Es obligatorio, también, incluir un fichero de texto plano de nombre readme.txt en el que se identifiquen: El número del grupo Los componentes del grupo Instrucciones de construcción y ejecución de la práctica Ingeniería del Software I 4º IINF. Plan Documentación (I) La documentación de la práctica se entregará en un único archivo con formato Adobe PDF (i.e.: lab1.pdf,, lab5.pdf). Se calificará positivamente la utilización de herramientas de generación automática de documentación a partir de los comentarios del código fuente como: javadoc Para código fuente en java Licencia: Sun Microsystems, Inc. Binary Code License Agreement Doxygen Para código fuente en C, C++ y java Licencia: GNU General Public License Ingeniería del Software I 4º IINF. Plan

5 Presentación Las prácticas se entregarán por medio del correo electrónico a la dirección javmar@arrakis.es El Asunto del correo ha de ser Ingeniería de Software I - práctica P grupo G siendo: P es el número de práctica: 1,2,..., 5 G es el número de grupo. El número de grupo quedará asignado a la entrega de la primera práctica, mediante correo de respuesta. En la primera práctica deben de quedar perfectamente identificados los alumnos que componen el grupo. La entrega de cada práctica debe de realizarse antes de la cuarta semana transcurrida desde su realización. Ingeniería del Software I 4º IINF. Plan Procedimiento utilizado por el profesor en la corrección de las prácticas $ # se definen el número de práctica y el número de grupo a corregir $ export GROUP g01 $ export LAB lab1 $ # se extraen lof ficheros que comprenden la práctica $ tar xvzf $LAB-$GROUP.tar.gz... $ cd $LAB-$GROUP $ # se visualiza la documentación de la práctica $ cat readme.txt $ kpdf $LAB.pdf & $ make $ # se continua con mandatos específicos de cada práctica $ # finalización de la corrección $ make clean $ cd.. $ rm rf $LAB-$GROUP Ingeniería del Software I 4º IINF. Plan

6 Criterios de Evaluación Cumplimiento de la presente normativa. Calidad de la documentación Fichero Makefile completo. Ejecución de los diferentes targets del Makefile sin warnings ni errores. Cumplimiento de los requisitos funcionales de los programas desarrollados. Warnings y errores de construcción. Warnings y errores de ejecución. Ficheros intermedios (.o,.bak,.tmp, ejecutables, ) en el fichero de envío de la práctica (.tar.gz). Ingeniería del Software I 4º IINF. Plan Bibliografía I Advanced Linux Programming Mark Mitchell, Jeffrey Oldham, and Alex Samuel Published by New Riders Publishing ISBN First Edition, June Introduction to Linux - A Hands on Guide Machtelt Garrels Edition 230 páginas (1,54 MB) Ingeniería del Software I 4º IINF. Plan

7 Bibliografía II Linux Device Drivers, 3rd Edition Jonathan Corbet, Alessandro Rubini, Greg Kroah- Hartman This book is available under the terms of the Creative Commons Attribution-ShareAlike 2.0 license). l LinuxQuestions.org Man Pages Online Ingeniería del Software I 4º IINF. Plan