From Fedora Project Wiki

Introducción

Esta página describe detalladamente cómo crear un paquete RPM y en particular, cómo crear un archivo SPEC. A diferencia de otras guías RPM, esta página explica los detalles de Fedora con enlaces a los lineamientos específicos de Fedora. Dado que es mantenida a través de la Wiki de Fedora, es probable que esté más al día que otras guías. A pesar del enfoque en Fedora, la mayor parte de este documento se aplica a otras distribuciones basadas en RPM. Si está impaciente, puede comenzar por mirar el más breve Cómo crear un paquete RPM GNU Hola.

Tenga en cuenta que estos no son los lineamientos del paquete oficial de Fedora, que puede verse en los Lineamientos de empaquetado y Lineamientos de nombrado de paquetes. Dicho esto, esta página debe ser compatible con ellos.

Si va a crear un paquete RPM para el repositorio de Fedora, siga el procedimiento para unirse a los mantenedores de la colección de paquetes.

Preparando su sistema

Antes de crear paquetes RPM en Fedora, necesita instalar algunas herramientas básicas de desarrollo y configurar la(s) cuenta(s) que va a utilizar:

# yum install @development-tools
# yum install fedora-packager

Puede crear un usuario ficticio (dummy) específicamente para crear paquetes RPM por si el proceso de construcción sale mal no podrá destruir sus archivos o enviar sus claves privadas al mundo.

Stop (medium size).png
Usted nunca debe crear los paquetes como usuario root.

Crear un nuevo usuario con el nombre makerpm, agregar el usuario al grupo 'mock', establecer una contraseña e ingresar como usuario:

# /usr/sbin/useradd makerpm
# usermod -a -G mock makerpm
# passwd makerpm

Una vez que ha iniciado la sesión como un usuario build/dummy, crear la estructura de directorios necesaria en su directorio home ejecutando:

$ rpmdev-setuptree

El programa rpmdev-setuptree creará el directorio ~/rpmbuild y una serie de subdirectorios (por ejemplo SPECS y BUILD), que va a usar para crear sus paquetes. También se crea el archivo ~/.rpmmacros, que puede utilizarse para configurar diversas opciones.

Los lineamientos de empaquetado recomiendan preservar los datos del archivo; usted puede hacer esto automáticamente si usa wget o curl para obtener los archivos fuentes. Si utiliza wget para obtener los archivos fuentes, añada el texto «timestamping = on» a ~/.wgetrc. Si usa curl, agregue el texto «-R» a ~/.curlrc.

Normalmente, no necesitará volver a realizar estos pasos.

Los fundamentos de la construcción de paquetes RPM

Para crear un paquete RPM, necesitará crear un archivo de texto «.spec» que suministre la información acerca del software que será empaquetado. Luego podrá ejecutar el comando rpmbuild sobre dicho archivo SPEC, lo que provocará ejecutar una serie de pasos para producir sus paquetes.

Normalmente, deberá colocar sus fuentes originales (prístina), archivos tales como .tar.gz provistos por los desarrolladores originales, en el directorio ~/rpmbuild/SOURCES. deberá colocar su archivo .spec en el directorio ~/rpmbuild/SPECS y asignarle el nombre «NOMBRE.spec», donde NOMBRE es el nombre base del paquete. Para crear ambos paquetes, tanto el binario como el fuente, cambie al directorio ~/rpmbuild/SPECS y ejecute:

$ rpmbuild -ba NOMBRE.spec

Cuando rpmbuild es invocado de esta manera, leerá el archivo .spec y recorrerá en orden las etapas listadas a continuación. Los nombres que comienzan con % son macros predefinidas (vea la siguiente tabla).

Etapa Lee Escribe Acción
%prep %_sourcedir %_builddir Esta lee los archivos fuentes y parches en el directorio de fuentes %_sourcedir. Se desempaquetan los archivos fuentes al subdirectorio dentro del directorio de construcción %_builddir y se aplican los parches.
%build %_builddir %_builddir Esta compila los archivos dentro del directorio de construcción %_builddir. Esto se hace a menudo implementando alguna variación de «./configure && make».
%check %_builddir %_builddir Verifica que el software funciona correctamente. Esto es usualmente implementado ejecutando alguna variación de «make test». Muchos paquetes no implementan esta etapa.
%install %_builddir %_buildrootdir Esta lee los archivos dentro del directorio de construcción %_builddir y escribe a un directorio dentro del directorio raíz de construcción %_buildrootdir. Los archivos que son escritos son los que se supone serán instalados cuando el paquete binario sea instalado por el usuario final. Tenga cuidado con esta terminología algo extraña: El directorio raíz de construcción no es lo mismo que el directorio de construcción. Esta etapa usualmente se implementa ejecutando «make install».
bin %_buildrootdir %_rpmdir Este lee los archivos dentro del directorio raíz de construcción %_buildrootdir para crear los paquetes RPM binarios dentro del directorio RPM %_rpmdir. Adentro del directorio RPM hay un directorio para cada arquitectura, y un directorio "noarch" para los paquetes que se aplican a cualquier arquitectura. Estos archivos RPM son los paquetes para que instalen los usuarios.
src %_sourcedir %_srcrpmdir Este crea un paquete fuente RPM (.src.rpm) dentro del directorio fuente RPM %_srcrpmdir. Estos archivos son necesarios para revisar y actualizar los paquetes.


Como podrá notar, algunos directorios tienen ciertos propósitos específicos en rpmbuild. Estos son:

Nombre de la macro Nombre Usualmente Propósito
%_specdir Directorio de especificación ~/rpmbuild/SPECS Archivos de especificaciones RPM (.spec).
%_sourcedir Directorio fuente ~/rpmbuild/SOURCES Paquete fuente prístina (por ejemplo, tarballs) y parches.
%_builddir Directorio de construcción ~/rpmbuild/BUILD Los archivos fuentes son desempaquetados y compilados en un subdirectorio dentro de este.
%_buildrootdir Directorio raíz de construcción ~/rpmbuild/BUILDROOT Los archivos son instalados bajo este directorio durante la etapa %install.
%_rpmdir Directorio RPM binario ~/rpmbuild/RPMS Los RPM binarios son creados y almacenados bajo este directorio.
%_srcrpmdir Directorio RPM fuente ~/rpmbuild/SRPMS Los RPM fuente son creados y almacenados bajo este directorio.

Si falla alguna etapa, tendrá que revisar la salida para ver por qué falló y deberá cambiar el archivo .spec (u otra entrada) cuando sea necesario.

Preparándose a empaquetar un programa específico

Si se requieren programas especiales para construir o ejecutar el programa que está empaquetando, instale dichos programas y anote los que son.

Al empaquetar un programa para el repositorio de Fedora, debe empaquetar los fuentes prístina (originales), junto a los parches y las instrucciones de construcción; en general no es aceptable comenzar con un código precompilado. Instale el archivo con la fuente original (usualmente un archivo .tar.gz) en el directorio ~/rpmbuild/SOURCES (de la cuenta de usuario para construcción de RPM).

Lea el manual de instrucciones para la instalación de su programa. A menudo es una buena idea hacer un «simulacro» construyendo manualmente el programa antes de intentar hacerlo a través de RPM. Con unas pocas excepciones, todos los binarios y bibliotecas incluidos en los paquetes de Fedora deben construirse desde el código fuente que se incluye en el paquete fuente.

Dividir el programa

El código fuente de la aplicación es a menudo liberado con el código fuente de otras bibliotecas externas «incluido» en ellos. No junte bibliotecas externas con la aplicación principal en un solo paquete. En cambio, divídalos en paquetes separados.

Concesión de licencias

Sólo empaquete software que sea legal en su paquete. Ver Packaging:Guidelines#Legal, Licensing:Main y Packaging:LicensingGuidelines. En general, sólo empaquete software que sea lanzado como software de código abierto (OSS) utilizando una licencia OSS aprobada (tales como las licencias GPL, LGPL, BSD-new, MIT/X, o Apache 2.0). Asegúrese de que el software realmente tiene licencia de esta manera (por ejemplo, verificar in situ los encabezados del código fuente, archivos README, etc.). Si hay bibliotecas incluidas, asegúrese de que también son OSS.

Reutilizar la información del paquete existente

Trate de reutilizar lo que se pueda. Obviamente, asegúrese de que no está empaquetando algo que ya ha sido empaquetado. Encontrará una lista de los paquetes existentes en la Colección de paquetes de Fedora en la Base de datos de paquetes de Fedora. Compruebe también las Solicitudes de revisión en progreso y la lista de Paquetes retirados. Puede utilizar los Repositorios de paquetes Git de Fedora directamente para ver los archivos SPEC (y parches). Puede descargar los SRPMS utilizando un programa desde el paquete yum-utils:

$ yum -y install yum-utils
$ yumdownloader --source nombre-paquetefuente

Alternativamente, puede obtener el código fuente manualmente desde la página http/ftp de un espejo de Fedora dentro del directorio releases/32/Everything/source/SRPMS. Reemplace «32» con la versión de Fedora que desee y descargue el paquete .src.rpm que necesita.

Una vez que tiene el SRPM, instalarlo en ~/rpmbuild:

$ rpm -ivh nombre-paquetefuente*.src.rpm

También puede desempaquetar el SRPM en un directorio usando rpm2cpio:

$ mkdir NOMBREDEPROGRAMA_src_rpm
$ cd NOMBREDEPROGRAMA_src_rpm
$ rpm2cpio ../NOMBREDEPROGRAMA-*.src.rpm | cpio -i

Algunas veces es más fácil comenzar con un paquete existente y luego limpiarlo y prepararlo para Fedora. RPM Find puede ayudarle a encontrar RPM para sistemas diferentes a Fedora. Puede instalar SRPMS de otros sistemas de la misma forma que para los de Fedora. Si eso falla, puede localizar los archivos de paquetes fuentes (no los binarios .deb) en Ubuntu o Debian (los archivos de paquetes fuentes son tarballs estándar con un subdirectorio «debian/»). Si la colección de ports FreeBSD lo tiene, podrí­a descargarlo del FreeBSD ports tarball y ver si la información de empaquetado existente le ayuda como punto de partida. Sin embargo, esto a veces no es útil para todos. Las diferentes distribuciones tienen diferentes reglas y lo que hacen en algunos casos puede ser inapropiado para Fedora.

Creando un archivo SPEC

Ahora necesita crear un archivo SPEC en el directorio ~/rpmbuild/SPECS. Debería nombrarlo de acuerdo al nombre del programa (por ejemplo «program.spec»). Use donde se pueda el nombre de archivo o el nombre publicado por el autor del software, pero asegúrese de seguir los Lineamientos de nombres de paquetes.

Plantillas de SPEC

Al crear un archivo SPEC por primera vez, vim o emacs crearán automáticamente una plantilla para usted:

 $ cd ~/rpmbuild/SPECS
 $ vim program.spec

He aquí un ejemplo de lo que se verá como plantilla (Nota: la plantilla que se ofrece no necesariamente cumple con los Lineamientos de empaquetado de Fedora):

Name:		
Version:	
Release:	1%{?dist}
Summary:	
Group:		
License:	
URL:		
Source0:	
BuildRoot:	%{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n)

BuildRequires:	
Requires:	

%description

%prep
%setup -q

%build
%configure
make %{?_smp_mflags}

%install
rm -rf %{buildroot}
make install DESTDIR=%{buildroot}

%clean
rm -rf %{buildroot}

%files
%defattr(-,root,root,-)
%doc

%changelog

Puede usar $RPM_BUILD_ROOT en lugar de %{buildroot}. Ambos son aceptables, pero sólo para ser más consistente.

También puede usar el comando rpmdev-newspec para crear un archivo SPEC para usted. rpmdev-newspec NOMBRE-DE-NUEVO-PAQUETE puede crear un archivo SPEC inicial para un nuevo paquete, adaptado a varios tipos de paquetes. Adivinará también qué tipo de plantilla utilizar basándose en el nombre del paquete, o puede especificarle una plantilla en particular. Vea las plantillas disponibles en /etc/rpmdevtools/spectemplate-*.spec, y consulte rpmdev-newspec --help para más información. Por ejemplo, para crear un nuevo archivo SPEC para un módulo python:

cd ~/rpmbuild/SPECS
rpmdev-newspec python-antigravity
vi python-antigravity.spec

Ejemplo de SPEC

He aquí un ejemplo simple que muestra un archivo SPEC de Fedora 16 para el programa eject:

Summary:            A program that ejects removable media using software control
Name:               eject
Version:            2.1.5
Release:            21%{?dist}
License:            GPLv2+
Group:              System Environment/Base
Source:             %{name}-%{version}.tar.gz
Patch1:             eject-2.1.1-verbose.patch
Patch2:             eject-timeout.patch
Patch3:             eject-2.1.5-opendevice.patch
Patch4:             eject-2.1.5-spaces.patch
Patch5:             eject-2.1.5-lock.patch
Patch6:             eject-2.1.5-umount.patch
URL:                http://www.pobox.com/~tranter
ExcludeArch:        s390 s390x
BuildRequires:      gettext
BuildRequires:      libtool

%description
The eject program allows the user to eject removable media (typically
CD-ROMs, floppy disks or Iomega Jaz or Zip disks) using software
control. Eject can also control some multi-disk CD changers and even
some devices' auto-eject features.

Install eject if you'd like to eject removable media using software
control.

%prep
%setup -q -n %{name}
%patch1 -p1
%patch2 -p1
%patch3 -p1
%patch4 -p1
%patch5 -p1
%patch6 -p1

%build
%configure
make %{?_smp_mflags}

%install
make DESTDIR=%{buildroot} install

install -m 755 -d %{buildroot}/%{_sbindir}
ln -s ../bin/eject %{buildroot}/%{_sbindir}

%find_lang %{name}

%files -f %{name}.lang
%doc README TODO COPYING ChangeLog
%{_bindir}/*
%{_sbindir}/*
%{_mandir}/man1/*

%changelog
* Tue Feb 08 2011 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 2.1.5-21
- Rebuilt for https://fedoraproject.org/wiki/Fedora_15_Mass_Rebuild

* Fri Jul 02 2010 Kamil Dudka <kdudka@redhat.com> 2.1.5-20
- handle multi-partition devices with spaces in mount points properly (#608502)

Resumen del archivo SPEC

Otras guías útiles:

Usted deberá seguir los lineamientos Fedora: Lineamientos de nombres de paquetes, Lineamientos de empaquetado, y Lineamientos de revisión de paquetes.

Insertar los comentarios con el primer carácter «#», pero evite las macros (comienzan con %) que sean potencialmente multilíneas (las que se expanden primero). Si está comentando una línea, doble los signos de porcentaje (%%). Evite también los comentarios inline en la misma línea como un comando de script.

Las principales etiquetas se enumeran a continuación. Tenga en cuenta que las macros %{name}, %{version} y %{release} pueden utilizarse para hacer referencia a las etiquetas Name, Version y Release respectivamente. Cuando cambia la etiqueta, las macros se actualizan automáticamente para utilizar el nuevo valor.

  • Name: El nombre (base) del paquete, que debe coincidir con el nombre del archivo SPEC. Debe seguir los Lineamientos de nombres de paquetes y generalmente estar en minúsculas.
  • Version: El número de versión de desarrollo. Vea la Sección etiqueta de versión en los lineamientos de empaquetado. Si la versión contiene etiquetas que no son numéricas (contiene etiquetas que no son números), puede que necesite incluir caracteres no numéricos adicionales en la etiqueta Release. Si el desarrollo utiliza fechas completas para distinguir las versiones, considere usar números de versión con la forma yy.mm[dd] (por ejemplo 2008-05-01 se convierte en 8.05).
  • Release: El valor inicial normalmente debería ser 1%{?dist}. Incremente el número cada vez que libere un nuevo paquete para la misma versión de software. Cuando una nueva versión de desarrollo es liberada, cambiar la etiqueta Version para igualar y restablecer el número de Release a 1. Vea la Sección etiqueta de versión en los lineamientos de empaquetado. La etiqueta opcional Dist podría ser útil.
  • Summary: Un breve, sumario del paquete en una línea. Use inglés americano. Y no termine con un punto.
  • Group: Este tiene que ser un grupo pre-existente, como «Applications/Engineering»; ejecute «less /usr/share/doc/rpm-*/GROUPS» para ver la lista completa. Use el grupo «Documentation» para los sub-paquetes (por ejemplo kernel-doc) que contienen documentación. Nota: Esta etiqueta está en desuso desde Fedora 17. Consulte Preámbulo de referencia del archivo Spec
  • License: La licencia, debe ser una licencia de software de código abierto. No usar la antigua etiqueta Copyright. Utilizar una abreviatura estándar (por ejemplo «GPLv2+») y ser específico (por ejemplo use «GPLv2+» para la GPL versión 2 o superior en lugar de simplemente «GPL» o «GPLv2» cuando sea cierto). Consulte Licensing y los Lineamientos de licencias. Usted puede listar múltiples licencias combinándolas con «and» y «or» (por ejemplo «GPLv2 and BSD»).
  • URL: La dirección URL completa para obtener más información sobre el programa (por ejemplo, la página web del proyecto). Nota: Esta no es de donde proviene el código fuente original que sirve para la etiqueta Source0 de abajo.
  • Source0: La dirección URL completa para el archivo comprimido que contiene el código fuente (original) prístina, liberado como desarrollo. «Source» es sinónimo de «Source0». Si usted da una dirección URL completa (y debería), su nombre base será utilizado cuando se busque en el directorio SOURCES. Si es posible, insertar %{name} y %{version}, así los cambios en cualquiera de ellas irá al lugar adecuado. Preservar los datos al descargar archivos fuentes. Si existe más de un archivo fuente, nómbrelos como Source1, Source2 y así sucesivamente. Si va a añadir nuevos archivos completos, además de las fuentes originales, lístelos como fuentes después de las fuentes prístinas. Una copia de cada una de estas fuentes serán incluídas en cualquier SRPM que cree, a menos que específicamente le indique lo contrario. Vea Source URL para obtener más información sobre los casos especiales (por ejemplo, control de revisión).
  • Patch0: El nombre del primer parche para aplicar al código fuente. Si necesita parchear los archivos después de que hayan sido descomprimidos, debe editar los archivos y guardar sus diferencias como un archivo «patch» en su directorio ~/rpmbuild/SOURCES. Los parches deben hacer sólo un cambio lógico cada uno, así que es muy posible tener varios archivos de parches.
  • BuildArch: Si está empaquetando archivos que son independientes de la arquitectura (por ejemplo, scripts de shell, archivos de datos), agregar «BuildArch: noarch». La arquitectura para el RPM binario será entonces «noarch».
  • BuildRoot: Esta es dónde los archivos serán «instalados» durante el proceso %install (después del proceso %build). Esta es ahora redundante en Fedora y sólo es necesaria para EPEL5. De forma predeterminada, la raíz de construcción se coloca en «%{_topdir}/BUILDROOT/».
  • BuildRequires: Una lista separada por comas de paquetes requeridos para la construcción (compilar) del programa. Este campo se puede (y lo es comúnmente) repetir en varias líneas. Estas dependencias no son determinadas automáticamente, usted debe incluir todo lo necesario para construir el programa. Algunos paquetes comunes se pueden omitir, tal como gcc. Puede especificar una versión mínima si es necesario (por ejemplo «ocaml >= 3.08»). Si necesita el archivo /EGGS, determinar el paquete que lo posee mediante la ejecución de «rpm -qf /EGGS». Si necesita el programa EGGS, determinar el paquete que lo posee mediante la ejecución de «rpm -qf which EGGS». Mantener las dependencias al mínimo (por ejemplo use sed en vez de perl si realmente no necesita las capacidades de perl), pero tenga en cuenta que algunas aplicaciones desactivan funciones permanentemente si la dependencia asociada no está presente; en estos casos deberá incluir los paquetes adicionales. El paquete Package-x-generic-16.pngauto-buildrequires puede ser útil.
  • Requires: Una lista separada por comas de los paquetes que se requieren cuando se instala el programa. Tenga en cuenta que la etiqueta BuildRequires lista lo que se necesita para construir el RPM binario, mientras que la etiqueta Requires lista lo que se requiere para la instalación/ejecución del programa; un paquete puede estar en una lista o en ambas. En muchos casos, rpmbuild detecta automáticamente las dependencias por lo que la etiqueta Requires no siempre es necesaria. Sin embargo, puede que desee resaltar algunos paquetes específicos cuando sea necesario, o es posible que no sean detectados automáticamente.
  • %description: Una más larga, descripción multilínea del programa. Use inglés americano. Todas las líneas deben ser de 80 caracteres o menos. Las líneas en blanco indican un nuevo párrafo. Algunos programas de instalación de la interfaz gráfica de usuario reformatearán los párrafos; las líneas que comienzan con un espacio en blanco se tratan como texto preformateado y se mostrarán tal cual, normalmente con una fuente de ancho fijo. Consulte Guía RPM.
  • %prep: Comandos de script para «preparar» el programa (por ejemplo, para descomprimirlo) y que pueda estar listo para la construcción. Típicamente es sólo «%setup -q»; una variación común es «%setup -q -n NOMBRE» si el archivo fuente se desempaqueta en NOMBRE. Consulte la sección %prep de abajo para más detalles.
  • %build: Comandos de script para «construir» el programa (por ejemplo, para compilarlo) y prepararlo para la instalación. El programa debe venir con instrucciones de cómo hacerlo. Vea la sección %build de abajo para más detalles.
  • %check: Comandos de script para «probar» el programa. Estos se ejecutan entre los procedimientos %build e %install, así que debe colocarlo allí si tiene esta sección. A menudo simplemente contiene «make test» o «make check». Esto es aparte de %build para que las personas puedan omitir la comprobación automática si lo desean.
  • %install: Comandos de script para «instalar» el programa. Los comandos deben copiar los archivos desde el directorio de CONSTRUCCIÓN %{_builddir} al directorio raíz de construcción, %{buildroot}. Vea la sección %install de abajo para más detalles.
  • %clean: Instrucciones para limpiar la raíz de construcción. Tenga en cuenta que esta sección es ahora redundante en Fedora y sólo es necesaria para EPEL. Normalmente esto sólo contiene:
rm -rf %{buildroot}
  • %files: La lista de archivos que serán instalados. Consulte la sección %files de abajo para más detalles.
  • %changelog: Cambios en el paquete. Utilice de ejemplo el formato anterior.
  • ExcludeArch: Si el paquete no compila, construye o funciona correctamente en una arquitectura en particular, liste esas arquitecturas bajo esta etiqueta.
  • Puede agregar secciones para que el código se ejecute cuando los paquetes sean instalados o removidos en el sistema real (en lugar de sólo ejecutar el script %install, que sólo hace una pseudo-instalación a la raíz de construcción). Estos se denominan «scriptlets», y se utilizan generalmente para actualizar el sistema en ejecución con información del paquete. Consulte la sección «Scriptlets» de abajo para más detalles.

RPM también soporta la creación de varios paquetes (llamados subpaquetes) desde un único archivo SPEC, como los paquetes name-libs y name-devel.

No use estas etiquetas:

  • Packager
  • Vendor
  • Copyright

No cree un paquete «relocalizable»; que no agrega valor en Fedora y hace las cosas más complicadas.

Secciones del archivo SPEC explicadas

Sección %prep

La sección %prep describe cómo desempaquetar los paquetes comprimidos para que puedan ser construidos. Típicamente, esto incluye los comandos «%setup» y «%patch» con referencia a las líneas Source0 (y Source1, etc.). Vea la sección %setup y %patch en Maximum RPM para más detalles.

Las macros %{patches} y %{sources} están disponibles desde RPM 4.4.2 y son útiles si usted tiene una gran lista de parches o fuentes:

for p in %{patches}; do
    ...
done

Sin embargo, tenga en cuenta que el uso de estas hará a su SPEC incompatible con los RPMS utilizados en RHEL y otras distribuciones basadas en RPM.

Sección %prep: comando %setup

El comando «%setup» desempaqueta un paquete fuente. Los modificadores incluyen:

  • -q : Suprime la salida innecesaria. Este es comúnmente utilizado.
  • -n nombre : Si el archivo tarball Fuente se desempaqueta en un directorio cuyo nombre no es el nombre del RPM, este modificador puede utilizarse para especificar el nombre del directorio correcto. Por ejemplo, si el archivo tarball se desempaqueta en el directorio FOO, use «%setup -q -n FOO».
  • -c nombre : Si el archivo tarball Fuente se desempaqueta en varios directorios en lugar de un solo directorio, este modificador puede utilizarse para crear un directorio llamado nombre y luego descomprimir en él.

Hay más opciones %spec si está desempaquetando múltiples archivos, lo cual es especialmente útil si está creando subpaquetes (ver más abajo). Las más importantes son:

-a número Sólo desempaquetar la directiva Fuente del número dado después de cambiar de directorio (por ejemplo «–a 0» para Source0).
-b número Sólo desempaquetar la directiva Fuente del número dado antes de cambiar de directorio (por ejemplo «–b 0» para Source0).
-D No eliminar el directorio antes de desempaquetar.
-T Inhabilitar el desempaquetado automático del archivador.

Sección %prep: comando %patch

El comando «%patch0» aplica el Parche0 (y %patch1 aplica Parche1, etc.). Los parches son el método habitual de realizar los cambios necesarios en el código fuente para el empaquetamiento. La usual opción «-pNUMERO» se aplica, la que pasa ese argumento al patch en el programa.

Los nombres de los archivos parche usualmente lucen como «telnet-0.17-env.patch», que es el formato «%{name} - %{version} - RAZÓN.patch» (aunque a veces se omite la versión). Los archivos parche son típicamente el resultado de «diff -u»; si hace esto desde el subdirectorio ~/rpmbuild/BUILD entonces no tendrá que especificar un nivel -p posterior.

Este es un procedimiento típico para crear un parche para un solo archivo:

cp foo/bar foo/bar.orig
vim foo/bar
diff -u foo/bar.orig foo/bar > ~/rpmbuild/SOURCES/NOMBREDEPAQUETE.RAZÓN.patch

Si va a editar muchos archivos, un método fácil es copiar el subdirectorio completo debajo de BUILD y luego hacer diffs por subdirectorio. Después de cambiar al directorio «~rpmbuild/BUILD/NOMBRE», haga lo siguiente:

cp -pr ./ ../NOMBREDEPAQUETE.orig/
... muchas ediciones ...
diff -u ../NOMBREDEPAQUETE.orig . > ~/rpmbuild/SOURCES/NOMBRE.RAZÓN.patch

Si edita muchos archivos en un parche, también puede copiar los archivos originales mediante alguna terminación consistente como «.orig» antes de editarlos. Luego, puede usar «gendiff» (en el paquete rpm-build) para crear un parche con las diferencias.

Trate de asegurarse que el parche coincida exactamente con el contexto. El valor por omisión de «fuzz» es «0», que requiere coincidencia para ser exacto. Puede solucionar esto añadiendo «%global _default_patch_fuzz 2» para volver al valor encontrado en las versiones anteriores de RPM en Fedora, pero en general se recomienda evitar hacer esto.

Como se explica en Packaging/PatchUpstreamStatus, todos los parches deben tener un comentario sobre ellos en el archivo SPEC sobre su estado de desarrollo. Este debe documentar el desarrollo que incluye los errores/correo electrónico (incluyendo la fecha). Si es exclusivo de Fedora, debe mencionar por qué es único. El proyecto Fedora intenta no desviarse del desarrollo; consulte PackageMaintainers/WhyUpstream para ver la importancia de esto.

Sección %prep: Archivos sin modificar

A veces, uno o más de los archivos Fuente no necesitarán ser descomprimidos. Usted puede «prep» esos archivos en un directorio de construcción como este (donde SOURCE1 se refiere al archivo Fuente correspondiente):

cp -p %SOURCE1 .

Sección %build

La sección «%build» es a veces complicada; aquí usted configura y compila/construye los archivos a ser instalados.

Muchos programas siguen el enfoque configure de GNU (o alguna variación). De forma predeterminada, se instalarán con un prefijo de «/usr/local», que es razonable para los archivos desempaquetados. Sin embargo, como usted está empaquetándolo, cambiará el prefijo a «/usr». Las bibliotecas deben instalarse bien sea en /usr/lib o /usr/lib64 dependiendo de la arquitectura.

Ya que configure de GNU es tan común, la macro «%configure» se puede utilizar para invocar automáticamente las opciones correctas (por ejemplo, cambiar el prefijo a /usr). Alguna variación de esto a menudo funciona:

 %configure
 make %{?_smp_mflags}

Para sustituir variables en el makefile, pasarlas como parámetros a make:

make %{?_smp_mflags} CFLAGS="%{optflags}" BINDIR=%{_bindir}

Más información, consulte «GNU autoconf, automake, and libtool» y «Open Source Development Tools: An Introduction to Make, Configure, Automake, Autoconf» por Stefan Hundhammer.

Algunos programas usan cmake. Ver Packaging/cmake.

Sección %check

Si las pruebas automáticas están disponibles, por lo general es una buena idea incluirlas. Deben colocarse en la sección %check (que sigue inmediatamente a la sección %build) en lugar de dentro de la sección %build, de modo que puedan ser fácilmente omitidas cuando sea necesario.

A menudo, esta sección contiene:

make test

Sección %install

Esta sección incluye comandos de script para «instalar» el programa, copiar los archivos relevantes desde %{_builddir} a %{buildroot} (que por lo general significa desde ~/rpmbuild/BUILD a ~/rpmbuild/BUILDROOT) y la creación de directorios dentro de %{buildroot} según sea necesario.

Parte de la terminología que puede inducir a error:

  • El «directorio de construcción», también conocido como %{_builddir} no es el mismo que el «raíz de construcción», también conocido como %{buildroot}. La compilación se produce en el primer directorio, mientras que los archivos a ser empaquetados son copiados desde el primero al último.
  • Durante la sección de %build, el directorio actual comenzará en %{buildsubdir}, que es el subdirectorio dentro de %{_builddir} creado durante la etapa de %prep. Esto suele ser algo como ~/rpmbuild/BUILD/%{name}-%{version}.
  • La sección %install no no se ejecuta cuando el paquete RPM binario es instalado por el usuario final, pero sólo se ejecuta cuando se crea un paquete.

Normalmente, una variación de «make install» se lleva a cabo aquí:

%install
rm -rf %{buildroot}
make DESTDIR=%{buildroot} install

La eliminación de %{buildroot} ya no es necesaria, excepto para EPEL 5.

Idealmente debe usar DESTDIR=%{buildroot} si el programa lo admite, ya que redirige las instalaciones del archivo al directorio especificado y es exactamente lo que queremos que ocurra durante la sección %install.

Si el programa no admite DESTDIR (y sólo si), es posible la solución en una de las varias formas (inferiores):

  • Parchar el makefile así es compatible con DESTDIR. Crear directorios dentro de DESTDIR cuando sea necesario y enviar el parche a desarrollo.
  • Usar la macro «%makeinstall». Este método podría funcionar, pero puede conducir a fallas sutiles. Se expande a algo así como «make prefix=%{buildroot}%{_prefix} bindir=%{buildroot}%{_bindir} ... install», lo cual puede resultar que en algunos programas no funcione correctamente. Crear directorios dentro de %{buildroot} cuando sea necesario.
  • Considerar la posibilidad de usar el paquete auto-destdir. Para ello es necesario «BuildRequires: auto-destdir», y cambiar «make install» por «make-redir DESTDIR=%{buildroot} install». Esto sólo funciona bien si la instalación utiliza sólo ciertos comandos comunes para instalar los archivos, como cp e install.
  • Realizar la instalación a mano. Esto implicaría crear los directorios necesarios debajo de %{buildroot} y copiar los archivos desde %{_builddir} a %{buildroot}. Tenga especial cuidado con las actualizaciones, que a menudo contienen nombres de archivos nuevos o modificados. Un ejemplo de este procedimiento:
%install
rm -rf %{buildroot}
mkdir -p %{buildroot}%{_bindir}/
cp -p mycommand %{buildroot}%{_bindir}/

Como se indica en Packaging:Guidelines#Timestamps, tratar de preservar las marcas de tiempo de los archivos si el makefile permite sobrescribir comandos:

make INSTALL="install -p" CP="cp -p" DESTDIR=%{buildroot} install

Sección %files

Esta sección declara que los archivos y directorios son propiedad del paquete, por lo tanto los archivos y directorios se colocan en el RPM binario.

Conceptos básicos de %files

La %defattr establece los permisos de archivo por defecto, y se encuentra a menudo en el inicio de la sección %files. Tenga en cuenta que esto ya no es necesario a menos que los permisos deban modificarse. El formato de esta es:

%defattr(<permisos de achivo>, <usuario>, <grupo>, <permisos de directorio>)

El cuarto parámetro se omite a menudo. Usualmente se utiliza %defattr(-,root,root,-), donde «-» significa use los permisos predeterminados.

A continuación, debe listar todos los archivos y directorios a ser propiedad del paquete. Utilizar macros para los nombres de directorio donde sea posible, que pueden verse en Packaging:RPMMacros (por ejemplo, utilice %{_bindir}/mycommand en lugar de /usr/bin/mycommand). Si el patrón comienza con una «/» (o cuando se expande desde la macro) entonces se toma desde el directorio %{buildroot}. De lo contrario, se presume que el archivo está en el directorio actual (por ejemplo dentro de %{_builddir}, como los archivos de documentación que desee incluir). Si su paquete sólo instala un único archivo /usr/sbin/mycommand, la sección %files simplemente puede ser:

%files
%{_sbindir}/mycommand

Para hacer que su paquete sea menos sensible a los cambios, declare que todos los archivos dentro de un directorio sean propiedad del paquete con una coincidencia de patrón:

%{_bindir}/*

Para incluir un solo directorio:

%{_datadir}/%{name}/

Tenga en cuenta que %{_bindir}/* no reclama que este paquete sea propietario del directorio /usr/bin, pero sólo de los archivos contenidos en él. Si usted lista un directorio, entonces usted está reclamando que este paquete sea dueño de ese directorio y de todos sus archivos y subdirectorios contenidos en él. Por lo tanto, no liste el %{_bindir} y tenga cuidado con los directorios que puedan ser compartidos con otros paquetes.

Se producirá un error si:

  • una coincidencia de patrón no coincide con algún archivo o directorio
  • un archivo o directorio está listado o coincide más de una vez
  • un archivo o directorio en la %{buildroot} no ha sido listado

También es posible excluir archivos de una coincidencia anterior utilizando el glob %exclude. Esto puede ser útil para incorporar a casi todos los archivos incluidos por una coincidencia de patrón diferente, pero tenga en cuenta que también fallará si no coincide con algo.

Prefijos de %files

Puede que tenga que agregar uno o más prefijos a las líneas en la sección %files; separados con un espacio. Ver Max RPM section on %files directives.

Por lo general, «%doc» se utiliza para listar los archivos de documentación dentro de %{_builddir} que no se copiaron a %{buildroot}. Usualmente se incluyen los archivos README e INSTALL. Serán colocados en el directorio /usr/share/doc/%{name}-%{version}, cuya propiedad no necesita ser declarada.

Nota: Si se especifica una entrada %doc, entonces usted no puede copiar los archivos en el directorio de documentación durante la sección %install. Si, por ejemplo, desea un subdirectorio «ejemplos» dentro del directorio de documentación, no utilice %doc, pero en cambio cree los directorios y copie los archivos manualmente en %{buildroot}%{_defaultdocdir}/%{name}-%{version} durante la sección %install. Serán marcados correctamente como documentación. Asegúrese de incluir %{_defaultdocdir}/%{name}-%{version}/ como una entrada en la sección %files.

Los archivos de configuración deben ser colocados en /etc y normalmente son especificados como esto (lo que hace es asegurarse de que al actualizar no se sobrescriban los cambios hechos por el usuario):

%config(noreplace) %{_sysconfdir}/foo.conf

Si la actualización utiliza un formato de configuración no compatible con versiones anteriores, entonces especificarlo de la siguiente manera:

%config %{_sysconfdir}/foo.conf

«%attr(mode, user, group)» puede ser utilizado para un mayor control sobre los permisos, donde un «-» significa utilizar el valor predeterminado:

%attr(0644, root, root) FOO.BAR

Si un archivo está en un idioma natural en particular, use %lang para asentarlo:

%lang(de) %{_datadir}/locale/de/LC_MESSAGES/tcsh*

Los programas que utilizan archivos Locale deben seguir el método recomendado para el manejo de archivos de i18n:

  • encontrar los nombres de archivo en la etapa %install: %find_lang ${name}
  • añadir las dependencias de construcción necesarias: BuildRequires: gettext
  • utilizar los nombres de archivos encontrados: %files -f ${name}.lang

Estos prefijos no son válidos en Fedora: %license y %readme.

%files y Estándar de jerarquía del sistema de archivos (FHS)

Usted debería seguir el Estándar de jerarquía del sistema de archivos (FHS). Los ejecutables van en /usr/bin, los archivos de configuración global en /etc, las bibliotecas en /usr/lib (o /usr/lib64) y así sucesivamente. Hay una excepción: los ejecutables que no deberían ser ejecutados directamente por los usuarios o administradores deben ir en el subdirectorio /usr/libexec, lo que se conoce como %{_libexecdir}/%{name}.

No instalar los archivos en /opt o /usr/local.

Desafortunadamente, muchos programas no siguen el FHS por defecto. En particular, las bibliotecas independientes de la arquitectura se encontrarán en /usr/lib en lugar de /usr/share. El primero es para las bibliotecas dependientes de la arquitectura, mientras que el segundo es para las bibliotecas independientes de la arquitectura, lo que significa que los sistemas con arquitecturas de CPU diferentes pueden compartir en /usr/share. Hay muchas excepciones en Fedora (como Python y Perl), pero Fedora aplica esta regla más estrictamente que algunas distribuciones. rpmlint generalmente se quejará si usted pone algo más que archivos ELF en /usr/lib.

Ejemplo de %files

He aquí un ejemplo simple de una sección %files:

%files
%doc README LICENSE
%{_bindir}/*
%{_sbindir}/*
%{_datadir}/%{name}/
%config(noreplace) %{_sysconfdir}/*.conf

Búsqueda de duplicados

Puede listar los duplicados de dos paquetes binarios haciendo:

cd ~/rpmbuild/RPMS/ARCH # Sustituir «ARCH» por su arquitectura
rpm -qlp PACKAGE1.*.rpm | sort > ,1
rpm -qlp PACKAGE2.*.rpm | sort > ,2
comm -12 ,1 ,2

Scriptlets

Cuando un usuario final instala el RPM, es posible que desee ejecutar algunos comandos. Esto se puede lograr a través de scriptlets. Consulte Packaging/ScriptletSnippets.

Los scriptlets se pueden ejecutar:

  • antes (%pre) o después (%post) de instalar un paquete
  • antes (%preun) o después (%postun) de desinstalar un paquete
  • al inicio (%pretrans) o al final (%posttrans) de una transacción

Por ejemplo, cada paquete RPM binario que almacena archivos de las bibliotecas compartidas en cualquiera de las rutas de acceso predeterminadas del enlazador dinámico, debe llamar a ldconfig en %post y %postun. Si el paquete tiene varios subpaquetes con bibliotecas, cada subpaquete también debe realizar las mismas acciones.

%post -p /sbin/ldconfig
%postun -p /sbin/ldconfig

Si tan sólo ejecuta un solo comando, entonces la opción «-p» ejecuta el comando adyacente sin invocar el shell. Sin embargo, para varios comandos, omita esta opción e incluya los comandos de shell debajo.

Si ejecuta cualquier programa dentro de los scriptlets, debe especificar los requisitos en la forma «Requires(CONTEXTO)» (por ejemplo Requires(post)).

%pre, %post, %preun, y %postun ofrecen el argumento $1, que es el número de paquetes de este nombre que quedará en el sistema cuando la acción se complete. No comparar a la igualdad con 2, pero en cambio comprobar si es mayor o igual a 2. Para %pretrans y %posttrans, $1 es siempre 0.

Por ejemplo, si el paquete instala un manual de información, entonces el índice del manual de información debe ser actualizado con install-info del paquete info. En primer lugar, no hay ninguna garantía de que el paquete info estará disponible a menos que lo declaremos explícitamente como necesario, y en segundo lugar, no queremos fracasar completamente si se produce un error en install-info:

Requires(post): info
Requires(preun): info
...
%post
/sbin/install-info %{_infodir}/%{name}.info %{_infodir}/dir || :
%preun
if [ $1 = 0 ] ; then
/sbin/install-info --delete %{_infodir}/%{name}.info %{_infodir}/dir || :
fi

Hay otros fallos técnicos relacionados con la instalación de los manuales de información. El comando install-info actualizará el directorio de información, por lo que debemos eliminar el directorio inservible vacío de %{buildroot} durante la sección %install:

rm -f %{buildroot}%{_infodir}/dir

Otra capacidad tipo-scriptlet son los «triggers», que se pueden ejecutar con su paquete cuando otros paquetes sean instalados o desinstalados. Ver RPM Triggers.

Macros

Las macros son texto en el formato de %{string}. Macros típicas:

Macro Expansión típica Significado
%{_bindir} /usr/bin Directorio binario: donde se almacenan normalmente los ejecutables.
%{_builddir} ~/rpmbuild/BUILD Directorio de construcción: archivos que son compilados en un subdirectorio del directorio de construcción. Ver %buildsubdir.
%{buildroot} ~/rpmbuild/BUILDROOT Raíz de construcción: donde los archivos son «instalados» durante la etapa de %install, que copia los archivos desde un subdirectorio de %{_builddir} a un subdirectorio de %{buildroot}. (Históricamente, %{buildroot} estaba en «/var/tmp/».)
%{buildsubdir} %{_builddir}/%{name} Subdirectorio de construcción: un subdirectorio dentro de %{_builddir} donde se compilan los archivos durante la etapa de %build. Se establece después de %setup.
%{_datadir} /usr/share Directorio compartido.
%{_defaultdocdir} /usr/share/doc Directorio predeterminado de documentación.
%{dist} .fcNUMERO Distribución+nombre corto de versión (por ejemplo «.fc9»)
%{fedora} NUMERO Número de liberación de Fedora (por ejemplo «9»)
%{_includedir} /usr/include
%{_infodir} /usr/share/info
%{_initrddir} /etc/rc.d/init.d
%{_libdir} /usr/lib
%{_libexecdir} /usr/libexec
%{_localstatedir} /var
%{_mandir} /usr/share/man
%{name} Nombre del paquete, definido por Name: etiqueta
%{_sbindir} /usr/sbin
%{_sharedstatedir} /var/lib
%{_sysconfdir} /etc
%{version} Versión del paquete, definido por Version: etiqueta

Aprenda más sobre las macros mirando en /etc/rpm/* y /usr/lib/rpm, especialmente /usr/lib/rpm/macros. También use rpm --showrc para mostrar los valores que RPM va a utilizar en las macros (modificados por los archivos de configuración de macros y rpmrc).

Puede establecer sus propios valores de macro usando %global, pero asegúrese de definirlos antes de usarlos. (Las definiciones de macro pueden referirse a otras macros.) Por ejemplo:

%global date 2012-02-08

Use la opción «-E» de rpmbuild para encontrar el valor de una macro en un archivo SPEC:

rpmbuild -E '%{_bindir}' myfile.spec

Ver también Packaging/RPMMacros y Capítulo 9 de la guía RPM.

Otras marcas

Anotamos anteriormente las marcas "Requires" y "BuildRequires". Hay unas otras marcas más para controlar las dependencias: Provides, Obsoletes, Conflicts, y BuildConflicts.

  • "Provides:" le permite listar nombres de paquete virtual que este paquete provee. Algunas veces hay diferentes paquetes que pueden proveer la funcionalidad y usar paquetes (using packages) no importa cual. En ese caso (aclarar), cada uno de los paquetes que provee la funcionalidad deberían "proveer" un paquete virtual y entonces usando packages puede listar el nombre de paquete virtual bajo "Requires:". Por ejemplo, distintos paquetes puede proveer "latex", si usted depende del paquete virtual "tex(latex)", entonces los usuarios pueden escoger qué paquete obtener para obtener "latex" de él. Si usted provee paquetes virtuales, puede que tambien quiera usar sistema de alternativas, pero sea cuidadoso: los ajustes de las "alternativas" son a nivel del sistema, así que si múltiples usuarios en el mismo sistema quieren valores por omisión diferentes, no utilice este sistema. Usted puede encontrar lo que un paquete provee, tanto virtual como no-virtual, consultando "rpm -q --provides NOMBREDEPAQUETE". Algunos paquetes virtuales en Fedora son:
    • MTA : Nombre usado para Mail Transport Agents, tal como Postfix.
    • tex(latex) : Nombre usado para latex.
  • "Obsoletes:" le permite declarar que instalando este paquete debería (normalmente) provocar la remoción de los otros paquetes nombrados. Esto es útil cuando un nombre de paquete cambia, o cuando un paquete remplaza completamente a un paquete diferente.
  • "Conflicts:" le permite declarar cuáles paquetes no pueden ser instalados simultáneamente con este. Obviamente, intente evitar esto si puede, vea Packaging/Conflicts si cree que necesita usarlo.
  • "BuildConflicts:" le permite declarar qué paquetes no pueden ser instalados cuando se construye este paquete. Obviamente, intente evitar esto si puede.

Usted puede controlar qué arquitecturas un paquete construye (o no construye). Por ejemplo, si su paquete no puede compilar en ppc, usted puede hacer:

ExcludeArch: ppc

También existe la marca "ExclusiveArch". Las arquitecturas válidas que se pueden especificar en estas marcas están listadas en la sección Arquitecturas.

Subpaquetes

Un archivo spec puede definir más de un paquete binario, e.g., cliente y servidor, o paquetes runtime y developer. Si hay una gran cantidad de documentación, puede ser dividida en subpaquetes NOMBRE-doc. Usted siempre tendrá un archivo spec y un fuente RPM (SRPM), incluso si hay múltiples RPM binarios que ellos generan. Un archivo spec que produce múltiples paquetes binarios tiene aún así un único proceso de creación, así que existe secciones únicas %prep, %build, %check, e %install que crean todos los archivos para todos los paquetes.

En un archivo spec use la directiva %package para iniciar la definicón de un subpaquete:

%package sub_package_name

Por omisión, el nombre de subpaquete es PACKAGE_NAME, "-", SUBPACKAGE_NAME, usted puede utilizar "-n" para invalidar este comportamiento y construir un nuevo nombre:

%package -n new_sub_package_name

Después de la directiva %package, liste las marcas (tags) para el subpaquete. Debería incluirse como mínimo las marcas "Summary:" y "Group:" y las directivas "%description SUBPACKAGE_NAME" y "%files SUBPACKAGE_NAME". Cualquier cosa no especificada por el subpaquete será heredado de su padre.

Para las directivas, si usó "-n" con %package, usted lo necesitará nuevamente para estas directivas. Usted necesita especificar el nombre para las otras directivas, e.g., %pre y %post, si las usa en el subpaquete.

Vea la sección acerca de subpaquetes de RPM Guide para más información.

Condicionales

Usted puede insertar declaraciones condicionales. Es decir, usted puede probar si está creando un binario para una arquitectura dada con:

%ifarch ARCHITECTURE_NAME

the negated version with:

%ifnarch ARCHITECTURE_NAME

O la forma más general de condicional:

%if TRUE_OR_FALSE

Opcionalmente existe una sección "%else", todas las seccciones se cierran con "%endif".

Lineamientos específicos de aplicación

Existen muchos lineamientos específicos a las aplicaciones que pueden ayudarle (e.g., para lenguajes de programación específicos, aplicaciones, librerías, y sistemas de construcción). Muchos de ellos se listan como parte de Application Specific Guidelines of Packaging/Guidelines. Ejemplos de lineamientos específicos a la aplicación son aquellos para:

De fallar eso, otras formas de encontrar ayuda específica a la aplicación son:

Algunas otras pistas

Si desea ver muchos ejemplos de scriptlets, usted puede mostrar todos los scriptlets de los programas instalados utilizando:

rpm -qa --queryformat "

PACKAGE: %{name} " --scripts | less

La siguiente página tiene información acerca de los errores comunes que se cometen: [Packaging/FrequentlyMadeMistakes] .

No intente interactuar con el usuario, RPM está diseñado para soportar instalaciones en modo lote (batch). Si una aplicación necesita mostrar un EULA, eso sería parte de la ejecución inicial, no de la instalación.

Usted puede no querer iniciar ningún servicio, debido a que en una gran instalación eso puede frenar las cosas. Si instala un guión para init, considere usar chkconfig para arreglar que el servicio se arranque y detenga en el próximo reinicio del sistema. Antes de desinstalar usted debería normalmente intentar detener los servicios si están corriendo.

La desinstalación debería reversar la mayoría de los cambios hechos durante la instalación, pero no remueva ningún archivo creado por el usuario.

Normalmente, si existen binarios ejecutables, un paquete separado "debug" se crea con los símbolos, y los símbolos son removidos de los paquetes normales binarios. Si esto no debiese ocurrir, usted puede deshabilitar la creación del paquete y remoción con:

%define _enable_debug_package 0
%define debug_package %{nil}
%define __os_install_post /usr/lib/rpm/brp-compress %{nil}

Una forma de verificar la versión de Fedora en un archivo spec para construcción condicional es:

%if 0%{?fedora} <= <version>

El ? provoca que el macro evalúe a blanco si %fedora no está definido, y ello provoca que el resultado final sea "0", que es un número y en consecuencia aceptable, mientras que no interfiere con el resultado si de hecho hay un valor definido para %fedora.

Note que el truco anterior NO FUNCIONA en Koji "scratch" builds - %fedora es puesto durante la creación del fuente RPM. En consecuencia, este truco funciona en Koji ya que le sistema extrae las fuentes de los fuente RPM y reconstruye el fuente RPM con el valor apropiado de %fedora.

También existen algunas recomendaciones y trucos controversiales en [PackageMaintainers/Packaging_Tricks].

Los programas GUI deben tener una entrada desktop (de tal forma que las personas puedan invocarla desde un menú gráfico). El desktop entry spec (para archivos .desktop) y icon theme spec definen cómo hacerlo (e.g., como usar /usr/share/icon). Algunos documentos antiguos acerca de RPM tienen la mayor cantidad de información, pero algunos de estos documentos antiguos hacen algunas afirmaciones que ya no son ciertas:

  • Los archivo rpm ya no son colocados en un directorio compartido /usr/src/redhat. Esta es una forma obsoleta de usar rpm y no es recomendada. Los sistemas modernos definen %{_topdir} en vez de ~/rpmbuild.
  • El proceso %install no instala archivos en su ubicación final. En cambio, "instala" los archivos en buildroot.
  • El comando "rpm" ya no crea paquetes (e.g., "rpm -ba" fue alguna vez legal). Use el programa aparte "rpmbuild" para dichos propósitos.

Prueba rápida con rpmplint

Antes de intentar contruir nada, usted puede intentar ejecutar rpmlint sobre su archivo spec:

rpmlint program.spec

Este programa atajará muchos errores de forma temprana. Si el error reportado no tiene sentido, ejecute nuevamente con la opción "-i" (esta opción ofrece mensajes de error más explicativos).

Generalmente, usted no debería tener errores de rpmlint, pero algunas veces rpmlint es excesivamente ruidoso. Los lineamientos de empaquetamiento Fedora explican cuáles mensajes ignorar, e.g., ignore los erro"no-packager-tag" y "no-signature".

Vale la pena revisar http://wiki.mandriva.com/es/Problemas_comunes_RpmLint para saber cómo ajustar el archivo spec en ciertas circunstancias.

Creando RPMs a partir del archivo spec

Una vez que ha creado su archivo spec, digamos "programa.spec", usted puede crear los RPM fuente y binario simplemente corriendo:

$ rpmbuild -ba program.spec

Esto intentará ejecutar las siguientes etapas:

  • 1. Etapa %prep (preparación), que descomprime e instala los fuentes y parches en %_builddir (subdirectorio en ~/rpmbuild/BUILD).
  • 2. Etapa %build, que construye (e.g., compila) los archivos a ser instalados en %_buildir. Usualmente esto es algún equivalente a "make".
  • 3. Etapa install, que copia los archivos del directorio de construcción %_buildir (que estarí­a bajo ~/rpmbuild/BUILD) en el directorio buildroot, %{buildroot}. El directorio buildroot es definido por un previo "BuildRoot:", si lo deja a su valor normal que comienza con %{_tmppath}/{name}..., entonces el buildroot sería dentro de /var/tmp.
  • 4. Crea los RPM fuente y binario (archivos .rpm y .src.rpm). Los archivos binario RPM son creados utilizando la información de la lista %files.

Tenga cuidado: el "directorio de construcción" (donde ocurre la compilación durante %build) y la "raíz de construcción" (donde serán instalados los archivos durante %install) son diferentes .

Cuando las cosas salen mal, usted puede hacer "cd" al directorio apropiado y mirar que quedó allí. Si desea evitar etapas tempranas, use la opción "--short-circuit", esto es útil si ya tiene una construcción exitosa y un error en la sección %install. Por ejemplo, para reiniciar la etapa %install (saltando las etapas previas), haga lo siguiente:

 $ rpmbuild -bi --short-circuit program.spec

Si tiene éxito, encontrará sus RPMs bianrios en el subdirectorio "~/rpmbuild/RPMS/", y los fuente RPMs en "~/rpmbuild/SRPMS".

Si sólo desea crear el fuente RPM (.src.rpm), haga lo siguiente estando en el directorio SPECS:

rpmbuild -bs program.spec

Esto creará el fuente RPM en ~/rpmbuild/SRPMS. Crear solamente el fuente rpm (.src.rpm) es relativamente rápido porque rpm simplemente necesita copiar el archivo .spec y los SOURCES asociados en el archivo .src.rpm. Crear el rpm binario toma mucho más tiempo porque requiere que se ejecuten los guiones %prep, %build e %install.

Probar los RPMs construídos

Si usted hace "cd" al directorio "~/rpmbuild/RPMS", y luego cd al subdirectorio de la arquitectura especí­fica, encontrará algunos rpms binarios. Usted puede rápidamente ver sus archivos y permisos utilizando rpmls (verifique que sea lo que usted espera):

$ rpmls *.rpm

Ejecute rpmlint sobre el RPM "binario" (rpmlint trabaja sobre archivos .spec, RPMs binarios y RPMs fuentes, encontrando diferentes cosas en cada uno):

$ rpmlint *.rpm

Si esto luce bien, puede intentar convertirse en root e instalarlos:

# rpm -ivp XYZ1.rpm XYZ2.rpm XYZ3.rpm ...

Luego puede probarlos. Si es una herramienta de lí­nea de comandos, puede invocarla sin necesidad de prefijar con /usr/bin? Si es una herramienta GUI, ¿se muestra en el menú? (si no, algo está mal con su entrada .desktop).

Luego puede desinstalarlos usando:

# rpm -e XYZ1 XYZ2 XYZ3

Si todo ello funciona, puede usar Mock para hacer prueba rigurosa de que usted tiene los requerimientos para construcción adecuados. Vea PackageMaintainers/MockTricks para más información acerca de cómo usar Mock, una vez que su cuenta sea miembro del grupo "mock", puede ejecutar comandos como el siguiente para realizar pruebas locales:

$ mock -r fedora-9-i386 rebuild path_to_source_RPM

Una vez que Mock funcione en su sistema, puede usar Koji (que usa Mock) para hacer compilaciones en diferentes sistemas, algunos de los cuales usted puede que no tenga. Unirse_Mantenedores_de_Paquetes y PackageMaintainers/UsingKoji tienen más información acerca de Koji.

Una vez configurado, usted puede probar su RPM fuente en variedad de plataformas ejecutando comandos como el siguiente:

$ koji build --scratch dist-f9 path_to_source_RPM

Usted puede sustituir dist-f9 por dist-f8, dist-f10, etc., para intentar construir para otras versiones. No use "dist-rawhide", ello no es realmente rawhide. Recuerde, los valores %fedora, %fc9, etc., no serán correctos para un "scratch build", así­ que no funcionarán si su archivo spec hace algo diferente basándose en esos valores.

Sus compilaciones koji sólo pueden depender de paquete, de hecho están en el repositorio de la distribución OBJETIVO. En consecuencia, usted no puede usar koji para construir para distribuciones liberadas si su paquete depende de otros nuevos paquete que Bodhi no haya liberado aún. Usted "puede" usar koji para construir para rawhide (la próxima versión aún no liberada), incluso si depende de otros paquetes nuevos en la medida que los otros paquetes hayan sido construidos en la sección "devel" del CVS como se describe abajo.

Si necesita compilar versus un paquete que aún no está en una liberación estable, puede generar un ticket a rel-eng en: https://fedorahosted.org/rel-eng/newticket y solicitar que dicho paquete sea agregado como "buildroot override".

Herramientas útiles

El paquete "rpmdevtools" contiene una serie de herramientas útiles, "rpm -qil rpmdevtools" le mostrará qué es lo que instala. Una herramienta útil en particular es rpmdev-bumpspec que tiene la siguiente forma:

rpmdev-bumpspec --comment=COMMENT --userstring=NAME+EMAIL_STRING SPECFILES

rpmdev-bumpspec resaltará la marca release en los archivos specs y agrega un comentario al changelog con el formato correcto de fecha/hora y versión. COMMENT tí­picamente deberí­a comenzar con "- ".

De forma simular "yum-utils" posee una serie de herramientas especí­ficas a yum. "yumdownloader" es especialmente útil, usted puede descargar el RPM fuente de un paquete simplemente ejecutando "yumdownloader --source NOMBREDEPAQUETE. Luego puede entonces usar "rpm -U NOMBREPAQUETEFUENTE" para instalar los archivos fuentes. E.G., "yumdownloader --source glib; rpm -Uvh glib*.src.rpm".

Puede que le sea útil RUST (GPL). Es un herramienta GUI para creación RPM "drag&drop" y también es una herramienta para crear cajas de pruebas (sandoxing) que le permite ejecutar instalaciones de software dentro de un entorno chrooted y automáticamente generar RPMs para código fuente arbitrario, sin siquiera ver el archivo spec.

Si está creando archivos spec, puede ayudar el determinar %files. Note que, sin embargo, que ello no crea archivos spec, ni tampoco crea paquetes de calidad adecuada para los repositorios Fedora, es una herramienta principalmente para crear paquetes binarios RPM rápida y suciamente (Nota: ya no se encuentra más en "rusthq.com".)

Alien convierte entre formatos de paquetes. No producirá RPMs fuente limpios, pero convertir un paquete existente puede proveerle cierta información útil.

Lineamientos y reglas

Cuando usted cree sus paquetes, necesitará seguir las siguientes reglas y lineamientos:

   * Unirse Mantenedores de Paquetes - describe el proceso para convertirse en un mantenedor de paquetes Fedora.
   * Packaging Guidelines
   * Package Naming Guidelines
   * Dist Tag Guidelines
   * Package Review Guidelines

Existen muchos guí­as oficiales de lineamientos que le ayudarán con sus circunstancias especí­ficas (programas Java programs, programas OCaml, programas GNOME, etc.), el Packaging Guidelines incluye una referencia cruzada a dichas guí­as. También puede aprender a partir de las secciones SIGs y Package Maintainers. También puede ver la lista completa de páginas Wiki acerca de Empaquetamiento para ver si alguna aplica a su circunstancia.

En caso de que ello falle, puede encontrar recomendaciones útiles en los borradores no oficiales Packaging Drafts y Packaging Drafts To Do. Obviamente estos no son oficiales. Puede encontrar algunas ideas a partir de SuSE , Debian , pero recuerde las distribuciones difieren en sus reglas, así­ que no presuma que pueden ser utilizadas directamente.

Los archivos .spec que usted cree deben ser igualmente de código libre, como se nota en el CLA.

Mantenimiento de paquetes

Una vez que su paquete sea aceptado, usted, o sus comantenedores, deben mantenerlo. Vea el Package update HOWTO y el Package update guidelines para más información.

Si usted actualiza la versión en múltiples liberaciones de Fedora, hágalo "hacia atrás" en el tiempo, e.g., libere para Fedora N, luego, una vez aceptado, Fedora N-1 (el sistema presume que las versiones más recientes de Fedora poseen la misma o más recientes versiones de programas).

Para más información

La página Package Maintainers enlaza a muchas otras páginas útiles y Updating Package HOWTO describe como actualizar un paquete existente que ya usted mantiene en Fedora.

Para más información, fuera de este sitio, y del Wiki de Fedora, vea:

  • How to build RPM packages on Fedora - vistazo breve
  • Packaging software with RPM (developerWorks) Part 1 , Part 2 y Part 3 .
  • Fedora Packager's Handbook
  • When Sally met Eddie - un cuento simple, pero poco detalle.
  • Maximum RPM Book - la información más completa, pero en algunos casos, antigua/obsoleta.
  • RPM Guide, sección creando RPMs - esto tiene mucha buena información y es ligeramente más actualizada, pero es un borrador.
  • Developer's guide, section on building RPMs .
  • Creating RPMS slides de Guru Labs.
  • The fight, my first attempt to make a readable rpm package building introduction .
  • RPM Tutorial .
  • RPM HOWTO: RPM at Idle by Donnie Barnes .
  • RPM HowTo por Dawson.
  • SuSE build tutorial - es acerca de SuSE, no Fedora. Cross-distribution package HOWTO tiene algunas pistas si está creando un RPM para varias distribuciones.
  • Mandriva Rpm HowTo (alt ) es un tutorial RPM, para Mandriva (Mandrake). Nota: En Fedora no se recomprime los tarballs originales, como Mandriva sugiere porque ello cambiarí­a sus hash criptográficos.
  • Creating Your Own Linux RPM's - The Initial Software Build es otra introducción breve, pero anota acerca de que el proceso de construir RPMs es mucho más simple que crear paquetes para Solaris, menos pasos, y tiene la habilidad de agregar toda la información del software en un único archivo haciendo el proceso algo más compacto y fácil de modificar o reproducir para el caso del sistema de empaquetamiento de software.
  • All you need to know about RPM - más acerca de instalación de paquetes que acerca de crear paquetes.
  • El Wiki de rpm.org Wiki tiene algunas informaciones útiles, tal como la lista de problemas RPM conocidos .

Nota: El sitio de rpm5.org tien algo de documentación pero no dependa de ella, ese es el sitio del "fork" de RPM mantenido por Jeff Johnson. El RPM utilizado por Fedora y Novell/SuSE, está basado en rpm.org rpm.org. lwn.net tiene un breve artí­culo al respecto.