Xbps-src/es

From Void Linux Wiki
Jump to: navigation, search

Este artículo es una guía práctica para crear y construir paquetes desde plantillas llamadas templates (receta para constuir) con xbps-src. Puede encontrar la documentación oficial con más detalles técnicos en: inglés.

Nota: La página puede contener enlaces a otras que no se encuentran traducidas, cuyo idioma predeterminado es el inglés.

Requisitos

Se necesita xtools para enlazar los paquetes antes de que se envíe y se generen las sumas de verificación; esto también incluye una variedad de programas muy útiles:

 sudo xbps-install xtools

Bifurca (fork) un repositorio

Esto solo es necesario, si quiere hacer cambios en los repositorios oficiales de paquetes de Void Linux. Por otro lado, si no lo desea puede saltarse a la sección de Guía rápida.

Nota: Estese seguro, de que el software que empaquete cumpla con las normas contribución. Nosotros no aceptaremos cualquier paquete que contenga versiones no-liberadas como por ejemplo git específicos o revisiones-svn.

 git clone git@github.com:yourusername/void-packages.git
 cd void-packages
 git remote add upstream https://github.com/void-linux/void-packages.git

Crea una nueva rama

Estos pasos solo son necesarios llevarlos a cabo una vez. Cuando quiera hacer cualquier cambio o implementar alguna característica nueva (por ejemplo añadir un nuevo paquete y sus dependencias), descarge y cree una nueva rama desde el repositorio principal.

 git fetch upstream
 git checkout -b mi-nuevo-paquete-mola-ramal upstream/master

Guía rápida

Clone los paquetes del repositorio, en caso de que no lo haya hecho:

 git clone https://github.com/void-linux/void-packages
 cd void-packages

Cree un entorno de desarrollo rápido

 ./xbps-src binary-bootstrap

Modifique o cree una plantila, dependiendo de lo que quiera hacer. Le tomará un cierto tiempo leerse el manual de empaquetamiento (en inglés) para más información sobre el formato de las plantillas. Por favor, lea los estándares para nombrar los paquetes.

Para crear un nuevo paquete ( con la ayuda de la herramienta xtools), ejecútela:

 xnew mi-nuevo-paquete-mola-ramal

Este comando simplemente le creará un fichero básico de plantilla. Quizás tenga que añadir tus credenciales de usuario para el git, primero.

Para generar la suma de verificación sha256 para su nuevo, o cambio de la ruta del código fuente.

 xgensum -f srcpkgs/mi-nuevo-paquete-mola-ramal/template

Nota: Además, puede usar el comando xgensum para depurar su código con la función do_fetch(), para mostrar más sobre la salida de xbps-src. Por ejemplo git submodule puede fallar, si perl no está en la lista dentro de la variable hostmakedepends.

Construya su paquete:

 ./xbps-src pkg mi-nuevo-paquete-mola-ramal

Puede que falle la mayoría de las veces la primera vez que se intente, para corregir su paquete, vuelva a ejecutar xbps-src de nuevo. Puede ejecutar todo a la vez fases de empaquetamiento de forma independiente. Si no cambió las dependencias en una segunda ejecución, utilice el parámetro -I para saltarse los pasos de auto-eliminación y reinstalación.

 ./xbps-src -I build mi-nuevo-paquete-mola

Una vez que se hayan ejecutado correctamente los pasos del empaquetamiento, puede instalar su paquete:

 sudo xbps-install --repository=hostdir/binpkgs/mi-nuevo-paquete-mola mi-nuevo-paquete-mola

o (con la ayuda de xtools)

 xi mi-nuevo-paquete-mola

(xi automáticamente mezcla su repositorio local, si este se ejecuta dentro de una estructura void-packages)

Si ha modificado un paquete y no desea añadir un cambio en el repositorio oficial de paquetes, añádalo a modo espera:

 xbps-pkgdb -m hold <pkgname>

Publique los cambios

Ejecute el programa que ha instalado en su ordenador y compruebe si todo funciona como debiera. Entonces enlace su paquete y corrija todos los errores antes de continuar:

 xlint srcpkgs/mi-nuevo-paquete-mola/template

Comente sus cambios con un mensaje que siga las normas de comentado:

 git add srcpkgs/mi-nuevo-paquete-mola
 git commit -m "New package: mi-nuevo-paquete-mola-1337"

Nota: Si comete un error, utilice git commit --amend y ahora para corregirlo.

Suba los cambios desde su repositorio:

 git push -u origin mi-nuevo-paquete-mola-branch

Solicitud de aprobación

Para que le apruebaen sus cambios y siga las instrucciones que se han descrito en el artículo Contribuyendo.