Converter ZIP para DEB

Um sistema baseado em Debian pode precisar de um pacote .deb para que o software possa ser instalado, atualizado e removido por meio do APT e do dpkg. Um arquivo ZIP deve ser descompactado e montado com metadados de pacote Debian; renomear .zip para .deb não cria um pacote instalável.

O que é ZIP

ZIP é um formato de arquivo de uso geral utilizado pelo Windows Explorer, macOS Archive Utility, 7-Zip, versões do GitHub, sistemas de build e fornecedores de software. Ele agrupa arquivos e pode compactá-los, mas não define caminhos de instalação do Linux, dependências de pacotes, arquitetura da CPU, proprietário, permissões ou comportamento de desinstalação.

Um ZIP pode conter código-fonte, recursos portáteis, software do Windows, binários do Linux ou um pacote Debian existente. Verifique seu conteúdo antes de tentar empacotá-lo:

unzip -l release.zip

Se o arquivo já contiver um arquivo .deb, extraia e use esse pacote em vez de recriá-lo:

unzip release.zip '*.deb'

O que é DEB

DEB é o formato de pacote binário usado pelo Debian, Ubuntu, Linux Mint e distribuições relacionadas. Um DEB é um arquivo ar que contém um marcador debian-binary, um arquivo de controle com metadados do pacote e um arquivo de dados com os arquivos a serem instalados.

Seus metadados de controle identificam o nome, a versão, a arquitetura, o mantenedor, as dependências e a descrição do pacote. O arquivo de dados normalmente instala executáveis em /usr/bin, arquivos compartilhados do programa em /usr/lib ou /usr/share e configurações em /etc.

Um pacote criado corretamente pode ser instalado com apt install ./package.deb. O APT pode obter as dependências declaradas a partir dos repositórios configurados, enquanto o dpkg registra os arquivos instalados para que possam ser removidos corretamente posteriormente.

Criar um DEB a partir de conteúdo ZIP adequado

Empacote somente software que já seja compatível com a versão do Debian e a CPU de destino. A ferramenta padrão para desktop e linha de comando é o dpkg-deb, fornecido pela instalação normal do dpkg. Ela cria um pacote válido, mas não determina dependências nem o local onde os arquivos devem ser instalados.

Instale as ferramentas de extração e de verificação de pacotes opcionais:

sudo apt update && sudo apt install unzip lintian

Crie diretórios separados para extração e preparação do pacote e, em seguida, examine os arquivos extraídos:

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

Copie os arquivos para o diretório de preparação usando os caminhos de instalação pretendidos. Para um executável nativo chamado myapp, instale-o da seguinte forma:

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

Coloque os dados específicos do aplicativo em caminhos como pkg/usr/share/myapp ou pkg/usr/lib/myapp. Não copie cegamente o diretório de nível superior de um arquivo para /, não substitua arquivos fornecidos por outro pacote e não instale arquivos arbitrários diretamente em /usr.

Crie pkg/DEBIAN/control com metadados 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.

Os nomes dos pacotes devem estar em letras minúsculas e podem conter letras, dígitos, +, - e .. Use Architecture: all somente para scripts, documentação, temas ou dados independentes de arquitetura; use valores como amd64 ou arm64 para binários e bibliotecas nativos. Declare somente dependências verificadas: ldd pode revelar os nomes das bibliotecas compartilhadas necessárias, mas não identifica de forma confiável os pacotes Debian ou as versões mínimas que as fornecem.

Crie o pacote com a propriedade root registrada em seu arquivo:

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

Inspecione e valide o resultado antes da distribuição:

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

Teste-o em uma máquina virtual, container ou sistema de teste descartável:

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

Limites de compatibilidade e empacotamento

Um wrapper DEB não faz com que software incompatível seja executado no Linux. Arquivos .exe do Windows, aplicativos do macOS, pacotes do Android e binários compilados para outra CPU exigem um runtime, port ou recompilação compatível; colocá-los em um DEB apenas altera a forma de distribuição.

Os arquivos ZIP frequentemente não preservam as permissões de executável do Unix. Use o modo 0755 para programas e scripts executáveis; arquivos comuns e bibliotecas normalmente usam 0644. Verifique se os arquivos instalados não dependem de caminhos relativos ao diretório original do ZIP.

Se o pacote instalar configurações editáveis em /etc, liste esses arquivos em DEBIAN/conffiles para que as atualizações do pacote preservem as alterações locais. Adicione scripts do mantenedor somente quando necessário; os scripts são executados com privilégios elevados durante a instalação e a remoção.

DEB não é inerentemente menor que ZIP. Ambos os formatos podem compactar dados, enquanto um DEB também inclui metadados do pacote e pode usar configurações de compactação diferentes.

Nenhum conversor online confiável consegue determinar com segurança os locais corretos dos arquivos, permissões, dependências, arquitetura e scripts de instalação a partir de conteúdo ZIP arbitrário. Evite enviar código-fonte ou executáveis proprietários para sites de conversão; crie o pacote localmente com dpkg-deb. Para software distribuído como código-fonte, use seus arquivos de empacotamento Debian ou um fluxo de trabalho adequado de pacote-fonte Debian em vez de reempacotar um ZIP de distribuição.