パッケージの作成 - 版の履歴

Kgx: 同期

2025-02-27T20:49:59Z

同期

← 古い版		2025年2月28日 (金) 05:49時点における版
185行目:		185行目:
	* パッケージのビルドプロセスを自動化する前に、''あらかじめ''何をするのか''正確に''わかっている場合(その場合あなたはそもそもこの文章を読まないと思いますが)を除いて、少なくとも一度は手動でビルドを行なって下さい。残念ながら、大勢のプログラムの作者が "{{ic\|./configure}}; {{ic\|make}}; {{ic\|make install}}" のビルド3ステップに従っているにもかかわらず、これがいつも上手く行くとは限りません。下手をすると、全てを問題なく動かすにはパッチを適用する必要がある場合も考えられます。大雑把に言うと: プログラムをソース tarball からコンパイルして、規定の一時サブディレクトリにインストールすることができない場合、パッケージングを試行する必要さえありません。{{ic\|makepkg}} にはソースの問題を解決してくれるような妖精の粉はないからです。		* パッケージのビルドプロセスを自動化する前に、''あらかじめ''何をするのか''正確に''わかっている場合(その場合あなたはそもそもこの文章を読まないと思いますが)を除いて、少なくとも一度は手動でビルドを行なって下さい。残念ながら、大勢のプログラムの作者が "{{ic\|./configure}}; {{ic\|make}}; {{ic\|make install}}" のビルド3ステップに従っているにもかかわらず、これがいつも上手く行くとは限りません。下手をすると、全てを問題なく動かすにはパッチを適用する必要がある場合も考えられます。大雑把に言うと: プログラムをソース tarball からコンパイルして、規定の一時サブディレクトリにインストールすることができない場合、パッケージングを試行する必要さえありません。{{ic\|makepkg}} にはソースの問題を解決してくれるような妖精の粉はないからです。
	* 稀に、ソースからパッケージを作成することができなくて {{ic\|sh installer.run}} などのようにコマンドを実行しなくてはならないことがあります。そのようなときは、パッケージを作成するためにドキュメント (README や INSTALL の手順、man ページ、あるいは Gentoo の ebuild や他のパッケージインストーラのソースパッケージ、それでも駄目なら Makefile やソースコードまで) を相当読まなくてはなりません。最悪の場合、ソースファイルに編集を加える必要さえ出てくることもあります。しかしながら、{{ic\|makepkg}} はユーザーの補助がなくてもビルドが通るように完全に自動化する必要があります。そのため、Makefile を編集しなくてはならないときは、{{ic\|PKGBUILD}} にカスタムパッチを供えて {{ic\|prepare()}} 関数の中からパッチをインストールするか、あるいは {{ic\|prepare()}} 関数の中で {{ic\|sed}} コマンドを実行してください。		* 稀に、ソースからパッケージを作成することができなくて {{ic\|sh installer.run}} などのようにコマンドを実行しなくてはならないことがあります。そのようなときは、パッケージを作成するためにドキュメント (README や INSTALL の手順、man ページ、あるいは Gentoo の ebuild や他のパッケージインストーラのソースパッケージ、それでも駄目なら Makefile やソースコードまで) を相当読まなくてはなりません。最悪の場合、ソースファイルに編集を加える必要さえ出てくることもあります。しかしながら、{{ic\|makepkg}} はユーザーの補助がなくてもビルドが通るように完全に自動化する必要があります。そのため、Makefile を編集しなくてはならないときは、{{ic\|PKGBUILD}} にカスタムパッチを供えて {{ic\|prepare()}} 関数の中からパッチをインストールするか、あるいは {{ic\|prepare()}} 関数の中で {{ic\|sed}} コマンドを実行してください。

	== より詳細なガイドライン ==
	{{Package Guidelines}}

	== 自動化 ==		== 自動化 ==

Kgx: /* 自動化 */ 同期

2025-02-27T20:48:19Z

自動化: 同期

← 古い版		2025年2月28日 (金) 05:48時点における版
207行目:		207行目:
	* [[Ruby]]: {{AUR\|gem2arch}}, {{AUR\|pacgem}}		* [[Ruby]]: {{AUR\|gem2arch}}, {{AUR\|pacgem}}
	* [[Rust]]: {{AUR\|cargo-pkgbuild}}		* [[Rust]]: {{AUR\|cargo-pkgbuild}}

			=== 新しいアップストリームリリース ===

			''pkgctl''({{pkg\|devtools}} パッケージの一部)は、{{ic\|.nvchecker.toml}} 設定ファイルの形式で [https://github.com/lilydjwg/nvchecker nvchecker] 統合をサポートしています(このファイルは {{ic\|PKGBUILD}} と同じディレクトリに配置する必要があります)例として、pacman パッケージの[https://gitlab.archlinux.org/archlinux/packaging/packages/pacman/-/blob/main/.nvchecker.toml?ref_type=heads .nvchecker.toml] 設定ファイルを参照してください。

			{{Tip\|{{ic\|pkgctl version setup}} は、PKGBUILD で指定されたソース配列を分析して、{{ic\|.nvchecker.toml}} 設定ファイルを自動的に作成しようとします。}}

			その後、{{ic\|pkgctl version check}} を使用して、新しいアップストリームバージョンがリリースされているかどうかを確認できます({{ic\|PKGBUILD}} に指定された {{ic\|pkgver}} と比較して)また、{{ic\|pkgctl version upgrade}} を使用して、{{ic\|PKGBUILD}} をそれに応じて更新できます。詳細については、{{man\|1\|pkgctl-version}} を参照してください。

	==参照==		==参照==

Kgx: /* クリーンな chroot を設定する */ リンクを修正

2023-12-21T15:54:22Z

クリーンな chroot を設定する: リンクを修正

← 古い版		2023年12月22日 (金) 00:54時点における版
67行目:		67行目:
	=== クリーンな chroot を設定する ===		=== クリーンな chroot を設定する ===

	システムのパッケージや設定が PKGBUILD のミスにつながらないようにするには [~~https://wiki.archlinux.org/title/~~DeveloperWiki:~~Building_in_a_clean_chroot~~ ~~Building~~ ~~in a clean chroot~~] に従うことを推奨します。これはより堅牢で正しいパッケージのビルド方法であり、システムに既に存在していたために必要だと気づかなかった依存関係の欠落を見つけることがよくあります。		システムのパッケージや設定が PKGBUILD のミスにつながらないようにするには [[DeveloperWiki:クリーンな chroot でビルドする]] に従うことを推奨します。これはより堅牢で正しいパッケージのビルド方法であり、システムに既に存在していたために必要だと気づかなかった依存関係の欠落を見つけることがよくあります。

	== PKGBUILDの作成 ==		== PKGBUILDの作成 ==

Kgx: /* 準備 */ クリーンな chroot を設定するを翻訳して追加

2023-12-21T15:45:13Z

準備: クリーンな chroot を設定するを翻訳して追加

← 古い版		2023年12月22日 (金) 00:45時点における版
64行目:		64行目:

	プログラムが正しく動作するか確認すると良いでしょう。		プログラムが正しく動作するか確認すると良いでしょう。

			=== クリーンな chroot を設定する ===

			システムのパッケージや設定が PKGBUILD のミスにつながらないようにするには [https://wiki.archlinux.org/title/DeveloperWiki:Building_in_a_clean_chroot Building in a clean chroot] に従うことを推奨します。これはより堅牢で正しいパッケージのビルド方法であり、システムに既に存在していたために必要だと気づかなかった依存関係の欠落を見つけることがよくあります。

	== PKGBUILDの作成 ==		== PKGBUILDの作成 ==

2023年12月21日 (木) 15:40にKgxによる

2023-12-21T15:40:39Z

← 古い版		2023年12月22日 (金) 00:40時点における版
122行目:		122行目:
	ここでは {{Ic\|make check}} などのテストを動作させます。ソフトウェアが正しくビルドできたか確認したり依存関係が問題ないか調べるのに役立つので {{ic\|check()}} を記述することは推奨されています。		ここでは {{Ic\|make check}} などのテストを動作させます。ソフトウェアが正しくビルドできたか確認したり依存関係が問題ないか調べるのに役立つので {{ic\|check()}} を記述することは推奨されています。

	テストの必要のないユーザー（や、時にはテストを通過させるようにパッケージを修正できないメンテナ）は、PKGBUILD や makepkg.conf で {{ic\|1=BUILDENV+=('!check')}} オプションを指定する (もしくは {{ic\|--nocheck}} フラグを付けて {{ic\|makepkg}} を呼び出す) ことで、これをスキップできます。		テストの必要のないユーザー(や、時にはテストを通過させるようにパッケージを修正できないメンテナ)は、PKGBUILD や makepkg.conf で {{ic\|1=BUILDENV+=('!check')}} オプションを指定する (もしくは {{ic\|--nocheck}} フラグを付けて {{ic\|makepkg}} を呼び出す) ことで、これをスキップできます。

	==== 関数 {{ic\|package()}} ====		==== 関数 {{ic\|package()}} ====

	最後に、コンパイルされたファイルを、''makepkg'' がファイルを読み込むことができる（そしてパッケージを作成する）ディレクトリに置きます。デフォルトでは {{ic\|pkg}} ディレクトリです。このディレクトリは単なる fakeroot 環境です。すなわち、このディレクトリはインストール先のファイルシステムの <code>/</code> (root ファイルシステム) に相当します。インストールするファイルは全て {{ic\|pkg}} 以下に、ディレクトリ構造を保ったまま置かれる必要があります。例えば、ファイルを <code>/usr/bin</code> にインストールさせたい場合は <code>${pkgdir}/usr/bin</code> にファイルを置きます。数ダースのファイルを手動でコピーしなくてはならない場合はほとんどありません。ほとんどのソフトウェアでは、代わりに {{ic\|make install}} を呼び出すことでコピーが行われます。ソフトウェアを {{ic\|pkg}} ディレクトリに正しくインストールするために、最後の行は以下のようになるでしょう:		最後に、コンパイルされたファイルを、''makepkg'' がファイルを読み込むことができる(そしてパッケージを作成する)ディレクトリに置きます。デフォルトでは {{ic\|pkg}} ディレクトリです。このディレクトリは単なる fakeroot 環境です。すなわち、このディレクトリはインストール先のファイルシステムの <code>/</code> (root ファイルシステム) に相当します。インストールするファイルは全て {{ic\|pkg}} 以下に、ディレクトリ構造を保ったまま置かれる必要があります。例えば、ファイルを <code>/usr/bin</code> にインストールさせたい場合は <code>${pkgdir}/usr/bin</code> にファイルを置きます。数ダースのファイルを手動でコピーしなくてはならない場合はほとんどありません。ほとんどのソフトウェアでは、代わりに {{ic\|make install}} を呼び出すことでコピーが行われます。ソフトウェアを {{ic\|pkg}} ディレクトリに正しくインストールするために、最後の行は以下のようになるでしょう:

	make DESTDIR="$pkgdir/" install		make DESTDIR="$pkgdir/" install
148行目:		148行目:
	makepkg は問題なく終了すると、作業ディレクトリに {{ic\|pkgname-pkgver.pkg.tar.zstd}} という名前のファイルを作成します。このパッケージは {{ic\|pacman -U}} コマンドでインストールすることができます。ただし、パッケージファイルが作られたというだけでは完全に機能するとは言えません。あるいはディレクトリだけでファイルが全く含まれていない可能性もあります (例えば、prefix が間違って指定されているとか)。pacman の query 関数を使うことでパッケージに含まれているファイルのリスト、パッケージが必要とする依存パッケージを {{ic\|pacman -Qlp [package file]}} と {{ic\|pacman -Qip [package file]}} でそれぞれ表示することができます。		makepkg は問題なく終了すると、作業ディレクトリに {{ic\|pkgname-pkgver.pkg.tar.zstd}} という名前のファイルを作成します。このパッケージは {{ic\|pacman -U}} コマンドでインストールすることができます。ただし、パッケージファイルが作られたというだけでは完全に機能するとは言えません。あるいはディレクトリだけでファイルが全く含まれていない可能性もあります (例えば、prefix が間違って指定されているとか)。pacman の query 関数を使うことでパッケージに含まれているファイルのリスト、パッケージが必要とする依存パッケージを {{ic\|pacman -Qlp [package file]}} と {{ic\|pacman -Qip [package file]}} でそれぞれ表示することができます。

	パッケージが問題ないようでしたら、これであなたの作業は終了です！ただし、{{ic\|PKGBUILD}} ファイルを公開するつもりならば、{{ic\|depends}} の中身を何度もチェックするべきです。		パッケージが問題ないようでしたら、これであなたの作業は終了です!ただし、{{ic\|PKGBUILD}} ファイルを公開するつもりならば、{{ic\|depends}} の中身を何度もチェックするべきです。

	また、パッケージバイナリが完璧に''動く''ことを確認しましょう！全ての必要なファイルが含まれているが、（システムの他の部分と問題を起こすような）度しがたい設定オプションによってクラッシュするパッケージを公開するのは迷惑です。勿論、あなた自身のためだけにパッケージをコンパイルするのなら、品質保証について心配しすぎる必要はありません。誤りによって苦しむのはあなただけなのですから。		また、パッケージバイナリが完璧に''動く''ことを確認しましょう!全ての必要なファイルが含まれているが、(システムの他の部分と問題を起こすような)度しがたい設定オプションによってクラッシュするパッケージを公開するのは迷惑です。勿論、あなた自身のためだけにパッケージをコンパイルするのなら、品質保証について心配しすぎる必要はありません。誤りによって苦しむのはあなただけなのですから。

	===パッケージの正常性のテスト===		===パッケージの正常性のテスト===
179行目:		179行目:
	=== 注意点 ===		=== 注意点 ===

	* パッケージのビルドプロセスを自動化する前に、''あらかじめ''何をするのか''正確に''わかっている場合（その場合あなたはそもそもこの文章を読まないと思いますが）を除いて、少なくとも一度は手動でビルドを行なって下さい。残念ながら、大勢のプログラムの作者が "{{ic\|./configure}}; {{ic\|make}}; {{ic\|make install}}" のビルド3ステップに従っているにもかかわらず、これがいつも上手く行くとは限りません。下手をすると、全てを問題なく動かすにはパッチを適用する必要がある場合も考えられます。大雑把に言うと: プログラムをソース tarball からコンパイルして、規定の一時サブディレクトリにインストールすることができない場合、パッケージングを試行する必要さえありません。{{ic\|makepkg}} にはソースの問題を解決してくれるような妖精の粉はないからです。		* パッケージのビルドプロセスを自動化する前に、''あらかじめ''何をするのか''正確に''わかっている場合(その場合あなたはそもそもこの文章を読まないと思いますが)を除いて、少なくとも一度は手動でビルドを行なって下さい。残念ながら、大勢のプログラムの作者が "{{ic\|./configure}}; {{ic\|make}}; {{ic\|make install}}" のビルド3ステップに従っているにもかかわらず、これがいつも上手く行くとは限りません。下手をすると、全てを問題なく動かすにはパッチを適用する必要がある場合も考えられます。大雑把に言うと: プログラムをソース tarball からコンパイルして、規定の一時サブディレクトリにインストールすることができない場合、パッケージングを試行する必要さえありません。{{ic\|makepkg}} にはソースの問題を解決してくれるような妖精の粉はないからです。
	* 稀に、ソースからパッケージを作成することができなくて {{ic\|sh installer.run}} などのようにコマンドを実行しなくてはならないことがあります。そのようなときは、パッケージを作成するためにドキュメント (README や INSTALL の手順、man ページ、あるいは Gentoo の ebuild や他のパッケージインストーラのソースパッケージ、それでも駄目なら Makefile やソースコードまで) を相当読まなくてはなりません。最悪の場合、ソースファイルに編集を加える必要さえ出てくることもあります。しかしながら、{{ic\|makepkg}} はユーザーの補助がなくてもビルドが通るように完全に自動化する必要があります。そのため、Makefile を編集しなくてはならないときは、{{ic\|PKGBUILD}} にカスタムパッチを供えて {{ic\|prepare()}} 関数の中からパッチをインストールするか、あるいは {{ic\|prepare()}} 関数の中で {{ic\|sed}} コマンドを実行してください。		* 稀に、ソースからパッケージを作成することができなくて {{ic\|sh installer.run}} などのようにコマンドを実行しなくてはならないことがあります。そのようなときは、パッケージを作成するためにドキュメント (README や INSTALL の手順、man ページ、あるいは Gentoo の ebuild や他のパッケージインストーラのソースパッケージ、それでも駄目なら Makefile やソースコードまで) を相当読まなくてはなりません。最悪の場合、ソースファイルに編集を加える必要さえ出てくることもあります。しかしながら、{{ic\|makepkg}} はユーザーの補助がなくてもビルドが通るように完全に自動化する必要があります。そのため、Makefile を編集しなくてはならないときは、{{ic\|PKGBUILD}} にカスタムパッチを供えて {{ic\|prepare()}} 関数の中からパッチをインストールするか、あるいは {{ic\|prepare()}} 関数の中で {{ic\|sed}} コマンドを実行してください。

191行目:		191行目:
	新しいソフトウェアリリースのチェックサムを更新するプロセスは、{{ic\|updpkgsums}} ツールによって自動化できます。詳細については、[[makepkg#新しいチェックサムを生成する\|新しいチェックサムを生成する]] を参照してください。		新しいソフトウェアリリースのチェックサムを更新するプロセスは、{{ic\|updpkgsums}} ツールによって自動化できます。詳細については、[[makepkg#新しいチェックサムを生成する\|新しいチェックサムを生成する]] を参照してください。

	== PKGBUILD ジェネレーター ==		=== PKGBUILD ジェネレーター ===

	パッケージによっては、PKGBUILD を自動的に生成できます。		パッケージによっては、PKGBUILD を自動的に生成できます。

Kgx: /* PKGBUILD ジェネレーター */ 自動化を翻訳して追加

2023-12-21T15:39:42Z

PKGBUILD ジェネレーター: 自動化を翻訳して追加

← 古い版		2023年12月22日 (金) 00:39時点における版
184行目:		184行目:
	== より詳細なガイドライン ==		== より詳細なガイドライン ==
	{{Package Guidelines}}		{{Package Guidelines}}

			== 自動化 ==

			=== チェックサム ===

			新しいソフトウェアリリースのチェックサムを更新するプロセスは、{{ic\|updpkgsums}} ツールによって自動化できます。詳細については、[[makepkg#新しいチェックサムを生成する\|新しいチェックサムを生成する]] を参照してください。

	== PKGBUILD ジェネレーター ==		== PKGBUILD ジェネレーター ==
189行目:		195行目:
	パッケージによっては、PKGBUILD を自動的に生成できます。		パッケージによっては、PKGBUILD を自動的に生成できます。

	{{Note\|ジェネレーターの利用者であっても、自動生成されたファイルを [[AUR]] へ投稿する前に、パッケージが高い品質基準を満たしていると保証する責任があります。}}		{{Note\|ジェネレーターの利用者であっても、自動生成されたファイルを [[AUR]] へ投稿する前に、パッケージが高い品質基準を満たしていると確認する責任があります。}}

	* [[Go]]: [https://github.com/seletskiy/go-makepkg go-makepkg]
	* [[Haskell]]: [https://github.com/magthe/cblrepo cblrepo]		* [[Haskell]]: [https://github.com/magthe/cblrepo cblrepo]
	* [[Node.js]]: {{AUR\|nodejs-npm2arch}} [https://github.com/simon04/npm2arch\|igorvisi npm2arch]		* [[Node.js]]: {{AUR\|nodejs-npm2arch}} [https://github.com/simon04/npm2arch\|igorvisi npm2arch]
			* [[Perl]]: {{pkg\|perl-cpanplus-dist-arch}}
	* [[Python]]: {{AUR\|pipman-git}}, {{AUR\|pip2arch-git}}, {{AUR\|python-pypi2pkgbuild}}		* [[Python]]: {{AUR\|pipman-git}}, {{AUR\|pip2arch-git}}, {{AUR\|python-pypi2pkgbuild}}
	* [[Ruby]]: {{AUR\|gem2arch}}, {{AUR\|pacgem}}		* [[Ruby]]: {{AUR\|gem2arch}}, {{AUR\|pacgem}}

Kgx: /* 概要 */ 英語版に追従して項目を整理

2023-03-10T09:52:13Z

概要: 英語版に追従して項目を整理

← 古い版		2023年3月10日 (金) 18:52時点における版
26行目:		26行目:
	==概要==		==概要==

	Arch Linux のパッケージは、[[makepkg]] ユーティリティーと [[PKGBUILD]] に記載された情報からビルドされます。{{ic\|makepkg}} が実行されると、カレントディレクトリの {{ic\|PKGBUILD}} を見て、ソースをコンパイルするか必要なファイルをダウンロードするかの指示に従ってパッケージファイル ({{ic\|pkgname.pkg.tar.~~zstd~~}}) が作成されます。こうして出来上がったパッケージはバイナリとインストールの実行スクリプトが含まれ、[[pacman]] でインストールできるものになります。		Arch Linux のパッケージは、[[makepkg]] ユーティリティーと [[PKGBUILD]] に記載された情報からビルドされます。{{ic\|makepkg}} が実行されると、カレントディレクトリの {{ic\|PKGBUILD}} を見て、ソースをコンパイルするか必要なファイルをダウンロードするかの指示に従ってパッケージファイル ({{ic\|pkgname.pkg.tar.zst}}) が作成されます。こうして出来上がったパッケージはバイナリとインストールの実行スクリプトが含まれ、[[pacman]] でインストールできるものになります。

	Arch のパッケージは、~~以下のファイルが~~ tar アーカイブ、つまり 'tarball' にま~~とめら~~れ、~~{{man\|1\|zstd}}~~ ~~で圧縮~~されたものです。		Arch パッケージは、{{man\|1\|zstd}} を使用して圧縮された tar アーカイブまたは 'tarball' にすぎません。これには、makepkg によって生成された次のファイルが含まれています。

	* インストールするバイナリやファイル。		* インストールするバイナリやファイル。
34行目:		34行目:
	* {{ic\|.BUILDINFO}}: Reproducible Builds のための情報が含まれます。pacman 5.1 以降でのビルド時のみ含まれます。		* {{ic\|.BUILDINFO}}: Reproducible Builds のための情報が含まれます。pacman 5.1 以降でのビルド時のみ含まれます。
	* {{ic\|.MTREE}}: ファイルのハッシュとタイムスタンプ。ローカルデータベースに含めることで pacman はパッケージの整合性を検証することができます。		* {{ic\|.MTREE}}: ファイルのハッシュとタイムスタンプ。ローカルデータベースに含めることで pacman はパッケージの整合性を検証することができます。
	* {{ic\|.INSTALL}}: 任意のファイル。インストール/アップグレード/削除の後に実行される ({{ic\|PKGBUILD}} で指定された場合のみ存在する)。		* {{ic\|.INSTALL}}: 任意のファイル。インストール/アップグレード/削除の後に実行される。 ({{ic\|PKGBUILD}} で指定された場合のみ存在する)
	* {{ic\|.Changelog}}: パッケージメンテナによるパッケージの更新についての覚え書き (必ず付属するとは限~~らない~~)。		* {{ic\|.Changelog}}: パッケージメンテナによるパッケージの更新についての覚え書き。 (必ず付属するとは限りません)

	=== メタパッケージとグループ ===

	パッケージグループはパッケージ作成者によって定義される関連パッケージのセットで、グループの名前を使うことで個々のパッケージを同時にインストールしたりアンインストールすることができます。グループはパッケージではありませんが、インストールする方法はパッケージと同じです。[[Pacman#パッケージグループのインストール]]や [[PKGBUILD#groups]] を見てください。

	メタパッケージ (大抵は ''-meta'' が名前に付いています) はパッケージグループと同じように相互に関連する複数のパッケージを同時にインストール・アンインストールするためのものです。メタパッケージは他のパッケージと同じようにインストールすることができます。[[Pacman#特定のパッケージのインストール]]を見てください。メタパッケージと通常のパッケージの違いは、メタパッケージの中身は空っぽであり、あくまで関連パッケージを互いに依存関係にリンクするためだけに存在することです。

	グループと比べてメタパッケージには利点が存在しています。新しいパッケージが依存関係に追加された場合、メタパッケージの更新によってインストールされるということです。グループでは、新しいパッケージが追加されても自動的にはインストールされません。メタパッケージの欠点はグループよりも柔軟性に欠けるという点です。グループではインストールしたいパッケージを選択することが可能ですが、メタパッケージではどれをインストールするのか選べません。同じように、グループでは一部のパッケージだけをアンインストールすることができますが、メタパッケージでは中に入っているパッケージだけを削除するのは不可能です。

	== 準備 ==		== 準備 ==

Kgx: /* ソフトウェアの準備 */ 同期

2023-03-10T09:48:33Z

ソフトウェアの準備: 同期

← 古い版		2023年3月10日 (金) 18:48時点における版
49行目:		49行目:
	=== ソフトウェアの準備 ===		=== ソフトウェアの準備 ===

	まず、必要なツールがインストールされているか確認してください。 {{Grp\|base-devel}} があれば十分です。このグループには '''make''' などのコンパイルに必要なツールが含まれています。		まず、必要なツールが [[インストール]] されているか確認してください。 {{Grp\|base-devel}} があれば十分です。このグループには '''make''' などのコンパイルに必要なツールが含まれています。

	# pacman -S base-devel

	{{Pkg\|pacman}} で提供される [[makepkg]] はパッケージ作成で最も重要なツールの一つです。makepkg は以下を行います:		{{Pkg\|pacman}} で提供される [[makepkg]] はパッケージ作成で最も重要なツールの一つです。makepkg は以下を行います:
58行目:		56行目:
	# 圧縮されたソースファイルを展開する。		# 圧縮されたソースファイルを展開する。
	# fakeroot 環境でコンパイルし、インストールする。		# fakeroot 環境でコンパイルし、インストールする。
	# バイナリやライブラリから不要シンボルを除去する (symbol stripping)。		# バイナリやライブラリから不要シンボルを除去する (symbol stripping)
	# パッケージのメタデータを生成する。		# パッケージのメタデータを生成する。
	# fakeroot 環境をパッケージに圧縮する。		# fakeroot 環境をパッケージに圧縮する。

Hiromi-mi: xz -> zstd への移行に追従 (Pacman 5.2.0 移行)

2020-08-19T14:03:09Z

xz -> zstd への移行に追従 (Pacman 5.2.0 移行)

← 古い版		2020年8月19日 (水) 23:03時点における版
26行目:		26行目:
	==概要==		==概要==

	Arch Linux のパッケージは、[[makepkg]] ユーティリティーと [[PKGBUILD]] に記載された情報からビルドされます。{{ic\|makepkg}} が実行されると、カレントディレクトリの {{ic\|PKGBUILD}} を見て、ソースをコンパイルするか必要なファイルをダウンロードするかの指示に従ってパッケージファイル ({{ic\|pkgname.pkg.tar.xz}}) が作成されます。こうして出来上がったパッケージはバイナリとインストールの実行スクリプトが含まれ、[[pacman]] でインストールできるものになります。		Arch Linux のパッケージは、[[makepkg]] ユーティリティーと [[PKGBUILD]] に記載された情報からビルドされます。{{ic\|makepkg}} が実行されると、カレントディレクトリの {{ic\|PKGBUILD}} を見て、ソースをコンパイルするか必要なファイルをダウンロードするかの指示に従ってパッケージファイル ({{ic\|pkgname.pkg.tar.zstd}}) が作成されます。こうして出来上がったパッケージはバイナリとインストールの実行スクリプトが含まれ、[[pacman]] でインストールできるものになります。

	Arch のパッケージは、以下のファイルが tar アーカイブ、つまり 'tarball' にまとめられ、{{man\|1\|xz}} で圧縮されたものです。		Arch のパッケージは、以下のファイルが tar アーカイブ、つまり 'tarball' にまとめられ、{{man\|1\|zstd}} で圧縮されたものです。

	* インストールするバイナリやファイル。		* インストールするバイナリやファイル。
77行目:		77行目:
	== PKGBUILDの作成 ==		== PKGBUILDの作成 ==

	パッケージ作成に必要な情報は全て <code>PKGBUILD</code> に書かれます。<code>makepkg</code> は実行されると、カレントディレクトリに <code>PKGBUILD</code> ファイルがあるか探し、そこに書かれていることに従ってソフトウェアのソースコードをコンパイルします。{{ic\|PKGBUILD}} に書かれている指示は、[[Bash]] として実行可能である必要があります。コンパイルが無事終了すれば、出来上がったバイナリと、バージョンや依存パッケージなどのパッケージのメタデータが <code>''パッケージ名''.pkg.tar.xz</code> にまとめられます。このパッケージファイルは <code>pacman -U ''パッケージファイル''</code> でインストールすることができます。		パッケージ作成に必要な情報は全て <code>PKGBUILD</code> に書かれます。<code>makepkg</code> は実行されると、カレントディレクトリに <code>PKGBUILD</code> ファイルがあるか探し、そこに書かれていることに従ってソフトウェアのソースコードをコンパイルします。{{ic\|PKGBUILD}} に書かれている指示は、[[Bash]] として実行可能である必要があります。コンパイルが無事終了すれば、出来上がったバイナリと、バージョンや依存パッケージなどのパッケージのメタデータが <code>''パッケージ名''.pkg.tar.zstd</code> にまとめられます。このパッケージファイルは <code>pacman -U ''パッケージファイル''</code> でインストールすることができます。

	新しいパッケージを作るには、まず空の作業ディレクトリを用意します ({{ic\|~/abs/''パッケージ名''}} が推奨です)。このディレクトリにファイル {{ic\|PKGBUILD}} を作成します。プロトタイプとして、{{ic\|/usr/share/pacman/PKGBUILD.proto}} や、類似パッケージの {{ic\|PKGBUILD}} が使えます。オプションを変更するだけなどの場合、後者が便利になるかもしれません。		新しいパッケージを作るには、まず空の作業ディレクトリを用意します ({{ic\|~/abs/''パッケージ名''}} が推奨です)。このディレクトリにファイル {{ic\|PKGBUILD}} を作成します。プロトタイプとして、{{ic\|/usr/share/pacman/PKGBUILD.proto}} や、類似パッケージの {{ic\|PKGBUILD}} が使えます。オプションを変更するだけなどの場合、後者が便利になるかもしれません。
156行目:		156行目:
	{{ic\|build()}} 関数を記述している間、バグがないことを確認するために変更をテストしたくなるかもしれません。{{ic\|PKGBUILD}} ファイルが含まれているディレクトリで {{ic\|makepkg}} コマンドを実行してすることでテストすることができます。フォーマットが正しい {{ic\|PKGBUILD}} なら、makepkg はパッケージを作成します。{{ic\|PKGBUILD}} が壊れていたり未完成だと、エラーを吐きます。		{{ic\|build()}} 関数を記述している間、バグがないことを確認するために変更をテストしたくなるかもしれません。{{ic\|PKGBUILD}} ファイルが含まれているディレクトリで {{ic\|makepkg}} コマンドを実行してすることでテストすることができます。フォーマットが正しい {{ic\|PKGBUILD}} なら、makepkg はパッケージを作成します。{{ic\|PKGBUILD}} が壊れていたり未完成だと、エラーを吐きます。

	makepkg は問題なく終了すると、作業ディレクトリに {{ic\|pkgname-pkgver.pkg.tar.xz}} という名前のファイルを作成します。このパッケージは {{ic\|pacman -U}} コマンドでインストールすることができます。ただし、パッケージファイルが作られたというだけでは完全に機能するとは言えません。あるいはディレクトリだけでファイルが全く含まれていない可能性もあります (例えば、prefix が間違って指定されているとか)。pacman の query 関数を使うことでパッケージに含まれているファイルのリスト、パッケージが必要とする依存パッケージを {{ic\|pacman -Qlp [package file]}} と {{ic\|pacman -Qip [package file]}} でそれぞれ表示することができます。		makepkg は問題なく終了すると、作業ディレクトリに {{ic\|pkgname-pkgver.pkg.tar.zstd}} という名前のファイルを作成します。このパッケージは {{ic\|pacman -U}} コマンドでインストールすることができます。ただし、パッケージファイルが作られたというだけでは完全に機能するとは言えません。あるいはディレクトリだけでファイルが全く含まれていない可能性もあります (例えば、prefix が間違って指定されているとか)。pacman の query 関数を使うことでパッケージに含まれているファイルのリスト、パッケージが必要とする依存パッケージを {{ic\|pacman -Qlp [package file]}} と {{ic\|pacman -Qip [package file]}} でそれぞれ表示することができます。

	パッケージが問題ないようでしたら、これであなたの作業は終了です！ただし、{{ic\|PKGBUILD}} ファイルを公開するつもりならば、{{ic\|depends}} の中身を何度もチェックするべきです。		パッケージが問題ないようでしたら、これであなたの作業は終了です！ただし、{{ic\|PKGBUILD}} ファイルを公開するつもりならば、{{ic\|depends}} の中身を何度もチェックするべきです。
166行目:		166行目:
	パッケージが機能するかテストした後 [[namcap]] を使ってエラーがないか確認してください:		パッケージが機能するかテストした後 [[namcap]] を使ってエラーがないか確認してください:
	$ namcap PKGBUILD		$ namcap PKGBUILD
	$ namcap ''<package file name>''.pkg.tar.xz		$ namcap ''<package file name>''.pkg.tar.zstd

	Namcap は以下を行います:		Namcap は以下を行います:

Hiromi-mi: /* PKGBUILD の関数 */ prepare() -> pkgvar() の順に呼び出されるので訂正, 英語版と同期, 古い情報残した

2019-06-20T13:43:22Z

PKGBUILD の関数: prepare() -> pkgvar() の順に呼び出されるので訂正, 英語版と同期, 古い情報残した

@@ 99行目: / 99行目: @@
 {{Note|{{ic|package()}} 関数は省略できません、この関数は全ての PKGBUILD で必須になります。}}
 ==== 関数 {{ic|pkgver()}} ====
@@ 106行目: / 112行目: @@
 [[VCS パッケージガイドライン|git/svn/hg などのパッケージを作成する]]ときにこの関数は特に便利です。なぜならビルドプロセスは同じままでも、ソースは毎日・毎時間更新される可能性があるからです。昔は日時を pkgver フィールドに入れていたため、ソフトウェアが更新されていなくても、makepkg はバージョンが変更されたと考えてリビルドをしていました。この関数では {{ic|git describe}}, {{ic|hg identify -ni}} などのコマンドが有用です。PKGBUILD を投稿する前に、{{ic|pkgver()}} 関数がビルドを停止させないかテストしてください。
 {{Note|pkgver には空白やハイフン ({{ic|-}}) を含めることができません。sed を使って対処してください。}}
 ====関数 {{ic|build()}} ====
@@ 120行目: / 120行目: @@
  cd "$pkgname-$pkgver"
 そして、手動でソフトウェアをコンパイルをするのと同じコマンドを書き連ねます。{{ic|build()}} 関数は、煎じ詰めて言えば手でコンパイルするのに必要な操作を自動化したものなのです。今パッケージしているソフトウェアが configure を使っているのなら、{{ic|1=--prefix=/usr}} を使うのが良いでしょう。(多くのソフトウェアがファイルをインストールするのに使う) {{ic|/usr/local}} ディレクトリは、手動でインストールする場合のみに限って使われるべきです。すべての Arch Linux パッケージは、{{ic|/usr}} ディレクトリを使うべきです。{{ic|/usr/share/pacman/PKGBUILD.proto}} に書かれているように、次の2行はだいたい以下のようになるでしょう: