Convertir ZIP a DEB

Un sistema basado en Debian puede necesitar un paquete .deb para que el software se pueda instalar, actualizar y eliminar mediante APT y dpkg. Un archivo ZIP debe descomprimirse y ensamblarse con metadatos de paquete de Debian; cambiar el nombre de .zip a .deb no crea un paquete instalable.

Qué es ZIP

ZIP es un formato de archivo de propósito general utilizado por Windows Explorer, macOS Archive Utility, 7-Zip, las versiones de GitHub, los sistemas de compilación y los proveedores de software. Agrupa archivos y puede comprimirlos, pero no define las rutas de instalación de Linux, las dependencias del paquete, la arquitectura de CPU, el propietario, los permisos ni el comportamiento de desinstalación.

Un ZIP puede contener código fuente, recursos portátiles, software de Windows, binarios de Linux o un paquete de Debian existente. Compruebe su contenido antes de intentar empaquetarlo:

unzip -l release.zip

Si el archivo ya contiene un archivo .deb, extráigalo y use ese paquete en lugar de volver a compilarlo:

unzip release.zip '*.deb'

Qué es DEB

DEB es el formato de paquete binario utilizado por Debian, Ubuntu, Linux Mint y distribuciones relacionadas. Un DEB es un archivo ar que contiene un marcador debian-binary, un archivo de control con metadatos del paquete y un archivo de datos con los archivos que se instalarán.

Sus metadatos de control identifican el nombre del paquete, la versión, la arquitectura, el responsable, las dependencias y la descripción. Normalmente, el archivo de datos instala los ejecutables en /usr/bin, los archivos compartidos del programa en /usr/lib o /usr/share y la configuración en /etc.

Un paquete creado correctamente se puede instalar con apt install ./package.deb. APT puede obtener las dependencias declaradas de los repositorios configurados, mientras que dpkg registra los archivos instalados para poder eliminarlos limpiamente más adelante.

Crear un DEB a partir de contenido ZIP adecuado

Empaquete únicamente software que ya sea compatible con la versión de Debian y la CPU de destino. La herramienta estándar de escritorio y de línea de comandos es dpkg-deb, proporcionada por la instalación normal de dpkg. Crea un paquete válido, pero no adivina las dependencias ni dónde deben ubicarse los archivos.

Instale las herramientas de extracción y comprobación opcional de paquetes:

sudo apt update && sudo apt install unzip lintian

Cree directorios separados para la extracción y la preparación del paquete, y después inspeccione los archivos extraídos:

rm -rf work pkg
mkdir -p work pkg/DEBIAN
unzip release.zip -d work
find work -maxdepth 3 -type f

Copie los archivos en el directorio de preparación usando las rutas de instalación previstas. Para un ejecutable nativo llamado myapp, instálelo de la siguiente manera:

install -Dm755 work/myapp pkg/usr/bin/myapp

Coloque los datos específicos de la aplicación en rutas como pkg/usr/share/myapp o pkg/usr/lib/myapp. No copie ciegamente el directorio de nivel superior de un archivo en /, no sobrescriba archivos proporcionados por otro paquete ni instale archivos arbitrarios directamente bajo /usr.

Cree pkg/DEBIAN/control con metadatos válidos:

Package: myapp
Version: 1.0.0
Section: utils
Priority: optional
Architecture: amd64
Maintainer: Example Maintainer <maintainer@example.com>
Depends: libc6 (>= 2.34)
Description: Command-line application
A longer package description.

Los nombres de los paquetes deben estar en minúsculas y pueden contener letras, dígitos, +, - y .. Use Architecture: all únicamente para scripts, documentación, temas o datos independientes de la arquitectura; use valores como amd64 o arm64 para binarios y bibliotecas nativos. Declare solo dependencias verificadas: ldd puede mostrar los nombres de las bibliotecas compartidas necesarias, pero no identifica de forma fiable los paquetes de Debian ni las versiones mínimas que las proporcionan.

Compile el paquete registrando el propietario root en su archivo:

dpkg-deb --build --root-owner-group pkg myapp_1.0.0_amd64.deb

Inspeccione y valide el resultado antes de distribuirlo:

dpkg-deb --info myapp_1.0.0_amd64.deb
dpkg-deb --contents myapp_1.0.0_amd64.deb
lintian myapp_1.0.0_amd64.deb

Pruébelo en una máquina virtual, un contenedor o un sistema de prueba desechable:

sudo apt install ./myapp_1.0.0_amd64.deb
myapp
sudo apt remove myapp

Compatibilidad y límites del empaquetado

Un contenedor DEB no hace que el software incompatible se ejecute en Linux. Los archivos .exe de Windows, las aplicaciones de macOS, los paquetes de Android y los binarios compilados para otra CPU requieren un entorno de ejecución compatible, una adaptación o una recompilación; colocarlos en un DEB solo cambia la forma de distribución.

Los archivos ZIP con frecuencia no conservan los permisos de ejecución de Unix. Use el modo 0755 para programas y scripts ejecutables; los archivos normales y las bibliotecas normalmente usan 0644. Compruebe que los archivos instalados no dependan de rutas relativas del directorio original del ZIP.

Si el paquete instala una configuración editable en /etc, incluya esos archivos en DEBIAN/conffiles para que las actualizaciones del paquete conserven los cambios locales. Añada scripts del responsable solo cuando sea necesario; los scripts se ejecutan con privilegios elevados durante la instalación y la eliminación.

DEB no es inherentemente más pequeño que ZIP. Ambos formatos pueden comprimir datos, mientras que un DEB también incluye metadatos del paquete y puede utilizar distintos ajustes de compresión.

Ningún conversor en línea de buena reputación puede determinar de forma segura las ubicaciones correctas de los archivos, los permisos, las dependencias, la arquitectura y los scripts de instalación a partir de un contenido ZIP arbitrario. Evite subir código fuente o ejecutables propietarios a sitios de conversión; compile localmente con dpkg-deb. Para el software distribuido como código fuente, use sus archivos de empaquetado de Debian o un flujo de trabajo adecuado de paquetes fuente de Debian en lugar de volver a empaquetar un ZIP de versión.