added guide to make deb package
This commit is contained in:
parent
4ace38f58d
commit
faad7b0de0
GPG Key ID:
E47FE0AB36CD5ED6
220
content/posts/2025/linux/make-deb.md
Normal file
220
content/posts/2025/linux/make-deb.md
Normal file
@ -0,0 +1,220 @@
|
|||||||
|
---
|
||||||
|
title: "📦 Создание .deb пакета | dpkg-deb"
|
||||||
|
date: 2025-06-03T14:35:45+03:00
|
||||||
|
draft: false
|
||||||
|
tags: [linux, package, tutorial]
|
||||||
|
---
|
||||||
|
|
||||||
|
> Заметка является моим вольным переводом статьи
|
||||||
|
**internal / pointers**:
|
||||||
|
[Building binary deb packages: a practical guide](https://www.internalpointers.com/post/build-binary-deb-package-practical-guide)
|
||||||
|
|
||||||
|
# 📄 Инструкция по созданию `deb` пакета
|
||||||
|
|
||||||
|
Файл deb - это архив, содержащий данные программы и другие необходимые ресурсы.
|
||||||
|
Он используется для простого распространения и установки программ для Debian/Ubuntu и производных от них. Имеет расширение файла `.deb`.
|
||||||
|
Файлы `.deb` удобны, когда приложению необходимо позаботиться о дополнительных зависимостях,
|
||||||
|
выполнить интеграцию с рабочим столом, запускать сценарии до и после установки и так далее.
|
||||||
|
|
||||||
|
|
||||||
|
## 🩻 Анатомия `deb` пакета
|
||||||
|
|
||||||
|
`.deb` - это стандартный архив Unix, содержащий приложение и другие служебные файлы.
|
||||||
|
Наиболее важным из них является управляющий файл **control file**
|
||||||
|
в котором хранится информация о пакете и программе, которую он устанавливает.
|
||||||
|
|
||||||
|
Пакет `.deb` содержит набор папок, имитирующих типичную файловую систему Linux, таких как `/usr`, `/usr/bin`, `/opt` и так далее.
|
||||||
|
Файл, помещенный в один из этих каталогов, будет скопирован в то же место в реальной файловой системе во время установки.
|
||||||
|
Так, например, двоичный файл, помещенный в `<.deb>/usr/local/bin/binaryfile`, будет установлен в `/usr/local/bin/binaryfile`.
|
||||||
|
|
||||||
|
Все файлы пакетов `.deb` соответствуют определенному соглашению об именовании:
|
||||||
|
|
||||||
|
```text
|
||||||
|
<name>_<version>-<revision>_<architecture>.deb
|
||||||
|
```
|
||||||
|
|
||||||
|
То есть:
|
||||||
|
|
||||||
|
* `<name>` – название приложения;
|
||||||
|
* `<version>` – номер версии приложения;
|
||||||
|
* `<revision>` – номер версии текущего пакета;
|
||||||
|
* `<architecture>` – аппаратная архитектура.
|
||||||
|
|
||||||
|
Например, необходимо сделать пакет для программы под названием `hello` версии `1.0`, созданную для 64-разрядных процессоров ARM.
|
||||||
|
Имя файла `.deb` будет выглядеть примерно так `hello_1.0-1_arm64.deb`.
|
||||||
|
|
||||||
|
|
||||||
|
## 🧰 Создание `deb` пакета
|
||||||
|
|
||||||
|
Убедитесь, что в вашей системе установлена программа `dpkg-deb`: она необходима для создания окончательного архива.
|
||||||
|
|
||||||
|
|
||||||
|
### 📂 1. Создание рабочего каталога
|
||||||
|
|
||||||
|
Создайте временный рабочий каталог, в который будет помещен ваш пакет.
|
||||||
|
Следуйте тому же соглашению об именовании, которое было рассмотрено ранее.
|
||||||
|
Например:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
mkdir hello_1.0-1_arm64
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🗃️ 2. Создание внутренней структуры
|
||||||
|
|
||||||
|
Поместите файлы программы туда, куда они должны быть установлены в целевой системе.
|
||||||
|
Например, необходимо, чтобы программа была установлена в `/usr/local/bin`:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
mkdir -p hello_1.0-1_arm64/usr/local/bin
|
||||||
|
```
|
||||||
|
|
||||||
|
Флаг `-p` для команды `mkdir` создаст вложенные каталоги.
|
||||||
|
Далее нужно скопировать исполняемый файл в этот каталог:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
cp ~/YourProjects/Hello/hello hello_1.0-1_arm64/usr/local/bin
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### 🕵🏻♀️ 3. Создание управляющего файла
|
||||||
|
|
||||||
|
Файл `control` находится в каталоге `DEBIAN`.
|
||||||
|
Обратите внимание на заглавные буквы. Аналогичный каталог с именем `debian` (в нижнем регистре)
|
||||||
|
используется для хранения исходного кода так называемых [пакетов с исходным кодом](https://www.debian.org/doc/debian-policy/ch-source.html).
|
||||||
|
Это руководство посвящено бинарным пакетам, поэтому оно нам не нужно.
|
||||||
|
|
||||||
|
Давайте сначала создадим папку `DEBIAN`:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
mkdir helloworld_1.0-1_arm64/DEBIAN
|
||||||
|
```
|
||||||
|
|
||||||
|
А затем создайте пустой управляющий файл:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
touch helloworld_1.0-1_arm64/DEBIAN/control
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### 📝 4. Заполнение управляющего файла
|
||||||
|
|
||||||
|
Файл `control` - это просто список полей данных. Для бинарных пакетов существует минимальный набор обязательных полей:
|
||||||
|
|
||||||
|
* `Package` – название программы;
|
||||||
|
* `Version` – версия программы;
|
||||||
|
* `Architecture` – целевая архитектура;
|
||||||
|
* `Maintainer` – имя и адрес электронной почты лица, ответственного за обслуживание пакета;
|
||||||
|
* `Description` – краткое описание программы.
|
||||||
|
|
||||||
|
Для примера:
|
||||||
|
|
||||||
|
```text
|
||||||
|
Package: hello
|
||||||
|
Version: 1.0
|
||||||
|
Architecture: arm64
|
||||||
|
Maintainer: Ivan Sumkin <info@test.com>
|
||||||
|
Description: Программа, которая приветствует вас.
|
||||||
|
Вы можете добавить более подробное описание здесь. Обратите внимание на пробелы в начале этого абзаца.
|
||||||
|
```
|
||||||
|
|
||||||
|
Файл `control` может содержать дополнительные полезные поля, такие как [`раздел`](https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections),
|
||||||
|
к которому он принадлежит, или [список зависимостей](https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps).
|
||||||
|
|
||||||
|
Последнее чрезвычайно важно, если для корректной работы вашей программы требуются внешние библиотеки.
|
||||||
|
При желании вы можете заполнить его вручную, но есть вспомогательные инструменты, которые облегчат эту задачу.
|
||||||
|
Как это сделать будет показано в следующих нескольких абзацах.
|
||||||
|
|
||||||
|
|
||||||
|
### 🛠️ 5. Создание `deb` пакета
|
||||||
|
|
||||||
|
Это последний шаг. Вызовите `dpkg-deb` следующим образом:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
dpkg-deb --build --root-owner-group <package-dir>
|
||||||
|
```
|
||||||
|
|
||||||
|
Итак, в нашем примере:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
dpkg-deb --build --root-owner-group <helloworld_1.0-1_arm64>
|
||||||
|
```
|
||||||
|
|
||||||
|
Флаг `--root-owner-group` делает все содержимое пакета `deb` принадлежащим пользователю `root`, что является стандартным способом.
|
||||||
|
Без такого флага все файлы и папки принадлежали бы пользователю, которые могли бы отсутствовать в системе, в которую был бы установлен deb-пакет.
|
||||||
|
|
||||||
|
Приведенная выше команда сгенерирует файл `.deb` рядом с рабочим каталогом или выдаст сообщение об ошибке,
|
||||||
|
если что-то не так или отсутствует внутри пакета.
|
||||||
|
Если операция прошла успешно, пакет `,deb` готов к распространению.
|
||||||
|
|
||||||
|
|
||||||
|
## 🎯 Тестирование `deb` пакета
|
||||||
|
|
||||||
|
Рекомендуется протестировать ваш deb-пакет после его создания.
|
||||||
|
Вы можете установить его как любой другой обычный deb-пакет:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sudo dpkg -i <package>
|
||||||
|
```
|
||||||
|
|
||||||
|
Убедитесь, что его также можно легко удалить. Вы можете просто удалить пакет:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sudo dpkg -r <appname>
|
||||||
|
```
|
||||||
|
|
||||||
|
Или удалить его вместе с конфигурационными файлами (если таковые имеются):
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sudo dpkg -P <appname>
|
||||||
|
```
|
||||||
|
|
||||||
|
Убедитесь, что приложение было удалено правильно, выполнив:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
dpkg -l | grep <appname>
|
||||||
|
```
|
||||||
|
|
||||||
|
Команда `dpkg -l` выводит список всех установленных пакетов, в то время как `grep` выполняет поиск по `<имя_программы>`.
|
||||||
|
Если приложение было удалено правильно, выходные данные должны быть пустыми.
|
||||||
|
|
||||||
|
|
||||||
|
### 🐞 Иногда установка `.deb` идёт неправильно
|
||||||
|
|
||||||
|
Особенно, когда вы имеете дело со сценариями до/после установки или удаления, которые в какой-то момент дают сбой.
|
||||||
|
Это типичное сообщение об ошибке от `dpkg`, что препятствует какому-либо прогрессу.
|
||||||
|
|
||||||
|
```text
|
||||||
|
Package is in a very bad inconsistent state - you should reinstall it before attempting a removal.
|
||||||
|
```
|
||||||
|
|
||||||
|
Хитрость заключается в том, чтобы переместить все ссылки на ваш поврежденный пакет в безопасное место
|
||||||
|
(например, в каталог `/tmp`), а затем принудительно удалить его, например, так:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sudo mv /var/lib/dpkg/info/<packagename>.* /tmp/
|
||||||
|
sudo dpkg --remove --force-remove-reinstreq <packagename>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## 👨👩👦 Забота о внешних зависимостях
|
||||||
|
|
||||||
|
Вы можете сгенерировать их автоматически с помощью `dpkg-shlibdeps`. Программа проанализирует ваш двоичный код и выполнит поиск внешних символов.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
dpkg-shlibdeps -O path/to/binary/file
|
||||||
|
```
|
||||||
|
|
||||||
|
Флаг `-O` выведет зависимости.
|
||||||
|
Скопируйте выход терминала и вставьте его в раздел `Depends` вашего файла `DEBIAN/control`.
|
||||||
|
После этого вы можете избавиться от файла `debian/control`.
|
||||||
|
|
||||||
|
|
||||||
|
## 🤖 Запускайте скрипты до или после установки и удаления пакета
|
||||||
|
|
||||||
|
Четыре файла: `postinst`, `preinst`, `postrm` и `prerm` называются сценариями сопровождающего.
|
||||||
|
|
||||||
|
Эти файлы находятся в каталоге `DEBIAN` и, как следует из их названий,
|
||||||
|
`preinst` и `postinst` запускаются до и после установки,
|
||||||
|
в то время как `prerm` и `postrm` выполняются до и после удаления.
|
||||||
|
Они должны быть помечены как исполняемые файлы.
|
||||||
|
Кроме того, не забудьте указать права доступа: они должны быть в диапазоне от `0555` до `0775`.
|
||||||
Loading…
x
Reference in New Issue
Block a user