Changes between Initial Version and Version 1 of Development/PerlModulePackaging

Timestamp:

2012/03/08 16:21:32 (15 years ago)

Author:

shaolin

Comment:

--

Development/PerlModulePackaging

@@ +1 @@
+= Perl モジュールの rpm パッケージ化の注意点 =
+
+( [http://ml.vinelinux.org/vineseed/msg07900.html VineSeed ML 024756] を参照のこと )
+
+== 背景 ==
+
+従来は、x86_64 環境で noarch パッケージを build すると、モジュールファイルが `/usr/lib64` 以下にインストールされてしまい、ix86 環境では利用できないパッケージができてしまう。逆に ix86 環境で build された noarch パッケージは、x86_64 環境でも利用可能。
+
+そこで、perl-5.12.3-5 (VineSeed, Vine-6/proposed-updates) より、以下の通り定義を変更した。
+
+x86_64: sitelib, vendorlib の prefix を `/usr/lib` に
+{{{
+$ perl -V:installsitelib
+installsitelib='/usr/lib/perl5/site_perl/5.12.3';
+$ perl -V:installsitearch
+installsitearch='/usr/lib64/perl5/site_perl/5.12.3/x86_64-linux-thread-multi';
+$ perl -V:installvendorlib
+installvendorlib='/usr/lib/perl5/vendor_perl/5.12.3';
+$ perl -V:installvendorarch
+installvendorarch='/usr/lib64/perl5/vendor_perl/5.12.3/x86_64-linux-thread-multi';
+}}}
+
+ix86: 従来と同じ
+{{{
+$ perl -V:installsitelib
+installsitelib='/usr/lib/perl5/site_perl/5.12.3';
+$ perl -V:installsitearch
+installsitearch='/usr/lib/perl5/site_perl/5.12.3/i386-linux-thread-multi';
+$ perl -V:installvendorlib
+installvendorlib='/usr/lib/perl5/vendor_perl/5.12.3';
+$ perl -V:installvendorarch
+installvendorarch='/usr/lib/perl5/vendor_perl/5.12.3/i386-linux-thread-multi';
+}}}
+
+この作業の際、現在リポジトリにある Perl Module パッケージの spec をみてみると、
+意外と統一感のない状態であったので、ここにメモをまとめる。
+
+
+== パッケージングの際の注意点 ==
+
+=== 原則として sitelib, sitearch は使わない方向で ===
+
+例 (1)：
+{{{
+%build
+%{__perl} Makefile.PL INSTALLDIRS=vendor OPTIMIZE="%{optflags}"
+make %{?_smp_mflags}
+
+%install
+rm -rf %{buildroot}
+make pure_install DESTDIR=%{buildroot}
+find %{buildroot} -type f -name .packlist -exec rm -f {} +
+find %{buildroot} -depth -type d -exec rmdir {} 2>/dev/null \;
+}}}
+
+例 (2)：
+{{{
+%build
+%{__perl} Build.PL installdirs=vendor optimize="%{optflags}"
+./Build
+
+%install
+rm -rf %{buildroot}
+./Build install destdir=%{buildroot} create_packlist=0
+find %{buildroot} -type f -name '*.bs' -size 0 -exec rm -f {} \;
+find %{buildroot} -depth -type d -exec rmdir {} 2>/dev/null \;
+}}}
+
+=== noarch は vendorlib へ ===
+
+noarch な Perl Module パッケージは、`vendorlib` (`%{perl_vendorlib}`) に入る。
+
+{{{
+%files
+...
+%{perl_vendorlib}/Fuga/Fuga.pm
+...
+}}}
+
+=== arch dependent は vendorarch へ ===
+
+バイナリや so モジュールを含むなど arch dependent な Perl Module パッケージの場合は `vendorarch` (`%{perl_vendorarch}`) に入る。
+
+{{{
+%files
+...
+%{perl_vendorarch}/auto/*
+%{perl_vendorarch}/Hoge/Hoge.pm
+...
+}}}
+
+=== 極力テストを通す ===
+
+{{{
+%check
+make test (あるいは ./Build test)
+}}}
+
+テストに必要な他モジュールは BuildRequires にモジュール名で追加
+
+=== provides/requires のフィルタリングを適切に ===
+
+主にプライベートモジュールが不用意に Provides / Requires に現れないように provides/requires フィルタリングを行う。
+
+その他の例としては、Perl モジュールを内包する（が、他のプログラムからの利用を考えていないパスに格納されている）パッケージを作成する場合に、不必要に Provides がついてしまうのを防ぐためにも用いられる。
+
+例えば `0.87.2-1` およびそれ以前の `shutter` パッケージでは、`/usr/share/shutter/resources/modules/` 以下に Perl モジュールが数種類格納されており、Provides されてしまっていた（しかしそれらのモジュールは別パッケージとしてレポジトリに存在していた）。その際、apt-get などであるパッケージをインストールする際、間違えて `shutter` パッケージが引っ張ってこられてしまうことがあった。
+
+以下、自動検出されパッケージに付加される Provides から `perl(DB)`、`perl(UNIVERSAL)` を除去、および `perl(Switch` で始まるものを全て除去する場合の例。
+
+{{{
+## 通常 %prep より前に書く
+
+%if "%{_dist_release}" > "vl6"
+
+## VineSeed 用 (rpm >= 4.9)
+%global __provides_exclude %{?__provides_exclude:__provides_exclude|}^perl\\((DB|UNIVERSAL)\\)$
+%global __provides_exclude %__provides_exclude|^perl\\(Switch
+
+%else
+
+## Vine-6.x 用 (rpm < 4.9)
+%global provfilt /bin/sh -c "%{__perl_provides} |\
+    grep -Ev '^perl[(](DB|UNIVERSAL)[)]$' |\
+    grep -Ev '^perl[(]Switch'"
+%define __perl_provides %{provfilt}
+
+%endif
+}}}