📚 ПАМЯТКА: Сборка пакетов локально на ROSA Linux

Версия: для ROSA 13
Формат пакетов: RPM
Инструменты: rpmbuild, meson, cmake, make

---

1. 🔧 Подготовка окружения

Шаг 1.1: Установите инструменты для сборки

sudo dnf install -y rpm-build rpmdevtools wget git

Пакет	Назначение
rpm-build	Базовые инструменты сборки RPM
rpmdevtools	Утилиты для разработчиков (rpmdev-setuptree, etc.)
wget / curl	Загрузка исходников
git	Работа с репозиториями

Шаг 1.2: Создайте структуру директорий

rpmdev-setuptree

Это создаст стандартную структуру в ~/rpmbuild/:

~/rpmbuild/
├── BUILD/          # Распаковка и компиляция исходников
├── BUILDROOT/      # Временная корневая система для установки
├── RPMS/           # Готовые бинарные пакеты (.rpm)
├── SOURCES/        # Исходные архивы, патчи, иконки
├── SPECS/          # Spec-файлы (инструкции сборки)
└── SRPMS/          # Исходные пакеты (.src.rpm)

Шаг 1.3: Проверка структуры

ls -la ~/rpmbuild/

---

2. 📁 Структура директорий (подробно)

Директория	Назначение	Что хранить
SOURCES/	Исходные материалы	.tar.gz, .patch, .desktop, .png
SPECS/	Инструкции сборки	.spec файлы
BUILD/	Рабочая область	Автоматически создаётся при сборке
BUILDROOT/	Псевдокорень	Автоматически создаётся при сборке
RPMS/	Готовые пакеты	.rpm файлы (результат)
SRPMS/	Исходные пакеты	.src.rpm (для передачи другим)

---

3. 📄 Создание spec-файла

Шаг 3.1: Шаблон spec-файла

Создайте файл ~/rpmbuild/SPECS/имя-пакета.spec:

nano ~/rpmbuild/SPECS/myapp.spec

Шаг 3.2: Минимальный шаблон

# ========== ЗАГОЛОВОК ==========
Name:           myapp
Version:        1.0.0
Release:        1
Summary:        Краткое описание программы
License:        GPLv2
Group:          Applications/Other
URL:            https://example.com/myapp
Source0:        %{name}-%{version}.tar.gz

# ========== ЗАВИСИМОСТИ ==========
# Для сборки (не войдут в готовый пакет)
BuildRequires:  meson
BuildRequires:  ninja
BuildRequires:  gtk3-devel

# Для запуска (войдут в зависимости пакета)
Requires:       gtk3
Requires:       lib64gtk3.0_0

# ========== ОПИСАНИЕ ==========
%description
Подробное описание программы. Что она делает,
для чего предназначена, основные возможности.

# ========== ПОДГОТОВКА ==========
%prep
%setup -q
# Здесь можно применить патчи:
# %patch -p1 -i %{SOURCE1}

# ========== СБОРКА ==========
%build
%meson
%meson_build

# ========== УСТАНОВКА ==========
%install
%meson_install

# ========== ФАЙЛЫ ==========
%files
%{_bindir}/myapp
%{_datadir}/applications/*.desktop
%{_datadir}/icons/hicolor/*/apps/*.png
%doc README.md LICENSE
%{_mandir}/man1/*.1*

# ========== СКРИПТЫ ==========
%post
%desktop_database_update
%icon_theme_cache_update

%postun
%desktop_database_update
%icon_theme_cache_update

# ========== ЖУРНАЛ ИЗМЕНЕНИЙ ==========
%changelog
* Fri Mar 20 2026 Your Name <your@email.com> - 1.0.0-1
- Initial build for ROSA Linux

Шаг 3.3: Основные поля заголовка

Поле	Описание	Пример
Name	Имя пакета (строчные буквы, без пробелов)	myapp
Version	Версия программы	1.0.0
Release	Номер сборки пакета	1
Summary	Краткое описание (одна строка)	Мой приложение
License	Лицензия	GPLv2, MIT, BSD
Group	Группа пакета	Applications/Other
URL	Сайт проекта	https://example.com
Source0	Исходный архив	%{name}-%{version}.tar.gz

---

4. 🚀 Процесс сборки

Шаг 4.1: Поместите исходники в SOURCES

cd ~/rpmbuild/SOURCES
wget https://example.com/myapp-1.0.0.tar.gz

Шаг 4.2: Запустите сборку

cd ~/rpmbuild/SPECS
rpmbuild -ba myapp.spec

Ключ	Описание
-ba	Сборка бинарного + исходного пакета
-bb	Только бинарный пакет
-bs	Только исходный пакет
-bi	Только установка (%install)
-bc	Только компиляция (%build)

Шаг 4.3: Проверьте результат

# Готовые пакеты
ls -lh ~/rpmbuild/RPMS/x86_64/*.rpm

# Исходный пакет
ls -lh ~/rpmbuild/SRPMS/*.src.rpm

Шаг 4.4: Установите пакет

sudo dnf install ~/rpmbuild/RPMS/x86_64/myapp-1.0.0-1.x86_64.rpm

---

5. 🔍 Полезные команды

Проверка и отладка

# Проверить spec-файл на ошибки
rpmlint ~/rpmbuild/SPECS/myapp.spec

# Проверить готовый пакет
rpmlint ~/rpmbuild/RPMS/x86_64/myapp-*.rpm

# Показать зависимости пакета
rpm -qpR ~/rpmbuild/RPMS/x86_64/myapp-*.rpm

# Показать файлы в пакете
rpm -qlp ~/rpmbuild/RPMS/x86_64/myapp-*.rpm

# Показать информацию о пакете
rpm -qip ~/rpmbuild/RPMS/x86_64/myapp-*.rpm

Поиск зависимостей

# Найти пакет по имени
dnf search название

# Найти пакет, который предоставляет файл
dnf provides /usr/bin/команда

# Найти development-пакет
dnf search название | grep devel

# Проверить установленные пакеты
rpm -qa | grep название

Работа с pkg-config

# Проверить наличие библиотеки
pkg-config --exists название && echo "Найдено" || echo "Не найдено"

# Узнать версию
pkg-config --modversion название

# Узнать флаги компиляции
pkg-config --cflags название

# Узнать флаги линковки
pkg-config --libs название

# Найти .pc файл
find /usr -name "название*.pc" 2>/dev/null

Очистка

# Очистить BUILD (освобождает место)
rm -rf ~/rpmbuild/BUILD/*

# Очистить BUILDROOT
rm -rf ~/rpmbuild/BUILDROOT/*

# Очистить кэш dnf
sudo dnf clean all

---

6. ❌ Частые ошибки и решения

Ошибка 1: Неудовлетворённые зависимости сборки

ошибка: Неудовлетворенные зависимости сборки:
        gtk3-devel нужен для myapp-1.0.0-1.x86_64

Решение:

# Найти правильное имя пакета
dnf search gtk3 | grep devel

# Установить зависимость
sudo dnf install lib64gtk3.0-devel

# Запустить сборку снова
rpmbuild -ba myapp.spec

---

Ошибка 2: Файл не найден в %files

ошибка: Файл не найден: /home/teo/rpmbuild/BUILDROOT/.../usr/bin/myapp

Решение:

1. Проверьте, куда реально устанавливаются файлы:

   # Временно отключите проверку файлов
   # Добавьте в конец spec-файла:
   %define _missing_doc_files_terminate_build 0

2. Или исправьте список в %files

---

Ошибка 3: Архив распаковывается в другую папку

cd: myapp-1.0.0: No such file or directory

Решение:

# Узнайте реальное имя папки
tar -tzf ~/rpmbuild/SOURCES/myapp-1.0.0.tar.gz | head -1

# Укажите его в %prep
%prep
%setup -q -n RealFolderName-1.0.0

---

Ошибка 4: Библиотека не найдена (pkg-config)

Dependency "libname" not found, tried pkgconfig and cmake

Решение:

# Найти .pc файл
find /usr -name "libname*.pc" 2>/dev/null

# Если файл есть, но с другим именем — создать симлинк
sudo ln -s /usr/lib64/pkgconfig/real-name.pc /usr/lib64/pkgconfig/expected-name.pc

# Если файла нет — установить development-пакет
sudo dnf install libname-devel

---

Ошибка 5: Несовместимость версий библиотек

Invalid version, need 'libname' ['>= 2.0'] found '1.5'

Решение:

1. Попробовать более старую версию программы
2. Сделать зависимость необязательной в meson.build:

   %prep
   %setup -q
   sed -i "s/dependency('libname'/dependency('libname', required: false/" meson.build

3. Обновить библиотеки в системе (если возможно)

---

Ошибка 6: Vala не находит пакет

error: Package 'packagename' not found in specified Vala API directories

Решение:

# Найти .vapi файлы
find /usr -name "*.vapi" 2>/dev/null | grep packagename

# Создать симлинк с ожидаемым именем
sudo ln -s /usr/share/vala/vapi/real-name.vapi /usr/share/vala/vapi/expected-name.vapi

---

7. 📖 Шпаргалка по макросам

Стандартные макросы ROSA

Макрос	Значение	Пример
%{_prefix}	/usr	%{_prefix}/bin
%{_bindir}	/usr/bin	%{_bindir}/myapp
%{_libdir}	/usr/lib64	%{_libdir}/lib.so
%{_datadir}	/usr/share	%{_datadir}/icons
%{_mandir}	/usr/share/man	%{_mandir}/man1/*.1
%{_sysconfdir}	/etc	%{_sysconfdir}/myapp.conf
%{name}	Имя пакета	myapp
%{version}	Версия	1.0.0
%{release}	Release	1

Макросы для скриптов

Макрос	Описание
%glib_schema_compile	Компиляция GSettings схем
%desktop_database_update	Обновление базы .desktop файлов
%icon_theme_cache_update	Обновление кэша иконок
%ldconfig	Обновление кэша библиотек

Секции spec-файла

Секция	Описание
%prep	Подготовка (распаковка, патчи)
%build	Компиляция
%install	Установка в BUILDROOT
%files	Список файлов пакета
%post	Скрипт после установки
%postun	Скрипт после удаления
%changelog	История изменений

---

8. 🎯 Чек-лист перед сборкой

• [ ] Установлены rpm-build и rpmdevtools
• [ ] Создана структура ~/rpmbuild/
• [ ] Исходный архив в ~/rpmbuild/SOURCES/
• [ ] Spec-файл в ~/rpmbuild/SPECS/
• [ ] Все BuildRequires указаны и установлены
• [ ] Имя папки в %prep соответствует архиву
• [ ] Список %files соответствует установленным файлам
• [ ] Лицензия указана корректно

---

9. 📚 Дополнительные ресурсы

Ресурс	Описание
ROSA Wiki	Официальная документация ROSA
forum.rosa.ru	Форум сообщества ROSA
ABF ROSA	Система сборки ROSA (для публикации)

---

10. 💡 Советы новичкам

1. Начинайте с простых пакетов — выберите программу с минимальными зависимостями
2. Изучайте готовые spec-файлы — смотрите в /usr/share/doc/rpm/ или на ABF
3. Сохраняйте логи сборки — rpmbuild -ba spec.spec 2>&1 | tee build.log
4. Тестируйте локально — перед отправкой в ABF убедитесь, что пакет собирается у вас
5. Не бойтесь ошибок — каждая ошибка учит чему-то новому
6. Документируйте изменения — ведите %changelog для каждого изменения
7. Используйте git — храните spec-файлы в git-репозитории

---

📋 Быстрый старт (копируй и вставляй)

# 1. Установка инструментов
sudo dnf install -y rpm-build rpmdevtools wget git

# 2. Создание структуры
rpmdev-setuptree

# 3. Скачивание исходников
cd ~/rpmbuild/SOURCES
wget https://example.com/app-1.0.tar.gz

# 4. Создание spec-файла
cd ~/rpmbuild/SPECS
nano app.spec

# 5. Сборка
rpmbuild -ba app.spec

# 6. Установка
sudo dnf install ~/rpmbuild/RPMS/x86_64/app-*.rpm

# 7. Проверка
app --version

---

Удачной сборки! 🚀

Если возникнут вопросы — обращайтесь на forum.rosa.ru или сохраняйте логи ошибок для анализа.