Normas para la realización de las Prácticas

(1)

1 Departamento de Sistemas Informáticos

Escuela Técnica Superior de Ingeniería – ICAI Universidad Pontificia Comillas

Normas para la realización de las Prácticas

Ingeniería del Software I – 4º IINF. Plan 2001 1

Normas para

la realización

de las Prácticas

Departamento de Sistemas Informáticos

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.

(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.

(3)

Formato de Entrega (I)

Las prácticas se entregarán por correo electrónico a la dirección [email protected].

Toda el conjunto de la práctica (documentación, programas, ...) se entregará, en un único archivo comprimidoen formato tar.gz, adjunto a dicho correo electrónico:

Es obligatorio incluir un archivo de

mantenimiento “GNU Make”Makefilecon los

“targets”all, cleany distcomo mínimo.

http://www.gnu.org/software/make/manual/make.html

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:

rm -f $(PROGRAMS) *.o *.bak dist: clean

mkdir $(NAME)-$(GROUP) cp $(DISTFILES) $(LAB)-$(GROUP)

tar cvzf $(LAB)-$(GROUP).tar.gz $(LAB)-$(GROUP) rm -rf $(LAB)-$(GROUP)

(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.

http://ant.apache.org/

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

Documentación (I)

La documentación de la práctica se entregará en

un único archivocon 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

9 Para código fuente en java http://java.sun.com/j2se/javadoc/

Licencia: Sun Microsystems, Inc. Binary Code License Agreement

¾ Doxygen

9 Para código fuente en C, C++ y java http://www.stack.nl/~dimitri/doxygen Licencia: GNU General Public License

(5)

Presentación

Las prácticas se entregarán por medio del correo electrónico a la dirección [email protected]

El Asunto del correo ha de ser “Ingeniería de Software I -práctica Pgrupo G” siendo:

Pes el número de práctica: 1,2, ..., 5

Ges 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.

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

(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).

Bibliografía I

Advanced Linux Programming

Mark Mitchell, Jeffrey Oldham, and Alex Samuel Published by New Riders Publishing ISBN 0-7357-1043-0 First Edition, June 2001

http://www.advancedlinuxprogramming.com/

Introduction to Linux - A Hands on Guide

Machtelt Garrels 1.24 20061101 Edition 230 páginas (1,54 MB)

(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.0license).

http://linux.inet.hr/linux_device_drivers_3rd_edition.htm l

LinuxQuestions.org Man Pages Online