Capítulo 2. Primeros pasos

Fíjate que el carácter que separa nombre_del_paquete y versión se ha cambiado de - (guión) a _ (guión bajo).

En los nombres de archivo que siguen, nombre_del_paquete se substituye por el nombre del paquete, versión por la versión del código fuente, revisión por la revisión Debian, arquitectura por la arquitectura del paquete ^[5].

Cada paso de este esquema se explica con ejemplos detallados en secciones posteriores.

Si el paquete ya existe, ¡instálalo! :-) Si te encuentras con que el paquete es un paquete huérfano (cuando su desarrollador es el Debian QA Group, es decir, el grupo de calidad de Debian), puedes adoptarlo (convertirte en el responsable de empaquetarlo y mantenerlo) si está disponible. También puedes adoptar un paquete para el cual se ha emitido una «solicitud de adopción» (Request for Adoption o RFA) por su desarrollador o por un DD ^[6].

Hay varios recursos para conocer el estado de los paquetes:

A modo de nota al margen, es importante tener presente que Debian incorpora paquetes de un gran número de programas de todo tipo, y que la cantidad de paquetes disponibles en el repositorio de Debian es mucho mayor al de colaboradores con permiso para incorporar paquetes al repositorio. En consecuencia, la colaboración en el mantenimiento de paquetes que ya están en el repositorio se valora muy positivamente (y es más fácil conseguir patrocinador) por el resto de desarrolladores ^[7]. Puedes hacer esto de distintas formas:

If you are able to adopt the package, get the sources (with something like apt-get source packagename) and examine them. This document unfortunately doesn't include comprehensive information about adopting packages. Thankfully you shouldn't have a hard time figuring out how the package works since someone has already done the initial setup for you. Keep reading, though; a lot of the advice below will still be applicable to your case.

Si el paquete es nuevo y decides que te gustaría verlo en Debian debes seguir los pasos indicados a continuación:

Of course, the last one is just a safety measure, and is intended to save you from enraging users if you do something wrong in some setuid daemon… When you gain more experience in packaging, you'll be able to package such software.

Como nuevo desarrollador, es aconsejable que adquieras experiencia con la construcción de paquetes sencillos y se desaconseja construir paquetes complicados.

Construir paquetes de alta complejidad no es demasiado difícil, pero requiere más conocimientos. Debes buscar las orientaciones específicas para cada caso según su complejidad. Por ejemplo, algunos lenguajes interpretados tienen sus normas específicas.

There is another old Latin saying: fabricando fit faber (practice makes perfect). It is highly recommended to practice and experiment with all the steps of Debian packaging with simple packages while reading this tutorial. A trivial upstream tarball, hello-sh-1.0.tar.gz, created as follows may offer a good starting point:^[8]

$ mkdir -p hello-sh/hello-sh-1.0; cd hello-sh/hello-sh-1.0
$ cat > hello <<EOF
#!/bin/sh
# (C) 2011 Foo Bar, GPL2+
echo "Hello!"
EOF
$ chmod 755 hello
$ cd ..
$ tar -cvzf hello-sh-1.0.tar.gz hello-sh-1.0

Si tu programa viene en otro tipo de archivo (por ejemplo, el fichero termina en .Z o .zip^[9]), descomprímelo con las herramientas adecuadas y reconstrúyelo de nuevo.

Si el código fuente del programa viene con algunos contenidos que no cumplan con las DFSG, debes descomprimirlo para eliminar dichos contenidos y volver a comprimirlo modificando el código de versión original añadiendo dfsg.

Como ejemplo, usaré el programa conocido como gentoo, un gestor de ficheros de X11 en GTK+ ^[10].

Crea un subdirectorio en tu directorio personal llamado debian o deb o lo que creas apropiado (por ejemplo ~/gentoo/ estaría bien en este caso). 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 al desempaquetarlo en sistemas de otras personas, cuyas herramientas de desempaquetado puede que no ignoren estas anomalías. En el terminal de órdenes, deberías ver lo siguiente.

$ mkdir ~/gentoo ; cd ~/gentoo
$ wget http://www.example.org/gentoo-0.9.12.tar.gz
$ tar xvzf gentoo-0.9.12.tar.gz
$ ls -F
gentoo-0.9.12/
gentoo-0.9.12.tar.gz

Ahora tienes otro subdirectorio, con el nombre gentoo-0.9.12. Accede a ese directorio y lee atentamente la documentación. Habitualmente encontrarás archivos con el nombre README*, INSTALL*, *.lsm o *.html. Deberías encontrar instrucciones sobre cómo compilar e instalar el programa (probablemente se asumirá que la instalación será en el directorio /usr/local/bin, aunque tú no lo harás eso, como se explica más adelante en Sección 3.3, “Instalación de los archivos en su destino” ).

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

Los programas sencillos incluyen un fichero Makefile y pueden (generalmente) compilarse con «make»^[11]. Algunos de ellos soportan make check, esta orden ejecuta las comprobaciones automáticas que estén definidas. Generalmente se instalarán en sus directorios de destino ejecutando make install.

Ahora intenta compilar y ejecutar el programa, para asegurarte que funciona bien y que no genera errores en el sistema mientras está instalándose o ejecutándose.

También, generalmente, puedes ejecutar make clean (o mejor make distclean) para limpiar el directorio donde se compila el programa. A veces hay incluso un make uninstall que se puede utilizar para borrar todos los archivos instalados.

Buena parte de los programas libres están escritos en lenguaje C y C++. Muchos utilizan las «Autotools» y «CMake» para compilar en diferentes plataformas. Estas herramientas se utilizan para generar un archivo Makefile y otros archivos necesarios para la compilación. Así, muchos programas se compilan ejecutando «make; make install».

Las Autotools son el sistema de compilación GNU e incluyen Autoconf, Automake, Libtool y gettext. Confirmarás que el programa utiliza las autoools por la presencia de los archivos configure.ac, Makefile.am, y Makefile.in ^[12].

El primer paso en el uso de «Autotools» es la ejecución por parte del autor de la orden autoreconf -i -f la cual genera, a partir de los archivos fuente (a la izquierda del gráfico) los archivos que utilizará la orden «configure» (a la derecha del gráfico).

configure.ac-----+-> autoreconf -+-> configure
Makefile.am -----+        |      +-> Makefile.in
src/Makefile.am -+        |      +-> src/Makefile.in
                          |      +-> config.h.in
                      automake
                      aclocal
                      aclocal.m4
                      autoheader

La edición de los archivos configure.ac y Makefile.am requiere conocer el funcionamiento de autoconf y automake. Véase «info autoconf» y «info automake» (ejecutando las órdenes en el terminal).

El segundo paso en el uso de «Autotools« es la ejecución de «./configure && make» en el directorio del código fuente para compilar el programa generando un archivo binario.

Makefile.in -----+                +-> Makefile -----+-> make -> binary
src/Makefile.in -+-> ./configure -+-> src/Makefile -+
config.h.in -----+                +-> config.h -----+
                 |
  config.status -+
  config.guess --+

Puedes hacer cambios en el archivo Makefile, por ejemplo cambiando el directorio de instalación predeterminado usando las opciones de la orden ejecutando: ./configure --prefix=/usr.

Aunque no es necesario, la actualización del archivo configure y de otros archivos con la orden autoreconf -i -f es la mejor manera para mejorar la compatibilidad del código fuente ^[13].

CMake es un sistema de compilación alternativo. La presencia del archivo CMakeLists.txt te indicará que se utiliza esta opción para compilar el programa.

Si el código original se presenta como gentoo-0.9.12.tar.gz, puedes poner como nombre del paquete gentoo y como versión original 0.9.12. Estas referencias se utilizan en el archivo debian/changelog descrito más adelante en Sección 4.3, “El archivo changelog”.

Although this simple approach works most of the time, you may need to adjust package name and upstream version by renaming the upstream source to follow Debian Policy and existing convention.

You must choose the package name to consist only of lower case letters (a-z), digits (0-9), plus (+) and minus (-) signs, and periods (.). It must be at least two characters long, must start with an alphanumeric character, and must not be the same as existing packages. It is a good idea to keep its length within 30 characters. ^[14]

Si el código fuente original utiliza palabras genéricas tales como prueba-privada por nombre, es buena idea cambiarlo para no «contaminar» el espacio de nombres y para identificar su contenido en forma explícita ^[15].

You should choose the upstream version to consist only of alphanumerics (0-9A-Za-z), plus signs (+), tildes (~), and periods (.). It must start with a digit (0-9). ^[16] It is good idea to keep its length within 8 characters if possible. ^[17]

If upstream does not use a normal versioning scheme such as 2.30.32 but uses some kind of date such as 11Apr29, a random codename string, or a VCS hash value as part of the version, make sure to remove them from the upstream version. Such information can be recorded in the debian/changelog file. If you need to invent a version string, use the YYYYMMDD format such as 20110429 as upstream version. This ensures that dpkg interprets later versions correctly as upgrades. If you need to ensure smooth transition to the normal version scheme such as 0.1 in the future, use the 0~YYMMDD format such as 0~110429 as the upstream version.

El código de la versión ^[18] será comparado por dpkg(1) como sigue:

$ dpkg --compare-versions versión_1 op versión_2

La regla de comparación de versiones se pueden resumir de la siguiente manera.

Uno de los casos difíciles sucede cuando la versions del código fuente gentoo-0.9.12-ReleaseCandidate-99.tar.gz se utiliza como el pre-lanzamiento de gentoo-0.9.12.tar.gz. Debes asegurarte que la actualización funciona correctamente cambiando el nombre a las fuentes originales por gentoo-0.9.12~rc99.tar.gz.

Primero debes configurar las variables de entorno «shell» $DEBEMAIL y $DEBFULLNAME que son utilizadas por varias herramientas de mantenimiento de Debian para obtener tu nombre y correo electrónico como se indica a continuación ^[19].

$ cat >>~/.bashrc <<EOF
DEBEMAIL="tu.direccion.de.correo@ejemplo.org"
DEBFULLNAME="Nombre Apellido"
export DEBEMAIL DEBFULLNAME
EOF
$ . ~/.bashrc

$ cd ~/gentoo
$ wget http://example.org/gentoo-0.9.12.tar.gz
$ tar -xvzf gentoo-0.9.12.tar.gz
$ cd gentoo-0.9.12
$ dh_make -f ../gentoo-0.9.12.tar.gz

Deberás cambiar el nombre del archivo por el correspondiente a tus fuentes ^[20]. Véase dh_make(8) para una descripción más detallada.

You should see some output asking you what sort of package you want to create. Gentoo is a single binary package — it creates only one binary package, i.e., one .deb file — so we will select the first option (with the s key), check the information on the screen, and confirm by pressing ENTER. ^[21]

Tras ejecutar dh_make, se genera una copia del código original con el nombre gentoo_0.9.12.orig.tar.gz en el directorio raíz para facilitar la construcción del paquete de fuentes no nativo de Debian con el archivo debian.tar.gz:

$ cd ~/gentoo ; ls -F
gentoo-0.9.12/
gentoo-0.9.12.tar.gz
gentoo_0.9.12.orig.tar.gz

Observa que hay dos cambios clave en el nombre del fichero gentoo_0.9.12.orig.tar.gz:

Observa que la ejecución de la orden ha generado varios archivos de plantilla en el directorio debian. Se tratará sobre ellos en Capítulo 4, Archivos necesarios en el directorio debian y Capítulo 5, Otros ficheros en el directorio debian.. El proceso de empaquetado no está totalmente automatizado. Se tratará la modificación de los archivos Debian en Capítulo 3, Modificar las fuentes. A continuación se compilará el paquete Debian en el apartado Capítulo 6, Construcción del paquete, la revisión del resultado en Capítulo 7, Comprobación del paquete en busca de fallos y el envío del paquete en Capítulo 9, Enviar el paquete. Se explicará cada una de estas etapas a continuación.

Si accidentalmente has eliminado alguna de las plantillas mientras trabajabas en ellas, puedes regenerarlas ejecutando dh_make con la opción --addmissing desde el directorio con las fuentes del paquete Debian.

Actualizar un paquete existente puede complicarse debido a que puede estar construido con técnicas más antiguas. Para aprender lo básico, es mejor limitarse a la construcción de un paquete nuevo; se amplia la explicación en Capítulo 8, Actualizar el paquete.

Please note that the source file does not need to contain any build system discussed in Sección 2.4, “Métodos de compilación simple” and Sección 2.5, “Métodos de compilación portables populares”. It could be just a collection of graphical data, etc. Installation of files may be carried out using only debhelper configuration files such as debian/install (see Sección 5.11, “Archivo install”).