doc.ubuntu-es - Contribuciones del usuario [es]

Wine

2010-01-11T09:07:20Z

Festor: /* Nuevas versiones de Wine (no recomendado) */

{{software
| nombre = wine
| versión_estable = [http://winehq.org/announce/1.0.1 1.0.1]
| fecha_versión_estable = 17 de octubre de 2008
| versión_inestable = [http://winehq.org/announce/1.1.12 1.1.12]
| fecha_versión_inestable = 2 de enero de 2009
| género = [[:Categoría:Compatibilidad con otros S.O.|Implementación de API]]
| licencia = [[w:software libre|libre]] ([[w:GNU Lesser General Public License|LGPL]])
| español = Sí
| web = [http://www.winehq.org/ www.winehq.org]
}}

'''Wine''' es una implementación de la [[w:Application Programming Interface|API]] de [[w:Microsoft Windows|Windows]] que te permite ejecutar muchos programas de este [[w:sistema operativo|sistema operativo]] en [[w:Linux|GNU/Linux]]. Si dispones de la última versión de Wine puedes recibir ayuda en el canal de [[IRC]] [irc://irc.freenode.net/#winehq #winehq].

<div style="clear: right; float: right; display: table;">__TOC__</div>

== Etimología ==

El término «wine» es un acrónimo recursivo en [[w:idioma inglés|inglés]] que significa '''''W'''ine '''I'''s '''N'''ot an '''E'''mulator'', ''Wine no es un Emulador''. «Wine» también significa «vino» en [[w:idioma inglés|inglés]].

== Instalación ==

En los repositorios <code>universe</code> tienes disponible una versión moderadamente reciente de Wine. Siempre es recomendable instalar software solo de los canales oficiales, pero también tienes la opción de instalar la última versión del repositorio no oficial de WineHQ.

=== Versiones Ubuntu de Wine (recomendado) ===

'''1.''' [[repositorios|Añade el repositorio]] ''universe''.

'''2.''' Actualiza la lista de paquetes:
sudo aptitude update
'''3.''' [[instalar aplicaciones|Instala]] el paquete <code>wine</code>.

Nota: Si estás buscando paquetes de Wine para '''AMD64''', ve a esta página [[Wine AMD64]].

=== Nuevas versiones de Wine (no recomendado) ===

[http://www.winehq.org/ WineHQ] proporciona las últimas versiones empaquetadas de Wine par Ubuntu. Al ser versiones más nuevas pueden ser algo inestables. Para usarlas necesitas añadir el repositorio de WineHQ y entonces instalar Wine con Synaptic. Para ayuda añadiendo repositorios, consulta la página de [[Repositorios]].

: Añade el repositorio correspondiente:
* Para '''Ubuntu 8.04 «Hardy Heron»''':

: Añade al clave del repositorio escribiendo lo siguiente en la [[terminal]]:
wget -q http://wine.budgetdedicated.com/apt/387EE263.gpg -O- | sudo apt-key add -
: Actualiza la caché de paquetes haciendo clic en 'Recargar' en Synaptic o con el siguiente comando:
sudo aptitude update
: [[instalar aplicaciones|Instala]] el paquete <code>wine</code>.

Nota: Si deseas un repositorio de fuentes, simplemente añade lo mismo pero reemplazando <code>deb</code> por <code>deb-src</code> o sigue las instrucciones de la [http://winehq.org/site/download-deb web oficial].

== Funcionamiento ==

=== Instalar aplicaciones de Windows ===

Para instalar aplicaciones de Windows usando Wine, sigue las siguientes instrucciones:

# Descarga la aplicación de Windows de alguna fuente (por ejemplo. download.com). Descarga el .EXE (ejecutable).
# Ponlo en un directorio conveniente (por ejemplo en el escritorio o en la home).
# Abre la terminal y entra en el directorio donde esté localizado el archivo EXE: <code>cd /ruta/del/directorio</code>.
# Escribe <code>wine ''el-nombre-de-la-aplicacion.extension''</code> (p.e. <code>wine realplayer.exe</code>).

Esto iniciará el .EXE usando Wine. Si es un instalador, deberá ejecutarse como si lo hiciera en Windows. Si la aplicación te pregunta por un directorio donde instalar la aplicación, selecciona un lugar que esté bajo C:\Program Files. El disco duro virtual C: se crea bajo ./wine después de que un usuario ejecute ''wine'' en la terminal por primera vez. El directorio .wine está oculto por defecto. Para verlo, ve a tu directorio de usuario en home y presiona CTRL-H, o ve a Ver > Mostrar ficheros ocultos.

=== Ejecutar un programa de Windows ===

Después de instalar una aplicación utilizando las indicaciones anteriores, estas aplicaciones pueden ser iniciadas y utilizadas introduciendo en una [[terminal]]
wine nombreprograma.exe
(por ejemplo: <code>''wine realplayer.exe''</code>).
Cuando lo hagas, cierra la aplicación como lo harías normalmente. Debes correr el ejecutable instalado, el cual por defecto estará en el disco virtual de Windows creado por Wine, en ''~/.wine/drive_c''.

Generalmente los programas se instalaran en algún lugar bajo ''Program Files'' dentro del disco virtual de Windows, siguiendo las convenciones de Windows.

Si quieres inicializar un CD/DVD hay que acceder a la unidad lectora y desde allí buscar el ejecutable de arranque e iniciarlo con los pasos mencionados en el párrafo anterior.

Puedes también utilizar el navegador de archivos de Wine, ejecutando en una terminal:
winefile

Haciendo clic en el botón '''C:\''' en la barra de herramientas abrirás una ventana donde podrás examinar el disco virtual de Windows creado en .wine. Haciendo doble click en un ejecutable en el navegador de archivos de Wine, lo ejecutarás con wine.

=== Crear un lanzador a una aplicación ===

En vez de tener que estar siempre entrando en la terminal para usar el navegador de archivos de wine, puedes también crear un, por ejemplo, icono de escritorio, e iniciar aplicaciones de Wine usando ese icono.
Para hacerlo, haz click con el botón derecho en el escritorio y selecciona '''Crear un acceso directo'''. Si lo deseas, selecciona un icono de la lista de iconos disponibles, o navega hasta un icono que quieras utilizar, pon el resto de información que se te pide (Nombre, nombre genérico, etc.). Para el comando, escribe <code>Wine localización_del_programa.exe</code> (por ej. wine /home/john/.wine/realplayer.exe).
La parte más importante de crear un acceso directo es el comando, y la otra información no es necesarias (p. e. Nombre genérico). Asegúrate de ‘’’no’’’ tener seleccionado "ejecutar en una terminal." Esto completa el proceso.

Si deseas tener un icono en el panel, crea un lanzador en el panel de tu elección. Hazlo haciendo clic con el botón derecho en el panel, seleccionando "Añadir a Panel," y selecciona, "Lanzador personalizado." Te preguntará por la misma información que en un acceso directo.

=== Desinstalar aplicaciones de Windows ===

Abre una terminal y escribe:
uninstaller
Esto abrirá un programa similar al panel de control "añadir/quitar programas" de Windows, permitiéndote desinstalar aplicaciones de la instalación de Wine. Ejecutar los programas de desinstalación directamente via Wine debe también funcionar normalmente. También puedes directamente eliminar el directorio de la aplicación. Sin embargo, como en Windows, este método será “poco limpio” y no eliminará la configuración del programa del registro de Wine como lo haría el desinstalador.

== Configuración ==

En la línea de comandos escribe <code>winecfg</code>.

=== Añadir discos CD y DVD ===

Ve a la pestaña '''drives''' en winecfg. Dale al botón Autodetectar.
Si encuentras que esto no funciona correctamente, entonces sigue las siguientes instrucciones:

# Ejecuta <code>winecfg</code>
# Navega a la pestaña '''drives'''
# Haz Click en '''Añadir...'''
# En la barra de ruta, escribe <code>/media/cdrom</code>
# Haz Click en el botón '''Mostrar Avanzadas''' bajo el botón '''Examinar...''' y pon en '''Tipo''' <code>CD-ROM</code>
# Haz click en ''OK''

Si tienes más de un dispositivo CD/DVD necesitarás identificar cada uno de manera diferente. Utiliza <code>/media/cdrom0</code> para el primer dispositivo de CD/DVD, <code>/media/cdrom1</code> para el segundo, y así sucesivamente. Si tienes alguna duda, escribe <code>ls -la ~/.wine/dosdevices/</code> en una terminal para comprobar los detalles de tus dispositivos de CD/DVD después de la instalación de Wine.

=== Añadir aplicaciones al menú ===

Es un buen procedimiento antes de configurar la entrada del menú es lanzar el programa de Windows desde la línea de comandos para asegurarse que el programa funciona correctamente. Para hacerlo escribe <code>wine "C:\RUTA DELPROGRAMA\Program.exe"</code> en la línea de comandos. (por ejemplo: <code>wine "C:\Program Files\World of Warcraft\WoW.exe"</code>. Una vez hayas comprobado que todo está correcto, usa el proceso normal de edición menu para añadir una nueva entrada. Asegúrate de copiar en el campo de Comando exactamente la línea utilizada para iniciar el programa desde la terminal. Finaliza y guarda la nueva entrada. Pruebalo para asegurarte de que el programa se carga desde el menú.

=== Cambiar la configuración específica de la aplicación ===

# Escribe <code>winecfg</code> en la línea de comandos.
# Haz clic en <code>Añadir Aplicaciones...</code>.
# Navega hasta donde esté el exe y escoge el programa.
# El menú desplegable de la parte inferior te permite escoger qué versión de Windows debe emular Wine. También, cualquier cambio en las pestañas de Librerías y Gráficos afectarán solo a la aplicación escogida en la pestaña Aplicaciones.

=== Temas visuales de Windows ===

==== Esquema de color ====

Puedes cambiar el esquema de color de wine para que se parezca un poco más a los colores por defecto de Ubuntu

gedit ~/.wine/user.reg

Sustituye la sección de [Control Panel\\Colors] por

[Control Panel\\Colors] 1176981676
"ActiveBorder"="239 235 231"
"ActiveTitle"="239 235 231"
"AppWorkSpace"="198 198 191"
"Background"="93 77 52"
"ButtonAlternativeFace"="200 0 0"
"ButtonDkShadow"="85 85 82"
"ButtonFace"="239 235 231"
"ButtonHilight"="255 255 255"
"ButtonLight"="255 255 255"
"ButtonShadow"="198 198 191"
"ButtonText"="0 0 0"
"GradientActiveTitle"="239 235 231"
"GradientInactiveTitle"="239 235 231"
"GrayText"="198 198 191"
"Hilight"="246 200 129"
"HilightText"="0 0 0"
"InactiveBorder"="239 235 231"
"InactiveTitle"="239 235 231"
"InactiveTitleText"="255 255 255"
"InfoText"="0 0 0"
"InfoWindow"="255 255 166"
"Menu"="239 235 231"
"MenuBar"="239 235 231"
"MenuHilight"="246 200 129"
"MenuText"="0 0 0"
"Scrollbar"="239 235 231"
"TitleText"="255 255 255"
"Window"="255 255 255"
"WindowFrame"="0 0 0"
"WindowText"="0 0 0"}}}

==== Temas visuales ====

Wine tiene un gestor básico para ficheros de tema/skin de Windows en el formato "msstyles". Hay un gran número de estos temas en [http://www.deviantart.com/ Deviant Art]. Para usarlos debes crear un directorio en el disco virtual de Windows, y entonces decirle a wine que use ese tema.

Primeramente ve al disco virtual de Wine, que se encuentra normalmente en tu directorio <code>~/.wine/drive_c</code> (está oculto, así que necesitarás seleccionar Ver->Mostrar archivos ocultos en el navegador de archivos). Dentro de este directorio ve al directorio <code>Windows</code> y crea un nuevo subdirectorio con el nombre <code>Resources</code>. Entra en él y crea otro nuevo, llamado <code>Themes</code>. Dentro de este puedes crear directorios para cada tema que quieras, y meter dentro directamente ficheros acabados en extensión ".msstyles". Por ejemplo, la ruta completa a un fichero de tema llamado «ejemplo» será <code>/home/usuario/.wine/drive_c/windows/Resources/Themes/Ejemplo/sample.msstyles</code>.

A continuación debes decirle a Wine que use tu tema, así que ejecuta <code>winecfg</code>. En la ventana de configuración selecciona la pestaña «Desktop Integration» y marca la cajetilla de «Theme», que debe tener ahora tu tema en este menú. Después de seleccionar el tema, haz clic en «Aplicar» en la parte inferior para ver como queda (no siempre se muestra apropiadamente), entonces, si te gusta, haz clic en «OK» y tendrás tu nuevo tema.

== Registrar archivos OCX o DLL ==

Para registrar archivos OCX o DLL primero necesitamos el archivo ya sea extraido de una pagina que te de archivos dll o copiarlos desde una partición windows.

1. Copia el archivo en cuestion al directorio <code>.wine/drive_c/windows/system32</code>, el cual está oculto en <code>/home</code>. Para verlo en [[Nautilus]] presiona <code>Ctrl+H</code>.

2. Abre una terminal y teclea lo siguiente:
wine regsvr32.exe archivo.ocx

Si el archivo no tiene dependencias te dirá que a quedado registrado en caso contrario te avisará qué dependencias tiene para que las copies al directorio.

== Ejecutar paquetes MSI ==

Esto es muy sencillo, con una [[terminal]] abierta en el directorio donde se encuentra el paquete .msi, escribimos lo siguiente:

msiexec /i paquete.msi

== Crear asociaciones de ficheros ==

Si quieres que ciertos ficheros se abran con una aplicación de windows cuando hagas clic en ellos, la mejor manera es crear un script. Por ejemplo, si quieres que los ficheros (''*.fla'') de un proyecto de Adobe Flash se abran con el editor de Flash de Adobe haciendo doble clic en él.

Puedes por ejemplo crear un fichero <code>gedit ~/.wine/Flash\ 8</code>. Ahora pega el script de ejemplo en el, guárdala y cierra gedit.

Script de ejemplo:
#!/bin/sh

QUICKPARLOCATION='c:\\Program Files\\Macromedia\\Flash 8\\Flash.exe'
PARAM=$(winepath -w "$*")
wine "$QUICKPARLOCATION" "$PARAM"
exit 0

Asegúrate de que este fichero es ejecutable <code>chmod +x ~/.wine/Flash\ 8</code>.

Después de completar esto, ve a un fichero ''*.fla'' y haz clic con el botón derecho, propiedades, ve a «abrir con», haz clic en añadir, pega <code>'/home/<tunombredeusuario>/.wine/Flash 8'</code> en la línea de comando y selecciona el «radio bullet». Ahora si todo ha ido bien, puedes hacer doble clic en el fichero y este se abrirá en Flash 8.

== Resolución de problemas comunes ==

=== Problemas con la superposición del panel a pantalla completa ===

A veces el panel se superpone a tu aplicación de Windows en pantalla completa que estás ejecutando con wine. Una solución es eliminar el panel antes de iniciar la aplicación y reiniciarla después.

En [[GNOME]] ([[Ubuntu]]) los comandos son, respectivamente:
gnome-session-remove gnome-panel
gnome-panel

En [[KDE]] ([[Kubuntu]]) sería:
killall kicker
kicker

Y en [[Xfce]] ([[Xubuntu]]):
killall xfce4-panel
xfce4-panel

=== Error: Unhandled Page Fault ===

Si obtienes el mensaje de error 'wine: Unhandled page fault on read access', prueba a actualizar a wine 0.9.31, desde http://wine.budgetdedicated.com/archive/index.html
(Descárgalo, e instalalo con <code>sudo dpkg -i ./wine_0.9.31~winehq0~ubuntu~6.10-1_i386.deb</code>)

== Instrucciones para programas de Windows específicos ==

Algunos programas de Windows han sido probados en Ubuntu. Se listan a continuación:

* [[DVDShrink]].
* [[Flash Player Standalone]].
* [[World of Warcraft]].
* [[Instalar_Directx_usando_Wine|Directx 9]]
* [[Steam]].

Consulta también la [http://appdb.winehq.org/ base de datos de compatibilidad con aplicaciones en wine].

== Fuentes ==

* [https://help.ubuntu.com/community/Wine wine] en [http://help.ubuntu.com/ help.ubuntu.com] {{en}}.

== Véase también ==

* [[Wine para AMD64]].

=== Aplicaciones similares ===

* [[CrossOver]].
* [[Cedega]].

== Enlaces externos ==

{{Wikipedia}}
* [http://www.winehq.org/ Sitio web oficial de wine] {{en}}.

[[Categoría:Compatibilidad con otros S.O.]]
[[Categoría:Wine]]

Usuario discusión:Suso

2008-07-11T00:18:49Z

Festor: Torrent disponible, se necesitan seeds!

=== Archivos de discusiones antiguas ===
:* [[Usuario_Discusi%C3%B3n:Suso/2007 | Archivo 2007]]

== Sobre la categoría virtualización ==

Claro que te ayudo :)
He visto el problema, veo que cuando añades la categoría virtualización lo haces de ésta manera: <code><nowiki>[[Categoría:Virtualización|Virtualización]]</nowiki></code>. Esto lo que hace es que en la página de categoría se incluya en la letra V. Es decir, si pusieras <code><nowiki>[[Categoría:Virtualización|A]]</nowiki></code>, te la incluiría en la letra A. Lo normal es no poner nada, es decir, poner la categoría como <code><nowiki>[[Categoría:Virtualización]]</nowiki></code> y de ésta manera te lo ordenará por el nombre real de la página. Esto se utiliza por ejemplo para páginas que se llaman Proyecto:loquesea, poniendo <code><nowiki>[[categoría:Proyecto|Nombre de la página]]</nowiki></code>, y se hace para que en el listado de categorías aparezca ordenado por el término que sustituyamos (en este caso por la N de "Nombre de la página" en lugar de por la P de proyecto, que es el nombre real. Espero haberme explicado y no haberte liado más, jeje! Saludos.--[[Usuario:Kelp|kelp]] 14:35 8 feb 2008 (CET)

== Delay man ==
Suso, siento todo el retraso y silencio por mi parte. Por un lado..aun no he conseguido enviarte correo desde el portal, parece que no funciona. Por otro, por temas laborales y personales..voy muy liado...apenas puedo echar un vistazo a algun artículo y modificarlo si mientras lo leo, detecto un error. En fins, que tu dejame mensajes y cuando pueda los respondo. Lo del tema mldnkey, que es lo que buscas? un ubuntu con mldonkey actuando como servidor?
tb incluyendo un servidor ftp? explicame un poquillo..que yo tpoco soy experto en nada.
un saludete golfo--[[Usuario:Gould|Gould]] 15:10 19 feb 2008 (CET)

== Probar Mldonkey ==
Buenas chaval, me baje ayer ubuntu server para intentar montar lo que tu, ahora que hago..ein?
He visto que has configurado tu Ubuntu server como server OpenSSH y con un mldonkey preparado. Ahora me lo descargo y te diré algo.Dime qué catálogo de pruebas quieres que realice.
Hay una cosa que no entiendo, me dices que necesitamos un servidor ftp/torrent, entiendo pues lo que has colgado en Beta mldonkey, no lo es, ya que es un servidor openssh con un mldonkey corriendo. Me equivoco?

Yo no se mucho de mldonkey solo lo uso un poquillo. He estado investigando y he visto que su desarrollo esta un poco abandonado en algunos aspectos. De todas maneras de momento se me ocurre probar una GUI para acceder a el desde un PC remoto. Y no se que mas decirte. Alguna sugerncia?

Solucionado lo del correo. Saludetes--[[Usuario:Gould|Gould]] 16:17 6 mar 2008 (CET)

== Torrent disponible, se necesitan seeds! ==

Suso te informo de que apareces apuntado en la página:

http://doc.ubuntu-es.org/Proyecto:Colaboración

Por lo que sería de gran ayuda que colaboraras con el ultimo lanzamiento:

http://linuxtracker.org/download.php?id=842d42675b92bc32ee10a1b96255b50c90cb7726&f=Ubuntu-ES.iso%208.04.1%2032bits.torrent

Gracias!

Usuario discusión:Sertorio

2008-07-11T00:18:02Z

Festor: Torrent disponible, se necesitan seeds!

== Bienvenido ==

{{bienvenido}} [[Usuario:mstreet linux|::: mstreet linux :::]] [[[Usuario Discusión:mstreet linux|disc]]|[[Especial:Contributions/mstreet linux|contrib]]] 22:55 19 jun 2008 (CEST)

== Torrent disponible, se necesitan seeds! ==

Sertorio te informo de que apareces apuntado en la página:

http://doc.ubuntu-es.org/Proyecto:Colaboración

Por lo que sería de gran ayuda que colaboraras con el ultimo lanzamiento:

http://linuxtracker.org/download.php?id=842d42675b92bc32ee10a1b96255b50c90cb7726&f=Ubuntu-ES.iso%208.04.1%2032bits.torrent

Gracias!

Usuario discusión:Ganon

2008-07-11T00:17:57Z

Festor: Torrent disponible, se necesitan seeds!

==Comos o COMOs==

¿Cual de los dos prefieres para el nombre de la categoría? --[[Usuario:Gallaecio|Gallaecio]][[Usuario_Discusión:Gallaecio|¿Y luego?]] 13:27 25 nov 2007 (CET)

== Gracias por tu bienvenida ==

Pues eso gracias por tu bienvenida.
--[[Usuario:Suso|Suso]] 19:20 8 dic 2007 (CET)

== Perdona que abuse ==

Estoy un poco perdido, ¿me puedes indicar a quien/quienes me dirijo para intentar lanzar mi propuesta de [http://doc.ubuntu-es.org/Proyectos:Propuestas#Virtualizaci.C3.B3n virtualización] ?
--[[Usuario:Suso|Suso]] 13:28 11 dic 2007 (CET)

== Gracias ==

Gracias por tu pronta respuesta. Espero no tener problemas, el proyecto quiero hacerlo yo, ya tengo preparada alguna documentación y alguna máquina virtual lista par poder compartir. Eso si me gustaría que alguien me supervisara, dado que no me manejo bien en la wiki. Es mi primera vez.

Saludos.
--[[Usuario:Suso|Suso]] 16:01 11 dic 2007 (CET)

Ya he comenzado con un esbozo de tres niveles. Gracias por tus ánimos. Permíteme una pregunta. Las máquinas virtuales acaban apuntando a una "zona de descarga" tengo dos posibilidades:
- El servidor de mi casa, para que la gente lo pueda descargar por ftp. La subida no es ninguna maravilla, 90 Kb, y además no puedo usar todo el ancho de banda. Me crearía una dependencia, si desconecto el pc, no funciona el tema.
- Torrent: Tener en alguna parte la semilla ¿se llama así? y todos los ficheros en mi casa, tiene la ventaja sobre el anterior de que puede haber más gente compartiendo, el problema que veo es donde poner la semilla.

Te pongo un ejemplo [[Proyecto:Virtualización/MV:VMware:Ubuntu_jeOS_7_10 | Servidor Ubuntu jeOS 7.10 ]]

En todo caso gracias por tu colaboración y disculpa el abuso, pero ando perdido en el ciberespacio.{{No firmado|Suso|--[[Usuario:Ganon|Ganon]] ([[Usuario Discusión:Ganon|¿mande?]]) [[Especial:Emailuser/Ganon|@]] 22:37 11 dic 2007 (CET)}}

He tomado nota. En el tema de cambiar lo de MV hemos coincidido con una diferencia de 3 minutos haciéndolo.
Lo de meter una categoría mas la :VMware: lo pensé para separar las máquinas de esta plataforma de las de XEN y Virtual BOX.
El otro tema de la página para el torrent, creo que sería lo mejor. Cuenta conmigo para lo que puedas necesitar.

Lo he vuelto a hacer. Me olvido de firmar. Mis disculpas.
--[[Usuario:Suso|Suso]] 17:43 12 dic 2007 (CET)

Otra vez yo. El pesado. Gracias por "wikificarme" el tema de Servidores:jeOS. Continúo intentado aprender. Tengo un par de problemas:
- No se si la categorización ha sido correcta.
- No logro enlazar desde otras páginas, he intentado [:Servidores:jeOS|jeOS] o [Servidores:jeOS|jeOS] pero no me funciona. Gracias.
PD. Está vez me he acordado de firmar.
--[[Usuario:Suso|Suso]] 20:39 14 dic 2007 (CET)

Pues queda claro que no hice bien la pregunta: si enlazaba con otras páginas internas, incluso externas con nomenclatura interna, como la wikipedia, con la que no lo consigo es con [Servidores:jeOS|jeOS]. Me he leido un par de veces las instrucciones de la wiki y cada vez que veo algo nuevo para mi, es decir muchas veces, entro en edición para ver como está hecho.
En todo caso, saludos.
--[[Usuario:Suso|Suso]] 19:33 15 dic 2007 (CET)

== Guia Ubuntu ==

Hola, actualmente también soy colaborador de guia-ubuntu.org, pero en tu pagina de usuario dice que has dejado de colaborar, y quisiera saber cuales son esos problemas para saber si me dedico a colaborar solo aquí y dejo el projecto de guia ubuntu.{{No firmado|Black-Fox|--[[Usuario:Ganon|Ganon]] ([[Usuario Discusión:Ganon|¿mande?]]) [[Especial:Emailuser/Ganon|@]] 01:07 20 dic 2007 (CET)}}

OK, he leído tu crónica y estoy de acuerdo con lo que comentas, dedicare mi tiempo solo en este proyecto, gracias
--[[Usuario:Black-Fox|Julio Cesar Díaz]] 21:12 24 dic 2007 (CET)

== Ahora te he entendido. ==

Ahora, [[Usuario:Ganon|Ganon]], te he entendido mejor. Podría estar de acuerdo en que todos somos usuarios, pero no en que estamos en el mismo nivel. Yo por lo menos, no. Insisto en que ando perdido y hago lo que mis pocos conocimientos me permiten. He realizado algunos cambios. He separado la página de [[Virtualización]] del proyecto de [[Proyecto:Virtualización]] y he comenzado ha escribir en la página de [[Proyecto_Discusión:Virtualización | Discusión]] del proyecto. Por cierto no hay nada que disculpar, son malos entendidos sin mayor historia, al contrario, tu me has ayudado en muchas cosas. --[[Usuario:Suso|Suso]]([[Usuario Discusión:Suso|Suso a la escucha]]) [[Especial:Emailuser/Suso|@Si me quieres escribir]]

== Estilo de los resúmenes ==
Creo que tienes razón. En principio no borraba los signos de comentario, /* y */, por lo que se producía el sombreado del Resumen. Estaré atento. Gracias por avisarme.
--[[Usuario:Suso|Suso]] ([[Usuario Discusión:Suso|Suso a la escucha]]) [[Especial:Emailuser/Suso|@Si me quieres escribir...]]
:Pues a vuelto a pasar, le saqué los signos, en el comentario anterior, y a vuelo a pasar. Pruebo de nuevo.
:--[[Usuario:Suso|Suso]] ([[Usuario Discusión:Suso|Suso a la escucha]]) [[Especial:Emailuser/Suso|@Si me quieres escribir...]]
::Puede que no tenga que ver. Siempre me aparecen sombreadas los dos últimos resúmenes, es decir los dos superiores. O eso creo. Antes de grabar esta entrada estoy viendo dos lineas en sombreado. En este caso volveré a dejar los signos de comentario.
::--[[Usuario:Suso|Suso]] ([[Usuario Discusión:Suso|Suso a la escucha]]) [[Especial:Emailuser/Suso|@Si me quieres escribir...]]

:::Esa forma no la había probado. Ahora he puesto '''/* Estilo de los resúmenes */ Enésima prueba''' Veremos cómo aparece.
:::--[[Usuario:Suso|Suso]] ([[Usuario Discusión:Suso|Suso a la escucha]]) [[Especial:Emailuser/Suso|@Si me quieres escribir...]]

::::Continúa apareciendo mal.
::::--[[Usuario:Suso|Suso]] ([[Usuario Discusión:Suso|Suso a la escucha]]) [[Especial:Emailuser/Suso|@Si me quieres escribir...]]

:::::No nos entendimos. Yo me refería a que las dos primeras filas aparecen enmarcadas en gris. Y tu al titulo de la sección y al comentario adiciona. No se cual es la causa, o el objetivo, caso de que sea intencionado, de que las dos primeras filas aparezcan sombreadas en gris.
:::::--[[Usuario:Suso|Suso]] ([[Usuario Discusión:Suso|Suso a la escucha]]) [[Especial:Emailuser/Suso|@Si me quieres escribir...]]

:::::: Me refería a la [http://doc.ubuntu-es.org/index.php?title=Usuario_Discusi%C3%B3n:Ganon&action=history historia]. Las dos primeras filas aparecen enmarcadas en gris.
::::::--[[Usuario:Suso|Suso]] ([[Usuario Discusión:Suso|Suso a la escucha]]) [[Especial:Emailuser/Suso|@Si me quieres escribir...]]

== Bienvenido ==

{{bienvenido}} :P [[Usuario:mstreet linux|::: mstreet linux :::]] [[[Usuario Discusión:mstreet linux|disc]]|[[Especial:Contributions/mstreet linux|contrib]]] 09:23 10 ene 2008 (CET)

== Torrent disponible, se necesitan seeds! ==

Ganon te informo de que apareces apuntado en la página:

http://doc.ubuntu-es.org/Proyecto:Colaboración

Por lo que sería de gran ayuda que colaboraras con el ultimo lanzamiento:

http://linuxtracker.org/download.php?id=842d42675b92bc32ee10a1b96255b50c90cb7726&f=Ubuntu-ES.iso%208.04.1%2032bits.torrent

Gracias!

Usuario discusión:Kelp

2008-07-11T00:16:58Z

Festor: Torrent disponible, se necesitan seeds!

==Hola==

He estado buscando una lista de administradores, pero no la he encontrado, así que me fuí al historia de edición de la portada, y allí encontré tu nombre.

Quería avisar de que el logo (doc.ubuntu-es) que hay en la parte superior izquierda me tapa parte del panel de usuario. Es decir, que la "parte invisible" del logo se superpone a los enlaces a mi página de usuario y discusión. Por lo tanto, cuando intento cliquear en mi nombre de usuario para ir a mi página de usuario, en realidad acabo yendo a la portada, que es el enlace al que lleva el logo.

En fin, que si hubiese manera de que la imagen no se superpusiera, pues genial. De todas formas, tengo alguna experiencia en [http://gl.wikipedia.org/wiki/Usuario:Gallaecio wikis], y me las puedo apañar, pero supongo que tarde o temprano le pasará a más gente.

Muchas gracias por adelantado, y felicidades por el proyecto que estais levantando. Promete. --[[Usuario:Gallaecio|Gallaecio]][[Usuario_Discusión:Gallaecio|¿Y luego?]] 01:16 25 nov 2007 (CET)

==Licencia de doc.ubuntu-es==

¿Por qué este wiki no usa licencia GNU GPL? Hay otras wikis de documentación que las usan (Wikifonts, Wikibooks...) y no han tenido problemas. Además, la única diferencia que veo con la de Creative Commons que se está utilizando es el reconocimiento del autor, lo cual no es necesario para una documentación de ayuda. --[[Usuario:Gallaecio|Gallaecio]][[Usuario_Discusión:Gallaecio|¿Y luego?]] 12:59 25 nov 2007 (CET)

== Gracias por tus correcciones y consejos ==

Pues eso, que gracias. Estoy en ello. Lo de hacer subpáginas no sabía que se podía hacer. Ahora no se como, pero lo averiguaré.
Saludos.--[[Usuario:Suso|Suso]] 20:44 11 dic 2007 (CET)

== ¿Me puedes ayudar? ==
Tengo un problema con la ordenación de las categorías:
*[http://doc.ubuntu-es.org/Categoría:Virtualización Categoría:Virtualización ]
*[http://doc.ubuntu-es.org/Categoría:Máquinas_virtuales Categoría:máquinas virtuales.]
He estado incluyéndolas en los artículos del [[P:V]], pero las de virtualización me aparece casi todas en la '''V''' y no en las letras que les corresponde. En la otra categoría, aparecen bien. ¿Tienes alguna idea?. Gracias. --[[Usuario:Suso|Suso]] 14:22 8 feb 2008 (CET)
::Entiendo lo que me dices. Lo que es peor, lo había leído pero no procesado. Esta tarde trataré de arreglarlo. Gracias. --[[Usuario:Suso|Suso]] 14:38 8 feb 2008 (CET)

== Buen Administrador ==

Kelp para mí ha sido uno de los mejores administradores de Ubuntu-es.

[[Usuario:Marcianisto|Marcianisto]] 04:04 2 mar 2008 (CET)

== Agradecimiento ==

No se si es un proceso automatizado, sea como sea, me ha gustado recibir la bievenida tener el mensaje en mi discusión, me parece una excelente aclaratoria y motivadora idea.

Un saludo.
--[[Usuario:Carsses|JCasares]] 23:59 18 abr 2008 (CEST)

== otro mensaje, obviamente de un newbie ==

ah, yo nunca he sabido como funciona esto, pero me gustaria, sabes, hacerme cargo, por defecto, de las partes mas "lentas" del informe semanal... esto es, el asunto respecto a la blogósfera y "las noticias"... a mí, la verdad, me toma 20 minutos hacer la traducción.. y es algo que hago ahora, por ejemplo. si no es posible ello, me gustaría coordinar con otras personas a quienes les interese el tema, para definir secciones a traducir.... saludos!!

p.s.:mira, en Resumen de reuniones > MOTU, Edicion 88

agregué a los anuncios de cada cual que llegaba a MOTU, lo siguiente:

* Y encima, sus logros, los de todos, son traducidos a otros idiomas, para mayor gloria.

la verdad, no sé si corresponde, pero lo hice porque me pareció, porque se merecían la notificación al respectol, aunque quizás no lo lean o no conozcan el idioma. a lo mejor no corresponde. en fin, me parecío que quizás sería importnate para ellos, dado que ya estarian siendo destacados en otro idioma.. ah, yo y mi mala costumbre profesional de bibliotecario...

si no corresponde ello, lo elimino.
{{no firmado|Axolotl}}

uy, tienes razon, se me fue firmar mi mensaje... ahora sí que sí. --[[Usuario:axolotl|axolotl]]

== Gracias por la bienvenida ==

Gracias por el mensaje de bienvenida, e intentaré ser más meticulos con los resumenes de mis actividades.

Saludos (y que no se me olvide firmar)
--[[Usuario:JoRRieal|JoRRieal]] 02:42 29 abr 2008 (CEST)

== Edicion 89 del Boletin de Noticias Ubuntu casi listo... ==

acabo de traducir el Boletin de Noticias Ubuntu #89, con algunas excepciones, debido a que hay términos técnicos que no supe traducir bien.

dichas excepciones están en:

Noticias de Launchpad (no traduje nada de ahí): http://doc.ubuntu-es.org/NSU/Edicion_89#Noticias_de_Launchpad

En Otras Noticias - Lanzamiento de DeltaH: http://doc.ubuntu-es.org/NSU/Edicion_89#gNewSense_lanza_DeltaH_.28basado_en_Hardy_Heron.29

En Otras Noticias - Consumo Energia Ubuntu vs W$ Vista: http://doc.ubuntu-es.org/NSU/Edicion_89#Consumo_de_energ.C3.ADa_en_Ubuntu_8.04_vs._Windows_Vista

además, hay un par de secciones que habría que eliminar al menos en esta edición, dado que no existen en el original en inglés. estas son: Entrevista a..., Lo nuevo en Hardy Heron, y el Resumen de Reuniones.

también hay que refinar algunos detalles, como los nombres de los equipos en el calendario de reuniones.

de todas formas, dejé el original en inglés abajo de la traducción, tal como estaba.

bueno, y eso sería todo por ahora.

saludos!

[[Usuario:Axolotl|Axolotl]] 21:04 5 may 2008 (CEST)

== Boletin Semanal #90 ==

te escribo, como todos los lunes, para contarte que quedó lista la traducción para el número #90 del Boletin Semanal de Noticias.

saludos!

[[Usuario:Axolotl|Axolotl]] 08:36 12 may 2008 (CEST)

== Edicion #90 ==

bueno, esos son los ratos libres, las maravillas de la cesantía, jajajaj

saludos!

[[Usuario:Axolotl|Axolotl]] 21:34 12 may 2008 (CEST)

== Torrent disponible, se necesitan seeds! ==

Kelp te informo de que apareces apuntada en la página:

http://doc.ubuntu-es.org/Proyecto:Colaboración

Por lo que sería de gran ayuda que colaboraras con el ultimo lanzamiento:

http://linuxtracker.org/download.php?id=842d42675b92bc32ee10a1b96255b50c90cb7726&f=Ubuntu-ES.iso%208.04.1%2032bits.torrent

Gracias!

Nvidia Geforce FX 5100 y superiores

2008-07-09T11:01:04Z

Festor:

{{Importante|'''Nota Importante''': La mayoría de las tarjetas NVIDIA funciona con el driver libre "nv", se recomienda usar este driver porque tiene soporte directo de Ubuntu. Solo se recomienda el driver propietario nvidia-glx a las personas que no les funcione el driver "nv" (sobre todo en la serie nueva 8000) o que quieran una aceleración mayor'''}}

== Forma recomendada de instalar el driver nvidia versión 1.0-9755(excepto para serie 8000 instalarlos manualmente)==

Usar el '''Gestor de controladores restringidos'''

Para arrancar el gestor de controladores restringidos usar los menus:

Sistema -> Administración -> Gestor de controladores restringidos

Marcamos el driver nvidia, esperamos a que se descarguen los ficheros, reiniciamos y comprobamos que la instalación es correcta

'''NOTA: Si sucede algún problema basta con realizar los mismos pasos y desmarcar el driver nvidia en el gestor de controladores restringidos'''

== Instalar el driver nvidia manualmente versión 100.14.09 (recomendados solo para serie 8000 o si tu tarjeta tiene algún problema)==

Para empezar lo primero que haremos sera una copia de seguridad del fichero xorg.conf:
sudo cp /etc/X11/xorg.conf /etc/X11/xorg.conf.backup
Después hay que bajarse los drivers mas modernos de la web de nvidia 100.14.09 es la versión con la que esta probada esta guía.
[http://www.nvidia.com/object/unix.html http://www.nvidia.com/object/unix.html]

Instalamos las cabeceras del kernel:
sudo aptitude install build-essential linux-headers-`uname -r`
Ahora tenemos que desinstalar todos los paquetes que puedan crear conflictos:
sudo aptitude purge nvidia-glx nvidia-glx-legacy nvidia-glx-new nvidia-settings
Ahora abrimos el archivo que se encuentra en /etc/default/linux-restricted-modules-common con vuestro editor de textos voy a poner el ejemplo con gedit pero basta cambiar gedit por vuestro editor preferido.
sudo gedit /etc/default/linux-restricted-modules-common
Ahora en el fichero que tenemos abierto desactivamos los drivers que lleva Ubuntu por defecto de Nvidia si no lo hacemos dara problemas y nuestro ordenador no arrancara en modo grafico. Buscamos lo siguiente:
DISABLED_MODULES=""
Y lo sustituimos por: (nvidia_new solo es necerario en feisty)
DISABLED_MODULES="nv nvidia_new"
No olvidarse de guardar el documento anterior.
Ahora vamos a modificar el fichero xorg.conf. Lo abrimos con el editor de textos:
sudo gedit /etc/X11/xorg.conf
Comentamos si tenemos la linea donde pone dri con una # como en el ejemplo:
Section "Module"
Load "bitmap"
Load "dbe"
Load "ddc"
# Load "dri" <------ Esto esta "comentado"
Load "extmod"
Load "freetype"
Load "glx"
Load "int10"
Load "record"
Load "type1"
Load "vbe"
EndSection

Ahora vamos hasta la sección device y cambiamos driver "nv" (o lo que tengamos puesto ej: "vesa") por "nvidia"
Section "Device"
Identifier "Card0"
Driver "nvidia" #Esto es lo que debe ser cambiado
EndSection
Guardamos todo el documento y cerramos lo que tengamos abierto porque vamos a cerrar el modo gráfico.
Apagamos el sistema gráfico (X-windows) para poder terminar de instalar el driver.
sudo /etc/init.d/gdm stop
Ahora nos situamos donde tengamos el driver descargado de Nvidia y le damos permisos de ejecucion si el nombre es diferente poner otro nombre:
sudo chmod +x NVIDIA-Linux-x86-100.14.09-pkg1.run
Ahora instalamos el driver y seguimos los pasos que nos indica .
./NVIDIA-Linux-x86-100.14.09-pkg1.run
Después de esto el driver esta instalado ya tendremos aceleracion grafica, iniciamos otra vez el modo grafico.
sudo /etc/init.d/gdm start
Si el driver esta bien instalado nos iniciara el modo gráfico ahora para comprobar que todo esta bien instalado reiniciamos el ordenador. Si no arranca el modo gráfico es porque tenemos algun conflicto con drivers antiguos porque no los hemos desactivado correctamente. Para volver a tener modo gráfico entrar en el archivo xorg.conf buscar la sección device driver "nvidia" y cambiarla por driver "nv"

== Compiz-fusion ==

Si vamos a usar beryl o compiz-fusion con nuestro driver instalado MANUALMENTE tenemos que ejecutar.

sudo nvidia-xconfig --add-argb-glx-visuals -d 24

== Ver también ==
*[[Nvidia]]
*[[Nvidia:Soporte|Lista de modelos soportados]]


[[Categoría:tarjetas gráficas]]

Guía de empaquetamiento/Completa

2008-07-08T14:40:31Z

Festor: /* Requisitos de paquetes nuevos para Ubuntu */

{{en desarrollo|Festor}}


== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa ''GNU hello'' como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio <code>hello/</code> que contiene los archivos del código fuente. Ahora necesitamos crear un directorio <code>debian/</code> donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro <code>-f</code> seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntará qué tipo de paquete queremos crear:

* La opción «s» para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción «m» genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb).
* La opción «l» para bibliotecas.
* La opción «k» se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar).
* La opción «b» utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones <code>-s</code>, <code>-m</code>, <code>-l</code>, <code>-k</code> o <code>-b</code> detrás del email para responder directamente a esta pregunta.

El comando <code>dh_make</code> sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar <code>dh_make</code> este crea los archivos básicos en el directorio <code>debian/</code> y algunos archivos plantilla (.ex) que quizás puedan ser necesarios o no. El programa ''Hello'' no es muy complicado, y una vez vista la sección [[#Empaquetando desde el código fuente|Empaquetando desde el código fuente]], sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos <code>.ex</code>:

cd debian/
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio <code>debian/</code>:

* <code>README.Debian</code>: el archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
* <code>dirs</code>: usado por dh_installdirs para crear los directorios necesarios.
* <code>docs</code>: usado por dh_installdocs para instalar la documentación del programa.
* <code>info</code>: usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada «Archivos de ejemplo dh_make».

Llegados a este pinto deberías tener en el directorio <code>debian/</code> sólo los archivos <code>changelog</code>, <code>compat</code>, <code>copyright</code> y <code>rules</code>.

==== changelog ====

El archivo '''<code>changelog</code>''', como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave [[GPG]], asegúrate de usar el mismo nombre y cuenta de correo en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo <code>changelog</code>:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aun más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato ''RFC822'' el cual se puede obtener usando el comando <code>date -R</code>. Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo <code>changelog</code> para ''hello'':

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice ''-0ubuntu1'', esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ''ubuntuX'' (donde ''X'' es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian ''hello 2.1.1-1'' se modifica para Ubuntu la línea de versión será ''2.1.1-1ubuntu1''. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es ''0'' (por ejemplo, ''2.1.1-0ubuntu1'').

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Date cuenta que en este caso la distribución a la que hace referencia es ''unstable'' (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo '''<code>control</code>''' contiene la información que el administrador de paquetes (como [[dpkg]], [[apt]], [[aptitude]], [[Synaptic]] y [[Adept]]) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete ''hello'' de Ubuntu, el archivo <code>control</code> verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de ''Maintainer'' (''Mantenedor'') normalmente un nombre y cuenta de correo general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los [[MOTU]] (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo <code>control</code> usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo ''XSBC-Original-Maintainer'').

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estás haciendo.
* '''Section:''' indica la categoría del paquete dentro de un repositorio [[apt]] que es reconocida por gestores de paquetes como [[Synaptic]] o [[Adept]], no obstante esto no tiene nada que ver con la categoría del menú de [[GNOME]] o [[KDE]].

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' indica la prioridad del paquete en el sistema. Dispones de las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más, si no se quiere dar basta con modificarlo con algo como ''email@email.com''.

Eso sí, a la hora de firmar los paquetes con claves [[GPG]] (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes Deb deben seguirla.

Para más información mira la [http://www.debian.org/doc/debian-policy/ documentación oficial de Debian].

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución.

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una [[terminal]]:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el <code>dh-make</code> lo hace automáticamente, pero si estás portando un paquete de los ''backports'' de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' esta es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en ''Package'' y ''Source'' deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete. Algunos ejemplos son:
** ''all'' - El programa a empaquetar no depende de la arquitectura del sistema. Se refiere a programas hechos en lenguajes interpretados o independientes de la plataforma, como [[Python]] o [[Java]]. El resultado será un paquete binario cuyo nombre acabará en ''_all.deb''.
** ''any'' - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas compatibles. Habrá un archivo .deb para cada arquitectura (''_i386.deb'' por ejemplo).

Se puede optar por una o más de un subconjunto de arquitecturas (''i386'', ''amd64'', ''ppc'', etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu.

* '''Depends:''' esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el ''-dev'').

En algunas ocasiones (empaquetado de programas hechos en Python, Java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' se usa para paquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo [[aptitude]], instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado.

* '''Conflicts:''' se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' aquí describiremos el programa, esto es lo que se verá cuando abras el archivo <code>.deb</code> con un programa como [[GDebi]]. La descripción de un paquete deb se basa en dos partes:
** Un ''título'' de 60 letras que va directamente después de ''Description:''.
** Un ''texto'' de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada línea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

El archivo '''<code>copyright</code>''' proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo <code>COPYING</code> en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar ''hello'' se libera bajo la [[w:licencia de software|licencia]] [[w:licencia pública general de GNU|GPL]]. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Nota que el archivo <code>copyright</code> del paquete ''hello'' de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el '''<code>rules</code>'''. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un ''Makefile'' con instrucciones para compilar e instalar la aplicación, luego crear el archivo <code>.deb</code> a partir de los archivos instalados. También tiene instrucciones para revertir la compilación e instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del <code>rules</code> creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones ''noopt'' para la información de depuración (debugging).

Ahora vamos a ver la sección ''build'':

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso <code>./configure</code> con las variables adecuadas, luego ejecutan <code>make</code> y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección ''clean'' en la cual se ejecuta <code>make -i distclean</code> eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones ''binary-indep'' vacías. Algunos paquetes se crean independientes de una arquitectura específica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas Python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en ''_all.deb''.

''hello'' es un programa escrito en [[w:lenguaje de programación C|C]] por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en ''_i386.deb'' o ''_amd64.deb'' principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo ''binary-arch'':

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts ''debhelper'' que crean nuestros paquetes deb. ''dh_testdir'' y ''dh_testroot'' hacen algunas comprobaciones de la estructura. ''dh_installdocs'' y ''dh_installchangelogs'' instala los archivos que especifiques en los archivos *.doc y *.changelog. ''dh_strip'' tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. ''dh_compress'' ejecuta [[gzip]] (un compresor de consola) para comprimir alguna documentación. ''dh_shlibdeps'' añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente ''dh_builddeb'' construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, <code>compat</code>, el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estás listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

''Debuild'' comprobará primero si el paquete <code>build-depends</code> está instalado, luego usará <code>dpkg-buildpackage</code> para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo <code>debian/rules</code>. Si todo está bien debuild intentará firmar digitalmente el o los paquetes con [[GPG]], si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tú no tienes una llave GPG con el mismo nombre y correo que el que usaste en el archivo <code>debian/changelog</code>.

Tu nuevo paquete debería estar en el directorio superior al código fuente. Échale un vistazo e instálalo:

cd ..
lesspipe *deb
sudo dpkg --install *.deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio <code>debian/</code> en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el <code>.orig.tar.gz</code> para crear un archivo <code>.dsc</code> que contiene la descripción y el <code>md5sum</code> para el paquete fuente y un archivo <code>.diff.gz</code> en el cual se compara el código fuente comprimido (<code>.orig.tar.gz</code>) con el descomprimido en donde se halla el directorio <code>debian/</code>. Los archivos <code>.dsc</code> y <code>*_source.changes</code> usados para subir el paquete fuente serán firmados usando tu llave GPG.

La opción <code>-S</code> le dice al debuild que construya el paquete fuente usando los scripts ''dpkg-buildpackage'' y ''[[fakeroot]]'' para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las opciones <code>-us -uc</code> con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos. Para asegurarte de que debuild encuentre correctamente la clave GPG debes introducir las variables de entorno <code>DEBFULLNAME</code> y <code>DEBEMAIL</code>, en el script de inicio de tu intérprete de comandos (<code>~/.bashrc</code> en [[bash]], por ejemplo), con el nombre y el cuenta de correo electrónico respectivamente que uses para la clave GPG y en el archivo <code>debian/changelog</code>.

Algunos usuarios han reportado que les fue imposible que debuild encontrara la clave GPG incluso después de introducir las variables. Si este fuera tu caso puedes probar con el comando:

debuild -k <id_clave_GPG>

Donde <id_clave_GPG> es el identificativo de tu clave GPG.

Para comprobar que el paquete se construya en un entorno limpio también podemos construir el paquete binario con ''pbuilder'':

sudo pbuilder build ../*.dsc

Usando ''pbuilder'' podemos saber si las dependencias son correctas ya que este proporciona un entorno mínimo así que todas las dependencias quedarían determinadas por el archivo <code>control</code>.

Ahora podemos comprobar los errores comunes en el paquete fuente usando ''lintian'':

cd ..
lintian -i *.dsc

==== Requisitos de paquetes nuevos para Ubuntu ====

Cuando un paquete fuente, que aún no existe, se sube a Ubuntu o se construye un nuevo paquete binario debe ser colocado en la lista NEW y tienen que ser revisado por un miembro del equipo del archivo de Ubuntu

===== Empaquetado =====

* Lo más importante: Mirar los derechos de autor (copyright) y la información de la licencia antes de nada.
* El paquete fuente y el paquete binario deben tener un nombre "sano": ni uno demasiado corto (como "editor") ni uno extremadamente largo y sin sentido (como "nuevo-cool-administrador")
* debian/control y debian/rules deben construir paquetes con Architecture:, Build-Depends[-Indep]: correctos, y el archivo rules debe tener muy presente la relación (binary-arch vs. binary-indep).
* Los scripts de mantenimiento del paquete no deben estropear demasiado el sistema
* ...

===== Otros =====

=== Empaquetando con CDBS ===

...

=== Empaquetando módulos Python con CDBS ===

...

=== Empaquetado avanzado ===

...

==== Creando más de un paquete binario ====

...

=== Empaquetando librerías compartidas ===

...

==== Librerías compartidas ====

...

=== Errores comunes ===

...

==== Archivos de ejemplo dh-make ====

...

==== Abusando de archivos ====

...

==== Cambiando el tarball original ====

...

===== Soluciones =====

...

===== Consejos =====

...

==== Información de Copyright ====

...

==== Paquetes de referencia ====

...

== Sistema de parches ==

== KDE ==

== Archivos complementarios ==

== Recetas ==

== Apéndice ==

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

[[Categoría:MOTU-es]]

Prólogo.- ¿Qué vamos a aprender?

2008-07-07T09:38:54Z

Festor: /* Descripción */

== Introducción ==
¿Qué duda cabe que hoy día cualquier aplicación que se precie debe contemplar una interfaz gráfica que lo convierta en agradable para el usuario? Pero no es común encontrar gente cualificada para desarrollar esas aplicaciones, a pesar de que, tal y como vamos a demostrar, son unos conocimientos al alcance de todos.

También cabe denotar que ante esta situación se ha generalizado el uso de otros lenguajes de programación que ya incluyen esta posibilidad, pero que no obstante, pierden la potencia y velocidad que en su día hicieron famoso a C++

== Descripción ==
Realmente, sobre [http://www.codeblocks.org/ code::block] hay poco que mencionar, pues tan solo es una [http://es.wikipedia.org/wiki/Entorno_de_desarrollo_integrado IDE], pero en cambio, si conviene hacer unos breves comentarios sobre [http://www.wxwidgets.org/ wxWidgets]

wxWidgets son unas librerías que en un principio se orientaron a crear interfaces gráficas para C++, pero que actualmente sirven incluso para implementaciones cliente/servidor. Además de su potencia como herramienta de desarrollo, está su potencia como herramienta multiplataforma, ya que llevado el código con cuidado, este será igual de válido para Linux, Windows, Mac, etc.

Efectivamente, nos centraremos en el mundo Ubuntu, no obstante, dedicaremos un capítulo a preparar un compilado de nuestro código para Windows.

== Objetivo ==
Pues ya lo hemos mencionado, nuestro objetivo es crear una aplicación con una interfaz gráfica, intentando tocar todos lo puntos a los que el programador pueda tener que enfrentarse.

Así pues, y sin más preámbulos, comencemos con el tutorial.

{| border=1 class="wikitable" align=center
|-
| style="text-align: center; border: 2px solid #8B673A; background-color: #F0E2C6; -moz-border-radius: 8px; margin: 10 10 10 10; padding: 5px; font-weight: bold;" | [[Nuestra primera interfaz gráfica con CodeBlocks y wxWidgets]]
| style="text-align: center; border: 2px solid #8B673A; background-color: #F0E2C6; -moz-border-radius: 8px; margin: 10 10 10 10; padding: 5px; font-weight: bold;" | [[Nuestra primera interfaz gráfica con CodeBlocks y wxWidgets]]
| style="text-align: center; border: 2px solid #8B673A; background-color: #F0E2C6; -moz-border-radius: 8px; margin: 10 10 10 10; padding: 5px; font-weight: bold;" | [[Capítulo 0.- Sobre como instalar wxWidgets y CodeBlocks]]
|}

Preguntas frecuentes

2008-07-07T04:39:23Z

Festor: /* Solucionar problemas con Synaptic */

'''FAQ''' es el acrónimo de '''''F'''requently '''A'''sked '''Q'''uestions'' (en inglés), que en español significa ''preguntas frecuentes''. El término se refiere a una lista de preguntas y respuestas, dentro de un determinado contexto y para un tema en particular.

En español aunque menos utilizado, existe el término '''PUF''' acrónimo de '''''P'''reguntas de '''U'''so '''F'''recuente''.

En esta sección trataremos de dar solución rápida a través de respuestas concisas a los problemas más frecuentes con que se puede encontrar el usuario de [[Ubuntu]], desde el principiante hasta el avanzado.

== Consejos iniciales ==

Si quieres encontrar la pregunta que te interesa lo más rápido posible, es aconsejable usar el buscador de tu navegador de internet pulsando CTRL + F.

== Pre-instalación de Ubuntu ==

=== ¿De dónde descargo Ubuntu? ===

Es siempre aconsejable bajarse una .ISO (Imagen de Disco) desde la página oficial para no llevarse sorpresas.

[[Sitios de descarga|Página de Descargas de Ubuntu]]

Si no puedes descargarlo debido a tu ancho de banda, también puedes pedir que te envíen el CD a casa desde [https://shipit.ubuntu.com/ Shipit].

=== ¿Qué versión de Ubuntu debo descargarme? ===

Normalmente es aconsejable instalar la versión más actual pero si tu ordenador es antiguo o tiene pocos recursos deberías ver los requerimientos de cada versión. No es recomendable descargar una versión de Ubuntu inferior a 6.06 LTS. Consulta las versiones de Ubuntu en '''[[Versiones]]'''

La principal limitación a la hora de instalar Ubuntu es la memoria RAM, ya que la instalación se realiza en modo gráfico. A pesar de ello, puedes emplear la '''versión alternate (o alternativa)'''.

Algunos usuarios recomiendan Ubuntu 6.06 LTS por ser más estable, y otros recomiendan la última versión de Ubuntu por ser más sencilla en su uso y estar más actualizado.

La decisión a la hora de elegir cual versión de Ubuntu usar, está a criterio personal.

=== ¿Desktop, Alternate o Server? ===

'''La imagen tipo Desktop (o Escritorio)''' es una versión Live-CD (que te permite arrancar Ubuntu sin instalarlo en tú ordenador) que te da la posibilidad de instalarlo desde el escritorio con el icono "Install". Es la adecuada para la mayoría de ordenadores actuales para uso doméstico o para oficina

'''La imagen tipo Alternate (o Alternativa)''' es una versión que permite ciertas instalaciones especiales, como puede ser el caso de ordenadores con poca memoria RAM (menos de 192Mb) o con tarjetas gráficas problemáticas. Es la indicada si la versión anterior te ha dado algún problema durante la ejecución/instalación gráfica. No permite ejecutar Ubuntu con el entorno gráfico sino que te invita a instalarlo desde el principio.

'''La imagen tipo Server (o Servidor)''' es una versión que no instala un interfaz gráfico de usuario (aunque se puede instalar después), ya que está destinada a ordenadores que tengan que trabajar como servidores. En el menú inicial puedes elegir entre dos tipos de instalación:

* '''Server:''' Se instala el sistema operativo y luego tú has de instalar las aplicaciones que necesites.
[[LAMP]]:''' Se instala el sistema operativo junto con Apache, soporte PHP, [[MySQL]] y queda configurado desde la instalación para trabajar como servidor web.

Una recomendación final, al momento de seleccionar cual imagen descargar, muchos recomiendan 6.06 LTS por ser más estable y por tener más tiempo de soporte (hasta 2011). Aunque no significa que la versión más actualizada sea inestable.

=== Distintos tipos de CD, ¿cuál es el adecuado para mi ordenador? ===

Dentro de cada tipo de imagen hay distintos tipos de CD en función de la arquitectura de tu ordenador:

* '''PC (Intel x86):''' Adecuada para la mayoría de PCs (i.e. Pentium, Celeron, Core, Athlon, Sempron) que ejecutan Windows. Escoge ésta si no está seguro, pues siempre te funcionará.

* '''Mac (PowerPC):''' Adecuada para máquinas Apple Macintosh G3, G4 y G5. Esto incluye iBooks y PowerBooks.

* '''64-bit PC (AMD64):''' Adecuada para máquinas basadas en la arquitectura AMD64 o EM64T (i.e. Athlon64, Core, Opteron, EM64T Xeon). No es la necesaria para todos ni la apropiada para muchos, solo para aquellos que soporten arquitectura de 64bits.

* '''SPARC server install CD:''' Este tipo de CD sólo está disponible para la imagen tipo Server y es la adecuada para las computadoras UltraSPARC de Sun Microsystems. Esto también incluye a las máquinas basadas en procesadores multicore UltraSPARC T1 ("Niagara").

== Instalación de Ubuntu ==

=== ¿Cómo instalo Ubuntu? ===

En pocos pasos:
# ''Redimensionar la partición de Windows'' y dejar un espacio de más o menos unos 10 GB o más no particionado. Puedes hacerlo desde Windows con Partition Magic por ejemplo.
# ''Insertar el CD de Ubuntu'' que has grabado y reiniciar.
# ''Instalar'': Cuando llegue a la opción de instalar Ubuntu en el disco duro (si es una versión alternate) o cuando entres en el escritorio y le des al icono de INSTALL (si es una versión Desktop) elige la opción “Instalar en espacio no asignado”. Del resto se encarga Ubuntu: te formateará la partición y te creará otra pequeña partición swap. Cuando acabe, reinicia y voilà: ya tendrás tu Ubuntu funcionando.

Para una información más detallada, visita la sección de '''[[Instalación]]'''

{{nota|Si eres un usuario más avanzado es aconsejable realizar el particionado mediante el programa de particionado de Ubuntu (que te aparece al instalar) dejando una partición Swap, una ext3 para "/" y una partición ext3 para "/home".}}

== Básicos Ubuntu ==

=== No puedo entrar como root ===

Ubuntu tiene desactivada por defecto la cuenta '''root'''. De este modo obtenemos dos ventajas fundamentales:

* Que un usuario novato no provoque destrozos en el sistema, ya que no sabe que el archivo que está tocando es importante para el buen funcionamiento del sistema operativo.

* Estar con privilegios totales constantemente es un agujero de seguridad importante que permitiría que algún programa malicioso dañara tu equipo.

Una vez sepas activar la cuenta root por ti mismo, significará que ya estás preparado para usarla. Hasta entonces... mejor ser un SUDOer y emplear el comando SUDO.

=== ¿Cómo puedo trabajar con privilegios de root? ===

Si trabajas a través del entorno gráfico, él mismo ya te pide '''tu contraseña''' cada vez que se requieran permisos de administrador para realizar una acción. Esto suele ser para instalar programas a través de [[Synaptic]], cambiar la [[configuración de red]], [[usuarios y grupos|crear un nuevo usuario]], etc.

Si necesitas realizar alguna acción desde consola con privilegios de root, sólo has de escribir el comado '''sudo''' delante del comando a ejecutar.

Ejemplo: sudo fdisk -l (para ver las particiones del ordenador)

=== ¿Qué es Sudo? ===

Para ejecutar operaciones de administración en Ubuntu se emplea un comando llamado '''«sudo»'''. Este programa nos pregunta la contraseña de nuestro usuario actual para acceder a los poderes administrativos. Tras un tiempo de inactividad los permisos "caducan", un mecanismo de seguridad para evitar los mismos riesgos que tendría trabajar desde la cuenta root.

Este programa puede utilizarse en modo gráfico con «gksudo programa», por ejemplo:

gksudo gedit (para lanzar el editor de textos en modo administrador)

aunque la consola es el uso mas común de sudo.

=== En la terminal me pide la contraseña pero cuando lo introduzco no sale nada ===

Aunque no veas la contraseña, sí que la estás escribiendo. Es una medida de seguridad ante miradas indiscretas. Simplemente escríbela y dale a intro.

=== ¿Cómo puedo trabajar gráficamente con permisos de Root? ===

A veces nos interesa trabajar con archivos y carpetas de los que nuestro usuario no tiene permisos de escritura. En estas situaciones trabajar por consola mediante el comando ''sudo'' puede ser muy lento y tedioso. Para poder trabajar desde el entorno de ventanas debemos trabajar con nautilus (el gestor gráfico de archivos de Gnome) con privilegios de usuario root.

Existe una forma muy sencilla de hacer esto::

* Instala el paquete '''nautilus-gksu''' de los repositorios oficiales de Ubuntu.

* Una vez instalado el paquete abre una terminal y escribe el comando '''killall nautilus''' para activar la función de este paquete.

* A partir de ahora aparecerá una opción llamada '''Abrir como administrador''' al pulsa con el botón derecho del ratón en una carpeta o archivo.

== Programas ==

=== ¿Cómo hacer que un programa se arranque desde el inicio? ===

En Ubuntu es muy fácil. Sólo has de ir a:

'''Sistema -> Preferencias -> Sesiones -> Programas de Inicio'''

Donde has de añadir el nombre del programa que quieres que arranque al iniciarse el sistema.

Otra opción es instalarte el programa '''Boot-Up Manager''' mediante [[Synaptic]]. Una vez instalado lo podrás encontrar en:

'''Sistema -> Administración -> Boot-Up Manager'''

=== ¿Hay algún messenger para Ubuntu? ===

'''[[Pidgin]]''':
Tienes múltiples opciones. El sistema lleva preinstalado un programa llamado [[Pidgin]] (antiguo gaim), que permite trabajar como cliente Jabber, Google Talk, Messenger,..., aunque su interfaz gráfica no es similar a la de Messenger.

'''[[aMSN]]''':
Otra opción es instalarte [[aMSN]], un clon libre de MSN Messenger (y en algunos aspectos superior). Puedes instalártelo desde [[Synaptic]] desde el cual debes buscar e instalar el paquete '''amsn'''.

'''[[emesene]]''':
Una nueva opción que a partir de Ubuntu 8.04 se puede descargar de "Añadir/Eliminar..." en el menú "Aplicaciones". También [[emesene]], es un clon libre de MSN Messenger, pero se destaca por tener una interfaz usuario flexible, configurable, agradable y muy intuitiva para usuarios que migran de [[w:Windows Live Messenger|Windows Live Messenger]].

=== Mi aMSN no emite sonidos. ¿Cómo puedo solucionarlo? ===

Abre la aplicación de aMSN y vete a Herramientas -> Preferencias -> Otras

En la parte de servidor de sonidos verás una línea donde pone

play $sound

que has de sustituir con:

aplay $sound

De modo que AMSN empleará ALSA para emitir los sonidos.

=== ¿Cuáles son los equivalentes de mis programas de Windows en GNU/Linux? ===

En [[Aplicaciones y equivalencias]] puedes hallar una colección de equivalencias entre programas Windows/Linux.

Como verás, hay gran cantidad de alternativas (muchas de ellas superiores a sus homólogas de Windows). Puedes asesorarte con miembros de la comunidad ubuntu para escoger la que más se adapte a tus necesidades.

=== ¿Cómo se instalan programas? ===

Existen diversas formas de [[instalar aplicaciones|instalar programas]] en Ubuntu en función de la situación en que te encuentres. En un rango de dificultad tenemos:

* '''Añadir y Quitar Aplicaciones (método más sencillo):''' Aplicaciones -> ''Añadir y Quitar...''. Te instala por programas.

* '''[[Synaptic]]:''' Sistema -> Administración -> Gestor de Paquetes Synaptic. Instalación por paquetes, pero te soluciona dependencias.

* '''[[aptitude]]:''' Mediante el comando en consola ''sudo aptitude paquete''. Más potente que APT-GET. También te soluciona dependencias y recuerda librerías descargadas desinstalandolas si están en desuso.

* '''[[apt]]:''' Mediante el comando en consola ''sudo apt-get install paquete''. También te soluciona dependencias.

* '''Paquetes .deb:''' Mediante el Gestor de Paquetes [[Instalar aplicaciones descargadas|gDebi]] (doble click sobre el .deb). No te soluciona dependencias.

* '''Archivos .bin:''' Son los ejecutables de GNU/Linux.

* '''Archivos .run:''' Suelen ser asistentes de instalación para GNU/Linux.

* '''Paquetes .rpm:''' Mediante [[Alien]] los conviertes a paquetes.deb y los instalas, con doble click.

* '''[[Compilar programas|Instalar aplicaciones a partir del código fuente (Compilar)]]:''' es la forma más eficiente, pero la más complicada.

Ten en cuenta que '''sólo podrás tener un programa de instalación activo a la vez''', por lo que si tienes abierto el programa Synaptic no podrás añadir aplicaciones mediante otro de los métodos de instalación ni actualizar el sistema operativo, de forma que se proteja la integridad del sistema.

Si quieres saber más de cómo instalar programas, pásate por la sección de [[Instalar aplicaciones]].

=== ¿Cómo ejecutar programas de Windows en Ubuntu? ===

Puedes ejecutar programas de Windows empleando un emulador de Windows como:

* '''[[Wine]]''' (http://es.wikipedia.org/wiki/Wine): Programa '''libre y gratuito''' que permite ejecutar programas de Windows y MS-DOS.

* '''[[Crossover Office]]''' ([[w:CrossOver Office|CrossOver Office]]): Programa '''privativo y de pago''' que viene a ser Wine con algunos parches y una configuración más sencilla.

* '''[[Cedega]]''' (http://es.wikipedia.org/wiki/Cedega): Programa '''privativo y de pago''' basado en Wine, pero diseñado para juegos de ordenador.

También tienes la opción de virtualizar Windows mediante:

* [[w:VMware VMware|VMware VMware]].

* [[VirtualBox]], de licencia GNU en una de sus ediciones.

* [[w:Virtual PC|Virtual PC]]

* [[w:BOCHS|BOCHS]], de licencia GNU.

* [[w:QEMU|QEMU]], de licencia GNU.

* [[w:Virtuozzo|Virtuozzo]], software propietario.

== Multimedia ==

=== ¿Cómo ver peliculas en DivX, etc.? ===

Ubuntu viene con el Reproductor de Películas Totem ya instalado, pero los codecs para poder visualizar formatos DivX, Xvid, etc. hay que instalarlos aparte por ser de carácter propietario.
; En Ubuntu 7.10 (Gutsy Gibbon)
* Haz click en '''Aplicaciones → Añadir/Quitar''' y busca el paquete '''Ubuntu restricted extras'''. Seleccionalo y haz click en '''OK'''.
* Para ver la mayoría de DVDs necesitarás el paquete '''libdvdcss2''' . Este paquete está disponible utilizando [[Medibuntu]]. Este es un repositorio de terceros y no está soportado por Canonical.
* Algunos codecs externos pueden necesitar para reproducirse ciertos formatos propietarios como Apple Quicktime o Real``Video. Estos códecs externos están disponibles en el repositorio de terceros [[Medibuntu]].

'''Consulta: [[Formatos libres]] y [[Formatos Restrictivos]].'''

== Personalización ==

=== ¿Cómo crear un Acceso Directo? ===

Tenemos diferentes mecanismos para hacer esto:

* '''Desde Menú Aplicaciones:''' Para añadir un acceso directo de un programa que tengamos en Aplicaciones, únicamente deberemos hacer clic con el botón derecho sobre nuestra aplicación y seleccionar: "añadir este lanzador al escritorio".

* '''Desde Consola:''' Para añadir un acceso directo a cualquier aplicación, archivo o carpeta (independientemente de que aparezca en Aplicaciones) abriremos la consola de comandos y escribiremos:

ln -s /ruta_origen ~/Desktop

* '''Desde Escritorio:''' Le das al botón derecho del ratón en cualquier parte del escritorio y seleccionamos ''crear nuevo -> enlace a aplicación''. Una vez dentro de esta ventana, en la pestaña ''aplicación'' donde pone ''orden'' pones el nombre de la aplicación y lo demas lo decoras a tu gusto (pones un icono, descripción y el nombre que tu quieras).

=== ¿Cambiar tamaño de iconos? ===

Abre una ventana del administrador de archivos [[Nautilus]] y en menú '''Editar''' vete a:

'''Preferencias -> Vistas -> Valores Predeterminados para la vista de Iconos -> Nivel de Ampliación Predeterminado'''

Donde puedes escoger el porcentaje de tamaño que quieres para los iconos. Cuanto menor sea el porcentaje, más pequeños se verán todos los iconos del sistema y viceversa.

== Resolución de Problemas Habituales ==
=== Activar aceleración gráfica ===
Consulta la sección [[Tarjetas gráficas]]

=== Problemas con el módulo tls de amsn ===

Si cuando inicias amsn te pide que descargues el módulo tls siempre, prueba lo siguiente:
Copia la ruta del módulo tls, será algo parecido a <tt>http://switch.dl.sourceforge.net/sourceforge/amsn/tls-1.5.0-linux-x86.tar.gz</tt>
Abre una terminal y escribe:
cd
Descarga el paquete (cambia la ruta por la que te haya aparecido a tí):
wget http://switch.dl.sourceforge.net/sourceforge/amsn/tls-1.5.0-linux-x86.tar.gz
Moverlo a la carpeta /usr/share/amsn:
sudo mv tls-1.5.0-linux-x86.tar.gz /usr/share/amsn
Entrar en esa carpeta:
cd /usr/share/amsn
Descomprimirlo:
sudo tar -xvzf tls-1.5.0-linux-x86.tar.gz

Y después ejecuta el Amsn y ve a '''Cuenta > Preferencias > Avanzadas > Otras > TLS''' y ahi mismo escribe <tt>/usr/share/amsn/tls1.50</tt>
Reinicia el Amsn y ya no te aparecerá más el problema

=== ¿Cómo escribir/leer en una partición NTFS? ===
{{nota|A partir de Ubuntu 7.04 el soporte para lectura y escritura de particiones ntfs viene habilitado por defecto}}
Para versiones anteriores:
# Instala '''NTFS-3g''' mediante [[Synaptic]].
# Ve a '''''Aplicaciones -> Herramientas del Sistema -> Herramienta de configuración de ntfs3-g''''' y activa la primera opción al menos, si ves que es necesario activa también la segunda.

=== ¿Cómo recargo fstab sin reiniciar el sistema? ===

'''Fstab''' es el archivo de configuración de particiones, en el se hacen cambios para [[montar particiones|montar y desmontar particiones y discos duros]].
Para ello has de entrar en consola y escribir:

sudo umount -a (desmonta todas las particiones que no estén en uso)
sudo mount -a (monta las particiones que aparecen en fstab que no estén ya montadas)

=== ¿Por qué el portapapeles de Ubuntu no funciona igual que en Windows? ===

Algunos usuarios observan que al copiar algo en una aplicación, al cerrar esta aplicación la información no queda memorizada en el portapapeles como en Windows. Esto es debido al diferente sistema de trabajo del portapapeles en GNU/Linux y Windows.

En Windows los datos copiados de una aplicación se mantienen en memoria, lo cual causa un decremento del rendimiento del sistema a la hora de albergar grandes cantidades de datos en el portapapeles (ya que se ha de sacrificar memoria para una copia). El planteamiento en Linux es más eficiente, ya que la aplicación simplemente informa al sistema de que esos datos son los que se han de copiar. Al no almacenar la información completa en memoria evitamos duplicar esfuerzos y el rendimiento mejora. A parte, este sistema ofrece otras ventajas como por ejemplo que de este modo se consigue más seguridad a la hora de navegar por internet.

Si aún así te interesa esta opción, puedes instalarte [http://http://glipper.sourceforge.net/ Glipper] a través de Synaptic, una sencilla herramienta que guarda un histórico de lo datos copiados (entre otras funciones). Esta aplicación estará ya accesible desde instalación en Ubuntu Feisty Fawn 7.04.

=== ¿Cómo recupero un GRUB perdido? ===

Distintas soluciones, pero las más sencillas son:

a.) Reinstalar el GRUB con tu Live-CD -> http://arot-linux.blogspot.com/2005/08/reinstalar-grub-en-el-mbr.html

b.) Reinstalar GRUB con SuperGRUB Disk -> [[Super Grub Disk]]

La que prefieras... una implica descargar algo de internet y la otra es independiente de internet. Decisiones, decisiones...

=== Al reiniciar, la pantalla se queda en negro y no arranca el entorno gráfico ===

Posiblemente has estado tocando la configuración de tu tarjeta gráfica. Si te aparece el modo texto de ubuntu, escribe:

sudo dpkg-reconfigure xserver-xorg

Y vuelve a configurar tu entorno gráfico. Si no tienes acceso a escritura, reinicia y entra en modo seguro, cuando te aparezca la pantalla escribe el comando anteriormente escrito.
La próxima vez que edites el archivo Xorg.conf, haz una copia de seguridad, de esta manera:

sudo cp /etc/X11/xorg.conf /etc/X11/xorg.conf-backup

Y si tienes problemas al reiniciar el entorno gráfico, entonces podrás recuperar tu antiguo xorg con el comando:

sudo cp /etc/X11/xorg.conf-backup /etc/X11/xorg.conf

=== ¿Cómo hacer que arranque por defecto Windows en lugar de Ubuntu? ===

Hay que editar el archivo menu.lst que se encuentra en ''/boot/grub/menu.lst''. Para ello hay que ir a la consola de comandos y escribimos:

sudo gedit /boot/grub/menu.lst

Buscar la línea que ponga únicamente ''default'' y allí indica el número de línea que se carga por defecto (lo encontrarás con el número cero).

# You can specify 'saved' instead of a number. In this case, the default entry
# is the entry saved with the command 'savedefault'.
# WARNING: If you are using dmraid do not change this entry to 'saved' or your
# array will desync and will not let you boot your system.
default 0
ejemplo:
0=Ubuntu (development branch), kernel 2.6.22-14-generic
1=Ubuntu (development branch), kernel 2.6.22-14-generic (recovery mode)
2=Ubuntu (development branch), memtest86+
3=Other operating systems:
4=Microsoft Windows XXXXX

Si tienes Windows y Ubuntu instalado este número debería ser 4 para que cargue Windows por defecto (hay que tener en cuenta que la entrada que aparece como separador (''"title Other operating systems:"'') también cuenta a la hora de contar el número de línea.

Cierra el documento guardando y cuando reinicies verás el resultado.

Si esto no te funciona, consulta este [http://www.ubuntu-es.org/index.php?q=node/57256 howto].

=== Solucionar problemas con Synaptic ===

Cuando estamos instalando programas con [[Synaptic]], Añadir y Quitar o vía terminal nos puede pasar que se nos quede colgado el PC o se nos vaya la luz a mitad instalación. En estos casos al volver abrir [[Synaptic]] nos sale el siguiente mensaje:

E: dpkg was interrupted, you must manually run 'dpkg --configure -a' to correct the problem.
E: _cache->open() failed, please report.

Para solucionarlo es muy sencillo, tan sólo hemos de seguir la recomendación que nos sale en la primera línea, es decir; cerrar [[Synaptic]], abrir una terminal y teclear:

sudo dpkg --configure -a

=== Cuando aprieto el boton central del raton en firefox no me aparece el autoscroll ===

Muchos que cambiais de Windows a Linux Ubuntu os encontrais con que al apretar el botón central del ratón no aparece el autoscrolling, cosa que si pasaba en Windows. Esto se arregla en firefox llendo a ''Editar>Preferencias>Avanzado>General>Activar Usar desplazamiento automático''.

También diré que en Ubuntu, ese botón se puede usar para copiar y pegar (seleccionas un texto en una ventana, click en el botón, vas a otra, click y lo pegas). Con alt+click puedes redimensionar ventanas sin moverte hasta las esquinas, tambien puedes mover con él los iconos de los paneles de gnome...

=== ¿Cómo pongo Firefox en español? ===

Necesitas instalar el paquete mozilla-firefox-locale-es-es.

=== ¿Cómo pongo OpenOffice.org en español? ===

Necesitas instalar el paquete openoffice.org-l10n-es.


[[Categoría:Empezando]]

Guía de empaquetamiento/ManualDebdiff

2008-07-04T15:30:33Z

Festor:

Los archivos '''debdiff''' se utilizan normalmente para comparar las modificaciones entre 2 paquetes. Esto es útil para enviar un parche y facilitar la tarea al MOTU ya que puede comprobar de una forma más sencilla los cambios entre el paquete ya existente y el nuevo que se creará después de aplicar el parche.

Pongamos un ejemplo: Nos informan de un paquete deb que actualmente presenta un error en la descripción del programa.

Primero comprobamos que el error exista realmente, en este caso usaremos la herramienta '''apt-cache''' para ver la descripción.

apt-cache show deborphan

(Nota: esto es un ejemplo, por lo que el error no existe lo hemos provocado a propósito)

festor@sniper-win:~$ apt-cache show deborphan
Package: deborphan
Priority: optional
Section: universe/admin
Installed-Size: 420
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
Original-Maintainer: Peter Palfrader <weasel@debian.org>
Architecture: i386
Version: 1.7.23
Depends: libc6, dialog, bash (>= 2.05b-14), gettext-base (>= 0.14.1-6)
Recommends: apt
Filename: pool/universe/d/deborphan/deborphan_1.7.23_i386.deb
Size: 71432
MD5sum: 8d3db29961a02e0b5cb7e22eff830ed5
SHA1: 5cce77d9feac087baa448f0092771bb01a9f3703
SHA256: 92e0d6c9bf28edede6dac91821d98d88ef4b9ed816561c0c56e81a0e2d9ed8f8
Description-es: Encuentra bibliotecas huérfanas
deborphan encuentra paquetes «huérFAnos» en el sistema.
Bugs: mailto:ubuntu-users@lists.ubuntu.com
Origin: Ubuntu

Como podéis ver debería ser «huérfanos» y no «huérFAnos». Así que vamos a arreglar el error. Para ello debemos buscar el archivo .dsc del paquete. La web http://packages.ubuntu.com es un buen sitio para empezar. En este caso en la página http://packages.ubuntu.com/hardy/deborphan veremos en la columna de la izquierda algo parecido a esto:

[[Imagen:Deborphan-debdiff.png]]

Normalmente en despues de ''"Download Source Package nombre_del_paquete_subrayado:"'' hay un tercer archivo llamado .diff.gz pero en este caso se trata de un paquete nativo. Para más información consultar la [[Guía de empaquetamiento/Completa|Guía completa de empaquetamiento]]

dget -x http://archive.ubuntu.com/ubuntu/pool/universe/d/deborphan/deborphan_1.7.23.dsc

Entramos en el directorio recién creado:

cd deborphan-1.7.23

Y luego al directorio debian/:

cd debian

Por último ejecutamos el editor '''nano''' (o cualquier editor de su elección) seguido del nombre del archivo que queremos modificar:

nano control

Arreglamos el error, guardamos el archivo con Ctrl+O y salimos con Ctrl+X

dch -i

Actualizamos el changelog del paquete:

debuild -S

Generamos el nuevo código fuente del paquete, usa los parámetros '''-us -uc''' después del '''-S''' para evitar la firma digital

Finalmente para crear el archivo debdiff ejecutamos el siguiente comando:

debdiff deborphan_1.7.23.dsc deborphan_1.7.23ubuntu1.dsc > deborphan_1.7.23ubuntu1.debdiff

Ahora ya podemos enviárselo al mantenedor del paquete.

Guía de empaquetamiento/ManualDebdiff

2008-07-04T15:28:30Z

Festor: New page: Los archivos '''debdiff''' se utilizan normalmente para comparar las modificaciones entre 2 paquetes. Esto es útil para enviar un parche y facilitar la tarea al MOTU ya que puede comproba...

Los archivos '''debdiff''' se utilizan normalmente para comparar las modificaciones entre 2 paquetes. Esto es útil para enviar un parche y facilitar la tarea al MOTU ya que puede comprobar de una forma más sencilla los cambios entre el paquete ya existente y el nuevo que se creará después de aplicar el parche.

Pongamos un ejemplo: Nos informan de un paquete deb que actualmente presenta un error en la descripción del programa.

Primero comprobamos que el error exista realmente, en este caso usaremos la herramienta '''apt-cache''' para ver la descripción.

apt-cache show deborphan

(Nota: esto es un ejemplo, por lo que el error no existe lo hemos provocado a propósito)

festor@sniper-win:~$ apt-cache show deborphan
Package: deborphan
Priority: optional
Section: universe/admin
Installed-Size: 420
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
Original-Maintainer: Peter Palfrader <weasel@debian.org>
Architecture: i386
Version: 1.7.23
Depends: libc6, dialog, bash (>= 2.05b-14), gettext-base (>= 0.14.1-6)
Recommends: apt
Filename: pool/universe/d/deborphan/deborphan_1.7.23_i386.deb
Size: 71432
MD5sum: 8d3db29961a02e0b5cb7e22eff830ed5
SHA1: 5cce77d9feac087baa448f0092771bb01a9f3703
SHA256: 92e0d6c9bf28edede6dac91821d98d88ef4b9ed816561c0c56e81a0e2d9ed8f8
Description-es: Encuentra bibliotecas huérfanas
deborphan encuentra paquetes «huérFAnos» en el sistema.
Bugs: mailto:ubuntu-users@lists.ubuntu.com
Origin: Ubuntu

Como podéis ver debería ser «huérfanos» y no «huérFAnos». Así que vamos a arreglar el error. Para ello debemos buscar el archivo .dsc del paquete. La web [http://packages.ubuntu.com] es un buen sitio para empezar. En este caso en la página [http://packages.ubuntu.com/hardy/deborphan] veremos en la columna de la izquierda algo parecido a esto:

[[Imagen:Deborphan-debdiff.png]]

Normalmente en despues de ''"Download Source Package nombre_del_paquete_subrayado:"'' hay un tercer archivo llamado .diff.gz pero en este caso se trata de un paquete nativo. Para más informacón consultar la [[Guía de empaquetamiento/Completa Guía completa de empaquetamiento]]

dget -x http://archive.ubuntu.com/ubuntu/pool/universe/d/deborphan/deborphan_1.7.23.dsc

Entramos en el directorio recién creado:

cd deborphan-1.7.23

Y luego al directorio debian/:

cd debian

Por último ejecutamos el editor '''nano''' (o cualquier editor de su elección) seguido del nombre del archivo que queremos modificar:

nano control

Arreglamos el error, guardamos el archivo con Ctrl+O y salimos con Ctrl+X

dch -i

Actualizamos el changelog del paquete:

debuild -S

Generamos el nuevo código fuente del paquete, usa los parámetros -us -uc después del -S para evitar la firma digital

Finalmente para crear el archivo debdiff ejecutamos el siguiente comando:

debdiff deborphan_1.7.23.dsc deborphan_1.7.23ubuntu1.dsc > deborphan_1.7.23ubuntu1.debdiff

Archivo:Deborphan-debdiff.png

2008-07-04T15:15:30Z

Festor:

Guía de empaquetamiento

2008-07-04T14:59:43Z

Festor: /* Guías */

Bienvenido al espacio wiki de la Guía de Empaquetamiento.

== Organización ==

Toda la información relacionada con la creación de paquetes deb ha sido añadida aquí y dividida en partes más pequeñas para un mejor control.

== Guías ==

*[[Guía de empaquetamiento/Completa|'''Guía Completa''']]
*[[Guía de empaquetamiento/ManualDebdiff|'''Crear Debdiffs''']]
*[http://www.youtube.com/watch?v=VyEl3w7SFK4 Aprender crear paquetes deb (el primero de 3 vídeos en inglés)]

----
[[Categoría:MOTU-es]]

Guía de empaquetamiento

2008-07-04T14:51:45Z

Festor: /* Guías */

Bienvenido al espacio wiki de la Guía de Empaquetamiento.

== Organización ==

Toda la información relacionada con la creación de paquetes deb ha sido añadida aquí y dividida en partes más pequeñas para un mejor control.

== Guías ==

*[[Guía de empaquetamiento/Completa|'''Guía Completa''']]
*[http://www.youtube.com/watch?v=VyEl3w7SFK4 Aprender crear paquetes deb (el primero de 3 vídeos en inglés)]

----
[[Categoría:MOTU-es]]

Guía de empaquetamiento

2008-07-04T14:51:16Z

Festor: /* Guías */

Bienvenido al espacio wiki de la Guía de Empaquetamiento.

== Organización ==

Toda la información relacionada con la creación de paquetes deb ha sido añadida aquí y dividida en partes más pequeñas para un mejor control.

== Guías ==

*[[Guía de empaquetamiento/Completa|'''Guía Completa''']]
*[http://www.youtube.com/watch?v=VyEl3w7SFK4 Aprender a ser un MOTU (el primero de 3 vídeos en inglés)]

----
[[Categoría:MOTU-es]]

Guía de empaquetamiento/Completa

2008-06-27T12:12:29Z

Festor: Vuelvo después del fin de semana (si alguien puede darle un poco de formato a la guía estaría bien :D )

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *.deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las variables -us -uc con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos. Para asegurase de que debuild encuentre correctamente la clave GPP debes introducir las variables de entorno DEBFULLNAME y DEBEMAIL, en tu archivo ~/.bashrc, con el nombre y el e-mail respectivamente que uses para la clave GPG y en el archivo debian/changelog.

Algunos usuarios han reportado que les fue imposible que debuild encontrara la clave GPG incluso después de introducir las variables. Si este fuera tu caso puedes probar con el comando:

debuild -k <id_clave_GPG>

Donde <id_clave_GPG> es el identificativo de tu clave GPG.

Para comprobar que el paquete se construya en un entorno limpio también podemos construir el paquete binario con pbuilder:

sudo pbuilder build ../*.dsc

Usando pbuilder podemos saber si las dependencias son correctas ya que pbuilder proporciona un entorno mínimo así que todas las dependencias quedarían determinadas por el archivo control.

Ahora podemos comprobar los errores comunes en el paquete fuente usando lintian:

cd ..
lintian -i *.dsc

==== Requerimientos de paquetes nuevos para Ubuntu ====

...

===== Empaquetado =====

...

===== Otros =====

=== Empaquetando con CDBS ===

...

=== Empaquetando módulos Python con CDBS ===

...

=== Empaquetado avanzado ===

...

==== Creando más de un paquete binario ====

...

=== Empaquetando librerías compartidas ===

...

==== Librerías compartidas ====

...

=== Errores comunes ===

...

==== Archivos de ejemplo dh-make ====

...

==== Abusando de archivos ====

...

==== Cambiando el tarball original ====

...

===== Soluciones =====

...

===== Consejos =====

...

==== Información de Copyright ====

...

==== Paquetes de referencia ====

...

== Sistema de parches ==

== KDE ==

== Archivos complementarios ==

== Recetas ==

== Apéndice ==

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

[[Categoría:MOTU-es]]

Archivo:Motu-es-mugshot.png

2008-06-27T11:01:23Z

Festor:

VirtualBox

2008-06-27T09:54:11Z

Festor:

{{nota|Se ha sugerido descentralizar el contenido de este artículo en varios.}}

{{software
| nombre = VirtualBox
| logo = VBoxLogo.png
| captura = PantallazoVirtualbox.jpg
| pie = VirtualBox virtualizando Windows Xp sobre Ubuntu
| desarrollador = InnoTek
| versión_estable = [http://www.virtualbox.org/wiki/Changelog 1.6.2]
| fecha_versión_estable = 6 de junio de 2008
| género = [[:Categoría:máquinas virtuales|Máquina virtual]]
| licencia = [[w:software no libre|privativa]] [[w:software libre|libre]] ([[w:GNU GPL|GPL]])
| español = Sí
| web = [http://www.virtualbox.org/ www.virtualbox.org]
}}

'''VirtualBox''' es una [[w: máquina virtual| máquina virtual]]. Para entender este concepto es aconsejable leer el artículo que trata sobre [[Virtualizaci%C3%B3n|virtualización]].

A la hora de afrontar la '''virtualización''' de un sistema operativo es importante definir muy claramente lo que es el sistema invitado y lo que es el sistema anfitrión:

:* '''Sistema (Operativo) Anfitrión: '''Es el sistema operativo donde tendremos instalado el programa VirtualBox que nos permitirá ejecutar otro sistema operativo encima y simultáneamente.

:::Ejemplo: Ejecutar Windows sobre '''Ubuntu''' (nuestro sistema operativo es ubuntu y dentro de él ejecutamos un Windows)

:* '''Sistema (Operativo) Invitado: '''Es el sistema operativo que instalamos encima del anterior con la ayuda de VirtualBox.

:::Ejemplo: Ejecutar '''Windows''' sobre Ubuntu (o sea que en este caso el "intruso" es Windows ;))

<div style="clear: right; float: right; display: table;">__TOC__</div>

== Versiones ==

Como paso previo a virtualizar algún sistema operativo bajo Ubuntu, veremos las dos versiones que hay y las diferencias entre ellas.

''VirtualBox OSE (Open Source Edition)''

Como bien indica su nombre es la versión de código abierto, distribuida bajo la licencia GPL. Es la que vamos a encontrar en los repositorios oficiales de Ubuntu junto al módulo que necesitamos precompilado. La carencia más significativa (se citan más abajo las diferencias) respecto a la versión PUEL es el soporte USB.

''VirtualBox PUEL (Personal use and evaluation license)''

Únicamente gratuita para un uso personal y de evaluación. Podemos obtener los binarios precompilados de la [http://www.virtualbox.org página oficial] del proyecto, o bien [[repositorios|agregando los repositorios]] oficiales de VirtualBox para instalarla mediante [[Synaptic]] o equivalentes. Las diferencias, que pueden encontrarse detalladamente [http://www.virtualbox.org/wiki/Editions aquí], son:

* Servidor Remote Display Protocol (RDP)
* Soporte USB
* USB sobre RDP
* Iniciador iSCSI

Para nuestro propósito elegiremos la versión OSE que funciona exactamente igual (hablando de rendimiento) que la versión PUEL. En el caso de elegir la segunda, los pasos a seguir son los mismos.

== Sistemas Operativos que nos permite Virtualizar ==

Virtualbox nos permite en principio crear una máquina virtual para ejecutar los siguientes sistemas operativos:

::* DOS
::* Windows 3.1
::* Windows 95
::* Windows 98
::* Windows NT 4
::* Windows Me
::* Windows 2000
::* Windows XP
::* Windows Server 2003
::* Windows Vista
::* OS/2 Warp 3
::* OS/2 Warp 4
::* OS/2 Warp 4.5
::* Linux 2.2
::* Linux 2.4
::* Linux 2.6
::* FreeBSD
::* OpenBSD
::* NetBSD
::* Netware
::* Solaris
::* L4

A pesar de ello, para estar a la última en cuanto a compatibilidad, funcionalidad, etc. de Virtualbox, tenemos el siguiente [http://www.virtualbox.org/wiki/Guest_OSes enlace] (en inglés, aunque no hay que entender nada más que el código de colores), donde se nos muestra una tabla actualizada de '''sistemas operativos invitados''' en la que figura la efectividad con que se virtualizan con Virtualbox. El rango de colores de las filas es:

:::* Verde: Funcionamiento perfecto y además tiene GuestAdditions.
:::* Ámbar: Funcionamiento parcial pueden haber complicaciones o características no funcionales) y además puede tener GuestAdditions o puede que no.
:::* Amarillo: Funciona, pero no hay GuestAdditions para ese sistema operativo.
:::* Rojo: No funciona

Las filas marcadas con asteriscos contienen información proporcionada por usuarios y que aún no ha sido verificada por Innotek.

No nos debemos dejar llevar a malas interpretaciones:

:Ejemplo: En la tabla aparecen Ubuntu 7.04 Server (servidor) y Ubuntu 7.10 (servidor) de color rojo. Esto no indica que no podamos instalar VirtualBox en ellos, si no que si intentamos instalar un Ubuntu 7.04 Server encima de otros sistema operativo (sistema operativo anfitrión), la virtualización no funcionará, que es algo independiente de si podemos instalar VirtualBox en Ubuntu 7.04 Server para virtualizar otro sistema operativo (como por ejempo un Windows).

{{nota|'''Para usuarios principiantes:''' Este sistema de clasificación por colores puede confundirnos si somos nuevos en esto de Ubuntu y la Virtualización. Se trata meramente de una ayuda para usuarios más avanzados que quieran saber hasta qué punto se virtualiza eficientemente un sistema operativo sobre VirtualBox, pero no hay que obsesionarse con ello. La mayoría de usuarios principiantes virtualiza Windows XP, 2000 y Vista, y sólo hay que saber que la virtualización de estos sistemas operativos (invitados) es 100% eficiente.}}

== Instalación ==

=== VirtualBox OSE ===

Podemos encontrar esta versión dentro de los repositorios la versión 7.10 de Ubuntu llamada Gutsy Gibbon.

Así que simplemente [[instalar aplicaciones|instalamos]] el paquete '''virtualbox-ose''' del repositorio ''?'' de Ubuntu.

Para otras versiones de Ubuntu utilizar la siguiente parte

=== VirtualBox PUEL ===

Podemos instalarlo de dos formas:

* '''Mediante un Paquete precompilado .deb'''
* '''Mediante Synaptic/APT-GET/Aptitude (recomendado)'''

==== Mediante un Paquete Precompilado .deb ====

Primero tenemos que [http://www.virtualbox.org/wiki/Downloads descargar el .deb de VirtualBox] de la web oficial (en este caso, para Ubuntu). Una vez descargado (en este caso descargaremos el archivo en el escritorio), nos tendremos que ir al directorio dónde está el fichero descargado e instalarlo con el comando '''''dpkg''''' en un terminal:
dpkg -i nombredelarchivo.deb

También podemos [[Instalar_aplicaciones_descargadas|instalar el .deb]] con la aplicación gráfica de instalación de paquetes .deb de Ubuntu: '''Gdebi'''.

Puede que tengamos que instalar algunas librerías (dependencias) como: ''libqt3-mt, libxalan110 y libxerces27'', pero en todo caso, si tenemos cualquier otro problema de dependencias el programa detendrá la instalación y nos las comunicará para que las podamos instalar nosotros. Esto añade una dificultad extra a este sistema.

{{nota|'''''Nota para nivel más avanzado:''''' Otra desventaja de este sistema de instalación es que no podremos tener al día nuestra versión de Virtualbox a través del actualizador del sistema de Ubuntu, ya que no hemos modificado los repositorios.}}

==== Mediante APT ====

Este método es el mejor sistema y el más sencillo.

'''Primero,''' añadiremos el repositorio de Virtualbox correspondiente a nuestra versión de Ubuntu a nuestra lista de repositorios. Para saber el repositorio que nos corresponde podemos obtenerlo de [http://www.virtualbox.org/wiki/Downloads esta web de Virtualbox].

Ejemplo: ''deb http://www.virtualbox.org/debian feisty non-free'' (repositorio para Feisty)

Una vez copiada la linea del repositorio que nos corresponda procederemos a añadirla en nuestro sources.list a través de un terminal:

sudo gedit /etc/apt/sources.list

'''Segundo,''' descargaremos la '''clave pública''' para [[apt-secure]] en el siguiente [http://www.virtualbox.org/debian/innotek.asc enlace] para luego añadirla con el comando:

sudo apt-key add innotek.asc

'''Tercero''', actualizaremos la lista de repositorios y nuestra distribución antes de realizar cualquier instalación.

sudo apt-get update --------> actualizamos la lista de repositorios

sudo apt-get dist-upgrade ----> Actualizamos los paquetes de nuestra distribución

'''Cuarto,''' procedemos a instalar VirtualBox con el gestor de paquetes que queramos: Synaptic, apt-get o aptitude, dependiendo de qué sistema nos guste más.

{{nota|'''''Nota para Nivel más Avanzado:''''' La ventaja de seguir este método es que las dependencias las soluciona el propio gestor de paquetes, cosa que no ocurre con el método anterior y que además el actualizador de ubuntu se encarga de avisarmos de nuevas actualizaciones.}}

== Configurar permisos de usuario para usar VirtualBox ==

Antes de arrancar el programa es interesante que realicemos ciertos cambios/comprobaciones para asegurarnos que nuestro usuario tiene privilegios sobre todo lo que precise para que Virtualbox nos trabaje a la perfección. este paso nos ahorrará muchos potenciales dolores de cabeza posteriores.

{| width=100%
|-
|Primeramente debemos agregar a nuestro usuario en el grupo de usuarios '''vboxusers'''. Para ello tenemos que ir a:

:'''''Sistema -> Administración -> Usuarios y Grupos'''''

Veremos la siguiente ventana (fig.1):
|[[Imagen:Vbox001.jpg|thumb|''Fig.1'' Ventana de Usuarios y Grupos]]
|-
|}

{| width=100%
|-
| Seguidamente haremos click en '''Administrar Grupos'''. Nos abrirá otra ventana con la lista de grupos de usuarios. Tenemos que seleccionar el grupo '''''vboxusers''''' (fig.2):
| [[Imagen:Vbox002.jpg|thumb|''Fig.2'' Ventana de Configuración de Grupos de Usuarios]]
|-
|}

{| width=100%
|-
| Y apretamos en el botón Propiedades. Nos aparecerá la ventana de configuración del grupo '''''vboxusers''''' (fig.3).
Debemos seleccionar los usuarios (el nuestro y el de otro usuario del sistema que sepamos que va a usar VirtualBox) que queremos que accedan a VirtualBox. Una vez seleccionados, apretamos en "Aceptar" y listos.
| [[Imagen:Vbox003.jpg|thumb|''Fig.3'' Ventana de Propiedades del Grupo vboxusers]]
|-
|}

== Crear una Máquina Virtual ==

{| width=100%
|-
| Para abrir el programa hemos de ir a: 
:'''''Aplicaciones -> Herramientas del Sistema -> Innotek VirtualBox'''''
 
con lo que nos aparecerá la siguiente ventana ''(fig.4)'':
| [[Imagen:Vbox004.jpg|thumb|''Fig.4'' Ventana Principal de Innotek VirtualBox]]
|-
|}

{| width=100%
|-
| En la imagen anterior se ve una máquina virtual creada, pero en vuestro caso no será así. Para crear una máquina virtual tendremos que pulsar en "Nueva" o teclear ''Ctrl + N'', como puede verse en la imagen anterior.

Nos aparecerá una nueva ventana en la que aparece el siguiente asistente ''(fig.5)'':

| [[Imagen:Vbox005.jpg|thumb|''Fig.5'' Ventana del Asistente para la Creación de una Nueva Máquina Virtual]]
|-
|}

{| width=100%
|-
| Ahora solo tendremos que seguir las instrucciones del asistente pulsando encima del botón ''"Siguiente"''. Nos aparecerá la siguiente ventana, en la que tenemos que poner el nombre de nuestra nueva máquina virtual. Cualquiera vale. En el desplegable hay que seleccionar el sistema operativo correspondiente. En el caso que se muestra es un Windows XP ''(fig.6)''.
| [[Imagen:Vbox006.jpg|thumb|''Fig.6'' Ventana del Asistente para la Creación de una Nueva Máquina Virtual donde poner Nombre de la Máquina Virtual y el tipo de Sistema Operativo que será]]
|-
|}

{| width=100%
|-
| La siguiente ventana nos pide que decidamos la cantidad de memoria RAM que vamos a reservar a la máquina virtual. Inicialmente nos ofrece 192Mbytes. Con 192Mbytes, un Windows XP virtualizado casi vacío (esto es sin antivirus, antispyware, etc.) funciona perfectamente. Vosotros mismos tenéis que decidir cuánta Ram podéis sacrificar y cuánta vais a necesitar. De todos modos podéis cambiar estos valores más adelante. Más abajo se muestra cómo ''(fig.7)''.
|
| [[Imagen:Vbox007.jpg|thumb|''Fig.7'' Ventana del Asistente para la Administración de Memoria Base de la Máquina Virtual]]
|-
|}

{| width=100%
|-
| Tras seleccionar la memoria dedicada a nuestra nueva máquina virtual, pulsamos en ''"Siguiente"'' y nos aparecerá una pantalla que nos pide que asignemos un disco virtual para nuestra máquina. Podemos elegir entre crear un disco o usar uno creado por nosotros previamente. En nuestro caso crearemos un nuevo disco ''(fig.8'').
| [[Imagen:Vbox008.jpg|thumb|''Fig.8'' Ventana del Asistente para Asignación de un Disco Duro Virtual]]
|-
|}

{| width=100%
|-
| Si decidimos crear un disco virtual nuevo nos aparece el asistente de creación de Discos Virtuales ''(fig.9)''.
| [[Imagen:Vbox009.jpg|thumb|''Fig.9'' Ventana del Asistente para Creación de un Disco Duro Virtual]]
|-
|}

{| width=100%
|-
| Si pulsamos en ''"siguiente"'' nos aparece una ventana que nos hace decidir entre dos opciones ''(fig.10)'':
* Crear una imagen de ''disco de expansión dinámica'' (disco virtual que expande su espacio dinámicamente a medida que se va llenando)
* Crear una imagen de tamaño fijo
| [[Imagen:Vbox010.jpg|thumb|''Fig.10'' Ventana del Asistente para determinar el Tipo de Imagen de Disco Virtual]]
|-
|}

{{nota| Muchos usuarios optan por la primera opción, ya que permite instalar programas sin límite de espacio. El problema de esto es que si no se va con cuidado uno puede llenar todo su disco físico, con los consiguientes problemas. Para evitarlo es interesante mantener control del espacio que ocupa nuestra máquina virtual de vez en cuando y usar como directorio de almacenaje el directorio compartido con el sistema anfitrión: Ubuntu. Más abajo se trata este tema. En este artículo se empleará la opción de Imagen de Expansión Dinámica.}}

{| width=100%
|-
| Seleccionaremos la opción de Imagen de Expansión Dinámica y pulsaremos en ''"Siguiente"'', por lo que nos aparecerá una ventana para ponerle nombre a la imagen del disco virtual, para ubicarla en nuestro PC y para asignarle el tamaño que ésta le comunicará que tiene al sistema. Este valor es puramente teórico, ya que a la práctica varía en función del uso que le demos a nuestra máquina virtual ''(fig.11)''.
| [[Imagen:Vbox011.jpg|thumb|''Fig.11'' Ventana del Asistente para determinar el Tamaño y Ubicación del Disco Virtual]]
|-
|}

{| width=100%
|-
| De todos modos, el asistente lo va explicando todo. Es muy intuitivo. Una vez decididos los parámetros, pulsaremos en ''"Siguiente"'' y se nos muestra un resumen de las características de nuestro nuevo disco virtual ''(fig.12)''.
| [[Imagen:Vbox012.jpg|thumb|''Fig.12'' Ventana de Resumen de Datos del Disco Virtual de nuestra Máquina Virtual]]
|-
|}

{| width=100%
|-
| Si pulsamos "Terminar" pasamos a la ventana final del asistente de creación de la nueva máquina virtual de VirtualBox ''(fig.13)''.
| [[Imagen:Vbox013.jpg|thumb|''Fig.13'' Ventana de Resumen de Datos de nuestra Máquina Virtual]]
|-
|}

{| width=100%
|-
| Una vez pulsamos en "Terminar" nos aparece la ventana de VirtualBox con la nueva maquina virtual creada ''(fig.14)''.

Ahora sólo queda configurarla como queramos.
| [[Imagen:Vbox014.jpg|thumb|''Fig.14'' Ventana Principal de Innotek VirtualBox con la nueva Máquina Virtual que hemos creado]]
|-
|}

== Configurar Máquina Virtual ==

Antes de instalar nuestro nuevo sistema operativo a virtualizar debemos "afinar" nuestra nueva máquina virtual.

{| width=100%
|-
|Para ello debemos seleccionar la nueva máquina virtual que acabamos de crear y pulsaremos en ''"Configuración"'' (fig.15), de forma que nos aparecerá una ventana con las distintas posibilidades de configuración de nuestra máquina virtual.
|[[Imagen:Vbox015.jpg|thumb|''Fig.15'' Imagen mostrando el botón para acceder a la ventana de Configuración de nuestra Máquina Virtual]]
|-
|}

=== Configuración General ===

{| width=100%
|-
|En la sección "General" (fig.16) podemos determinar aspectos como la memoria de la tarjeta gráfica que queremos dedicar (como ya se mencionó antes), el orden de booteo/arranque de la máquina (igual que las BIOS de nuestros PCs), etc. Es recomendable no alterar nada a no ser que sea estrictamente necesario (juegos, necesidad de más recursos, etc.). La configuración base ya tiene los parámetros más adecuados. En cualquier caso, siempre podremos volver aquí en cualquier momento para alterar estos parámetros aunque ya tengamos instalado nuestro sistema operativo invitado.

A pesar de lo dicho, podemos jugar un poco con estas opciones para aprender más sobre ellas, ya que todas las opciones son muy intuitivas.

La secuencia de Booteo ya está por defecto en disquete - CD-Rom - HDD - Red, que es la más adecuada, pero podemos alterarla si lo precisamos.
|[[Imagen:Vbox016.jpg|thumb|''Fig.16'' Sección "General" de la ventana de Configuración de nuestra Máquina Virtual]]
|-
|}

=== Configuración de la Unidad de CD/DVD-Rom ===

{| width=100%
|-
|En esta sección tendremos que seleccionar el dispositivo de CD/DVD que vayamos a usar. La unidad de la imagen de ejemplo (fig.17) es una unidad de DVD ubicada en /dev/cdrom (ya que Virtualbox está corriendo sobre Ubuntu),pero en otros PCs puede ser /dev/cdrom o /dev/cdrom0 u otra ubicación si corremos Virtualbox sobre otros sistema operativo.

Una vez hecho esto ya tendremos el CD/DVD-Rom habilitado para que cuando arranquemos nuestra máquina virtual podamos arrancar desde CD/DVD e instalar nuestro sistema operativo invitado (ejemplo: Windows virtualizado sobre Ubuntu).
|[[Imagen:Vbox017.jpg|thumb|''Fig.17'' Sección "CD/DVD-Rom" de la ventana de Configuración de nuestra Máquina Virtual]]
|-
|}

{{nota | Podemos hacer lo mismo con la unidad de 3'5 (disquetera) si vamos a usar un disquete de arranque (para virtualizar un Windows 98 por ejemplo).}}

=== Configuración de Audio ===

{| width=100%
|-
|Para que nos funcione el sonido tendremos habilitarlo haciendo un "click" sobre el "checkbox" correspondiente en '''Controlador de Audio Anfitrión''' y seleccionar:

* '''Controlador Audio ALSA''' si nos hallamos ejecutando Virtualbox sobre Ubuntu 7.10 o inferiores, que emplean [[ALSA]] como servidor de sonido(fig.18).

* '''Pulseadio''' si nos hallamos ejecutando Virtualbox sobre Ubuntu 8.04 o superiores (y también si empleamos 7.10 con [[Pulseaudio]] en lugar de [[ALSA]]).
|[[Imagen:Vbox018.jpg|thumb|''Fig.18'' Sección "Audio" de la ventana de Configuración de nuestra Máquina Virtual mostrando la configuración correcta para un sistema anfitrión Ubuntu]]
|-
|}

{{nota|Si al iniciar nuestro sistema invitado nos aparece el siguiente mensaje:

Some audio devices (PCM_in, PCM_mic) could not be opened. Guest applications generating audio output or depending on
audio input may hang. Make sure your host audio device is working properly. Check the logfile for error messages of the audio subsystem..

ID Error: HostAudioNotResponding
Gravedad: Aviso

significa que no hemos seleccionado el controlador de sonido adecuado. Seguramente hayamos seleccionado ALSA en lugar de Pulseaudio.}}

=== Configuración de la Conexión a Red ===

{| width=100%
|-
|Si queremos acceder a internet o a cualquier otra red desde nuestro sistema invitado tendremos que habilitar nuestro adaptador de red (tarjeta de red) habilitado. Nótese que podemos trabajar con más de un adaptador de red en función de las tarjetas que temgamos instaladas en nuestro ordenador. Como lo más normal es tener una sola tarjeta, trabajaremos con la pestaña del ''"Adaptador 0"'' (fig.19).

La configuración que deberemos poner será ''"Conectar a NAT"'', de modo que la configuración de red dependa del S.O. anfitrión: Ubuntu Linux. Esto no sólo será más cómodo para nosotros, si no que nos evita problemas de conexión, ya que entonces será 100% dependiente de la configuración de red del sistema anfitrión, por lo que solucionar problemas de conexión se simplifica enormemente y además se reducen eslabones donde puedan ocurrir fallos. Consecuentemente, si nos falla la conexión de red ya sabremos que nunca será por la configuración de red de nuestro sistema invitado.

La dirección MAC es generada automáticamente para que difiera de la real en la máquina virtual y el sistema anfitrión. Esta MAC no es necesario modificarla a menos que nos surjan problemas de MACs repetidas en una intranet.
|[[Imagen:Vbox019.jpg|thumb|''Fig.19'' Sección "Red" de la ventana de Configuración de nuestra Máquina Virtual mostrando la configuración correcta de los parámetros para el Adaptador de Red 0]]
|-
|}

{{nota | Tener la red habilitada puede dar problemas a veces en la instalación de Windows, haciendo que ésta se bloquee. Por eso, para evitarlo es aconsejable dejar la red deshabilitada inicialmente hasta haber instalado Windows. De este modo seguro que no habrá problemas.}}

=== Configuración de los Dispositivos USB ===

Como hemos visto más arriba, según la versión de Virtualbox, tendremos soporte para USB o no.

* Virtualbox OSE: No tiene soporte para USB, pero puede conseguirse.

* Virtualbox PUEL: Con soporte para USB

==== Configuración de los Dispositivos USB en Virtualbox OSE ====

Como se ha mencionado antes, la versión de Virtualbox OSE no tiene soporte para USB. Para conseguirlo habrá que hacer una serie de maniobras. Primero tendremos que abrir un terminal y escribir:

sudo gedit /etc/init.d/mountdevsubfs.sh

Esto nos abrirá un archivo que deberemos editar. Tendremos que buscar el siguiente texto (buscaremos ''"Magic to make /proc/bus/usb work"'':

#
# Magic to make /proc/bus/usb work
#
#mkdir -p /dev/bus/usb/.usbfs
#domount usbfs "" /dev/bus/usb/.usbfs -obusmode=0700,devmode=0600,listmode=0644
#ln -s .usbfs/devices /dev/bus/usb/devices
#mount --rbind /dev/bus/usb /proc/bus/usb

descomentando (eso es eliminando el símbolo de la almohadilla "#") determinadas líneas para que quede de la siguiente forma:

#
# Magic to make /proc/bus/usb work
#
mkdir -p /dev/bus/usb/.usbfs
domount usbfs "" /dev/bus/usb/.usbfs -obusmode=0700,devmode=0600,listmode=0644
ln -s .usbfs/devices /dev/bus/usb/devices
mount --rbind /dev/bus/usb /proc/bus/usb

Una vez hecho esto tendremos que reiniciar nuestro sistema anfitrión para que los cambios tengan efecto. Si al iniciar la máquina virtual nos aparece el siguiente error:

Not permitted to open the USB device, check usbfs options

habrá que editar el siguiente archivo:

sudo gedit /etc/udev/rules.d/40-permissions.rules

Y modificar:

SUBSYSTEM=="usb_device", MODE="0664"

por esto:

SUBSYSTEM=="usb_device", MODE="0666"

==== Configuración de los Dispositivos USB en Virtualbox PUEL ====

Para poder usar dispositivos USB en un sistema virtualizado que se esté ejecutando sobre un sistema anfitrión GNU/Linux como Ubuntu, debemos seguir dos pasos:

# Hacer que VirtualBox sea capaz de leer la carpeta de dispositivos USB
# Añadir los dispositivos correspondientes en la ventana de configuración de dispositivos USB de nuestra máquina virtual

{{nota | En un sistema Windows no es preciso hacer que VirtualBox sea capaz de leer la carpeta de dispositivos USB, ya que ya estamos trabajando con permisos de administrador y por tanto Virtualbox ya puede ver los dispositivos USB sin necesidad de tocar nada. Por ello, pasaríamos directamente a pasar al siguiente.}}

===== Hacer que VirtualBox sea capaz de leer la Carpeta de Dispositivos USB =====

Para ello lo primero será cerrar VirtualBox para poder hacer los ajustes debidamente a través de terminal. Una vez hecho esto, abriremos y escribiremos:

gksudo gedit /etc/udev/rules.d/40-permissions.rules

Con lo que se nos abrirá un archivo de texto donde tendremos que cambiar la línea:

SUBSYSTEM==”usb_device”, MODE=”0664"

por:

SUBSYSTEM==”usb_device”, MODE=”0666"

Una vez realizado este cambio, guardamos, cerramos el archivo y reiniciamos el ordenador para que cargue las nuevas reglas de permisos de nuestro sistema que permitirá a Virtualbox leer la carpeta de dispositivos USB.

===== Añadir Dispositivos USB a nuestra Máquina Virtual =====

{| width=100%
|-
|Lo primero a hacer es acceder a la sección USB de la ventana de configuración de nuestra máquina virtual. Llegados a esta sección tendremos que ''"Habilitar el controlador USB"'' haciendo click sobre el checkbox correspondiente (fig.20).
|[[Imagen:Vbox020.jpg|thumb|''Fig.20'' Sección "USB" de la ventana de Configuración de nuestra Máquina Virtual mostrando el checkbox para activar el controlador USB de nuestra máquina virtual]]
|-
|}

{| width=100%
|-
|Una vez hecho esto, ya podremos agregar los dispositivos USB que queramos (impresoras, pendrives, etc.). Todo lo que no agreguemos aquí, nuestro sistema invitado no lo verá. Para agregar nuevos dispositivos sólo hay que pulsar en el botón de ''“agregar desde”'' o presionar las teclas Alt+Insert (fig.21).

Nos saldrá una lista de dispositivos y sólo tendremos que “clicar” encima de los que queramos agregar.
|[[Imagen:Vbox021.jpg|thumb|''Fig.21'' Sección "USB" de la ventana de Configuración de nuestra Máquina Virtual mostrando el botón "Agregar desde" para añadir dispositivos USB a nuestra máquina virtual]]
|-
|}

{{nota | Cuando tenemos agregado un dispositivo USB en nuestra máquina virtual, mientras ésta está encendida, tiene a veces dicho dispositivo secuestrado. Es por ello que algunos dispositivos como los ratones usb no hay que agregarlos, ya que si no, son secuestrados (a veces) por el sistema operativo invitado y ya no puedes usarlos en el sistema operativo anfitrión aunque se intente liberar el control del ratón mediante el sistema estándar. De todos modos, el ratón, independientemente de si es USB o PS/2 ya es capturado como ratón a través del propio VirtualBox sin que pase esto. Lo aconsejable por tanto es agregar solamente dispositivos como pendrives, impresoras, escáneres, etc.}}

== Instalación de un sistema operativo invitado ==

En el apartado en el que se trataba el tema de crear una máquina virtual se mostraba cómo crear una máquina Windows XP, aunque en Virtualbox podemos crear una máquina para muchos otros sistemas operativos. En este caso lo realizaremos con Windows XP. Para ello tenemos que poner el Cd-Rom de Windows en la unidad CD/DVD de nuestro ordenador y seleccionar la máquina virtual que hemos creado antes.

A continuación tenemos que pulsar el botón ''"Iniciar”'' o hacer doble click sobre la máquina en cuestión. La máquina creada arrancará primero desde disquete (si lo habéis habilitado antes), si no encuentra disquete buscará en el lector de Cds/Dvds y se iniciará la instalación de windows como si en una sesión de ordenador normal se tratara. El resto del proceso sería una instalación estándar de Windows.

Es interesante saber que si se hace “click” con el ratón dentro de la ventana del sistema operativo invitado (Windows) el teclado y el ratón son capturados por ella y por tanto funcionarán sólo dentro de ella. Para devolver el control a nuestro sistema anfitrión (Ubuntu) tenemos que pulsar una vez la tecla ''CTRL derecha'' de nuestro teclado. Esta tecla es referida por Virtualbox como '''''Host''''' y será utilizada en combinación con otras para algunos atajos de teclado que nos pueden ser útiles. (ver sección de ''Combinaciones de Teclas'' más adelante).

{{nota | Nótese que como se ha mencionado anteriormente, podemos instalar más de un tipo de sistema operativo en Virtualbox. Para ello sólo hay que seguir el proceso de instalación estándar desde CD del propio sistema operativo. También podemos realizar una instalación desde red, ya que la configuración de red depende de la máquina virtual y del sistema anfitrión, por lo que ya tenemos acceso a red desde antes de instalar un sistema operativo.}}

== Añadir VboxGuestAdditions ==

Los '''Guest Additions''' son complementos que al instalarse en nuestra recientemente creada máquina virtual le confieren a ésta un incremento en el rendimiento del sistema invitado, además de una mayor interoperatividad entre el sistema anfitrión (en nuestro caso Ubuntu Linux) y el sistema invitado (por el ejemplo anterior, Windows XP). Un ejemplo de ello es si queremos tener algún directorio compartido entre nuestra máquina virtual y el sistema anfitrión. Tener los VboxGuestAdditions instalados es requisito indispensable.

Para instalar los VboxGuestAdditions podemos emplear dos sistemas:

::* Mediante Barra de Menús de la Máquina Virtual (recomendado)
::* Mediante CD/DVD de Arranque (proceso lento)

=== Mediante Barra de Menús de la Máquina Virtual ===

Este proceso seguramente sea el más rápido y sencillo, y nos sirve para cualquier sistema operativo invitado (osea que es independiente de la plataforma a virtualizar). Antes de probar el sistema a través de CD/DVD de arranque es aconsejable darle una oportunidad a este método, y si encontramos algún problema, optar por el método a través de CD/DVD de arranque.

El proceso es el siguiente:

{| width=100%
|-
|
:* Una vez encendido el sistema operativo invitado (en nuestro caso, Windows) iremos a la barra de menús de la ventana de nuestra máquina virtual VirtualBox y pulsaremos sobre “Dispositivos” (fig.22).
|[[Imagen:Vbox022.jpg|thumb|''Fig.22'' Vista de Windows en Máquina Virtual de Virtualbox en la que se ven los menús y entre ellos el de "dispositivos"]]
|-
|}

{| width=100%
|-
|
:* Seleccionaremos la opción “Instalar GuestAdditions (Aplicaciones del anfitrión)...” y nos aparecerá un asistente de instalación al estilo Windows (“siguiente – siguiente – siguiente”). Si seguímos las instrucciones del asistente se nos instalarán los VboxGuestAdditions. Finalmente sólo nos quedará reiniciar la máquina virtual.
|[[Imagen:Vbox023.jpg|thumb|''Fig.23'' Vista del Asistente de Instalación de GuestAdditions de Virtualbox]]
|-
|}

=== Mediante CD/DVD de Arranque (proceso lento) ===

Este proceso es más recomendable en caso improbable de que falle el método anterior.

{| width=100%
|-
|Primero tenemos que abrir el programa VirtualBox, y seleccionamos ''“Configuración”'' para ir a la sección '''CD/DVD-ROM'''. En esta sección tenemos que asegurarnos que tenemos montada la unidad de CD/DVD, pero seleccionaremos ''“Archivo de Imagen ISO”''.

Seguidamente emplearemos el botón de ''examinar'' que se puede ver a la derecha del campo texto (fig.24) para buscar el archivo de imagen '''''VboxGuestAdditions.iso'''''. Este archivo puede hallarse en dos posibles localizaciones en función del método de instalación que hayamos elegido en el apartado de instalación.

::* '''Método de Descarga de .deb:''' La imagen .iso estará en:

::::''/opt/VirtualBox-x.x.x/additions/VBoxGuestAdditions.iso'' (donde las “x” serían los números que indican nuestra versión de VirtualBox)

::* '''Mediante APT:''' La imagen .iso estará en:

::::''/usr/share/virtualbox/VBoxGuestAdditions.iso'' (como se dijo más arriba, es más sencillo hacerlo todo si elegíamos el método a través de un gestor de paquetes tipo APT-GET/Aptitude/Synaptic)

|[[Imagen:Vbox024.jpg|thumb|''Fig.24'' Vista de la Ventana de Configuración CD/DVD de nuestra máquina virtual de Virtualbox (en este caso la dirección de las GuestAdditions es la correspondiente al método de instalación con gestor de paquetes apt-get/aptitude/Synaptic)]]
|-
|}

==== Si el Sistema Invitado es Windows ====

Tendremos iniciar nuestra máquina virtual y que cargue nuestro Windows virtualizado. Seguidamente entraremos en ''“Mi PC”'' e iremos a nuestra unidad de CD-Rom/Dvd-rom para hacer clic sobre el .exe que nos muestre. Nos aparecerá un asistente de instalación sencilla de Windows (siguiente-siguiente-siguiente).

==== Si el Sistema Invitado es GNU/Linux ====

Tendremos que bajarnos antes el compilador gcc , el make y los headers correspondintes a nuestro kernel. Para ello tendremos que abrir un terminal en el sistema invitado y escibir lo siguiente:

$ sudo aptitude install gcc-4.0 # elegir el gcc con el que este compilado vuestro kernel
$ sudo aptitude install make
$ sudo aptitude install linux-headers-`uname -r`

Seguidamente, debemos decirle al sistema qué compilador de gcc usar:

$ sudo ln -s /usr/bin/gcc-4.0 /usr/bin/gcc

Una vez hecho esto, debemos mirar si el CD-rom está montado en el sistema (por su está en "auto" en fstab):

$ mount /dev/cdrom directorio _donde _queremos _que _se _monte (tenemos que tener este directorio creado anteriormente)

Nos situaremos dentro del directorio donde esta montado el cdrom y escribiremos:

$ sudo ./VBoxlinuxAdditions.run

'''Si no nos deja ejecutar el archivo por problemas de permisos,''' tendremos que copiar el archivo a cualquier carpeta de nusetro sistema (una buena opción es en nuestro escritorio) y darle permisos de ejecucion:

$ cp VBoxlinuxAdditions.run /home/nombre_de_usuario/Desktop
$ cd /home/nombre_de_usuario/Desktop
$ sudo chmod -R 777 VBoxlinuxAdditions.run (con esta orden asignamos permisos de lectura, modificación y ejecución a cualquiera)

Y ahora sí podremos hacer:

$ sudo ./VBoxlinuxAdditions.run

Nota: Siempre que usemos el sistema de CD/DVD de Arranque para instalar GuestAdditions tendremos que regresar a la configuración de nuestra máquina virtual para dejar el CD/DVD montado como estaba originalmente o si no no podremos leer CD/DVD desde nuestro sistema operativo invitado.

{| style="border: 1px solid #B1883E; background-color: #EBDAB5; margin: 0 auto 0 auto; width: 90%; padding: 5px 0 0 10px; -moz-border-radius: 8px;"
|-
|[[Imagen:Clip.png]]
|'''Importante:'''
* Para instalar VBoxGuestAdditions es mejor tener ya nuestro sistema operativo invitado instalado (Windows, etc.)
* Una vez realizada la instalación de las GuestAdditions tenemos que reiniciar el sistema operativo virtualizado para hacer efectivos los cambios.
* Una vez realizada la instalación de las GuestAdditions tendremos que dejar el CD/DVD montado como estaba originalmente o si no no podremos leer CD/DVD desde nuestro sistema operativo invitado (fig.25).
|[[Imagen:Vbox017.jpg|thumb|''Fig.25'' Configuración CD/DVD que debemos dejar una vez realizada la instalación de GuestAdditions]]
|-
|}

== Combinaciones de teclas ==

Las combinaciones de teclas más interesantes para usar en Virtualbox son:

* '''CTRL(derecho) :''' Para liberar el ratón y el teclado del sistema invitado y dar el control al sistema anfitrión.

* '''CTRL(derecho) + F :''' Para entrar o salir del modo pantalla completa.

* '''CTRL(derecho) + L :''' Para entrar o salir del seamless mode, un modo en el que se ve el sistema invitado maximizado, pero que no se ve el escritorio (a no ser que lo pidas explícitamente), si no sólo las ventanas de las aplicaciones y la barra de Windows/Linux. Este modo es un poco confuso. a mí no me agrada.

* '''CTRL(derecho) + A :''' Ajustar tamaño de ventana.

* '''CTRL(derecho) + G :''' Autoajustar la Ventana del anfitrión.

* '''CTRL(derecho) + SUPR. :''' Envía un CONTROL + ALT + SUPR. al sistema invitado (interesante si es Windows)

* '''CTRL(derecho) + BACKSPACE :''' Envía un CONTROL + ALT + BACKSPACE al sistema invitado (interesante si es GNU/Linux)

* '''CTRL(derecho) + S :''' Tomar una instantánea de la máquina virtual, como si apretáramos “Impr Pant”.

* '''CTRL(derecho) + I :''' Inhabilitar la Integración del ratón con la máquina virtual.

* '''CTRL(derecho) + R :''' Para reiniciar la máquina virtual. Es el famoso “reset” windowsero. seguro que más de uno lo usa alguna vez. algooooo

* '''CTRL(derecho) + P :''' Para pausar la máquina virtual. Una ventaja si te está comiendo recursos en un momento en que necesitas todos los recursos de tu ordenador para el sistema anfitrión.

* '''CTRL(derecho) + H :''' Apagado ACPI de la máquina virtual.

* '''CTRL(derecho) + Q :''' Cerrar la máquina virtual.

De todos modos, tenéis los mismos accesos de forma gráfica en la barra de menús de la máquina virtual. En el extremo inferior derecho de la ventana de la máquina virtual tenéis iconos para controlar aspectos de vuestra máquina virtual y el botón que libera el ratón y el teclado del sistema invitado y da el control al sistema anfitrión (igual que Ctrl Derecho). (fig.26)

[[Imagen:Vbox026.jpg|center|''Fig.26'' Detalle de la esquina inferior derecha de la Máquina Virtual]]

Podemos observar en la ventana de la máquina virtual que en el menú ''“Máquina”'' podemos pedirle a Virtualbox que nos abra el sistema operativo de la ventana a pantalla completa o '''''seamless mode'''''. Esta opción no es muy recomendable, porque aunque funciona bien, es mejor seleccionar la opción de pantalla completa y así poder tener control del sistema anfitrión (en nuestro caso Ubuntu) y del sistema invitado (Windows o el que sea). Además, este modo es más difícilmente reversible si no se sabe el comando de teclado (CTRL + L), ya que elimina botones de menú u otros accesos (si no se sabe esto la primera vez que se activa, no sabremos qué hacer para revertirlo). Este menú incluye otras opciones de visualización y control de la máquina virtual. Podemos jugar con estas opciones, ya que son más fácilmente reversibles que "seamless mode".

== Añadir un directorio compartido con sistema anfitrión ==

Para poder compartir una carpeta entre el sistema anfitrión (en nuestro caso seguramente Ubuntu) y el sistema invitado (Windows, FreeBSD, etc.) '''es indispensable''' tener instalados los ''VboxGuestAdditions''.

Para ello deberemos crear primero la carpeta compartida en nuestro sistema anfitrión (Ubuntu seguramente) y luego llamarla desde nuestro sistema invitado (Windows, FreeBSD,...).

=== Crear carpeta compartida en nuestro sistema anfitrión ===

{| width="100%"
|-
| Para crear una carpeta compartida en nuestro sistema anfitrión lo mejor y más fácil es hacerlo desde el propio VirtualBox. Para ello tendremos que seleccionar la máquina virtual que hayamos creado e ir a ''“Configuración”''.

En la Sección ''“Directorios Compartidos”'' nos aparecerá un cuadro con los directorios compartidos entre esa máquina virtual y el sistema anfitrión (fig.26).

| [[Imagen:Vbox027.jpg|thumb|''Fig.27'' Vista de la sección "Directorios Compartidos" en la Configuración de nuestra máquina virtual]]
|-
|}

{| width="100%"
|-
| Tenemos que apretar la tecla ''“Insert” (Ins)'' de nuestro teclado o hacer click en el botón de agregar nuevo directorio compartido (en la figura 28, botón de arriba a la derecha que se ha resalatado en rojo).

| [[Imagen:Vbox028.jpg|thumb|''Fig.28'' Vista de la sección "Directorios Compartidos" en la Configuración de nuestra máquina virtual en la que aparece resaltado en rojo el boton de "agregar nuevo directorio compartido"]]
|-
|}

{| width="100%"
|-
| Nos aparecerá un navegador de archivos (fig.29) que nos pide que localicemos la carpeta (la podemos crear desde aquí) y que le pongamos un nombre, que será un nombre interno para saber cómo la llamaremos desde el sistema invitado. Es aconsejable no dejar espacios en dicho nombre. Si queremos separar dos palabras, podemos hacerlo por medio de un guión bajo “_”. Un ejemplo de ello será el nombre de "Carpeta_Compartida" que se seguirá empleando en este artículo para trabajar con la carpeta compartida entre sistema invitado y sistema anfitrión.
| [[Imagen:Vbox029.jpg|thumb|''Fig.29'' Vista de la sección "Directorios Compartidos" en la Configuración de nuestra máquina virtual en la que aparece el navegador de archivos para localizar/crear nuestra carpeta compartida]]
|-
|}

Una vez hayamos hecho Click en “Ok” ya estará la carpeta activa. Ahora sólo nos quedará llamarla desde el sistema invitado.

=== Llamar a nuestra carpeta compartida desde nuestro sistema invitado ===

Hablaremos del método a seguir en el caso de que estemos virtualizando un sistema Windows o un sistema GNU/Linux.

Primero tendremos que iniciar el sistema invitado y según sea un Windows o un GNU/Linux haremos una cosa u otra:

* '''Para un sistema invitado Windows:''' Podemos hacerlo desde consola, pero lo más sencillo es agregar el directorio haciendo click con el botón derecho del ratón sobre “Mi PC” y seleccionar la opción "Conectar a unidad de red". Le asignamos una letra (la que queramos) a la nueva unidad y en el campo de Carpeta escribiremos:

\\vboxsvr\Carpeta_Compartida

* '''Para un sistema invitado GNU/Linux:''' Montaremos la carpeta compartida que llamamos "Carpeta_Compartida" en nuestro sistema en el punto de montaje que queramos. Para ello abriremos un terminal y pondremos:

mount -t vboxsf Carpeta_Compartida puntodemontaje

== Posibles problemas ==

Al actualizar el kernel de GNU/Linux puede ocurrir que al intentar ejecutar VirtualBox nos aparezca este mensaje:

VirtualBox kernel driver not installed. The vboxdrv kernel module was either not loaded or /dev/vboxdrv was not created for some reason.
Re-setup the kernel module by executing '/etc/init.d/vboxdrv setup' as root.
VBox status code: -1908 (VERR_VM_DRIVER_NOT_INSTALLED).

o bién,

chmod: no se puede acceder a `/dev/vboxdrv': No existe el fichero ó directorio

Este segundo mensaje también puede aparecer por otras causas como puede ser que no esté creada la carpeta, que no hayamos configurado el grupo de usuarios como se indica más arriba o que no se ha cambiado el parámetro de los permisos de los dispositivos USB, así que conviene asegurarse de que se han realizado los pasos como se indica en este artículo. Si estamos seguros que hemos seguido los pasos correctamente, entonces este segundo mensaje reponde a lo mismo que el primero: un problema debido a que VirtualBox no estará configurado para el nuevo kernel. En este caso, no es necesario volver a instalar VirtualBox, si no simplemente seguir estos sencillos pasos:

:'''1.)''' Instalar los ''kernel headers'' correspondientes al nuevo kernel. Usaremos el modificador ''uname -r'' para no tener que estar mirando la versión de nuestro nuevo kernel... que lo haga la propia máquina.

sudo aptitude install linux-headers-$(uname -r)

: '''2.)''' Seguidamente, ejecutaremos el siguiente comando para que se corrija el error:

sudo /etc/init.d/vboxdrv setup

Una vez hecho esto, VirtualBox ya estará configurado para el nuevo Kernel funcionará sin problemas.

== Fuentes ==

* [http://www.ubuntu-es.org/index.php?q=node/62374 Cómo instalar/hacer funcionar Virtualbox] en [http://www.ubuntu-es.org/ Ubuntu-es].

* [http://www.virtualbox.org/wiki/End-user_documentation Documentación de Usuario Final en la Wiki de VirtualBox] (en inglés)

* [http://www.virtualbox.org/wiki/User_HOWTOS How-Tos para Usuarios en la Wiki de Virtualbox] (en inglés)

* [http://www.virtualbox.org/wiki/User_FAQ Preguntas Frecuentes en la Wiki de Virtualbox] (en inglés)

* [http://www.blog.arun-prabha.com/2007/05/07/installing-virtualbox-and-windows-using-virtualbox-in-ubuntu/ Installing Virtualbox and Windows using Virtualbox in Ubuntu] (en inglés)

* [http://www.virtualbox.org/download/UserManual.pdf Manual de Usuario de Virtualbox] (en inglés)

== Enlaces externos ==

* [http://www.virtualbox.org/ Sitio web oficial de VirtualBox] {{en}}.
* [http://www.ubuntu-es.org/index.php?q=node/62374 Ubuntu-es - Cómo instalar/hacer funcionar VirtualBox].
{{Wikipedia}}
* [http://blarts.wordpress.com/2007/12/06/how-to-run-virtualbox-using-a-physical-partition-using-ubuntu-feisty-fawn/ Guía para usar una partición existente virtualizada en Ubuntu] (en inglés)
* [http://www.virtualbox.org/wiki/Migrate_Windows How to migrate existing Windows installations to VirtualBox] (en inglés)
[[Categoría:Máquinas virtuales]]
[[Categoría:Virtualización|Virtualización]]

Guía de empaquetamiento/Completa

2008-06-27T08:49:37Z

Festor:

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *.deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las variables -us -uc con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos. Para asegurase de que debuild encuentre correctamente la clave GPP debes introducir las variables de entorno DEBFULLNAME y DEBEMAIL, en tu archivo ~/.bashrc, con el nombre y el e-mail respectivamente que uses para la clave GPG y en el archivo debian/changelog.

Algunos usuarios han reportado que les fue imposible que debuild encontrara la clave GPG incluso después de introducir las variables. Si este fuera tu caso puedes probar con el comando:

debuild -k <id_clave_GPG>

Donde <id_clave_GPG> es el identificativo de tu clave GPG.

Para comprobar que el paquete se construya en un entorno limpio también podemos construir el paquete binario con pbuilder:

sudo pbuilder build ../*.dsc

Usando pbuilder podemos saber si las dependencias son correctas ya que pbuilder proporciona un entorno mínimo así que todas las dependencias quedarían determinadas por el archivo control.

Ahora podemos comprobar los errores comunes en el paquete fuente usando lintian:

cd ..
lintian -i *.dsc

==== Requerimientos de paquetes nuevos para Ubuntu ====

...

=== Empaquetando con CDBS ===

...

=== Empaquetando módulos Python con CDBS ===

...

=== Empaquetado avanzado ===

...

==== Creando más de un paquete binario ====

...

=== Empaquetando librerías compartidas ===

...

==== Librerías compartidas ====

...

=== Errores comunes ===

...

==== Archivos de ejemplo dh-make ====

...

==== Abusando de archivos ====

...

==== Cambiando el tarball original ====

...

===== Soluciones =====

...

===== Consejos =====

...

==== Información de Copyright ====

...

==== Paquetes de referencia ====

...

== Sistema de parches ==

== KDE ==

== Archivos complementarios ==

== Recetas ==

== Apéndice ==

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

[[Categoría:MOTU-es]]

World of Warcraft

2008-06-27T07:07:17Z

Festor: /* Enlaces externos */

{{software
| nombre = World of Warcraft
| desarrollador = [[w:Blizzard Entertainment|Blizzard Entertainment]]
| versión_estable = 2.4.2
| fecha_versión_estable = 13 de mayo de 2008
| género = [[:Categoría:Juegos de rol|Juego de rol]]
| licencia = [[w:software no libre|privativa]]
| español = Sí
| web = [http://www.worldofwarcraft.com/ www.worldofwarcraft.com]
}}

'''World of Warcraft''', también abreviado '''WoW''', es un [[w:videojuego|videojuego]] [[w:MMORPG|MMORPG]] desarrollado por [[w:Blizzard Entertainment|Blizzard Entertainment]] disponible para los sistemas operativos [[w:Microsoft Windows|Windows]] y [[w:Mac OS X|Mac OS X]]. Está basado en el mundo de ficción y la historia de Warcraft donde se adopta el papel de un personaje virtual que interactúa con otros personajes y desarrolla situaciones en un ambiente fantástico como en un juego de rol.

Consta de dos expansiones oficiales, una llamada ''World of Warcraft: The Burning Crusade'' y la otra ''World of Warcraft: Wrath of the Lich King''. Las revisiones de parches también añaden nuevos contenidos y son bastante frecuentes.

La aceptación del juego ha sido enorme. De hecho, Blizzard Entertainment anunció que en los primeros días de enero de 2007 existían más de 8 millones de jugadores registrados (pagando suscripción) en todo el mundo.

== Instalando los paquetes necesarios ==

[[instalar aplicaciones|Instalamos]] los paquetes <code>wine</code> del [[wine#Nuevas versiones de Wine (no recomendado)|repositorio oficial del proyecto]], <code>msttcorefonts</code> y <code>ttf-xfree86-nonfree</code> de los repositorios de Ubuntu.

sudo aptitude install wine msttcorefonts ttf-xfree86-nonfree

Configuramos wine usando el comando winecfg o usando el lanzador que instala Wine en el menú de Gnome.

[[Imagen:Wine-DirectX1.png|450px|Iniciamos la herramienta de configuración de Wine]]

En la ventana que se abrirá seleccionamos la versión de Windows (preferiblemente XP).

== Instalando World of Warcraft ==

Desde el menú de Ubuntu vamos a '''Lugares''' -> '''Carpeta personal''' y crearemos una carpeta llamada '''''wow'''''

En la carpeta '''''wow''''' deberemos copiar todos los archivos del CDs/DVD del juego, al finalizar abriremos el archivo Installer.exe con wine (botón derecho, "Abrir con Wine")

[[Imagen:Pantallazo-Instalador de World of Warcraft.png|Pantalla del instalador del WoW]] [[Imagen:Instalador_de_WoW-progreso.png|Progreso]]

Durante la instalación es posible que algunos diálogos aparezcan en blanco y el instalador consuma el 100% del procesador durante unos segundos.

Tranquilo, es normal, espera y pulsa continuar cuando sea posible.

== Configuración del juego ==

=== Config.wtf ===

Lo primero que debes hacer es ejecutar el juego y entrar en el con un personaje para que se creen los archivos de configuración del World of Warcraft. Luego sal del juego y empezaremos a configurarlo para que te funcione bien.

World of Warcraft usa [[w:DirectX|DirectX]] por defecto pero para la mayoría de las personas este modo no funciona bien. Lo mejor es usar el [[OpenGL]]. Para hacer esto debes editar el archivo <code>Config.wtf</code> que se encuentra en el directorio. Puede hacer esto con el siguiente comando:

xdg-open '.wine/drive_c/Archivos de programa/World of Warcraft/WTF/Config.wtf'

Para ello pulsa Alt+F2 y escribe la ruta, se abrirá el archivo con el editor de textos predeterminado.

Y añadimos esta linea de texto al archivo:

SET gxApi "opengl"

Luego si experimentas un rendimiento pobre, errores en los gráficos o el juego no funciona del todo bien añade las siguientes lineas también:

SET ffxDeath "0"
SET ffxGlow "0"

Al parecer si deshabilitamos el <code>ffxGlow</code> (como se hizo antes) puede permitir el uso del antialiasing según algunos usuarios.

Si experimentas un tartamudeo, sonido de mala calidad o simplemente no tienes sonido debes añadir estas otras líneas:

SET SoundOutputSystem "1"
SET SoundBufferSize "150"

=== Herramienta de configuración de Wine (winecfg) ===

Si aun modificando el archivo <code>Config.wtf</code> el sonido no funciona correctamente deberemos configurar el sistema de sonido en Wine mediante la aplicación winecfg que administra la configuración de este programa.

Configuramos wine usando el comando <code>winecfg</code> o usando el lanzador que instala Wine en el menú de Gnome.

[[Imagen:Wine-DirectX1.png|thumb|Iniciamos la herramienta de configuración de Wine]]

Dirígete a la pestaña de Audio/Sonido. No te preocupes si al pulsar en dicha pestaña el programa parece que se bloquea, es normal, al cabo de unos segundos volverá a funcionar bien.

Para la mayoría de las personas el sistema de sonido [[OSS]] le funciona mejor que el [[ALSA]], así que debes asegurarte de que solo está seleccionado OSS. Pero... para otros ALSA funciona mejor, así que intenta seleccionarla como segunda opción si OSS no funciona bien. En cualquier caso asegurarte de elegir solo uno a la vez, no puede haber dos sistemas de sonido seleccionados.

También, comentar que en la sección de Chat por voz encontrarás información sobre como conseguir múltiples streams de audio usando OSS y ALSA (dos programas que usen el audio a la vez) Esto te serviría, por poner un ejemplo, si deseas escuchar música y jugar al mismo tiempo.

Puedes probar a activar la opción «Emulación del manejador». Si no ayuda desactivarla.

=== Configuración del registro ===

Esto es una simple edición del registro de wine que aumentará drásticamente los FPS del juego. Mucha de esta información de obtuvo de [http://www.ubuntuforums.org/showthread.php?t=303509 este hilo en Ubuntuforums.org].

Abre una terminal, escribe <code>regedit</code> y pulsa enter. Esto iniciará el equivalente del editor de registro de Windows pero en Wine. Si estás familiarizado con el uso de la editor de registro bajo Windows, entonces no tendrás problemas ya que es muy similar.

[[Imagen:Pantallazo-Editor del registro.png|thumb|Hack de rendimiento]]

* Encuentra la clave <code>HKEY_CURRENT_USER\Software\Wine\</code>.
* Resalta la carpeta de Wine en el panel de la izquierda, haga clic en ella. El icono debería cambiar para abrir una carpeta.
* Click derecho en la carpeta Wine y selecciona «Nuevo» y luego «Clave».
* Remplaza el texto ''Nueva clave #1'' por ''OpenGL''.
* Click derecho en el panel de la derecha y selecciona «Nuevo» y luego «Valor de cadena».
* Remplaza el ''Nuevo valor #1'' por ''DisabledExtensions'' (fíjate bien en las mayúsculas y en las minúsculas).
* Realiza un doble click en cualquier lugar de la línea para que se abra una ventana de diálogo.
* En el campo «Datos del valor» escribe ''GPL_ARB_vertex_buffer_object''.

== Jugando ==

=== Iniciar desde el icono de escritorio ===

Doble click en el icono que encontrarás en tu Escritorio con el nombre World of Warcraft, esto iniciará el lanzador. Si nunca has usado algo que requiera de renderizado HTML con Wine se te notificará para descargar y instalar automáticamente el motor de renderizado Gecko. Debes instalarlo para que el lanzador WoW muestre las noticias y novedades.

=== Iniciar desde la terminal ===

Para usar la terminal simplemente escribe esto en ella:

wine "C:/Archivos de programa/World of Warcraft/Launcher.exe"

(instala el motor de renderizado Gecko cuando te lo pidan)

O, para entrar directamente al juego:

wine "C:/Archivos de programa/World of Warcraft/Wow.exe"

=== Menu WoW en Gnome ===

Puedes hacer una entrada en el menú de Gnome para el WoW con estos comandos:

wget http://kde-files.org/CONTENT/content-files/41569-wow-icon-scalable.svg -O WoW.svg
sudo mv WoW.svg /usr/share/pixmaps/
gksudo gedit /usr/share/applications/wow.desktop

Y en el archivo que se abrirá copiamos y pegamos el siguiente texto.

[Desktop Entry]
Encoding=UTF-8
Name=World of Warcraft
Exec=wine "C:/Archivos de programa/World of Warcraft/Wow.exe"
Icon=WoW.svg
Terminal=false
Type=Application
Categories=Application;Game;
StartupNotify=false

== Fuentes ==

* Artículo '''[https://help.ubuntu.com/community/WorldofWarcraft World of Warcraft]''' en [https://help.ubuntu.com/community/ Community Ubuntu Documentation] {{en}}.

== Problemas comunes ==

https://help.ubuntu.com/community/WorldofWarcraft/Troubleshooting.

== Ver también ==

* [[Wine]].

== Enlaces externos ==

{{Wikipedia}}
* [http://www.worldofwarcraft.com/ Sitio web oficial de World of Warcraft] {{en}}.

[[Categoría:Juegos de rol]]
[[Categoría:Wine]]

Guía de empaquetamiento/Completa

2008-06-26T21:35:25Z

Festor: /* Errores comunes */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *.deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las variables -us -uc con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos. Para asegurase de que debuild encuentre correctamente la clave GPP debes introducir las variables de entorno DEBFULLNAME y DEBEMAIL, en tu archivo ~/.bashrc, con el nombre y el e-mail respectivamente que uses para la clave GPG y en el archivo debian/changelog.

Algunos usuarios han reportado que les fue imposible que debuild encontrara la clave GPG incluso después de introducir las variables. Si este fuera tu caso puedes probar con el comando:

debuild -k <id_clave_GPG>

Donde <id_clave_GPG> es el identificativo de tu clave GPG.

Para comprobar que el paquete se construya en un entorno limpio también podemos construir el paquete binario con pbuilder:

sudo pbuilder build ../*.dsc

Usando pbuilder podemos saber si las dependencias son correctas ya que pbuilder proporciona un entorno mínimo así que todas las dependencias quedarían determinadas por el archivo control.

Ahora podemos comprobar los errores comunes en el paquete fuente usando lintian:

cd ..
lintian -i *.dsc

==== Requerimientos de paquetes nuevos para Ubuntu ====

...

=== Empaquetando con CDBS ===

...

=== Empaquetando módulos Python con CDBS ===

...

=== Empaquetado avanzado ===

...

==== Creando más de un paquete binario ====

...

=== Empaquetando librerías compartidas ===

...

==== Librerías compartidas ====

...

=== Errores comunes ===

...

==== Archivos de ejemplo dh-make ====

...

==== Abusando de archivos ====

...

==== Cambiando el tarball original ====

...

===== Soluciones =====

...

===== Consejos =====

...

==== Información de Copyright ====

...

==== Paquetes de referencia ====

...

== Sistema de parches ==

== KDE ==

== Archivos complementarios ==

== Recetas ==

== Apéndice ==

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-26T21:30:22Z

Festor: /* Requerimientos de paquetes nuevos para Ubuntu */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *.deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las variables -us -uc con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos. Para asegurase de que debuild encuentre correctamente la clave GPP debes introducir las variables de entorno DEBFULLNAME y DEBEMAIL, en tu archivo ~/.bashrc, con el nombre y el e-mail respectivamente que uses para la clave GPG y en el archivo debian/changelog.

Algunos usuarios han reportado que les fue imposible que debuild encontrara la clave GPG incluso después de introducir las variables. Si este fuera tu caso puedes probar con el comando:

debuild -k <id_clave_GPG>

Donde <id_clave_GPG> es el identificativo de tu clave GPG.

Para comprobar que el paquete se construya en un entorno limpio también podemos construir el paquete binario con pbuilder:

sudo pbuilder build ../*.dsc

Usando pbuilder podemos saber si las dependencias son correctas ya que pbuilder proporciona un entorno mínimo así que todas las dependencias quedarían determinadas por el archivo control.

Ahora podemos comprobar los errores comunes en el paquete fuente usando lintian:

cd ..
lintian -i *.dsc

==== Requerimientos de paquetes nuevos para Ubuntu ====

...

=== Empaquetando con CDBS ===

...

=== Empaquetando módulos Python con CDBS ===

...

=== Empaquetado avanzado ===

...

==== Creando más de un paquete binario ====

...

=== Empaquetando librerías compartidas ===

...

==== Librerías compartidas ====

...

=== Errores comunes ===

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-26T20:27:40Z

Festor: /* Construyendo el paquete fuente */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *.deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las variables -us -uc con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos. Para asegurase de que debuild encuentre correctamente la clave GPP debes introducir las variables de entorno DEBFULLNAME y DEBEMAIL, en tu archivo ~/.bashrc, con el nombre y el e-mail respectivamente que uses para la clave GPG y en el archivo debian/changelog.

Algunos usuarios han reportado que les fue imposible que debuild encontrara la clave GPG incluso después de introducir las variables. Si este fuera tu caso puedes probar con el comando:

debuild -k <id_clave_GPG>

Donde <id_clave_GPG> es el identificativo de tu clave GPG.

Para comprobar que el paquete se construya en un entorno limpio también podemos construir el paquete binario con pbuilder:

sudo pbuilder build ../*.dsc

Usando pbuilder podemos saber si las dependencias son correctas ya que pbuilder proporciona un entorno mínimo así que todas las dependencias quedarían determinadas por el archivo control.

Ahora podemos comprobar los errores comunes en el paquete fuente usando lintian:

cd ..
lintian -i *.dsc

==== Requerimientos de paquetes nuevos para Ubuntu ====

...

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-26T19:30:29Z

Festor: /* Construyendo el paquete fuente */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *.deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las variables -us -uc con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos. Para asegurase de que debuild encuentre correctamente la clave GPP debes introducir las variables de entorno DEBFULLNAME y DEBEMAIL, en tu archivo ~/.bashrc, con el nombre y el e-mail respectivamente que uses para la clave GPG y en el archivo debian/changelog.

Algunos usuarios han reportado que les fue imposible que debuild encontrara la clave GPG incluso después de introducir las variables. Si este fuera tu caso puedes probar con el comando:

debuild -k <id_clave_GPG>

Donde <id_clave_GPG> es el identificativo de tu clave GPG.

Para comprobar que el paquete se construya en un entorno limpio también podemos construir el paquete binario con pbuilder:

sudo pbuilder build ../*.dsc

Usando pbuilder podemos saber si las dependencias son correctas ya que pbuilder proporciona un entorno mínimo así que todas las dependencias quedarían determinadas por el archivo control.

Ahora podemos comprobar los errores comunes en el paquete fuente usando lintian:

cd ..
lintian -i *.dsc

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-26T19:16:41Z

Festor: /* Construyendo el paquete */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *.deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las variables -us -uc con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos. Para asegurase de que debuild encuentre correctamente la clave GPP debes introducir las variables de entorno DEBFULLNAME y DEBEMAIL, en tu archivo ~/.bashrc, con el nombre y el e-mail respectivamente que uses para la clave GPG y en el archivo debian/changelog.

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-26T19:15:52Z

Festor: /* Construyendo el paquete fuente */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las variables -us -uc con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos. Para asegurase de que debuild encuentre correctamente la clave GPP debes introducir las variables de entorno DEBFULLNAME y DEBEMAIL, en tu archivo ~/.bashrc, con el nombre y el e-mail respectivamente que uses para la clave GPG y en el archivo debian/changelog.

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Macbook

2008-06-26T19:09:15Z

Festor: /* Instrucciones básicas */

{{wikificar}}

[[Imagen:SPEngUs2.png]] Página traduciendose de la documentación original https://help.ubuntu.com/community/MacBook?highlight=(macbook)

----

= Como instalar Ubuntu en un Macbook =

Esta guía le ayudará con los pasos necesarios para la instalación de Ubuntu en un MacBook. Esta guía ha sido realizada para Ubuntu 7.10 (Gutsy Gibbon), pero está siendo adaptada para Ubuntu 8.04 (Hardy heron).

Si tienes un MacBook Pro te recomendamos que veas esta otra guía: https://wiki.ubuntu.com/MacBookPro, tenga en cuenta que es casi todo igual , aunque esta página es tambien relevante.

Si tienes el nuevo Macbook (Santa Rosa v3.1) veer esta guía: https://help.ubuntu.com/community/MacBook_Santa_Rosa

Para la discusión adicional de este asunto, vea: http://ubuntuforums.org/showthread.php?p=1699961

Para una guía de tripe arranque vea: http://wiki.onmac.net/index.php/Triple_Boot_via_BootCamp_Ubuntu

'''Las instrucciones abajo se refieren a la aplicación BootCamp de Apple que está disponible de forma pública excepto si usas Leopard Mac OS X 10.5. Otra opción, sin embargo, es redimensionar la partición Mac OS X utilizando las utilidades de disco o reinstalar Mac Os X haciendo más pequeña la partición de Mac OS X, dejando el espacion libre necesario para Ubuntu'''

== Instrucciones básicas ==
*1. Actualizar el software de tu sistema Mac Os X [http://www.apple.com/support/downloads/ firmware] a la versión más reciente. Tambien puede hacerlo de la manera estandard pulsando en la manzana y luego "Actualización de software" (Accesible desde el escritorio de su sistema Mac OS X) 
*2. Baja tu Ubuntu [http://www.ubuntu.com/getubuntu/download Live CD]. Para los primeros Macbooks tu debes seleccionar `i386`; Para los Macbooks Core 2 Duo (posterioes a 2006) puedes seleccionar `amd64` si tu estás interesado en arrancar a 64-bit OS,si no seleccionar ` i386`. 
*3. Instalar [http://refit.sourceforge.net/ rEFIt] si tu quieres un menu de arranque (para poder seleccionar OS X/Ubuntu) seleccionar el arranque. Puedes hacer que el arranque a Ubuntu sea por defecto y cargar la cuenta atras editando el fichero "refit.conf" (Según está descrito en el anterior web site [http://refit.sourceforge.net/ rEFIt]). 
*4. Si es necesario, use Boot Camp para redimensionar la partición OSX para dejar espacio para tu Ubuntu. Don't waste a CD creating a Windows driver disk. Reboot. 
*5. Pulsa la tecla "C" para iniciar desde el CD. 
*6. Instalar Ubuntu de la forma usual, excepto:
** En la particion, selecciona ''Editar manualmente la tabla de particiones''
** Borra /dev/sda3 y /dev/sda4 si existe
** Crea una nueva partición ext3 para tu usuario root
** Monte la reción creada partición ext3 en '/'
** Tenga en cuenta que con Boot Camp puede darle problemas si hace más de dos particiones. 
*7. Finaliza la instalación y reinicia. 
*8. Si has instalado rEFIT, deberíaa tener la posibilidad de elegir entre el arranque OS X y Ubuntu. Utilice las teclas de flecha y ENTER para seleccionar Ubuntu. 
*9. Aleternativamente, si no has instalado rEFIT, mantenga pulsada Alt/Opción para decidir si desea arrancar en OSX / Ubuntu. El menú de arranque del Bootcamp instalado reconocerá la instalación de Ubuntu como si fuera de Window$ pero en realidad arrancará Ubuntu sin problemas.
*10. Entre en su sistema.
*11. Siga las instrucciones que aparecen a continuación para configurar los distintos componentes de hardware que no funciona de forma estandard en Gutsy.

== Sound ==

Sound on MacBooks is provided by an Intel HDA-based integrated chipset, and should work out-of-the-box. However, in Ubuntu 8.04 alsa drivers 1.0.15 will not work with some chipsets, like SigmaTel STAC9221. In such cases everything seems to work fine but no sound is present (even unmuting all controls). Alsa drivers 1.0.16 should work fine, to install them:

{{{
sudo apt-get install build-essential linux-headers-$(uname -r) module-assistant alsa-source
sudo dpkg-reconfigure alsa-source
sudo module-assistant a-i alsa-source
}}}

This may disable Madwifi drivers for the wireless card, hence you want to compile alsa first.

The volume control will not work correctly out-of-the-box - in particular, reducing the default volume will result in sound distortion at lower volume levels, and volume control changes won't effect the headphone volume level.

To fix this, do the following

1. Add the following line to /etc/modprobe.d/alsa-base:
{{{
install snd-hda-intel position_fix=1 /sbin/modprobe --ignore-install snd-hda-intel $CMDLINE_OPTS && /lib/alsa/modprobe-post-install snd-hda-intel
}}}

2. Increase the volume (both using the key combination and the system tray applet) to its maximum possible value.

3. Right-click on the volume applet and choose Preferences. Select "PCM" as the device to control.

4. Open the Sound preferences (System-Preferences-Sound in GNOME). Select "PCM" as the device to control.

The above setting changes (step 3 and 4) can be done via the command line using these two gconftool-2 commands:
{{{
gconftool-2 --type list --list-type string --set /desktop/gnome/sound/default_mixer_tracks [PCM]
gconftool-2 --type string --set /apps/panel/applets/mixer_screen0/prefs/active-track PCM
}}}

Step 1. may be necessary in Hardy even if you don't appreciate this issue.

== Microphone ==

The built-in iSight microphone (above the LCD screen) will not record out of the box, but is really easy to get working. The steps that I took to get the microphone working were:

1. right-click on the volume applet and select "Open Volume Control".

2. within the volume control application select "Edit > Preferences".

3. select "Mux" and "Input Source" at the bottom of the list, and close.

4. select the "Recording" tab and set "Mux" at about 1/3 full volume (higher results in static).

5. make sure mic is unmuted!

6. select the "Options" tab and select "Mic" as the input source.

note: the only options I have checked in "Edit > Preferences" (step 2 above) are: PCM, Input source, and Mux.

The above settings, minus the 1/3 volume level setting, can be toggled using the below commands:

{{{
gconftool-2 --set /apps/gnome-volume-control/HDAIntelAlsamixerMux --type bool 1
gconftool-2 --set /apps/gnome-volume-control/HDAIntelAlsamixerPCM --type bool 1
gconftool-2 --set /apps/gnome-volume-control/HDAIntelAlsamixerInputSource --type bool 1
}}}

== Wireless ==

If you have a first generation MacBook (Core Duo) then your wireless should just start working, though you may want to update to the latest version as illustrated below for better power efficiency and signal strength. Second generation Mac``Books (Core 2 Duo) have a newer version of the Atheros Wifi chipset which requires the installation of the latest Atheros Mad``Wifi drivers. [https://bugs.launchpad.net/madwifi/+bug/122703 bug #122703]

Please note that the current Mad``Wifi drivers depend on a proprietary binary, the Atheros HAL, and therefore are not open-source software. A free software implementation, [http://madwifi.org/wiki/About/OpenHAL OpenHAL], is currently being developed by the Madwifi devs, but unfortunately it does not support the Atheros chipset in the MacBooks yet.

The following commands compile and install the prerelease Mad``Wifi driver, insert it into the kernel, and disable background scanning for better stability. For installation, you can choose to use daily snapshots or Subversion.

Using daily snapshots:
{{{
sudo apt-get install build-essential autoconf automake
wget http://snapshots.madwifi.org/madwifi-trunk-current.tar.gz
tar -zxvf madwifi-trunk-current.tar.gz
cd madwifi-trunk-r*
make
sudo make install-modules
echo -e '#!/bin/sh\n/sbin/iwpriv ath0 bgscan 0' | sudo tee -a /etc/acpi/resume.d/99-madwifi-bgscan.sh
sudo chmod 755 /etc/acpi/resume.d/99-madwifi-bgscan.sh
}}}

Alternatively, using Subversion (be patient with the checkout, it may take a while):
{{{
sudo apt-get install build-essential subversion autoconf automake
svn co http://svn.madwifi.org/madwifi/trunk madwifi
cd madwifi
make
sudo make install-modules
echo -e '#!/bin/sh\n/sbin/iwpriv ath0 bgscan 0' | sudo tee -a /etc/acpi/resume.d/99-madwifi-bgscan.sh
sudo chmod 755 /etc/acpi/resume.d/99-madwifi-bgscan.sh
}}}

At this point the driver should be installed and will be enabled after a reboot. Alternatively, you can skip the reboot and use the following commands to insert the driver into the running kernel:
{{{
sudo modprobe ath_pci
sudo iwpriv ath0 bgscan 0
}}}

Additionally, the Mad``Wifi drivers are sometimes unstable under certain circumstances when using the standard NetworkManager tool for managing networks. Because of these reasons, you may want to disable the drivers if you aren't using wireless. To do this, edit the /etc/modprobe.d/blacklist file and add "blacklist ath_pci" at the bottom. Additionally, you can deselect the Atheros HAL in the Restricted Manager (System-Administration-Restricted Drivers Manager).

To disallow replacement of just installed modules by installing linux-restricted-modules package update you can edit /etc/default/linux-restricted-modules-common and insert ath_hal into DISABLED_MODULES list:
{{{
sudo sed -i~ -e 's/^$DISABLED_MODULES="$$.*"$/\1ath_hal \2/' -e 's/ "$/"/' /etc/default/linux-restricted-modules-common
}}}

More information can be obtained at
http://madwifi.org/wiki/UserDocs/FirstTimeHowTo

If you need to connect to a channel that's not allowed in the regulatory domain in which you bought your laptop, you'll need to follow these instructions: http://tumbleweed.org.za/2008/02/11/madwifi-regdomain-issues

=== Ndiswrapper ===
If you instead want to use ndiswrapper to use the Windows wireless drivers on Ubuntu (only for 32-bit) these are the instructions:

You have to have the XP drivers on your hard disk. If you don't have a Windows XP installation on an alternate partition, you can get the drivers from the Boot Camp driver disk. The drivers from the Boot Camp disk can be uncompressed using the non-free unrar in the multiverse repository:
* Enable multiverse ( see https://help.ubuntu.com/community/Repositories/Ubuntu )
* Install the packages {{{rar unrar}}} (actually only unrar is truly necessary)
* Uncompress the Windows XP Atheros driver installer:

{{{
mkdir ~/atheros
unrar x atherosxpinstaller.exe ~/atheros/
}}}

* Install the atheros drivers using ndiswrapper:
{{{
sudo apt-get install ndiswrapper-utils-1.8

#install the driver into ndiswrapper:
sudo ndiswrapper -i "~/atheros/net5416.inf"
#--or--
sudo mount /dev/sda4 /mnt
sudo ndiswrapper -i "/mnt/Program Files/Macintosh Drivers for Windows XP 1.1.2/net5416/net5416.inf"

sudo modprobe ndiswrapper
sudo echo >> /etc/modules "ndiswrapper"
sudo umount /mnt
}}}

Reference: http://paulglover.net/20061210/triple-booting-macbook-os-x-ubuntu-edgy-windows-xp/

=== Wicd ===

In order to fix the wireless for the most recent Linux kernels, you may want to install wicd (http://wicd.net) instead of using network-manager. Follow the instructions for installation on Ubuntu on their website, then use these preferences:

WPA Supplicant Driver: wext
Wireless Interface: ath0
Wired Interface: eth0

All of the rest should not matter, except for your specific network settings, you should just leave them alone.

== Brightness ==

Brightness controls should work out-of-the box using HAL and GNOME Power Manager in Ubuntu 7.10. However, there are a few issues with automatic dimming. In particular, the automatic dimming feature actually *brightens* the MacBook screen when on AC, and on battery it brightens the screen if the screen brightness has been adjusted to a value below the standard level for battery power. This is documented in bug [https://bugs.launchpad.net/ubuntu/+source/gnome-power-manager/+bug/137598 #137598] and [https://bugs.launchpad.net/ubuntu/+source/gnome-power-manager/+bug/63543 #63543].

Due to these issues, you may want to disable auto-dimming. This can be done by opening the Gconf Editor (gconf-editor in a Terminal will open it), and unchecking the key "enable" in "apps/gnome-power-manager/backlight". If at a later time you want to re-enable this feature (i.e. if the bug is fixed in a future update) simply return to this key and check it instead of unchecking it.

** Easy fix for Macbook Pro Gutsy

I simply went into System > Preferences > Power Management
1) I unchecked "Dim Display when idle"
2) In the "On Battery Power" tab, uncheck "Dim Display when idle"
3) in the "General" tab, uncheck "use ambient light to adjust LCD brightness" <<-- This seems to be the main problem, but I kept the other two unchecked just to be sure ;-)

== Suspend ==

Suspend is broken in Ubuntu 7.10 on many first-generation MacBooks as well as some later-generation MacBooks and MacBook Pros [https://bugs.launchpad.net/bugs/151016 #151016]. In particular, these machines will go into suspend, but will not come out of suspend. This is because the 32bit kernel supplied with 7.10 has some issues which prevent this from working (the x86_64 kernel works correctly out of the box). To fix this you will have to download an older version of the Linux kernel that is known to work. The latest known version to work is 2.6.22-12, which you can download by installing the packages at the locations pointed to below. Be sure to install them in the order as they appear here.

https://launchpad.net/ubuntu/gutsy/i386/linux-image-2.6.22-12-generic/2.6.22-12.39
https://launchpad.net/ubuntu/gutsy/i386/linux-headers-2.6.22-12/2.6.22-12.39
https://launchpad.net/ubuntu/gutsy/i386/linux-headers-2.6.22-12-generic/2.6.22-12.39
https://launchpad.net/ubuntu/gutsy/i386/linux-ubuntu-modules-2.6.22-12-generic/2.6.22-12.32
https://launchpad.net/ubuntu/gutsy/i386/linux-restricted-modules-2.6.22-12-generic/2.6.22.4-12.3

After installing, edit /boot/grub/menu.lst and change the default=0 line to default=2 (if the newly-installed kernel is the third listed in the menu.lst file, which it should be when installed on a stock Gutsy install).

Restart your MacBook for the update to take effect. You will have to reinstall any wireless drivers you may have installed in the past.

Alternatively, users who prefer a newer kernel to an older one can install the 2.6.24 kernel packages from the upcoming Ubuntu 8.04 release by adding the hardy repositories to their software sources:
{{{
deb http://archive.ubuntu.com/ubuntu/ hardy main restricted
deb http://archive.ubuntu.com/ubuntu/ hardy-updates main restricted
deb http://security.ubuntu.com/ubuntu hardy-security main restricted
}}}
Note: These should not replace the existing gutsy sources, but should be in addition to them. See the Repositories Howto for more information.

Once the new repositories have been added, and the package list reloaded, installing the new linux-generic should get all the necessary kernel packages from hardy, including linux-image, linux-ubuntu-modules, and linux-restricted-modules. Once the new packages are installed, disable (but don't remove) the hardy repositories, so that upgrades using apt or synaptic don't result in a complete upgrade to hardy. The user can periodically re-enable these repositories in order to check for updated kernel packages.

Rebooting into the new kernel ''should'' result in a perfectly suspending MacBook.

On my Macbook (2007), I need to edit /etc/default/acpi-support in the following way:

- change POST_VIDEO=true into POST_VIDEO=false

- Add sky2 in the modules to be removed before suspend and reloaded after: MODULES="sky2"

Note: on my MacBook (2nd gen: Nov 2006), using the hardy kernel as explained above, no change to /etc/default/acpi-support was required.

== Whining noise ==

In order to fix the whining noise that some MacBooks make, you need to install the iSight firmware. To install the iSight firmware, follow the steps listed below under "iSight". After installing the firmware and restarting, your MacBook should be whine-free.

Note: The above does not always work. In that case, add the following to /etc/init.d/acpid before exit 0.
{{{
echo 2 > /sys/module/processor/parameters/max_cstate
}}}

== Fonts & Desktop Effects ==

When using desktop effects (which are enabled by default on most MacBooks), the fonts used for menu bar titles will sometimes be larger than normal. This issue is described in detail in bug [https://bugs.launchpad.net/ubuntu/+source/compiz/+bug/141001 #141001].

To fix this, in /etc/gdm/gdm.conf change:

{{{
[server-Standard]
name=Standard server
-command=/usr/bin/X -br -audit 0
}}}

to

{{{
[server-Standard]
name=Standard server
-command=/usr/bin/X -br -audit 0 -dpi 96
}}}

Restart X for this to take effect.

== iSight ==

The iSight is currently broken in Ubuntu Hardy, please see
https://bugs.launchpad.net/ubuntu/+source/linux-ubuntu-modules-2.6.24/+bug/185634

iSight works on Gutsy as long as you either 1) boot OS X before booting Gutsy or 2) install the iSight firmware in Gutsy.
To install the iSight firmware, perform the following steps, substituting your Mac OS X partition for sda2 and your kernel for 2.6.22-14-generic. Please note that you need a Mac OS X partition to extract the firmware.

{{{
sudo mount -t hfsplus /dev/sdax /mnt
sudo cp /mnt/System/Library/Extensions/IOUSBFamily.kext/Contents/PlugIns/AppleUSBVideoSupport.kext/Contents/MacOS/* /lib/firmware/2.6.22-14-generic/
}}}

Also, in /etc/default/acpi-support, edit the line that begins with MODULES such that it reads:

{{{
MODULES="isight_usb"
}}}

Restart for this to take effect. Once the firmware is functional, the iSight may be used with the "ekiga" program.

To install prerequisites and launch Ekiga (Ekiga may also be launched through the menus), do the following:

{{{
sudo apt-get install ekiga libpt-plugins-v4l2
ekiga
}}}

1. Configuration. You may have to select the iSight device. Edit > Preferences > Devices > Video Devices >
1. Video plugin: V4L2
1. Input device: Built-in iSight

If you want to use it in 640x480 mode, then:

{{{
gconftool-2 --type integer --set /apps/ekiga/devices/video/size 1
}}}

== Minimum Fan Speed ==

To set a minimum fan speed which may help your MacBook run cooler. Substitute your speed of choice (in RPM) for 3000 if you wish.

First you need to load the appropriate module:
{{{
sudo modprobe applesmc
echo applesmc | sudo tee -a /etc/modules
}}}
then add the following line to /etc/init.d/acpid just before the exit statement:
{{{
echo 3000 > /sys/devices/platform/applesmc.768/fan1_min
}}}

== Reducing Power Consumption ==

PowerTOP is a program that monitors a Linux system and gives suggestions on reducing power consumption. To install PowerTOP, enter this command in a terminal:

{{{
sudo apt-get install build-essential libncurses5-dev libncursesw5-dev
wget -c http://www.lesswatts.org/projects/powertop/download/powertop-1.9.tar.gz
tar -xvf powertop-1.9.tar.gz
cd powertop-1.9
sudo make
sudo make install
}}}

You can also use “checkinstall” instead of “make install” to create a simple .deb for easier removal.

PowerTOP must always be run as root, so use the following command to run it:

{{{
sudo powertop
}}}

== Reducing Drive Load/Unload Cycles ==

My Second Generation (C2D) MacBook is susceptible to a high load/unload cycle count on the hard drive. This is a workaround to lower the drive cycles and extend the drive life. Generate the following three files using the commands below:

{{{
echo -e '#!/bin/sh\nhdparm -B 254 /dev/sda' | sudo tee -a /etc/acpi/start.d/99-macbook-fix.sh
echo -e '#!/bin/sh\nhdparm -B 254 /dev/sda' | sudo tee -a /etc/acpi/resume.d/99-macbook-fix.sh
echo -e '#!/bin/sh\nhdparm -B 254 /dev/sda' | sudo tee -a /etc/acpi/suspend.d/99-macbook-fix.sh
}}}

Add execute permissions to the files:

{{{
sudo chmod a+x /etc/acpi/start.d/99-macbook-fix.sh
sudo chmod a+x /etc/acpi/resume.d/99-macbook-fix.sh
sudo chmod a+x /etc/acpi/suspend.d/99-macbook-fix.sh
}}}

To have these changes take effect immediately (without requiring a reboot):

{{{
sudo hdparm -B 254 /dev/sda
}}}

See [https://bugs.launchpad.net/ubuntu/+source/acpi-support/+bug/59695 this bug] for more details.

note: this is Ubuntu 8.04 "Hardy" on the Second Generation (C2D) MacBook. I have not tested on previous releases or other models.

== Right/Middle Clicking ==

There are two main approaches to right/middle clicking:
* Two/three finger taps via the synaptics touchpad driver by editing xorg.conf
* Remapping the functions of keys on the keyboard by editing system keyboard layouts or using xmodmap and a local configuration file

=== Multi-finger taps ===
See [#touchpadtweaks More touchpad tweaks].

=== Keyboard keys ===
Enable mouse emulation:
* On Ubuntu: Go to '''System ▸ Preferences ▸ Keyboard ▸ Accessibility''' in the Main menu. Check '''Enable keyboard accessibility features'''. Click the ''Mouse Keys'' tab and check '''Enable Mouse Keys''' also.
* On Kubuntu: bring up ''System Settings'', find ''Keyboard & Mouse'', choose ''Mouse'' on the left, than the ''Mouse Navigation'' tab, and check the checkbox beside ''Move pointer with keyboard (using the num pad)''. Please note that on Kubuntu you will lose your numpad.
* On Xubuntu: Go to '''Applications ▸ Settings ▸ Mouse Settings''' and on the '''Accessibility''' tab, enable the '''Enable mouse emulation''' check box.
Then '''either''' edit the system files '''or''' use a local configuration file and xmodmap:
* Editing system files (choose '''one''' of the following options):
* '''option 1:''' lower Enter key = Right Mouse Button, Shift + lower Enter key = Middle Mouse Button
{{{
sudo sed -i~ 's/KP_Enter/Pointer_Button3, Pointer_Button2/' /etc/X11/xkb/symbols/keypad
}}}
* '''option 2:''' lower Enter key = Right Mouse Button, Alt Gr key + lower Enter key = Middle Mouse Button
{{{
sudo sed -i~ 's/KP_Enter/Pointer_Button3, Pointer_Button3, Pointer_Button2, Pointer_Button2/' /etc/X11/xkb/symbols/keypad
}}}
* Using xmodmap and a local configuration file to override the system-wide layouts:
* The keycodes for relevant keys are:
* right Apple - keycode 116
* lower enter - keycode 108
* The keysyms for relevant input events are:
* Alt Gr - ISO_Level3_Shift
* Middle-click - Pointer_Button2
* Right-click - Pointer_Button3
* Create a text file as ~/.xmodmap containing the following text:
('''Note''': for my set up I use left Apple as Alt Gr, right Apple as middle-click and lower enter as right-click. If you want to use right Apple as Alt Gr then you may need to rethink your keys for clicks assignments.)
{{{
keycode 116 = Pointer_Button2
keycode 108 = Pointer_Button3
}}}
* Add a call to xmodmap to your startup applications:
* On Xubuntu: Go to '''Applications ▸ Settings ▸ Autostarted Applications''', click the '''Add''' button, fill in the '''Name''' and '''Description''' fields and put the following into the '''Command''' field:
{{{
xmodmap ~/.xmodmap
}}}
Then click '''OK''' and '''Close'''.

'''Restart X (Ctrl+Alt+Backspace) for the changes to take effect.'''

== Motion Sensor ==

The motion sensor doesn't support disk parking yet ([https://bugs.launchpad.net/bugs/139881 bug #139881]), but you can play physical neverball :-)

{{{
sudo modprobe applesmc
echo applesmc | sudo tee -a /etc/modules
}}}

Then fire up neverball... (or any other game that uses a joystick)

== Keyboard layouts ==

(Xubuntu 7.10 UK MacBook) There are some MacBook / MacBook Pro keyboard models defined in xkb, however, I have found that the Apple Laptop model with layout as ''gb'' (for my UK MacBook) and variant as ''mac'' with the xmodmap configuration as below. Maybe this approach will work well for others.

To make the keyboard usable, for an international keyboard layout:
## TODO cjwatson 2007-03-27: is this still required in Ubuntu 7.04? Changes like this won't be preserved on upgrade any more, so aren't recommended.

* The GUI way:
Bring up the ''Keyboard Preferences'' window with '''System ▸ Preferences ▸ Keyboard''' from the Main menu. Click on the '''Keyboard Layout Options''' tab, and find '''Third level choosers'''. Mark the ''right Win key'' as third level chooser. Now your right Apple key works as Alt Gr.
* The console way, editing system files:
* Alt Gr for right Apple key
{{{
sudo sed -i~ '/xkb_symbols "ralt_switch" {/a\ include "level3(rwin_switch)"' /etc/X11/xkb/symbols/level3
}}}
* Fix swapped keys
{{{
sudo sed -i~ 's/ <LSGT> = 94;/ <LSGT> = 49;\n <TLDE> = 94;/' /etc/X11/xkb/keycodes/xfree86
}}}
* The console way, using xmodmap and a local configuration file:
* keycodes for relevant keys:
* left Apple - keycode 115
* right Apple - keycode 116
* § or ± (UK MacBook key beneath escape) - keycode 49
* ` or ~ (UK MacBook key left of z) - keycode 94
* keysyms for relevant characters/functions:
* Alt Gr - ISO_Level3_Shift
* § or ± - section plusminus
* ` or ~ - grave tilde
* To fix the swapped keys and make left Apple equivalent to Alt Gr, edit a text file at ~/.xmodmap (create it if it doesn't exist) adding the following lines:
{{{
keycode 115 = ISO_Level3_Shift
keycode 49 = section plusminus
keycode 94 = grave asciitilde
}}}
Then add {{{xmodmap ~/.xmodmap}}} to your start up.

'''Restart X (Ctrl+Alt+Backspace) for the changes to take effect.'''

To swap the fn key behaviour:
{{{
#Add one of these commands to /etc/rc.local
echo -n 0x01 > /sys/module/hid/parameters/pb_fnmode #FN on (like OSX)
echo -n 0x02 > /sys/module/hid/parameters/pb_fnmode #FN off (press fn for volume/brightness/etc)
}}}

== Screen Colors (optional) ==
To calibrate the screen colors (in order to match OS X), you need to install ''xcalib''. This isn't available in the Ubuntu repositories, so you'll have to download it.

Go to http://www.etg.e-technik.uni-erlangen.de/web/doe/xcalib/ and (if you are running `i386`) download the newest Linux binary; save it to the Desktop. (If you are running `amd64`, you'll need to compile it from source; make sure to install `libxxf86vm-dev` and `libxext-dev` first, and then simply `make xcalib` in the extracted source directory. Take the resulting `xcalib` binary and continue with these instructions.)

To install and configure it, you will need to do a few things in the terminal and mount a Mac OS X partition (to copy your color profile) as follows (substitute your Mac OS partition's partition number for 2 in /dev/sda2, 2 being the first standard partition):
{{{
sudo mv ~/Desktop/xcalib /usr/local/bin/xcalib
sudo chmod 755 /usr/local/bin/xcalib
sudo mount -t hfsplus /dev/sda2 /mnt
sudo cp /mnt/Library/ColorSync/Profiles/Displays/* /usr/local/etc
}}}
Then, do an "ls /usr/local/etc" and note the name of the profile (for the next step).

Finally, add the following line to the end of either `/etc/gdm/Init/Default` (for standard Ubuntu/Gnome) or `/etc/kde3/kdm/Xsetup` (for Kubuntu/KDE), before the final "exit" statement:
{{{
/usr/local/bin/xcalib "/usr/local/etc/<insert name of profile here>"
}}}

Restart X (Ctrl-Alt-Backspace) and your Mac OS X color profile will load as X starts.

== Fonts like Mac OS X (optional) ==

By default, Ubuntu uses a style of font rendering different than that used on Mac OS X. You may prefer fonts similar to those on Mac OS X, and you can have these on Ubuntu by doing the following:

1. Open a terminal and do "sudo dpkg-reconfigure fontconfig-config". Set font hinting to "None" and leave the rest of the options as default.
2. Paste the following into a new file entitled "/etc/fonts/conf.d/lcd-legacy.conf":
{{{
<fontconfig>
<edit name="lcdfilter" mode="assign"><const>legacy</const></edit>
</fontconfig>
}}}
3. Install any fonts you commonly use on Mac OS X. (Note: the Microsoft Core Fonts - which are commonly used in Office documents and online - can be installed using Add/Remove Programs).
4. Enjoy!

[[Anchor(touchpadtweaks)]]
== More touchpad tweaks ==

To enable touchpad scrolling/tapping/right-click:

You will need to edit the xorg.conf file (in /etc/X11/xorg.conf)

'''For more information than is available below, read {{{man synaptics}}}!'''

Replace the Synaptics Touchpad InputDevice section with the following:
* Basic device definition layout:
{{{
Section "InputDevice"
Identifier "Synaptics Touchpad"
Driver "synaptics"
Option "SendCoreEvents" "true"
Option "Device" "/dev/psaux"
Option "Protocol" "auto-dev"
Option "SHMConfig" "true"
'''...insert other options from below here...'''
EndSection
}}}
* General options affecting the touchpad edge areas, speed, touch sensitivity, etc. Note that if not using edge scrolling, the edge boundaries can probably be decreased but the edge offsets will need to be reasonable (as below?) if edge scrolling is being used.:
{{{
Option "LeftEdge" "150"
Option "RightEdge" "1070"
Option "TopEdge" "100"
Option "BottomEdge" "310"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "SingleTapTimeout" "100"
Option "MaxDoubleTapTime" "180"
Option "LockedDrags" "off"
Option "MinSpeed" "1.10"
Option "MaxSpeed" "1.30"
Option "AccelFactor" "0.08"
}}}
* Options affecting taps for button clicks:
Buttons 1, 2 and 3 correspond to the left, middle and right mouse buttons respectively. If you set the values to 0, the method will be disabled. The ''TapButton'' options are for one, two or three finger taps. The ''CornerButton'' options are for one finger taps in the right-top (''RT''), right-bottom (''RB''), left-top (''LT'') and left-bottom (''LB'') corners of the touchpad. Generally you will want to use either corner taps or multi-finger taps, not both.
* Multi-finger taps
The following example uses a one-finger tap for left-click, a two-finger tap for right-click and a three-finger tap for middle-click (and the physical button can still used for left-click):
{{{
Option "TapButton1" "1"
Option "TapButton2" "3"
Option "TapButton3" "2"
}}}
* One-finger corner taps
The following example uses the right-bottom corner for middle-click and left-bottom corner for right-click (and the physical button is still used for left-click):
{{{
Option "RTCornerButton" "0"
Option "RBCornerButton" "2"
Option "LTCornerButton" "0"
Option "LBCornerButton" "3"
}}}
* Options affecting scrolling:
You can either use edge scrolling or two-finger scrolling (as in Mac OS X) but you won't generally want to use both.
* Scrolling speed
The following options affect how far you have to move your finger across the touchpad to affect a scroll. Smaller values should make scrolling faster.
{{{
Option "VertScrollDelta" "20"
Option "HorizScrollDelta" "50"
}}}
* Edge scrolling
The following options toggle whether moving a finger along an edge of the touchpad invokes scrolling. Set to 0 to disable.
{{{
Option "HorizEdgeScroll" "1"
Option "VertEdgeScroll" "1"
}}}
* Two-finger scrolling
The following options toggle whether moving two fingers horizontally or vertically over the touchpad invokes scrolling. Set to 0 to disable.
{{{
Option "VertTwoFingerScroll" "1"
Option "HorizTwoFingerScroll" "1"
}}}
* Additional useful information
* Firefox horizontal scrolling behavior
With two finger scrolling enabled, you will probably want to change Firefox's horizontal scrolling behavior. To do so, open Firefox, go to the URL "about:config", and change the following settings:
{{{
mousewheel.horizscroll.withnokey.action from 2 to 0
mousewheel.horizscroll.withnokey.numlines from -1 to 1
}}}
* Disable the touchpad temporarily while typing
It is useful to have the touchpad not use click or scroll events while you are typing. The information for this was found [http://ubuntu.wordpress.com/2006/09/20/disable-touchpad-temporarily-when-typing/ here]. Make syndaemon start up by default each time you login, add it to the list of Startup Programs in System->Preferences->Sessions. Add the following command:
{{{
syndaemon -t -d
}}}

'''Restart X for changes to take effect with Ctrl-Alt-Backspace'''

=== Examples ===
* Example 1
With the following settings, two finger scrolling is enabled as in Mac OS X. Right-click is done by tapping the bottom-left corner of the touchpad, and middle-click is done by tapping the bottom-right corner of the touchpad.
{{{
Section "InputDevice"
Identifier "Synaptics Touchpad"
Driver "synaptics"
Option "SendCoreEvents" "true"
Option "Device" "/dev/psaux"
Option "Protocol" "auto-dev"
Option "SHMConfig" "true"
Option "LeftEdge" "150"
Option "RightEdge" "1070"
Option "TopEdge" "100"
Option "BottomEdge" "310"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "MaxDoubleTapTime" "180"
Option "LockedDrags" "off"
Option "MinSpeed" "1.10"
Option "MaxSpeed" "1.30"
Option "AccelFactor" "0.08"
Option "TapButton1" "0"
Option "TapButton2" "0"
Option "TapButton3" "0"
Option "RTCornerButton" "0"
Option "RBCornerButton" "2"
Option "LTCornerButton" "0"
Option "LBCornerButton" "3"
Option "VertScrollDelta" "20"
Option "HorizScrollDelta" "50"
Option "HorizEdgeScroll" "0"
Option "VertEdgeScroll" "0"
Option "VertTwoFingerScroll" "1"
Option "HorizTwoFingerScroll" "1"
EndSection
}}}
* Example 2
With the following settings the Synaptics Touchpad configuration should be closer to Mac OS X. Right-click using a two-finger tap and scroll by moving two fingers across the touchpad.
{{{
Section "InputDevice"
Identifier "Synaptics Touchpad"
Driver "synaptics"
Option "SendCoreEvents" "true"
Option "Device" "/dev/psaux"
Option "Protocol" "auto-dev"
Option "SHMConfig" "true"
Option "LeftEdge" "10"
Option "RightEdge" "1200"
Option "TopEdge" "10"
Option "BottomEdge" "370"
Option "FingerLow" "10"
Option "FingerHigh" "20"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "SingleTapTimeout" "100"
Option "MaxDoubleTapTime" "180"
Option "LockedDrags" "off"
Option "MinSpeed" "1.10"
Option "MaxSpeed" "1.30"
Option "AccelFactor" "0.08"
Option "TapButton1" "1"
Option "TapButton2" "3"
Option "TapButton3" "2"
Option "RTCornerButton" "0"
Option "RBCornerButton" "0"
Option "LTCornerButton" "0"
Option "LBCornerButton" "0"
Option "VertScrollDelta" "20"
Option "HorizScrollDelta" "50"
Option "HorizEdgeScroll" "0"
Option "VertEdgeScroll" "0"
Option "VertTwoFingerScroll" "1"
Option "HorizTwoFingerScroll" "1"
EndSection
}}}

== DVI Output (gutsy) ==
[http://www.thinkwiki.org/wiki/Installing_Ubuntu_6.06.1_on_a_ThinkPad_R60e#Ubuntu_7.10_with_Intel_Graphics_Media_Accelerator_950 These instructions] worked perfectly for setting DVI output on my MacBook.

[http://ubuntu-tutorials.com/2007/11/25/extended-video-on-the-macbook-xrandr-ftw/ extended display] - These instructions worked for me. A little more to the point than the above link.

Warning: Screen and Graphics Preferences is currently dangerous. It completely broke my /etc/X11/xorg.conf on my first reconfiguration attempt.

== Misc ==
This is useful if you already have too many partitions on your macbook and want to put the swap file directly on the main / partition.
{{{
dd if=/dev/zero of=/swapfile bs=1024 count=2048000
mkswap /swapfile
swapon /swapfile
edit fstab:
/swapfile swap swap defaults 0 0
}}}

Note: You can use suspend on disk with a swapfile. To do that we have to add an option passed to the kernel. Add the resume=/dev/<partition> resume_offset=<offset to the swapfile in blocks> :
{{{
sudo filefrag -v /swapfile
#output : First block: 102300
}}}
Copy the first block number of the swapfile (ex:102300) and edit the defoptions line of /boot/grub/menu.lst :
{{{
# defoptions=quiet splash resume=/dev/sda3 resume_offset=102300
}}}
The update your grub configuration :
{{{
sudo update-grub
}}}
On this example, the swapfile is on partition /dev/sda3.
You are now able to use suspend on disk (hibernate).

----
References:
* [http://www.apple.com/macbook/ Apple - MacBook]
* [http://doc.gwos.org/index.php/UbuntuOnApple Ubuntu on Apple - Mac Mini]
* [http://bin-false.org/?p=17 /bin/false –help » Installing Ubuntu Linux on a MacBook (Dual Boot)]
* [http://modular.math.washington.edu/macbook/ Mactel: Linux on the MacBook Pro]
* [http://ubuntuforums.org/showthread.php?t=198453 Ubuntu on MacBook Pro - Ubuntu Forums]
* [https://wiki.ubuntu.com/MacBookProFeisty (k)ubuntu fiesty 7.04 on a MacBookPro]
* [http://www.mactel-linux.org/wiki/Dual_Booting Dual Booting - Mactel-Linux]
* [http://ubuntuforums.org/showthread.php?t=225621 Built-in iSight Howto, Intel Mac ( iMac, Macbook ) - Ubuntu Forums]
* [http://ubuntu-tutorials.com/2007/08/02/installing-ubuntu-on-a-macbook-tutorial-beta/ Nearly Complete Installation Tutorial]

* [http://modular.math.washington.edu/macbook/suspend2/ suspend2]

[[Categoría:Instalación avanzada]]

Guía de empaquetamiento/Completa

2008-06-26T14:39:58Z

Festor: /* Construyendo el paquete fuente */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

Si no tienes una clave GPG configurada en el sistema recibirás un error del debuild. Puedes crear e instalar una clave GPG o usar las variables -us -uc con debuild para no firmar digitalmente el paquete. Sin embargo, no serás capaz de subir tus paquetes a Ubuntu sin firmarlos.

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-26T10:45:59Z

Festor: /* Construyendo el paquete */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *deb

==== Construyendo el paquete fuente ====

Ahora, una vez que hemos analizado los archivos del directorio debian en profundidad, podemos construir el paquete fuente (y también los paquetes binarios). Primero vamos a movernos al directorio principal en el que extrajimos el código fuente para construir el paquete usando debuild:

debuild -S

Este comando hace que el sistema tome como referencia el .orig.tar.gz para crear un archivo .dsc que contiene la descripción y el md5sum para el paquete funete y un archivo .diff.gz en el cual se compara el código fuente comprimido (.orig.tar.gz) con el descomprimido en donde se haya la carpeta debian/. Los archivos .dsc y *_source.changes ) usados para subir el paquete fuente serán firmados usando tu llave GPG.

La variable -S le dice al debuild que construya el paquete fuente usando los scripts dpkg-buildpackage y fakeroot para poder simular privilegios de administrador (root) cuando se construye el paquete.

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-26T10:05:36Z

Festor: /* rules */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

Hay otro archivo, compat el cual contiene el número de la versión de los scripts debhelper. De vez en cuando se publican nuevas versiones del debhelper, la versión actual es la 6 (en Ubuntu 8.04). Si se introduce una versión más antigua entonces los scripts debhelper puede que funcionen ligeramente diferente.

==== Construyendo el paquete ====

Ya estas listo para construir le paquete. Para ello simplemente ejecutaremos el comando:

debuild

Debuild comprobará primero si el paquete build-depends está instalado, luego usará dpkg-buildpackage para compilar, instalar y construir el o los paquetes deb usando las indicaciones del archivo debian/rules. Si todo está bien debuild intentará firmar digitalmente el/los paquete/s con GPG, si te da un error de que no ha encontrado ninguna llave GPG significa que se ha creado correctamente el paquete deb pero tu no tienes una llave GPG con el mismo nombre y e-mail que el que usaste en el archivo debian/changelog.

Tu nuevo paquete debería estar en el direcotorio superior al código fuente. Échale un vistazo e instalalo:

cd ..
lesspipe *deb
sudo dpkg --install *deb

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-26T06:49:55Z

Festor: /* rules */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

Vamos a analizar el archivo con más detalle. La primera parte que puedes ver es la declaración de algunas variables:

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

En esta sección se exponen las banderas para el compilador y también se indica las opciones noopt para la información de depuración (debugging).

Ahora vamos a ver la sección build

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

Estos comandos ejecutan el famoso ./configure con las variables adecuadas, luego ejecutan make y luego hacen un registro de la construcción para prevenir compilaciones múltiples erróneas.

Las siguientes instrucciones corresponden a la sección clean en la cual se ejecuta make -i distclean eliminando todos los archivos que se crean durante la construcción del paquete:

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

Lo próximo que veremos será unas instrucciones binary-indep vacías. Algunos paquetes se crean independientes de una arquitectura especifica (como 32 o 64 bits) si no contienen archivos que necesiten de un compilador. La mayoría de los programas python o de temas de escritorio son ejemplos de esto, sus paquetes terminan siempre en _all.deb.

hello es un programa escrito en C por lo que necesita de un compilador para funcionar y el resultado será un código binario diferente para cada plataforma, sus paquetes pueden terminar en _i386.deb o _amd64.deb principalmente. Para estos paquetes dependientes de una arquitectura se usa el campo binary-arch:

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

Aquí se ponen en funcionamiento una serie de scripts debhelper que crean nuestros paquetes deb. dh_testdir y dh_testroot hacen algunas comprobaciones de la estructura. dh_installdocs y dh_installchangelogs instala los archivos que especifiques en los archivos *.doc y *.changelog. dh_strip tomará la información de depuración (debugging symbols) y la apartará de la aplicación reduciendo drásticamente su tamaño. dh_compress ejecuta gzip (un compresor de consola) para comprimir alguna documentación. dh_shlibdeps añade las librerías dependientes al campo "Depends: ${shlibs:Depends}" en el archivo debian/control. Finalmente dh_builddeb construye nuestro archivo .deb. Tranquilo, no te debes preocupar mucho acerca de estos scripts, normalmente crean el paquete sin problemas.

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-26T05:37:34Z

Festor: /* rules */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules. Este, prácticamente, hace todo el trabajo para crear nuestro paquete deb. Es un Makefile con instrucciones para compilar e instalar la aplicación, luego crear el archivo .deb a partir de los archivos instalados. También tiene instrucciones para reevertir la compilación&instalación eliminando todos los archivos originales y así poder volver a disponer solo del código fuente.

Aquí tenemos una versión simplificada del rules creado por dh-make:

#!/usr/bin/make -f (-)

package = hello

CC = gcc
CFLAGS = -g -Wall

ifeq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O2
endif

#export DH_VERBOSE=1

clean:
dh_testdir
dh_clean
rm -f build
-$(MAKE) -i distclean

install: build
dh_clean
dh_installdirs
$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr \
mandir=$(CURDIR)/debian/$(package)/usr/share/man \
infodir=$(CURDIR)/debian/$(package)/usr/share/info \
install

build:
./configure --prefix=/usr
$(MAKE) CC="$(CC)" CFLAGS="$(CFLAGS)"
touch build

binary-indep: install
# There are no architecture-independent files to be uploaded
# generated by this package. If there were any they would be
# made here.

binary-arch: install
dh_testdir -a
dh_testroot -a
dh_installdocs -a NEWS
dh_installchangelogs -a ChangeLog
dh_strip -a
dh_compress -a
dh_fixperms -a
dh_installdeb -a
dh_shlibdeps -a
dh_gencontrol -a
dh_md5sums -a
dh_builddeb -a

binary: binary-indep binary-arch

.PHONY: binary binary-arch binary-indep clean checkroot

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-25T21:09:45Z

Festor: /* Empaquetando desde el código fuente */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor -f ../archivo_comprimido_que_contiene_el_código_fuente

El parámetro ''-f'' seguido del ''../archivo_comprimido_que_contiene_el_código_fuente'' se utiliza para generar una copia de respaldo del código fuente con la etiqueta '''orig''' si disponemos de un tarball con el código fuente original.

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

Nos preguntara que tipo de paquete queremos crear:

* La opción "s" para programas que generen un sólo paquete deb. Normalmente es la opción más utilizada.
* La opción "m" genera más de un paquete deb (por ejemplo los juegos que tienen 2 paquetes juego.deb y juego-data.deb)
* La opción "l" para librerías
* La opción "k" se utiliza para módulos del kernel linux (algo que un empaquetador común no suele usar)
* La opción "b" utiliza el programa cdbs para generar el archivo rules del paquete deb. Es una opción normalmente indicada para gente con experiencia en la empaquetamiento, aunque puede ser muy util para la que no quiera complicarse la vida.

Se pueden añadir las opciones "-s", "-m", "-l", "-k" "-b" detrás del email para responder directamente a esta pregunta.

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules.

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-25T21:06:02Z

Festor: /* copyright */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor

Una vez ejecutado dh_make este te preguntará varios aspectos sobre tu futuro paquete:

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

Como ya puedes imaginar hello se libera bajo la licencia GPL. En este caso es muy sencillo copiar el archivo copyright del paquete hello de Ubuntu:

cp ../../ubuntu/hello-debhelper-2.2/debian/copyright .

Dese cuenta que el archivo copyright del paquete hello de Ubuntu incluye la declaración de la licencia para el manual. Es importante que todos los archivos del código fuente estén declarados bajo una licencia.

Más información, consejos y soluciones están disponibles en la sección Copyright.

==== rules ====

El último archivo que vamos a necesitar es el rules.

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-25T20:56:44Z

Festor: /* copyright */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor

Una vez ejecutado dh_make este te preguntará varios aspectos sobre tu futuro paquete:

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright: Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License: (Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.

Guía de empaquetamiento/Completa

2008-06-25T20:56:26Z

Festor: /* copyright */

{{en desarrollo|Festor}}

== Introducción ==

¡Bienvenido a la '''Guía de Empaquetamiento para Ubuntu'''! Esta guía pretende ser un de las principales referencias para aquellos que deseen construir y mantener paquetes Deb para [[Ubuntu]]. Asimismo muchos de los conceptos de esta guía podrían ser usados para hacer paquetes binarios para uso personal, está diseñada para aquellos que quieran distribuir sus paquetes. Aunque está orientada a la distribución GNU/Linux Ubuntu, debería ser al menos útil para cualquier distribución basada en [[Debian]].

Hay varias razones por las que querrías aprender a empaquetar para Ubuntu. La primera, crear y arreglar paquetes *buntu es una gran forma de contribuir a la comunidad Ubuntu. También un buen camino para aprender cómo funciona Ubuntu y las aplicaciones que tienes instaladas. Quiźas quieras instalar un programa que no esté en los repositorios de Ubuntu. Ojalá después de que completes está guía tengas los suficientes conocimientos y herramientas para realizar todas estas cosas.

=== Por dónde empezar ===

Si eres completamente nuevo en la creación de paquetes deb entonces deberías leerte esta guía de principio a fin, prestando especial atención a las secciones '''[[#Requisitos|Requisitos]]''' y '''[[#Empaquetado básico|Empaquetado básico]]'''. Gente con cierta experiencia en el tema encontrará cosas más útiles en la secciones '''[[#Empaquetado|Empaquetado]]''' y '''[[#Errores comunes|Errores comunes]]'''.

=== Requisitos ===

Esta guía asume que el lector tiene un conocimiento razonable a cerca de la construcción y la instalación de software desde su código fuente en distribuciones GNU/Linux. Además usaremos la [[Interfaz de Línea de Comandos]] (CLI en inglés) así que deberías defenderte bastante bien usando una [[terminal]]. Deberías ser capaz de usar al menos las siguientes herramientas:

* '''make''': GNU Make es una herramienta de construcción de software muy importante. Se usa para transformar una tarea de compilación compleja en algo trivial. Es muy importante que sepas usarlo, ya que desviaremos mucha de la información del proceso de empaquetamiento en un Makefile. La documentación está disponible en la web de GNU.

* '''./configure''': Este script se incluye en casi todos los códigos fuente de programas para GNU/Linux, especialmente en programas escritos en lenguajes de programación compilados tales como C y C++. Se usa para generar un Makefile (archivo usado por make) adaptado a su sistema. Las herramientas estándar de empaquetamiento de Debian lo usan, así que es importante que sepas qué hace el script '''configure'''. Información sobre ./configure puede consultarse en la documentación del make.

* '''[[apt]]/[[dpkg]]''': Más allá del uso básico de instalar programas, apt y dpkg tienen muchas características que los hacen muy útiles para empaquetar.

:* <code>apt-cache dump</code> - lista cada paquete en el cache. Este comando es especialmente util en combinación con grep. Un ejemplo apt-cache dump |grep foo buscará aquelos paqetes cuyos nombres o dependencias incluyan la palabra foo.

:* <code>apt-cache policy</code> - lista el repositorio (main/restricted/universe/multiverse) en cual existe el paquete.

:* <code>apt-cache show</code> - mostrar información acerca de un paquete binario

:* <code>apt-cache showsrc</code> - mostrar información acerca de un código fuente

:* <code>apt-cache rdepends</code> - muestra las dependencias invertidas para un paquete

:* <code>dpkg -S</code> - lista el/los paquete/s binario/s al cual/es pertenece un archivo en particular

:* <code>dpkg -l</code> - lista los paquetes que tengas instalados en el sistema

:* <code>dpkg -c</code> -lista el contenido de un paquete binario. Es util para asegurarse de que los archivos se instalan en los lugares correctos.

:* <code>dpkg -f</code> muestra el archivo control de un paquete binario. Es útil para asegurarse de que las dependencias son correctas.

:* <code>grep-dctrl</code> - busca información especializada en los paquetes. Es un uso específico de la herramienta grep (pero no instalado por defecto)

* '''diff''' y '''patch''':

:* El programa diff se puede usar para comparar 2 archivos y de este modo crear parches. Un ejemplo típico podría ser:

diff -ruN archivo.antiguo archivo.nuevo > archivo.diff

Este comando creará un archivo <code>.diff</code> que mostrará los cambios entre 2 archivos.

:* El programa patch es usado para aplicar un parche (normalmente creado por diff o otro programa similar). Para aplicar el parche utiliza el comando:

patch -p0 < archivo.diff

El parámetro <code>-p</code> le dice a patch cómo debe formatear los nombres de archivo en el parche. La opción -p0 significa que deja el parche intacto.

== Empezando ==

=== Paquetes binarios y paquetes fuente ===

La mayoría de los usuarios de una distribución basada en Debian como Ubuntu nunca van a tener que tratar con el código fuente que se usa para crear todos los programas que usen en sus ordenadores. En vez de eso, el código fuente se compila en paquetes binarios a partir de un paquete fuente que contiene ambos: el código fuente en sí mismo y las instrucciones para crear el paquete binario. Los mantenedores de paquetes suben el código fuente con los cambios a sistemas de empaquetado que compilan los paquetes binarios para cada arquitectura. Un sistema independiente distribuye los archivos binarios .deb generados y el código fuente con las instrucciones a cada repositorios espejo.

=== Herramientas de empaquetado ===

Hay muchas herramientas escritas específicamente para empaquetar en sistemas basados en Debian. Muchas de ellas no fueron creadas con la intención de empaquetar programas pero son realmente útiles y suelen automatizar tareas repetitivas. Sus páginas man e info son buenas fuentes de información. Sin embargo, la lista de paquetes son extremadamente necesarios para comenzar a empaquetar.

* '''build-essential''' es un metapaquete que depende de <code>libc6-dev</code>, <code>[[GCC|gcc]]</code>, <code>[[GCC|g++]]</code>, <code>make</code> y <code>dpkg-dev</code>. Uno de los paquetes con los que podrías no estar familiarizado es <code>dpkg-dev</code>. Este contiene herramientas de la talla de <code>dpkg-buildpackage</code> y <code>dpkg-source</code> que se usan para crear, desempaquetar y construir paquetes binarios o fuentes.

* '''devscripts''' contiene muchos scripts que facilitan considerablemente la tareas de un mantenedor de paquetes. Algunos de los más usados son <code>debdiff</code>, <code>dch</code>, <code>debuild</code> y <code>debsing</code>.

* '''ubuntu-dev-tools''' también contiene una colección de scripts (al igual que devscripts), pero específicos para Ubuntu. Contiene herramientas como <code>update-maintainer</code>, <code>dgetlp</code>, <code>what-patch</code>, <code>pbuilder-dist</code>, etc.

* '''debhelper''' son un conjunto de scripts que realizan tareas comunes de empaquetado.

* '''dh-make''' se usa para crear una plantilla para tu futuro paquete.

* '''diff''' y '''patch''' se usan para crear y aplicar parches, respectivamente. Su uso está muy extendido ya que son faciles de usar, limpios y más eficientes que modificar el código fuente a lo bruto.

* '''quilt''' administra los parches.

* '''gnupg''' es un completo y libre reemplazo para PGP usado para firmar digitalmente archivos (incluyendo paquetes).

* '''fakeroot''' simula ejecutar comandos con privilegios de root. Es útil para crear paquetes binarios para uso personal.

* '''lintian''' y '''linda''' diseccionan paquetes Debian y avisan de errores y violaciones de la normativa. Contienen autómatas que revisan muchos aspectos de la Normativa Debian así como otros errores comunes. linda no está disponible desde los repositorios de Ubuntu 8.04, pero aún está disponible en repositorios de lanzamientos anteriores.

* '''pbuilder''' crea un sistema chroot y construye un paquete en el mismo. Es un sistema ideal para comprobar si un paquete se realiza correctamente, revisar sus dependencias y construir paquetes para probar y distribuir.

=== Empaquetador personal: pbuilder ===

Usar '''pbuilder''' como un constructor de paquetes te permitirá crear paquetes sin necesidad de un entorno chroot. Puedes construir paquetes sin usar pbuilder, pero tendrás todas las dependencias instaladas en tu sistema muchas de las cuales no necesitarías (librerías de desarrollo y similares). Sin embargo, pbuilder permite al empaqeutador comprobar las dependencias de constucción ya que el paquete se construye con una instalación mínima de Ubuntu, y las dependencias de construcción serán descargadas de acuerdo con el archivo debian/control.

Un manual de uso rápido:

* Para crear un entorno pbuilder, ejecuta:

sudo pbuilder create --distribution <versión de ubuntu> \
--othermirror "deb http://archive.ubuntu.com/ubuntu <versión de ubuntu> main restricted ubiverse multiverse"

* Para construir un paquete usando pbuidler, ejecuta:

sudo pbuilder build *.dsc

* Para actualizar un entorno pbuilder, ejecuta:

sudo pbuilder update

* Usa ''pbuidler-dist'' (del paquete <code>ubuntu-dev-tools</code>) para tener distintas instalaciones de pbuidler para las diferentes lanzamientos de Ubuntu.

== Empaquetado básico ==

Dos de los problemas a los que se enfrentan la mayoría de los nuevos empaquetadores son las múltiples formas de crear paquetes deb y el hecho de que existan diversas herramientas para hacer lo mismo.

El desarrollo de un paquete suele necesitar de la instalación de muchos otros paquetes (especialmente paquetes ''-dev'' que contiene las cabeceras (headers) y otros archivos comunes de desarrollo) que no forman parte de una instalación normal de escritorio de Ubuntu. Si quieres evitar la instalación de paquetes extra o deseas desarrollar para una versión de Ubuntu distinta a la que usas (la versión en desarrollo por ejemplo) el uso de un entorno chroot es altamente recomendable.

Vamos a exponer dos ejemplos de sistemas de construcción comunes. Usaremos debhelper, el sistema de construcción más popular en Debian. Este ayuda al empaquetador automatizando tareas repetitivas. Luego vamos a cubrir brevemente el Sistema de Construcción Común para Debian (''Common Debian Build System'', CDBS) un sistema más automatizado que utiliza debhelper.

=== Empaquetando desde el código fuente ===

Requerimientos: <code>build-essential</code>, <code>automake</code>, <code>gnupg</code>, <code>lintian</code>, <code>fakeroot</code>, <code>pbuilder</code>, <code>debhelper</code> y <code>dh-make</code>.

Usaremos el programa GNU hello como ejemplo. Puedes descargarte el tarball del código fuente desde ftp.gnu.org. Para el propósito de este ejemplo, usaremos el directorio <code>~/hello/</code>.

mkdir ~/hello/
cd ~/hello/
wget http://ftp.gnu.org/gnu/hello/hello-2.1.1.tar.gz

Si estás empaquetando tu propio código fuente o el programa no está disponible en un archivo .tar.gz, puedes crear el archivo .tar.gz necesario desde el directorio que lo contenga con el siguiente comando:

tar czf hello-2.1.1.tar.gz hello-2.1.1

Para el propósito de este ejemplo, también compararemos nuestro paquete (<code>hello</code>) con uno que ya está empaquetado en el repositorio de ubuntu (bajo el nombre <code>hello-debhelper</code>). Por ahora nos centraremos en el directorio <code>hello</code> así que podremos mirar el paquete de los repositorios despues. Para conseguir el código fuente, asegúrate de tener una línea «deb-src» del repositorio principal en tu <code>/etc/apt/sources.list</code>. Entonces simplemente ejecuta:

mkdir ubuntu/
cd ubuntu/
apt-get source hello-debhelper
cd ..

A diferencia de la mayoría de los comandos apt-get, no necesitaras privilegios de administrador (root) para conseguir el paquete fuente, ya que se descarga en el directorio actual. De echo, es recomendable que sólo uses <code>apt-get source</code> como usuario normal, ya que de esta forma puedes editar archivos en el paquete fuente sin necesidad de privilegios de administrador. El comando <code>apt-get source</code>:

* Descarga el paquete fuente. Un paquete fuente normalmente contiene un archivo <code>.dsc</code> que describe el paquete y proporciona el md5sums para el paquete fuente, un archivo <code>.orig.tar.gz</code> que contiene el código fuente del autor/es del programa, un archivo <code>.diff.gz</code> que contiene las instrucciones de empaquetado (en el directorio <code>debian/</code>) y los parches que se aplicarán en el código fuente.

* Descomprime el archivo <code>.orig.tar.gz</code> en el directorio actual.

* Aplica el <code>.diff.gz</code> al directorio del código fuente.

Si te has descargado manualmente el paquete fuente (los archivos <code>.dsc</code>, <code>.orig.tar.gz</code> y <code>.diff.gz</code>) puedes desempaquetarlos de la misma manera que el <code>apt-get source</code> con el comando:

dpkg-source -x *.dsc

Nosotros queremos recrear lo anterior desde el código fuente. Lo primero que necesitaras es hacer una copia (algunas veces llamado «upstream») del tarball de forma que quede con el siguiente formato: <code><paquete>_<versión>.orig.tar.gz</code>. Con esto conseguir crear una copia del código fuente por si accidentalmente cambias o eliminas algo en el que estas trabajando. También debemos tener en cuenta que se considera una forma de actuar no muy aceptada modificar el código fuente original a menos que sea absolutamente necesario.

cp hello-2.1.1.tar.gz hello_2.1.1.orig.tar.gz
tar -xzvf hello_2.1.1.orig.tar.gz

La línea baja «_». entre el nombre del paquete (''hello'') y la versión (''2.1.1''), como opuesto de la línea alta «-», es muy importante. Las herramientas de empaquetado buscarán un archivo con ese nombre exacto. Si Si te equivocas, las herramientas asumirán incorrectamente que no hay código fuente original y el código fuente será construido como un paquete nativo de Debian.

Ahora tenemos un directorio hello que contiene los archivos del código fuente. Ahora necesitamos crear un directorio debian donde almacenaremos toda la información para construir el paquete, permitiendo serpara los archivos del paquete de los archivos del código fuente del programa. Usaremos dh_make para que cree el directorio debian con todos los archivos:

cd hello-2.1.1
dh_make -e tu.dirección.de.correo.electrónico.como@mantenedor

Una vez ejecutado dh_make este te preguntará varios aspectos sobre tu futuro paquete:

Type of packager single binary, multiple binary, libreary, kernel module or cdbs? [s/m/l/b] s

Maintainer name : Tu nombre
Email-Address : tu.dirección.de.correo.electrónico.como@mantenedor
Date: Thu, 6 Aprt 2008 10:07:19 -0700
Package Name : hello
Version : 2.1.1
License : blank
Type of Package : Single
Hit <enter> to confirm: Enter

El comando dh_make sólo se debe ejecutar una única vez. Si lo ejecutas más de una vez en el mismo directorio no funcionará correctamente. Si quieres cambiar o cometiste un error, elimina el directorio fuente y descomprime el tarball original de nuevo. Luego repite el proceso en el nuevo directorio.

Al ejecutar dh_make este crear los archivos básicos en el directorio debian/ y algunos archivos plantilla (.ex) que quizas puedan ser necesarios o no. El programa Hello no es muy complicado, y una vez vista la sección "Empaquetar desde la fuente", sus requerimientos no pasan de los archivos básicos. Por ello, procederemos a eliminar los archivos .ex:

cd debian
rm *.ex *.EX

Para hello, tampoco necesitaras algunos archivos del directorio debian:

*README.Deban: El archivo README concreta aspectos del paquete Debian, NO es el archivo README del programa.
*dirs : Usado por dh_installdirs para crear los directorios necesarios.
*docs : Usado por dh_installdocs para instalar la documentación del programa.
*info : Usado por dh_installinfo para instalar el archivo info.

Ten en cuenta que para la mayor parte de los paquetes estos archivos son necesarios. Para más información sobre ellos consulta la sección llamada "archivos de ejemplo dh_make"

Llegados a este pinto deberías tener en el directorio debian/ sólo los archivos changelog, compat, copyright y rules.

==== changelog ====

El archivo changelog, como su nombre indica, es una lista de cambios que se hacen en cada versión. Tiene un formato específico que proporciona el nombre del paquete, la versión, la distribución, los cambios, quien hizo el paquete y cuando lo hizo. Si tienes una llave GPG, asegúrate de usar el mismo nombre y e-mail en el changelog respecto al de tu llave. Lo siguiente es un ejemplo del contenido de un archivo changelog:

nombre_del_paquete (versión) distribución; urgency=prioridad/urgencia

* Detalles sobre los cambios
Más detalles sobre los cambios

* Aún más detalles sobre los cambios

-- Nombre del mantenedor <correo.electrónico> fecha_de_creación_del_paquete

El formato (especialmente el de la fecha) es importante. la fecha debe estar en formato RFC822 el cual se puede obtener usando el comando date -R . Tal y como veremos más adelante, el script dch te evitar preocuparte por la fecha.

Aquí tenéis un ejemplo del archivo changelog para hello:

hello (2.1.1-0ubuntu1) hardy; urgency=low

* Nueva versión con muchos errores corregidos

-- Capki Lerrenl Fontain <packager@coolness.com> Wed, 5 Apr 2006

Fíjate que la versión tiene un apéndice -0ubuntu1, esta es la revisión de la distribución la cual se usa para que un paquete pueda ser actualizado (para corregir errores, por ejemplo) con nuevas versiones usando la misma versión publicada del código fuente.

Ubuntu y Debian tiene cambios ligeramente diferentes en los esquemas de versiones para evitar conflictos con paquetes de la misma versión del código fuente. Si un paquete Debian ha sido cambiado en Ubuntu, este tiene ubuntuX (donde X es la revisión de Ubuntu) añadido al final de la versión de Debian. Así si el paquete Debian hello 2.1.1-1 se modifica para Ubuntu la línea de versión será 2.1.1-1ubuntu1. Si un paquete de Ubuntu no existe en Debian, la revisión Debian es 0 (por ejemplo, 2.1.1-0ubuntu1)

Ahora vemos el changelog para el paquete fuente que nos hemos descargado antes:

less ../../ubuntu/hello-debhelper-2.2/debian/changelog

Dese cuenta que en este caso la distribución a la que hace referencia es unstable (una rama de Debian), porque el paquete no ha sido cambiado por Ubuntu. Recuerda introducir el nombre de la distribución de tu elección.

==== control ====

El archivo control contiene la información que el administrador de paquetes (como dpkg, apt-get, aptitude, synaptic y adept) usa: dependencias necesarias, información del mantenedor y muchas cosas más.

Para el paquete hello de Ubuntu, el archivo control verás algo así:

Section: devel
Priority: optional
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
XSBC-Original-Maintainer: Captain Packager <packager@coolness.com>
Standards-Version: 3.7.3
Build-Depends: debhelper (>= 5)
Homepage: http://www.gnu.org/software/hello/

Package: hello
Architecture: any
Depends: ${shlibs:Depends}
Description: The classic greeting, and a good example
The GNU hello program produces a familiar, friendly greeting. It
allows non-programmers to use a classic computer science tool which
would otherwise be unavailable to them. . Seriously, though: this is
an example of how to do a Debian package. It is the Debian version of
the GNU Project's `hello world' program (which is itself an example
for the GNU Project).

En Ubuntu se introduce en el campo de Maintainer (Mantenedor) normalmente un nombre y e-mail general ya que cualquiera puede contribuir modificando el paquete, previa revisión de los MOTU (esta es una diferencia respecto a Debian donde las modificaciones de los paquetes normalmente se asignan a equipos o personas individuales).

Edita el archivo control usando la información de arriba (asegúrate de proporcionar la información del empaquetador original de Debian para el campo XSBC-Original-Maintainer).

Ok, vamos a empezar a describir línea por línea el primer párrafo que describe el paquete fuente.

* '''Source:''' Indica el nombre del código fuente. Simplemente no tocar a menos que sepas lo que estas haciendo.
* '''Section:''' Indica la categoría del paquete dentro de un repositorio apt que es reconocida por gestores de paquetes como Synaptic o Adept, pero esto no tiene nada que ver con la categoría del menú de Gnome o KDE.

Las categorías disponibles son (puede faltar alguna):

{| border="1" cellpadding="4" cellspacing="0"
|- style="background: #E0C58B; font-size: 130%; text-align: left;"
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
! Nombre
! width="130px" | Descripción
|-
| '''admin'''
| Administración del sistema
| '''kde'''
| Escritorio KDE
| '''shells'''
| Shells
| '''graphics'''
| Gráficos
|-
| '''base'''
| Sistema base
| '''libs'''
| Librerías
| '''sound'''
| Sonido y vídeo
| '''comm'''
| Comunicación
|-
| '''libdevel'''
| Librerías de desarrollo
| '''tex'''
| TeX, autoría
| '''contrib'''
| Contrib
| '''mail'''
| Correo electrónico
|-
| '''utils'''
| Utilidades/Herramientas
| '''devel'''
| Desarrollo
| '''math'''
| Matemáticas
| '''web'''
| Web (World Wide Web)
|-
| '''doc'''
| Documentación
| '''misc'''
| Miscelaneaos - Basados en texto
| '''x11'''
| Misceláneos - Gráficos
| '''editors'''
| Editores
|-
| '''net'''
| Redes
| '''interpreters'''
| Lenguajes de ordenador interpretados
| '''electronics'''
| Electrónica
| '''news'''
| Grupos de noticias
|-
| '''science'''
| Ciencia
| '''embedded'''
| Dispositivos integrados
| '''non-free'''
| No libre
| '''hamradio'''
| Radio
|-
| '''games'''
| Juegos
| '''oldlibs'''
| Librerías antiguas
| '''python'''
| Lenguaje de programación Python
| '''gnome'''
| Escritorio Gnome
|-
| '''otherosfs'''
| Plataformas cruzadas
| '''perl'''
| Lenguaje de programación Perl
|
|
|
|
|}

* '''Priority:''' Indica la prioridad del paquete en el sistema. Hay las siguientes opciones:
** '''Required''' : paquetes esenciales para que el sistema trabaje adecuadamente. Si son eliminados hay un alto riesgo de que el sistema quede inutilizarle o se rompa.
** '''Important''' : Un conjunto mínimo de paquetes para que un sistema sea usable. Eliminar estos paquetes no produce un quiebro irrecuperable de tu sistema, pero generalmente se consideran herramientas importantes sin las cuales la instalación de Linux sería incompleta. Nota: Esto no incluye cosas como Emacs o incluso el servidor X.
** '''Standard''' : Poca explicación hay sobre ella.
** '''Optional''' : en esencia esta categoría es para los paquetes no-requeridos, o la mayor parte de los paquetes. Sin embargo, estos paquetes no deberían presentar ningún conflicto con otros.
** '''Extra''' : paquetes que pueden presentar conflictos con otros paquetes en alguna de las categorías anteriores. También se usa para paquetes especializados que deberían ser únicamente útiles para aquellos quienes ya saben de ante mano el propósito del paquete/programa.

* '''Maintainer:''' Muestra el nombre del empaquetador y su correo electrónico de contacto en caso de algún problema con el paquete u otras cosas. El correo electrónico no tiene porque ser uno personal, es más si no se quiere dar basta con modificarlo con algo como email@email.com.

Eso sí, a la hora de firmar los paquetes con claves GPG (no es siempre necesario) el correo electrónico sirve entre otras cosas para identificar la clave con la que se va a firmar.

* '''Standards-Version:''' Especifica la versión de la [http://www.debian.org/doc/debian-policy/ Normativa de Debian (Debian policy)] que sigue el paquete. Esta es propia de cada versión de Ubuntu y por ello los paquetes deb deben seguirla.

Para más información visitar esta web:

http://www.debian.org/doc/debian-policy/

Este manual describe los requisitos de la política para la distribución Debian/Ubuntu GNU/Linux. Esto incluye la estructura y contenidos del archivo de Debian y varios temas de diseño del sistema operativo, así como los requisitos técnicos que cada paquete debe satisfacer para ser incluidos en la distribución

Puedes averiguar la versión del Debian policy que usa tu versión de Ubuntu ejecutando este comando en una terminal:

apt-cache show debian-policy | grep Version

Por lo general no debes preocuparte por ver si la versión está bien o no ya que el dh-make lo hace automáticamente, pero si estas portando un paquete de los backports de Ubuntu o Debian a otra versión de Ubuntu es probable que necesites comprobar este campo.

* '''Build-Depends:''' Está es una parte esencial del empaquetamiento del deb y quizás una de las que pueden llegar a ser un embrollo si no sabes las dependencias del paquete.

* '''Homepage:''' Una URL donde se puede encontrar más información acerca del software.

El siguiente párrafo es para el paquete binario que será construido a partir del código fuente. Si hay más de un paquete binario que se genere del código fuente debe haber un párrafo como el que describiremos a continuación para cada uno. De nuevo, vamos a ir línea por línea:

* '''Package:''' Esto especifica el nombre del paquete deb pero no la firma ni la etiqueta de la arquitectura. Los nombres que aparezcan en Package y Source deben ser el mismo.

* '''Architecture:''' La arquitectura para la cual será construido el paquete/s. Algunos ejemplos son:
** all - El programa a empaquetar no depende de la arquitectura del sistema. Me refiero a programas hechos en Python o otros lenguajes interpretados como java. El resultado será un paquete binario cuyo nombre acabará en _all.deb.
** any - El programa a empaquetar depende de la arquitectura del sistema y debe ser compilado en todas las arquitecturas soportadas. Habrá un archivo .deb para cada arquitectura ( _i386.deb por ejemplo)

Se puede optar por una o más de un subconjunto de arquitecturas (i386, amd64, ppc, etc.) para indicar que el programa a empaquetar depende de una arquitectura concreta y no funciona para todas las arquitecturas soportadas por Ubuntu

* '''Depends:''' Esto indica al sistema las dependencias del paquete deb resultante de todo el proceso, normalmente se resuelven basándose en las dependencias de construcción (''Build-Depends'') de modo que si por ejemplo indicamos allí ''programa-dev'' automáticamente el sistema sustituirá las variables ''${shlibs:Depends}'' y/o ''${misc:Depends}'' por ''programa'' (sin el -dev).

En algunas ocasiones (empaquetamiento de programas hechos en python, java y raras excepciones) es necesario indicar manualmente las dependencias del programa. Si se diera este caso lo más normal es añadirlas después de ''${misc:Depends}'' respetando la estructura de comas.

* '''Recommends:''' Se usa para apquetes altamente recomendados y que normalmente se instalan junto al paquete. Algunos administradores de paquetes, por ejemplo aptitude, instalan automáticamente los paquetes que pongas en este campo.

* '''Suggests:''' Se usa para paquetes que son similares o útiles cuando el paquete (que crearemos) esté instalado

* '''Conflicts:''' Se usa para paquetes que presentarán problemas con este paquete. Ambos no pueden estar instalados en un mismo sistema. Si uno se instala el otro se desinstalará y viceversa.

* '''Description:''' Aquí describiremos el programa, esto es lo que se verá cuando abrás el archivo .deb con un programa como [[GDebi]] La descripción de un paquete deb se basa en dos partes:
** Un "título" de 60 letras que va directamente después de ''Description:''
** Un texto ...de unas 47 letras (no estoy seguro si se pueden más) de largo con un espacio antes de cada linea. Los espacios entre párrafos se hacen mediante un punto.

==== copyright ====

Este archivo proporciona la información de derechos de autor. Generalmente, la información de copyright se encuentra en el archivo COPYING en el directorio principal del código fuente. Este archivo se debe incluir información como el nombre del empaquetador y del creador del paquete, la URL de donde conseguimos el código fuente, la licencia con el año del Copyright. Un plantilla del archivo podría ser:

This package was debianized by (Tu nombre) <tu_correo_electrónico> (Fecha)

It was downloaded from: (URL de la web de descarga del programa)

Upstream Author(s): (Nombre(s) y e-mail(s) del (los) autor(es) del programa)

Copyright:
Copyright (C) {año(s)} por {autor(es)} {correo(s) electrónico(s)}

License:
(Añade el texto de la licencia aquí. Para las licencias GNU basta con añadir la cabecera y
enlazar al texto completo normalmente alojado en /usr/share/common-licenses.)

the Ubuntu packaging:
Copyright (C) (año(s)) por (Tu nombre) <tu_correo_electrónico> (Fecha)
released under {la licencia que quieras para tu paquete}

== Fuentes ==

* https://wiki.ubuntu.com/PackagingGuide/Complete.