dpkg
and apt
into believing that some package is installed even though it is only an empty shell. This allows satisfying dependencies on a package when the corresponding software was installed outside the scope of the packaging system. Such a method works, but it should still be avoided whenever possible, since there is no guarantee that the manually installed software behaves exactly like the corresponding package would and other packages depending on it would not work properly.
equivs-control
e equivs-build
(do pacote equivs). O comando equivs-control arquivo
cria um arquivo de cabeçalho de pacote Debian que deve ser editado para conter o nome do pacote desejado, seu número de versão, o nome do mantenedor, suas dependências e sua descrição. Outros campos, sem um valor padrão são opcionais e podem ser excluídos. Os campos Copyright
, Changelog
, Readme
e Extra-Files
não são campos padrões em pacotes Debian; eles só fazem sentido no âmbito da equivs-build
, e eles não serão mantidos nos cabeçalhos do pacote gerados.
Exemplo 15.2. Arquivo de cabeçalho do pacote falso libxml-libxml-perl
Section: perl Priority: optional Standards-Version: 4.4.1 Package: libxml-libxml-perl Version: 2.0134-1 Maintainer: Raphael Hertzog <hertzog@debian.org> Depends: libxml2 (>= 2.7.4) Architecture: all Description: Fake package - module manually installed in site_perl This is a fake package to let the packaging system believe that this Debian package is installed. . In fact, the package is not installed since a newer version of the module has been manually compiled & installed in the site_perl directory.
equivs-build arquivo
. Voilà: o pacote foi criado no diretório atual e pode ser manejado como qualquer outro pacote Debian seria.
falcot-data-1.0
que conterá o pacote fonte. O pacote irá, logicamente, ser chamado de falcot-data
e terá o número de versão 1.0
. O administrador então coloca os documentos em um subdiretório data
. Então ele chama o comando dh_make
(do pacote dh-make) para adicionar os arquivos necessários para o processo de criação do pacote, o qual será armazenado em um subdiretório debian
:
$
cd falcot-data-1.0
$
dh_make --native
Type of package: (single, indep, library, python) [s/i/l/p]?
i
Maintainer Name : Raphael Hertzog Email-Address : hertzog@debian.org Date : Fri, 04 Sep 2015 12:09:39 -0400 Package Name : falcot-data Version : 1.0 License : gpl3 Package Type : indep Are the details correct? [Y/n/q] Currently there is not top level Makefile. This may require additional tuning Done. Please edit the files in the debian/ subdirectory now. $
Architecture: all
). single acts as a counterpart, and leads to a single binary package that is dependent on the target architecture (Architecture: any
). In this case, the former choice is more relevant since the package only contains documents and no binary programs, so it can be used similarly on computers of all architectures.
dh_make
criou uma pasta debian
com muitos arquivos. Alguns são necessários, em particular rules
, control
, changelog
e copyright
. Arquivos com extensão .ex
são exemplos de arquivos que podem ser utilizados, modificando-os (e removendo a extensão), se for o caso. Quando eles não são necessários, entao é recomendado removê-los. O arquivo compat
deve ser mantido, uma vez que é necessário para o funcionamento correto do conjunto de programas debhelper (todos começando com o prefixo dh_
) utilizado em diferentes estágios do processo de construção do pacote.
copyright
file must contain information about the authors of the documents included in the package, and the related license. In our case, these are internal documents and their use is restricted to within the Falcot Corp company. The default changelog
file is generally appropriate; replacing the “Initial release” with a more verbose explanation and changing the distribution from unstable
to internal
is enough. The control
file was also updated: the Section
field has been changed to misc and the Homepage
, Vcs-Git
and Vcs-Browser
fields were removed. The Depends
fields was completed with firefox-esr | www-browser
so as to ensure the availability of a web browser able to display the documents in the package.
Exemplo 15.3. O arquivo control
Source: falcot-data Section: misc Priority: optional Maintainer: Raphael Hertzog <hertzog@debian.org> Build-Depends: debhelper (>= 10) Standards-Version: 4.4.1 Package: falcot-data Architecture: all Depends: firefox-esr | www-browser, ${misc:Depends} Description: Internal Falcot Corp Documentation This package provides several documents describing the internal structure at Falcot Corp. This includes: - organization diagram - contacts for each department. . These documents MUST NOT leave the company. Their use is INTERNAL ONLY.
Exemplo 15.4. O arquivo changelog
falcot-data (1.0) internal; urgency=low * Initial Release. * Let's start with few documents: - internal company structure; - contacts for each department. -- Raphael Hertzog <hertzog@debian.org> Fri, 04 Sep 2015 12:09:39 -0400
Exemplo 15.5. O arquivo copyright
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: falcot-data Files: * Copyright: 2004-2019 Falcot Corp License: All rights reserved.
rules
geralmente contém um conjunto de regras usado para configurar, construir e instalar o software em um subdiretório específico (nomeado de acordo com o pacote binário gerado). O conteúdo desta pasta é depois arquivado dentro do pacote Debian, como se fosse a raiz do sistema de arquivos. No nosso caso, os arquivos serão instalados na pasta debian/falcot-data/usr/share/falcot-data/
, para que a instalação do pacote gerado implante os arquivos em /usr/share/falcot-data/
. O arquivo rules
é utilizado como um Makefile
, com alguns alvos padrões (incluindoclean
e binary
, utilizados, respectivamente, para limpar a pasta de origem e gerar o pacote binário).
debhelper
. Tal é o cado dos arquivos gerados pelo dh_make
. Para instalar nossos arquivos, nós simplesmente configuramos o comportamento do comando dh_install
criando o seguinte arquivo debian/falcot-data.install
:
data/* usr/share/falcot-data/
falcot-data.desktop
file and get it installed in /usr/share/applications
by adding a second line to debian/falcot-data.install
.
Exemplo 15.6. O arquivo falcot-data.desktop
[Desktop Entry] Name=Internal Falcot Corp Documentation Comment=Starts a browser to read the documentation Exec=x-www-browser /usr/share/falcot-data/index.html Terminal=false Type=Application Categories=Documentation;
debian/falcot-data.install
atualizado se parece com isso:
data/* usr/share/falcot-data/ falcot-data.desktop usr/share/applications/
dpkg-buildpackage -us -uc
command from within the falcot-data-1.0
directory.