「Meson パッケージガイドライン」の版間の差分

2022年2月17日 (木) 18:46時点における版

パッケージ作成ガイドライン

32ビット – CLR – クロス – Eclipse – Electron – Free Pascal – GNOME – Go – Haskell – Java – KDE – カーネル – Lisp – MinGW – Node.js – ノンフリー – OCaml – Perl – PHP – Python – R – Ruby – Rust – VCS – ウェブ – Wine

Meson 公式サイトより。

Meson はオープンソースのビルドシステムで、非常に高速で、さらに重要なことに、可能な限りユーザーフレンドリーであることを意図しています。

Python で書かれた Meson は、マルチプラットフォームのサポート、複数のプログラミング言語のサポート、クロスコンパイルなどを特徴としています。

Meson はソフトウェアを直接ビルドするのではなく、バックエンドのビルドシステムをセットアップします。一般的には ninja と共に使われますが、他のビルドシステムを使うこともできます。一般的には、GNU ビルドシステムを置き換えるために使われます。

このドキュメントは Meson を使うソフトウェアのための PKGBUILD を書くための標準ガイドラインを扱っています。

Usage

必要条件

meson は PKGBUILD の makedepends の配列に含まれなければなりません。

build()

設定とビルドは通常 meson バイナリを使うですが、Arch Linux arch-meson ラッパースクリプトを使うことによっても行うことができます。

meson と arch-meson コマンドはどちらも options と source directory と build directory を使用法のシンタックスに含んでいます。

オプション：少なくとも --prefix /usr を含める必要がありますが、その他のオプションは meson configure --help で確認してください。またソフトウェア固有の構築オプションも確認してください。
ソースディレクトリ (または "sourcedir"): ソフトウェアのソースコードが格納されている場所です。例えば ., $pkgname または $pkgname-$pkgver などです。
一般的には build または _build という名前ですが、任意で指定できます。

ノート: ソースディレクトリがビルドディレクトリの前に meson に渡される場合と、その逆の場合がありますが、Meson はどちらがどちらかを知っていて適切に環境をセットアップするので問題ありません。

meson バイナリを直接使用する場合

Arch Linux のパッケージはファイルを /usr/local にインストールしてはいけないため、--prefix=/usr は常に meson のバイナリに渡す必要があります、これは Arch パッケージガイドライン#パッケージエチケットに従っています。--buildtype=plain 組み込みのオプションは、あなたが何をしているかを知っていれば、他の値を設定することができます。

arch-meson ラッパースクリプトの使用

arch-meson は meson パッケージに含まれるラッパースクリプトで、Arch パッケージで使われるであろう Meson 組み込みのオプションのいくつかを設定し、パッケージ製作者の時間と PKGBUILD のコードを節約する利点があります。arch-meson に書かれている説明を引用すると、Highly opinionated wrapper for Arch Linux packaging（Arch Linux のパッケージングのための高度なラッパー）です。

例:

build() {
  arch-meson source build
  meson compile -C build
}

ソフトウェア固有のビルドオプションを設定する

Meson にはいくつかの組み込みビルドオプション (たとえば --prefix) がありますが、パッケージ化されるソフトウェアには、パッケージャーが考慮すべき、他のビルドオプションがあるかもしれません。有効なソフトウェア固有のビルドオプションは、通常 meson_options.txt という名前のファイルに書かれています。(存在する場合) と meson.build にあります。これらのファイルで option(settings) を探し、settings を読みます。

ソフトウェア固有のビルドオプションを使用するには、-D key=value という記法を使います。ここで key はプロジェクトで設定したビルドオプション名、 value は例えば true などの有効な値です。

例えば、gtranslator は以下のようなビルドオプションを持っています。

meson_options.txt

option('gtk_doc', type: 'boolean', value: false, description: 'use gtk-doc to build documentation')

したがって、そのドキュメントを構築するためには、Meson を実行する必要があります。 -D gtk_doc=true build オプションを指定すると、コマンドラインは次のようになります。

arch-meson $pkgname-$pkgver build -Dgtk_doc=true

check()

パッケージ化されるソフトウェアがテストスイートを提供しているなら、PKGBUILD の check() 関数で実行することを検討してください。これは meson test コマンドで実行することができます。

例

check() {
  meson test -C build
}

ここで build は、上記の #build() ステップで使用したものと同じビルドディレクトリ名です。

ヒント:

代わりに ninja test -C build を直接使用することができます。
失敗したテストによって生成された出力を、環境変数として他の有用な情報と共に報告するために、 --print-errorlogs パラメータを meson test に追加することができます。

詳細については meson test --help と Unit tests in Meson docs を参照してください。

package()

パッケージングには通常 meson install のみの実行が必要ですが、他のインストールコマンドが必要な場合は確認してください（例えば uncommon license など）上記と同じビルドディレクトリを使い、--destdir フラグをセットしてください。

package() {
  meson install -C build --destdir "$pkgdir"
}

ノート: DESTDIR="$pkgdir" を追加することも有効です。--destdir の代わりです [1]

ヒント: ninja install -C build の代わりに直接使用することができます。

テンプレート

以上の説明をまとめ、コピー＆ペーストのワンポイントを提供するために、以下のテンプレートをご覧ください。

makedepends=(meson)

build() {
  arch-meson $pkgname-$pkgver build
  meson compile -C build
}

check() {
  meson test -C build
}

package() {
  meson install -C build --destdir "$pkgdir"
}

サンプルパッケージ

これは、Meson を使用するパッケージの小さなリストです。meson の 必要とするパッケージ のリストにある他のパッケージも参照してください。

参照

@@ 117行目: / 117行目: @@
 == サンプルパッケージ ==
-これは、Meson を使用するパッケージの小さなリストです。{{Pkg|meson}} の ''Required by'' のリストにある他のパッケージも参照してください。
+これは、Meson を使用するパッケージの小さなリストです。{{Pkg|meson}} の ''必要とするパッケージ'' のリストにある他のパッケージも参照してください。
 * {{Pkg|gstreamer}}