SpecTips: различия между версиями

Материал из ALT Linux Wiki
м Spectips» переименована в «SpecTips»: proper spelling)
(→‎Документы: Обновлена ссылка на Maximum RPM)
(не показана 31 промежуточная версия 6 участников)
Строка 1: Строка 1:
[[Category:Devel]]
[[Category:RPM spec]]
{{Викифицировать}}
{{MovedFromFreesourceInfo|AltLinux/Sisyphus/devel/spectips}}


== Как писать спеки? ==
== Как писать спеки? ==
* [[Spec|Отличия спеков ALT Linux / Sisyphus от «обычного» RPM]]
* [[SampleSpecs|Примеры спек-файлов]]


{| border="1"
=== Документы ===
|-
* [[ALT_Packaging_HOWTO|Howto по упаковке пакетов в ALT]]
|
* [http://ftp.altlinux.org/pub/distributions/ALTLinux/Sisyphus/doc/old/rpm_packaging_howto.html ALT Packaging] (html версия)
=== Книжки ===
* [[Policy|ALT policy]]
* [http://docs.altlinux.ru/alt/devel/ch01.html ALT Packaging]
* [http://www.lexpr.ru/node/11 Русский перевод Red Hat RPM Guide] (актуально)
* [http://www.rpm.org/max-rpm-snapshot/p5206.html Maximum RPM] (snapshot)
* [http://ftp.rpm.org/max-rpm Maximum RPM] (snapshot), [http://rpm.org/max-rpm/s1-rpm-specref-macros.html макросы]
* [http://bog.pp.ru/work/rpm.html http://bog.pp.ru/work/rpm.html]
* [http://fedora.redhat.com/docs/drafts/rpm-guide-en/ Fedora RPM Guide], [http://fedoraproject.org/wiki/Packaging/Guidelines Fedora Packaging Guidelines]
* [[Policy]]
* [http://qa.mandriva.com/twiki/bin/view/Main/RpmHowTo Mandriva RPM Howto]
|
* [http://bog.pp.ru/work/rpm.html Краткий курс по RPM] (старо)
=== Инструменты ===
 
* [[spectips/buildreq|buildreq]]
=== Взаимодействие ===
* [[add_changelog|add_changelog]]
* [[OtherDistros|С другими дистрибутивами]]
|
* [[SpecTips/Compatibility|Совместимость с «чужими» спеками]]
=== Теги ===
 
* [[SpecTips/Group|Group]]
=== Макросы ===
* [[SpecTips/License|License]]
* [[spectips/Release|Release]]
* [[spectips/BuildRequires|BuildRequires]]
|
=== [http://rpm.org/max-rpm/s1-rpm-specref-macros.html Макросы] ===
* [[spectips/setup|%setup]] (*)
* [[spectips/origname|%origname]]
* [[SpecTips/triggers|%trigger*]]
* [[SpecTips/triggers|%trigger*]]
* [[SpecTips/optflags|%optflags]]
* [[SpecTips/optflags|%optflags]]
* [[Changelogs guide|%changelog]]
* [[SpecTips/makeinstall|%make_install vs. %makeinstall]]
* [[spectips/VersionHacks|Использование конкретных версий инструментов сборки]]
* [[spectips/VersionHacks|Использование конкретных версий инструментов сборки]]
* [http://lists.altlinux.ru/pipermail/devel/2004-December/016580.html Как (не) собирать -static пакеты]
 
|
=== Инструменты ===
* [[buildreq]]
* [[add_changelog|add_changelog]]
* [[rpmcs|rpmcs]]
 
=== Разное ===
=== Разное ===
* [[spectips/ReturnCodes|Скрипты и коды возврата]]
* [[TypicalPackagingErrors|Типичные ошибки]] при написании spec-файлов
* [[SpecTips/FiltrProvides|Фильтрация Provides/Requires]]
** e.g. использование [[TypicalPackagingErrors/InternalMacros|внутренних макросов RPM]] (%__macro)
* [[PackageSplitting|Рекомендации по размещению файлов в пакетах]]
* [[SpecTips/Requires|Генерируемые зависимости]]
* [[SpecTips/ReturnCodes|Скрипты и коды возврата]]
* [[SpecTips/ReqProvFilter|Фильтрация Provides/Requires]]
* [[SpecTips/autoreconf|autoreconf]]
* [[SpecTips/autoreconf|autoreconf]]
* [[spectips/l10n|Локализация]]
* [[SpecTips/l10n|Локализация]]
* [[spectips/ClashLinks|Одинаковые симлинки в пакетах]]
* [[SpecTips/ClashLinks|Одинаковые симлинки в пакетах]]
* [https://lists.altlinux.ru/pipermail/devel/2005-September/024045.html "Странные" зависимости вида rpmlib(CompressedFileNames)]
* [[PerlManPages|Perl man3 pages]]
* [[spectips/perlman3pages|Perl man3 pages]]
* [[TextRel|TEXTREL]]
* [[TextRel|TEXTREL]]
* [[SpecTips/triggers|Пакетные скрипты, в т.ч. триггеры]]
* [[SpecTips/triggers|Пакетные скрипты, в том числе триггеры]] <!-- дубль ссылки -->
* [[qmakeCFLAGS|CFLAGS в qmake]]
* [[qmakeCFLAGS|CFLAGS в qmake]]
* [[SpecTips/FileDirs|Упаковка %files]]
* [[SpecTips/FileDirs|Упаковка %files]]
* [[TextRel|Борьба с TEXTREL]]
* [[TextRel|Борьба с TEXTREL]]
* [[LaWars|Борьба с .la]]
* [[LaWars|Борьба с .la]]
|}
* [[SpecTips/ToolChain|Выбор версии компилятора/auto*]]
 
* [[ServiceMaint|Работа со службами]]
=== Примеры ===
* [[MassRebuild|Массовая пересборка]]
...[[SampleSpecs|здесь]]
* [http://uneex.ru/LecturesCMC/PackageMaintaining2009 Курс на ВМК МГУ]
 
* [http://www-uxsup.csx.cam.ac.uk/~jw35/docs/rpm_config.html <tt>%config</tt> в деталях] (англ.)
=== Взаимодействие ===
...[[OtherDistros|здесь]]
 
=== Совместимость ===
 
''Тут нужно написать о том, как *нужно* делать спеки, как их делать *не* нужно, и все такое.''
 
В частности, многие спрашивают: будет ли спек со стороны работать в альте?
Отвечаем: да, скорее всего, но:
:а) не обещаем
:б) наверняка он не соответствует альтовским правилам, а потому в сизиф не пройдет
 
Зато на другой вопрос: "будет ли альтовский спек работать где либо еще?", ответ вполне однозначный: в большинстве случаев нет.
 
Дело это поправимо. Для того, чтобы спек из другого дистрибутива сделать максимально подходящим для ALT, можно использовать команду rpmcs из пакета etersoft-build-utils. Для того, чтобы спек из ALT работал в другом дистрибутиве, там следует установить [http://freesource.info/wiki//devel/rpmbuildaltlinuxcompat пакет rpm-build-altlinux-compat]. Так же и [http://sisyphus.ru/srpm/etersoft-build-utils etersoft-build-utils] переносим на другие платформы с помощью этого пакета.
 
<pre>$ fortune ALT -m "наши spec-файлы"
(ALT)
%
На основании этого можно сделать очевидные выводы:
+ нам удобно, чтобы чужие spec-файлы у нас работали (хотя бы для удобства
  подготовки своего spec-файла);
+ нам все равно, будут ли наши spec-файлы работать где-либо еще.
                -- ldv in sisyphus@
%</pre>
 
Обоснование -- у нас "слишком" богатый набор макросов, сопоставимый (по мнению mike@) -- с макросами в [http://cvs.pld-linux.org/cgi-bin/cvsweb/SPECS/ PLD] и Conectiva.  В RedHat и SuSE наборы макросов удивительно бедные, а сами спеки -- очень часто (по всё тому же мнению mike@) жутко кривые.  Видимо, это не в последнюю очередь по причине специфической  организации сборочных систем и работе майнтейнеров не напрямую со спеками, а с их прообразами?
 
<pre>так как spec-файлы все ещё пишут люди, то их работу нужно свести к тому минимуму,
который, собственно, и требует участия человека. Разработчик не должен копировать
блоки кода из файла в файл, ибо эта неинтеллектуальная работа отнимает массу сил
и чревата ошибками. Для этого есть макросы. Если какой-то код появляется в разных
spec-файлах более одного раза, то надо написать макрос(ы).</pre>
(ldv@ в [http://docs.altlinux.ru/alt/devel/ch01.html#id2816423 ALT specfile conventions])
 
<pre>Если нужно просто собрать чужой srpm-пакет, то можно просто взять и
собрать.  FC'шные и MDK'шные пакеты с высокой вероятностью могут собраться
без внесения изменений в spec-файл.  Пакеты из SuSE и PLD более широко
используют свои макросы, возможно, потребуется адаптация.
 
Если нужно собрать пакет в Сизиф, придётся поработать головой, поскольку
качество чужих spec-файлов в среднем довольно невысокое.</pre>
''(тоже [http://lists.altlinux.org/pipermail/community/2006-October/185248.html ldv@])''
 
При этом недавно [http://lists.altlinux.ru/pipermail/devel/2005-December/027129.html выяснилось], что ''не'' следует использовать в спеках ''внутренние'' макросы RPM, которые начинаются с двух подчёркиваний (например, <tt>%__install</tt> или <tt>%__mkdir_p</tt>). "А мы и не знали" :-)
[[SpecTips/un|Скриптик]] для замены всех <tt>%__ </tt> на соответственные команды от Michael Shigorin
=== Ссылки ===
* [[TypicalPackagingErrors|Типичные ошибки]] при написании spec-файлов
* FreeSource:Altlinux/Policy/PackageSplitting


* [http://fedora.redhat.com/docs/drafts/rpm-guide-en/ http://fedora.redhat.com/docs/drafts/rpm-guide-en/]
{{Category navigation|title=RPM spec|category=RPM spec}}
* [http://fedoraproject.org/wiki/Packaging/Guidelines http://fedoraproject.org/wiki/Packaging/Guidelines]
* [http://qa.mandriva.com/twiki/bin/view/Main/RpmHowTo http://qa.mandriva.com/twiki/bin/view/Main/RpmHowTo]

Версия от 17:43, 29 мая 2017


Как писать спеки?

Документы

Взаимодействие

Макросы

Инструменты

Разное