makepkg (Español)
makepkg es usado para compilar y construir paquetes capaces de instalar mediante pacman, el manejador de paquetes de Arch Linux. makepkg es un script que automatiza el proceso de construcción de paquetes; este puede descargar y validar archivos fuente, resolver dependencias, configurar los parámetros de tiempo de compilación, compilar las fuentes e instalarlo dentro de un root temporal.
makepkg lo provee el paquete pacman.
Configuración
El archivo principal de configuración de makepkg es /etc/makepkg.conf
. la mayoría de los usuarios querrán configurar estas opciones de makepkg antes de construir cualquier paquete (por ejemplo modificar las variables MAKEFLAGS
en sistemas con soporte SMP para reducir tiempos de compilación , o personalizar la variable PACKAGER
para personalizar paquetes. Lea la documentación de PACKAGER
para más detalles
Para poder instalar paquetes con makepkg sin ser usuario administrador (con makepkg -s
, información más delante), instale sudo y agregue los usuarios con estos privilegios en el archivo to /etc/sudoers
:
USER_NAME ALL=(ALL) NOPASSWD: /usr/bin/pacman
La línea de arriba eliminara la necesidad de introducir un password cada vez que utilicemos pacman. Revise la wiki de sudo para mas información
Enseguida, puede configurar donde serán guardados los paquetes terminados. Este paso es meramente opcional; por definición los paquetes serán creados en el directorio donde makepkg se ejecute Cree el directorio:
$ mkdir /home/$USER/packages
Luego modifique la variable PKGDEST
en el archivo /etc/makepkg.conf
de acuerdo a esta directorio.
Información del empaquetador
Cada paquete es etiquetado con meta información que identifica entre otros el packager. Por defecto, paquetes compilados por el usuario son marcados con Unknown Packager
. Si múltiples usuarios van a compilar paquetes en un sistema o si planea distribuir sus paquetes con otros usuarios, es conveniente proveer un contacto real. Esto se puede hacer modificando la variable PACKAGER
en el archivo makepkg.conf
.
Para revisar esta variable en un paquete instalado ejecute:
$ pacman -Qi paquete
... Packager : John Doe <john@doe.com> ...
Para firmar sus paquete automaticamente, tambien modifique la variable GPGKEY
en el archivo makepkg.conf
.
Resultado del paquete
Por defecto, makepkg crea tarballs de los paquetes en el directorio de trabajo y descarga las fuentes en el directorio src/
. Rutas personalizadas pueden ser configuradas, por ejemplo para mantener todos los paquetes construidos en ~/build/packages/
y todas las fuentes en ~/build/sources/
.
Configure las siguientes variables en makepkg.conf
, si lo considera necesario:
PKGDEST
— directorio para guardar los paquetes resultantesSRCDEST
— directorio para guardar datos fuente, (links simbólicos seran puestos ensrc/
si la ruta es diferente)SRCPKGDEST
— directorio para guardar las fuentes resultantes (construido conmakepkg -S
)
Verificación de firmas
Si una firma de la forma .sig
o .asc
es parte del PKGBUILD en la sección source, makepkg automáticamente intentara verificarla. En caso de que el llavero del usuario no contenga la clave pública para la verificación makepkg abortara el procedimiento con un mensaje que la clave PGP no pudo ser verificada.
Si una clave pública es necesaria, el PKGBUILD probablemente tendrá una sección validpgpkeys con las IDs requeridas. Se puede importar manualmente, o la puede ubicar en un keyserver e importarla desde allí.
fakeroot
fakeroot
permite al usuario usar los permisos necesarios de root para crear paquetes en el ambiente de construcción sin necesidad de alterar todo el sistema. Si el proceso de construcción trata de alterar archivos fuera del ambiente de construcción entonces aparecerán mensajes de error y el empaquetado habrá fallado – esto es muy útil para verificar la calidad, seguridad e integridad de los PKGBUILD para su distribución. Por default fakeroot
esta habilitado en el archivo de configuración /etc/makepkg.conf
; los usuarios pueden utilizar el prefijo !
en la variable BUILDENV
para deshabilitar esto.
Utilización
Antes de continuar, asegúrese de que el grupo de paquetes base-devel este instalado. Los paquetes pertenecientes a este grupo no son requeridos en la lista de dependencias en los PKGBUILD.
Para crear un paquete primero debe tener un PKGBUILD, como se describe en la guía de in Creating packages, o obtenga uno del ABS tree, Arch User Repository, u obténgalo de alguna otra fuente.
Una vez en posesión de un PKGBUILD
, entre al directorio donde esta salvado este archivo y ejecute el siguiente comando para compilar y construir el paquete como lo fue descrito en el archivo un PKGBUILD
:
$ makepkg
Si no se satisfacen algunas dependencias, makepkg mostrara una advertencia antes de fallar, para construir el paquete e instalar sus dependencias automáticamente, simplemente se utiliza el comando:
$ makepkg -s
- Estas dependencias deben estar disponibles dentro de los repositorios disponibles para pacman, vea pacman (Español)#Repositorios y servidores de réplicas para mayor información al respecto. También se pueden instalar las dependencias antes de construir el paquete (
pacman -S --asdeps dep1 dep2
). - Solo se utilizarán valores globales cuando se instalen las dependencias, por ejemplo, cualquier anulación hecha en la función de paquete dividido no sera usado.
Una vez que se hayan satisfecho todas las dependencias y el paquete se construyo satisfactoriamente, un archivo con el nombre (pkgname-pkgver.pkg.tar.gz
) será creado en el directorio de trabajo. Para instalarlo (al igual que pacman -U pkgname-pkgver.pkg.tar.gz
) simplemente se ejecuta:
$ makepkg -i
Para despejar archivos que no son necesarios, como los existentes en $srcdir
, agregue la opción -c
. Este comando es útil al actualizar la version de los paquetes usando el mismo directorio. Se previene la transferencia de archivos obsoletos en la nueva construcción.
$ makepkg -c
Para mas información, mire makepkg(8).
Recomendaciones
Construir binarios optimizados
Una mejora de rendimiento del empaquetado de software se puede lograr habilitando optimizaciones en la máquina local. El inconveniente es que los binarios compilados para una arquitectura de procesador específico pueden no ejecutarse correctamente en otros ordenadores. En las máquinas x86_64 es raro ganar un rendimiento significativo que justifique invertir tiempo en reconstruir los paquetes oficiales.
Sin embargo es muy fácil disminuir el rendimiento utilizando FLAGS de compilación "no estandar". Muchas optimizaciones son útiles solo en determinadas situaciones y no debe de aplicarse para todos los paquetes. A no haya ser que puedas verificar que algo es más rápido, es una muy buena oportunidad ¡como no! Los artículos de Gentoo Guía de optimización de compilación y CFLAGS Seguros (en ingles) proporciona mas información detallada sobre optimizaciones de compilador.
Las opciones pasadas al compilador C/C++ (e.g. gcc o clang) están controladas por CFLAGS
, CXXFLAGS
y CPPFLAGS
variables de entorno. Para usarlos en el sistema de construcción de Arch, makepkg muestra las variables de entorno según las opciones de configuración en makepkg.conf
. Los valores por defecto están configurados para producir binarios genéricos que pueden ser instalados en un amplio rango de máquinas.
- Tener en cuenta que no todos los sistemas de construcciones utilizan las variables configuradas en
makepkg.conf
. Por ejemplo, cmake no tiene en cuenta las opciones de preprocesamientoCPPFLAGS
. Consecuentemente, muchos PKGBUILD contienen métodos alternativos con opciones específicas para el sistema constructor usado por el gestor de paquetes. - La configuración proporcionada con el código fuente en el
Makefile
o algún argumento específico en la compilación desde la linea de comandos tiene preferencia y puede potencialmente sobrescribir el demakepkg.conf
.
GCC puede detectar automáticamente y habilitar de forma segura las optimizaciones especificas de la arquitectura. Para utilizar esta función, primero elimina cualquier -march
y -mtune
flags, después añade -march=native
. Por ejemplo:
/etc/makepkg.conf
CFLAGS="-march=native -O2 -pipe -fstack-protector-strong -fno-plt" CXXFLAGS="${CFLAGS}"
Para ver que flags estan habilitadas en tu ordenador, ejecuta:
$ gcc -march=native -v -Q --help=target
-march=native
, después -Q --help=target
puede no funcionar como se espera.[2] Necesitas ir por los pasos de la compilación para ver que opciones están habilitadas realmente. Mira Find CPU-specific options en la wiki de Gentoo para instrucciones.Mejorar tiempos de compilación
Compilación paralela
El sistema de construcción make usa las MAKEFLAGS
como variables de entorno para especificar opciones adicionales. Las variables también pueden ser definidas en el archivo /etc/makepkg.conf
.
Usuarios con sistemas que poseen múltiples núcleos o CPU pueden especificar el número de trabajos a ejecutar simultáneamente. Esto se puede realizar usando nproc para determinar el número de procesadores disponibles, v.g. modificando la línea MAKEFLAGS
en /etc/makepkg.conf
.
MAKEFLAGS="-j$(nproc)"
Para decirle al compilador que use un número especifico de núcleos al momento de compilar, se usa el mismo parámetro -j<numero_de_núcleos>
. El número recomendado es n+1, donde n es la cantidad de núcleos de tu procesador.
Por ejemplo un procesador de 2 núcleos (2+1=3):
/etc/makepkg.conf
... #-- Make Flags: change this for DistCC/SMP systems MAKEFLAGS="-j3" ...
Algunos PKGBUILD sobrescriben específicamente con -j1
, por las condiciones en algunas versiones o porque simplemente no están soportadas en primer lugar. Paquetes que fallen la construcción por esto debe de ser reportado en el bug tracker (o en su caso de los paquetes del AUR, al mantenedor del paquete) después de estar seguro que ese error lo causa su MAKEFLAGS
.
Vea make(1) para una lista completa de opciones.
Construir desde archivos en memoria
La compilación requiere muchas operaciones I/O y manejar muchos archivos pequeños, moviendo el directorio de trabajo a tmpfs puede mejorar los tiempos de compilación.
La variable BUILDDIR
se puede exportar temporalmente a makepkg para establecer el directorio de trabajo a un tmpfs existente. Por ejemplo:
$ BUILDDIR=/tmp/makepkg makepkg
La configuración duradera se puede hacer en makepkg.conf
descomentando la opción BUILDDIR
, que se encuentra al final de la sección BUILD ENVIRONMENT
en el archivo /etc/makepkg.conf
por defecto. Estableciendo el valor en, por ejemplo, BUILDDIR=/tmp/makepkg
hará que make use el sistema de archivos temporal /tmp
por defecto en Arch.
- Evita compilar paquetes grandes en tmpfs para prevenir que se ejecute fuera de memoria.
- La carpeta tmpfs tiene que estar montada sin la opción
noexec
, si no evitara ejecutar la construcción de binarios. - Mantén en mente que los paquetes compilados en tmpfs no perdurarán en un reinicio. Considera establecer la opción PKGDEST apropiada para mover el paquete construido automáticamente a un directorio persistente.
Usar caché de compilación
El uso de ccache puede mejorar los tiempos de compilación generando caché los resultados de las compilaciones para utilizarlos sucesivamente.
Generar nueva suma de verificación
Instala pacman-contrib y ejecute el siguiente comando en el mismo directorio que el PKGBUILD para generar una nueva suma de verificación:
$ updpkgsums
Las sumas de verificación pueden también obtenerse con, por ejemplo, sha256sum
y añadirlo al array sha256sums
a mano.
Usar otros algoritmos de compresión
Para acelerar la empaquetación y la instalación, con la desventaja de tener paquetes más grandes, cambia PKGEXT
. Por ejemplo, lo siguiente hace que el paquete se descomprima para una sola invocación:
$ PKGEXT='.pkg.tar' makepkg
Otro ejemplo, usar el algoritmo lzop, con el paquete necesario lzop:
$ PKGEXT='.pkg.tar.lzo' makepkg
Para hacer estas configuraciones permanentes, establece PKGEXT
en /etc/makepkg.conf
.
Uso de múltiples núcleos en la compresión
xz es compatible con Multiprocesamiento_simétrico (SMP) con el párametro --threads
para acelerar la compresión. Para permitir que makepkg use tantos núcleos como sea possible al comprimir paquetes, edite la linea COMPRESSXZ
en /etc/makepkg.conf
:
COMPRESSXZ=(xz -c -z - --threads=0)
pigz es una implementación paralela de gzip en la que por defecto utiliza todos los núcleos de la CPU disponibles. El parámetro -p/--processes
se puede utilizar para que utilice menos núcleos:
COMPRESSGZ=(pigz -c -f -n)
pbzip2 en un drop-in, la implementación paralela para bzip2 que también utiliza todos los nucleos CPU disponibles por defecto. El parámetro -p#
se puede utilizar para emplear menos núcleos (Nota: no hay ningún espacio entre -p
y el número de núcleos).
COMPRESSBZ2 =(pbzip2 -c -f)
zstd soporta multiprocesamiento simétrico (SMP) a través de la bandera --threads
para acelerar la compresión. Por ejemplo, para dejar que makepkg utilice tantos nucleos de CPU como sea posible para comprimir paquetes edite el array COMPRESSZST
en /etc/makepkg.conf
:
COMPRESSZST=(zstd -c -z -q - --threads=0)
Ver paquetes con un empaquetador específico
Esto muestra todos los paquetes instalados en el sistema con el empaquetador nombreempaqueetador:
$ expac "%n %p" | grep "nombreempaquetador" | column -t
Esto muestra todos los paquetes instalados en el sistema con el empaquetador establecido en la variable PACKAGER
en el /etc/makepkg
. Solo muestra los paquetes que están en el repositorio definido en /etc/pacman.conf
.
$ . /etc/makepkg.conf; grep -xvFf <(pacman -Qqm) <(expac "%n\t%p" | grep "$PACKAGER$" | cut -f1)
Construir paquetes de 32-bit en un sistema de 64-bit
Primero, habilite el repositorio multilib e instala multilib-devel.
Después crea un archivo de configuración de 32-bit.
~/.makepkg.i686.conf
CARCH="i686" CHOST="i686-unknown-linux-gnu" CFLAGS="-m32 -march=i686 -mtune=generic -O2 -pipe -fstack-protector-strong" CXXFLAGS="${CFLAGS}" LDFLAGS="-m32 -Wl,-O1,--sort-common,--as-needed,-z,relro"
y ejecuta makepkg así
$ linux32 makepkg --config ~/.makepkg.i686.conf
Solución de problemas
CFLAGS/CXXFLAGS/LDFLAGS en makepkg.conf no funcionan en los paquetes basados en CMake
Con el fin de dejar que CMake use las variables definidas en makepkg.conf
, simplemente no especifique la variable -DCMAKE_BUILD_TYPE
cuando configure un proyecto cmake.[3]
Esto causa que cmake utilice una construcción tipo None
en la que utiliza las variables de entorno como CFLAGS
, CPPFLAGS
, etc.
Especificar el directorio de instalación para los paquetes basados en QMAKE
El makefile generado por "qmake" utiliza la variable de entorno INSTALL_ROOT
para determinar dónde se va a instalar el programa. Así que esta funcion del paquete debería funcionar:
PKGBUILD
... package() { cd "$srcdir/${pkgname%-git}" make INSTALL_ROOT="$pkgdir" install } ...
Tenga en cuenta que qmake tiene que estar configurado correctamente, por ejemplo ponga esto en su archivo ".pro":
YourProject.pro
... target.path = /usr/local/bin INSTALLS += target ...
ADVERTENCIA: Paquetes que contienen referencias a $srcdir
Por alguna razón, las cadenas $srcdir
o $pkgdir
literales acaban en uno de los archivos de instalación en su paquete.
Para identificar que archivos son, ejecute lo siguiente desde el directorio de construcción de makepkg:
$ grep -R "$PWD/src" pkg/
Una posible causa puede ser por el uso de la macro __FILE__
en el código C/C++ con la ruta absoluta pasada al comilador.
Makepkg falla al descargar las dependencias a través de un proxy
Cuando makepkg llama a las dependencias, llama a pacman para instalar los paquetes, que requieren permisos administrativos via sudo. De todas formas, sudo no pasa ninguna variable de entorno al entorno con privilegios, incluido las variables relacionadas con el proxy ftp_proxy
, http_proxy
, https_proxy
, y no_proxy
.
Para tener a makepkg trabajando a través de un proxy tiene que seguir uno de los dos métodos.
Habilitar proxy estableciendo su URL en XferCommand
XferCommand puede establecerse para utilizar la URL del proxy deseado en /etc/pacman.conf
. Añade o descomenta la siguiente línea en su pacman.conf
[4]:
/etc/pacman.conf
... XferCommand = /usr/bin/curl -x http://username:password@proxy.proxyhost.com:80 -L -C - -f -o %o %u ...
Habilitar proxy via sudoer's env_keep
Alternativamente, puede querer utilizar la opción env_keep
, que habilita preservar las variables dadas al entorno privilegiado.
Vea Sudo (Español)#Variables de entorno para más información.
Makepkg falla, pero el make termina bien
Si algo se compila manualmente utilizando make, pero falla al utilizar makepkg, casi seguro que es porque el /etc/makepkg.conf
establece la variable de compilación a algo que normalmente funciona, pero lo que usted esta compilando sea incompatible. Intente añadir estos parámetros a la linea options
del PKGBUILD:
!buildflags
, para evitar que utilice CPPFLAGS
, CFLAGS
, CXXFLAGS
, y LDFLAGS
dadas por defecto.
!makeflags
, para evitar que utilice MAKEFLAGS
por defecto, en caso de que se haya editado /etc/makepkg.conf
para habilitar la compilación paralela.
!debug
, para evitar que utilice DEBUG_CFLAGS
y DEBUG_CXXFLAGS
dadas por defecto, en caso de que su paquete sea una construcción debug.
Si alguno de estos parámetros soluciona el problema, lo puede indicar reportando un bug, si usted localiza que parámetro exactamente está causando el problema.