KOSC Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Создание пакета с плагином VLC для ALT Linux ====== 

Названия пакетов плагинов начинаются с vlc-plugin (см. apt-cache search vlc-plugin), поэтому делаем по аналогии.
Склонировать проект в каталог со скорректированным именем
<code>
git clone https://github.com/nurupo/vlc-pause-click-plugin vlc-plugin-pause-click
cd vlc-plugin-pause-click
</code>

По файлам BUILD.md, README.md и Makefile выяснить, как выполняется сборка и установка применительно к ALT Linux. Для данного проекта так:
<code>
sudo apt-get install libvlc-devel
make
sudo make install
</code>

Сборку лучше выполнить до написания .spec, потому что так тестирование будет выполнено быстрее.

По выводу команд сборки и установки видно, что будет создан единственный файл libpause_click_plugin.so. Надо убедиться, что нет пакета, в котором этот файл существовал бы. Для этого скачать список всех файлов во всех пакетах в Сизифе (http://ftp.altlinux.org/pub/distributions/ALTLinux/Sisyphus/x86_64/base/contents_index) и выполнить поиск в нем по имени файла

  grep libpause_click_plugin.so contents_index
  
Ничего не найдено - приступить к изучению репозитория.

  gitk
  
В истории коммитов найти последний апстримовский релиз. Соответствующий ему коммит обычно обозначается тегом. В нашем случае это тег 2.2.0. Следует просмотреть коммиты после апстримовского релиза и убедиться, что среди них нет критичных. В нашем случае изменения после релиза коснулись только документации и сборки на MacOS, поэтому их можно спокойно отбросить.

Перейти на тег последнего релиза

  git checkout 2.2.0
  
Создать ветку sisyphus и перейти на неё

  git checkout -b sisyphus
  
Тут желательно убедиться, что все получилось правильно

  gitk
  
Создать файл .spec. За основу можно взять файл из похожего пакета. Выбрать пакет можно тут http://git.altlinux.org/gears/

ВАЖНО!

1) %description принято переносить по строчкам на 72ом символе, как указано в инструкции: https://www.altlinux.org/Spec#%25description

2) Вместо make следует использовать макрос %make. Вместо make install следует писать %makeinstall_std.

3) В секции files особенно важно пользоваться макросами. В данном случае нужен %_libdir. Имя файла плагина должно начинатсья с того же самого пути, который в пакете vlc (%_libdir/vlc/plugins/video_filter/)

4) Последняя секция %changelog должна содержать записи по формату: дата, имя, почта, релиз пакета и ниже - описание изменений. Делать по образцу из .spec других пакетов. Есть пакет vim-plugin-spec_alt-ftplugin. После его установки в виме можно нажать \ac и в %changelog сгенерируется строка (https://www.altlinux.org/%D0%A0%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_changelog_%D0%B2_Vim).

Файл vlc-plugin-pause-click.spec должен располагаться в корне каталога с исходниками
<code>
Name: vlc-plugin-pause-click
Version: 2.2.0
Release: alt1

Summary: Pause Click plugin for VLC
License: LGPLv2.1+
Group: Video

Url: https://github.com/nurupo/vlc-pause-click-plugin
Source: %name-%version.tar

BuildRequires: libvlc-devel

Requires: vlc

%description
VLC plugin that allows you to pause/play a video by clicking
on the video image.
Can be configured to work nicely with double-click-to-fullscreen by
enabling "Prevent pause/play from triggering on double click" option
in the settings. By default it pauses on every click instead.

%prep
%setup

%build
%make

%install
%makeinstall_std

%files
%_libdir/vlc/plugins/video_filter/libpause_click_plugin.so

%changelog
* Mon May 02 2022 Kirill Izmestev <felixz@altlinux.org> 2.2.0-alt1
- Initial build for Sisyphus
</code>

Значение свойства License должно быть именем файла из каталога /usr/share/license.

Создать конфиг для gear (.gear/rules). Этот файл тоже можно создать на основе существующего. При этом учесть, что в .gear/rules надписи name=@name@-@version@ base=@name@-@version@ могут не иметь никакого смысла. Директива name указывает, как будет называться тарбол, а base - это то, куда делается cd в макросе %setup. Бывают странные пакеты, где приходится это настраивать, но по умолчанию используется как раз @name@-@version@

В данном случае содержимое .gear/rules

  tar: @version@:.
  
Сохранить апстримный тег последнего релиза в файлах каталога .gear/tags

  gear-store-tags -acv
  
Создать релизный коммит. Описание коммита будет создано автоматически на основе записи в %changelog.

  git add .gear/rules vlc-plugin-pause-click.spec
  gear-commit
  
Создать тег релизного коммита.

  gear-create-tag
  
Далее следует выполнить локальную сборку пакета (https://vk.com/@kirov_osc-sborka-paketov-alt-linux), установку и проверить, все хорошо работает.

Если релизный коммит потребуется изменить, то будут полезны команды:

  gear-commit --amend
  gear-create-tag -f