Ver el código fuente de «Empaquetando software para Debian»

{{Plantilla:Artículos en contrucción}}
= Resumen =
Creación de paquetes DEB en base a software

= Introducción =
Esta es una guía relativamente sencilla (Debido al gran avance que ha habido con las herramientas de parte de la gente de Debian) que sin embargo debe usarse con sumo cuidado. El enfoque a usar es debmake, debuild y quilt como herramientas para empaquetado

= Procedimiento =
== Instalación de paquetes ==
Estos paquetes se refieren a las herramientas que vamos a usar para empaquetar. El software que va a instalar podría necesitar otros paquetes, así que antes de empaquetarlo, debería probar a compilarlo para resolver todas las dependencias que necesite.

 apt install debmake devscripts quilt git

== Preparando la mesa de trabajo ==
Para facilitar todo, considere usar un par de variables desde consola
 nombre=paquete
 version=0.1

Las fuentes del software a empaquetar deben ser instaladas en un directorio que se llame <nombre_del_paquete>-<version>. Al mismo nivel que este se van a guardar todos los ficheros resultado del proceso de empaquetado, incluyendo precisamente el <code>.deb</code>. Así que lo recomendado es crear un directorio antes, quizá algo con el nombre más genérico del paquete. 

Es decir: 
 mkdir $nombre
 cd $nombre

== Obteniendo el paquete ==
Lo más común es que el software a empaquetar se encuentre en github. Lo recomendable es que use el comando git para obtenerlo.

 git clone https://github.com/usuario/paquete $nombre-$version

Necesitamos crear un tar.gz con el mismo nombre del directorio ya que debmake no lo hace
 tar czvf $nombre-$version.tar.gz $nombre-$version

Ya que no tenemos nada parecido, vamos a crear el proyecto más simple del mundo:
 mkdir $nombre-$version
 cat <<"MAFI">$nombre-$version/main.c
 #include <stdio.h> 
 
 int main(){
     
     printf("Hola Mundo\n");
 
     return 0;
 }
 
 MAFI

 cat <<"MAFI">$nombre-$version/Makefile
 salida:=saludador
  
 saludador:
    gcc main.c -o $(salida)
 
 install:
    install -m 0775 $(salida) /usr/local/bin
 
 .PHONY: clean
 
 uninstall:
    rm /usr/local/bin/$(salida)
 
  
 MAFI

Probamos que la compilación de nuestro paquete vaya bien:
 cd $nombre-$version
 # make
 gcc main.c -o saludador
 # make install
 install -m 0775 saludador /usr/local/bin
 # saludador
 Hola Mundo

Ahora borramos y eliminamos todo rastro de compilación
 # make uninstall 
 rm /usr/local/bin/saludador

También creamos el tar para este pequeño proyecto
 cd ..
 tar czvf $nombre-$version.tar.gz $nombre-$version

== Debianizando el paquete ==
Debianizar un paquete se refiere a crear una serie de ficheros que:
* Controlan como el paquete será creado (<code>debian/control</code> por ejemplo)
* Permite realizar algunos script en el proceso de instalacion (debian/postins, para realizar tareas de configuración al instalar el paquete)
* Dota al software de algunos añadidos esenciales para estar dentro del sistema (Páginas de README y MAN)

De todas las opciones posibles, usamos debmake dentro del directorio con las fuentes del software
 cd paquete-0.1/
 debmake -e alortiz@salud.gob.sv -f "Alexander Ortíz"

== Solucionando problemas de compilación ==
<code>debuild</code> se limita a ejecutar el proceso de compilación de la forma más sencilla posible. La construcción de este paquete va a fallar en varias maneras. La solución más sencilla (Me llevo como cuatro días darme cuenta) es la de modificar el Makefile. Como Makefile es básicamente parte del programa, es una mala idea que lo modifiquemos así nada más: La forma más correcta de hacerlo (Y tener un paquete apegado a las buenas prácticas) es la de crear un parche para nuestra aplicación. Usaremos <quilt>
 # export QUILT_PATCHES=debian/patches/
 # quilt new 01_construccion
 Patch debian/patches//01_construccion is now on top
 # quilt add Makefile 
 File Makefile added to patch debian/patches//01_construccion

En este punto, ya podemos hacer las modificaciones necesarias. El archivo debe quedar de la siguiente forma:

 cat <<"MAFI">Makefile
 salida:=saludador
 
 saludador:
    gcc main.c -o $(salida)
 
 install:
    mkdir -p $(DESTDIR)/usr/bin
    install -m 0775 $(salida) $(DESTDIR)/usr/bin
 
 .PHONY: clean
 
 uninstall:
    rm $(DESTDIR)/usr/bin/$(salida)
 
 clean:
    rm saludador
 MAFI

Los principales cambios han sido:
 * Agregamos la variable $(DESTDIR) como prefijo a todas las rutas. Esta es una buena práctica que debería usarse siempre
 * Ahora que será un paquete más oficial, le es permitido (Y de hecho necesario) dejar de usar <code>/usr/local/</code> por <code>/usr/</code>
 * Creamos el directorio donde vamos a instalar el fichero. Lo que adquiere más sentido al construir el software dentro de este proceso de empaquetado. Este es un punto bastante medular de todo este proceso.

Antes de guardar los cambios, puede probar a compilar el paquete, y verá que sigue funcionando. Esto es porque todo lo que agregamos se consideran buenas prácticas en la elaboración de un Makefile que compile software.

Ahora guardamos los cambios y revertimos los cambios. El paquete sigue siendo una copia exacta de parte del proveedor, nuestros parches están en debian/patches, todo muy estándar

 # quilt refresh
 Refreshed patch debian/patches//01_construccion
  # quilt pop -a
 Removing patch debian/patches//01_construccion
 Restoring Makefile 
 
 No patches applied

== Contruyendo el paquete ==
En este momento, habrá visto que todo es bastante más sencillo de lo que se puede creer en un principio. En este punto, bastará con correr el siguiente comando
 debuild -us -uc

Y básicamente, eso es todo. Un directorio atrás de las fuentes se encuentra el paquete. Se instala con <code>dpkg -i</code>
 # dpkg -i ../paquete_0.1-1_amd64.deb 
 Seleccionando el paquete paquete previamente no seleccionado.
 (Leyendo la base de datos ... 43811 ficheros o directorios instalados actualmente.)
 Preparando para desempaquetar ../paquete_0.1-1_amd64.deb ...
 Desempaquetando paquete (0.1-1) ...
 Configurando paquete (0.1-1) ...
 # saludador
 Hola Mundo

En principio, <code>debuild </code> puede ser corrido muchas tanta veces como se desee; en la práctica, puede presentar algunas complicaciones según el paquete.
Hasta este punto, este paquete es funcional. 
= Mejoras: Cumpliendo las normas de empaquetado=
Hacia el final de la salida del comando hay unas lineas del tipo <code>W: paquete</code> Se refieren a ciertas cosas que deben arreglar en los archivos en debian/

= Fuentes =
* [https://www.debian.org/doc/manuals/maint-guide/ Guía del nuevo desarrollador de Debian]
* [https://stackoverflow.com/questions/7459644/why-is-dh-usrlocal-throwing-a-build-error dh_usrlocal: … Why is dh_usrlocal throwing a build error?]
* [https://blog.packagecloud.io/debian/debuild/packaging/2015/06/08/buildling-deb-packages-with-debuild/ Building debian packages with debuild]

[[Category:DTIC|Empaquetando software para Debian]] 
[[Category:DTIC_Servidores|Empaquetando software para Debian]]