[ anterior ] [ Nota de Copyright ] [ Contenidos ] [ siguiente ]

Guía del Nuevo Desarrollador de Debian
Capítulo 2 Primeros pasos.


Mientras que la documentación en el Rincón del Desarrollador no está muy clara sobre dónde y cómo debería empezar un nuevo desarrollador su trabajo, este documento te explicará cada pequeño (y algunas veces incluso irrelevante) detalle, para ayudarte crear ese primer paquete, y ganar alguna experiencia en la construcción de nuevas versiones de éste y quizás otros paquetes más adelante.


2.1 Elige tu programa.

Probablemente hayas escogido ya el paquete que deseas construir, pero aquí hay algunos punteros para los novatos:

Por supuesto, esta lista es para tomar medidas de seguridad, y con la intención de salvarte de usuarios enfurecidos si haces algo mal con algún demonio setuid... Pero cuando tengas más experiencia en empaquetar cosas, podrás hacer este tipo de paquetes, pero incluso los desarrolladores más experimentados preguntan en la lista de distribución de debian-devel cuando tienen dudas. Y la gente allí te ayudará gustosamente.

Para más ayuda sobre esto, lee la Referencia del Desarrollador.


2.2 Obtén el programa, y pruébalo.

La primera cosa a hacer es encontrar y descargar el paquete original. Supongo que ya tienes el código fuente que obtuviste de la página del autor. Las fuentes de los programas gratuitos de Linux generalmente vienen en formato tar/gzip, con extensión .tar.gz, y generalmente contienen un subdirectorio llamado programa-versión con todas las fuentes en él. Si tu programa viene en otro tipo de archivo (por ejemplo, el fichero termina en ".Z" o ".zip"), descomprímelo con las herramientas adecuadas, o pregunta en debian-mentors si no estás seguro de cómo se puede desempaquetar correctamente (pista: prueba `file archivo.extensión`).

Como ejemplo, usaré el programa conocido como `gentoo', un gestor de ficheros de X11 en GTK+. Observa que el programa ya ha sido empaquetado previamente pero ha cambiado sustancialmente de versión desde que este texto se escribió.

Crea un subdirectorio bajo tu directorio personal llamado 'debian' o 'deb' o lo que creas apropiado (por ejemplo ~/gentoo/ estaría bien en este caso) Y mueve a él el archivo que has descargado, y descomprímelo de la siguiente forma: `tar xzf gentoo-0.9.12.tar.gz`. Asegúrate de que no hay errores, incluso errores "irrelevantes", porque es muy probable que haya problemas desempaquetando en sistemas de otras personas, cuyas herramientas de desempaquetado puede que no ignoren estas anomalías.

Ahora tienes otro subdirectorio, llamado 'gentoo-0.9.12'. Muévete a ese directorio y lee en profundidad la documentación que encuentres. Está generalmente en ficheros que se llaman README*, INSTALL*, *.lsm o *.html. Allí encontrarás instrucciones de cómo compilar e instalar el programa (muy probablemente asumirán que lo quieres instalar en el directorio /usr/local/bin: no harás esto, pero eso lo veremos más adelante en Instalación en un subdirectorio., Sección 3.1).

El proceso varía de programas a programas, pero gran parte de los programas modernos vienen con un guión 'configure' que configura las fuentes para tu sistema y se asegura de que tu sistema está en condiciones de compilarlo. Después de configurarlo (con `./configure`), los programas generalmente se compilan con `make`. Algunos de ellos soportan `make check` para ejecutarse incluyendo comprobaciones automáticas. Generalmente se instalarán en sus directorios de destino ejecutando `make install`.

Ahora intenta compilar, y ejecutar el programa, para asegurarte de que funciona bien y que no rompe nada más mientras está instalándose o ejecutándose.

También, generalmente, puedes escribir `make uninstall` para eliminar todos los programas instalados, y `make clean` (o mejor `make distclean`) para limpiar el directorio donde se genera el programa.


2.3 Cosas antes de `dh_make'.

Deberías empezar a construir tu paquete en un directorio de fuentes completamente limpio, o simplemente con las fuentes recién desempaquetadas.

Para construir correctamente el paquete, debes poner el nombre original del programa en letras minúsculas (si no lo está ya), y deberías mover el directorio de fuentes a <nombre_de_paquete>-<versión>.

Si el nombre del programa son varias palabras, contráelas a una palabra o haz una abreviatura. Por ejemplo, el paquete del programa "el editor para X de Javi" se podría llamar javiedx o jle4x, o lo que decidas, siempre y cuando no se exceda de unos límites razonables, como 20 caracteres.

Comprueba también la versión exacta del programa (la que se incluye en la versión del paquete). Si el programa no está numerado con versiones del estilo de X.Y.Z, pero con fecha de lanzamiento, eres libre de utilizar la fecha como número de versión, precedida por "0.0" (sólo por si los desarrolladores originales deciden sacar una versión nueva como 1.0). Así, si la fecha de las fuentes es el 19 de diciembre de 1998, puedes utilizar la abreviatura norteamericana 0.0.19981219 como número de versión. Aún así habrá algunos que ni siquiera estén numerados, en cuyo caso deberás contactar con el 'desarrollador fuente' para ver si tienen algún otro sistema de seguimiento de revisiones.


2.4 Ejecutando `dh_make'.

Asegúrate que estás en el directorio donde están las fuentes del programa, y ejecuta lo siguiente:

       dh_make -e tu.dirección@de.desarrollador -f ../gentoo-0.9.12.tar.gz

Por supuesto, cambia la cadena "tu.dirección@de.desarrollador" por tu dirección de correo electrónico para que se incluya en la entrada del fichero de cambios así como en otros ficheros, y el nombre de fichero de tu archivo fuente original. Lee dh_make(1) para más detalles.

Saldrá alguna información. Te preguntará qué tipo de paquete deseas crear. Gentoo es un solo paquete de binarios - crea sólo un binario, y, por tanto, sólo un fichero .deb - así que seleccionaremos la primera opción, con la tecla `s'. Comprueba la información que aparece en la pantalla y confirma pulsando la tecla <intro>. Como nuevo desarrollador, está desaconsejado crear paquetes multibinarios, o librerías, como se explicó antes. No es extremadamente difícil, pero sí necesita algunos conocimientos más, así que aquí no describiremos el proceso.

Ten en cuenta que deberías ejecutar dh_make sólo una vez, y que no se comportará correctamente si lo haces otra vez en el mismo directorio, ya "debianizado". Esto también significa que usarás un método distinto para crear una nueva revisión o una nueva versión de tu paquete en el futuro. Lee más sobre esto más adelante en Actualizar tu paquete., Sección 6.4.


[ anterior ] [ Nota de Copyright ] [ Contenidos ] [ siguiente ]
Guía del Nuevo Desarrollador de Debian
versión 1.0 (translation 1.0), 25 de enero de 2000
Josip Rodin jrodin@jagor.srce.hr
Traducido por: Javier Fernández-Sanguino Peña jfs@computer.org