GNOME パッケージガイドライン - 版の履歴

Kgx: /* Git リポジトリからのコミットの使用 */ 同期

2025-02-09T17:12:16Z

Git リポジトリからのコミットの使用: 同期

← 古い版		2025年2月10日 (月) 02:12時点における版
23行目:		23行目:
	もう1つの一般的な方法は、GNOME ソフトウェアのソースコードを git リポジトリから特定のコミットをソースとして使用することです。特定のコミットを設定する Pacman の機能 ({{man\|5\|PKGBUILD\|USING VCS SOURCES}} を参照) により PKGBUILD は最新の開発コミットに従わず、代わりに指定されたコミットハッシュからのソースを使用して {{ic\|pkgver}} フィールドを更新しないため、VCS パッケージとして分類されません。		もう1つの一般的な方法は、GNOME ソフトウェアのソースコードを git リポジトリから特定のコミットをソースとして使用することです。特定のコミットを設定する Pacman の機能 ({{man\|5\|PKGBUILD\|USING VCS SOURCES}} を参照) により PKGBUILD は最新の開発コミットに従わず、代わりに指定されたコミットハッシュからのソースを使用して {{ic\|pkgver}} フィールドを更新しないため、VCS パッケージとして分類されません。

	以下のテンプレートを参照してください。		以下のテンプレートを参照してください:
	{{hc\|1=PKGBUILD\|2=		{{hc\|1=PKGBUILD\|2=
			url="<nowiki>https://gitlab.gnome.org/GNOME/$pkgname</nowiki>"
	makedepends=(git)		makedepends=(git)
	~~commit~~=''hash_of_a_commit'' <nowiki>		_commit=''hash_of_a_commit'' # tags/''X.Y.Z'' <nowiki>
	source=("git+~~https://gitlab.gnome.org/GNOME/~~$~~pkgname~~.git#commit=$_commit")		source=("git+${url}.git#commit=$_commit")
	md5sums=('SKIP')		md5sums=('SKIP')

Kgx: /* .desktop ファイル */ 同期

2025-02-09T17:10:27Z

.desktop ファイル: 同期

← 古い版		2025年2月10日 (月) 02:10時点における版
96行目:		96行目:

	{{Note\|		{{Note\|
	* {{Pkg\|desktop-file-utils}}=0.22- 以降、データベースは [[Pacman#フック\|pacman フック]] 経由で自動的に更新されるため、.install ファイルで ''update-desktop-database'' を呼び出さないでください。		* {{Pkg\|desktop-file-utils}}=0.22-2 以降、データベースは [[Pacman#フック\|pacman フック]] 経由で自動的に更新されるため、.install ファイルで ''update-desktop-database'' を呼び出さないでください。
	* この依存関係は {{Pkg\|gtk4}} などのパッケージによって満たされるため、パッケージは {{Pkg\|desktop-file-utils}} に依存する必要は ''ありません''。		* この依存関係は {{Pkg\|gtk4}} などのパッケージによって満たされるため、パッケージは {{Pkg\|desktop-file-utils}} に依存する必要は ''ありません''。
	}}		}}

Kgx: /* Git リポジトリからのコミットの使用 */ 同期

2024-12-23T12:31:24Z

Git リポジトリからのコミットの使用: 同期

← 古い版		2024年12月23日 (月) 21:31時点における版
21行目:		21行目:
	=== Git リポジトリからのコミットの使用 ===		=== Git リポジトリからのコミットの使用 ===

	もう1つの一般的な方法は、GNOME ソフトウェアのソースコードを git リポジトリから特定のコミットをソースとして使用することです。特定のコミットを設定する Pacman の機能 ({{man\|5\|PKGBUILD\|USING VCS SOURCES}} を参照) が PKGBUILD を最新の開発コミットに従わず、{{ic\|pkgver}} フィールドを更新しないため、VCS パッケージとして分類されません~~。代わりに指定されたコミットハッシュのソース~~。		もう1つの一般的な方法は、GNOME ソフトウェアのソースコードを git リポジトリから特定のコミットをソースとして使用することです。特定のコミットを設定する Pacman の機能 ({{man\|5\|PKGBUILD\|USING VCS SOURCES}} を参照) により PKGBUILD は最新の開発コミットに従わず、代わりに指定されたコミットハッシュからのソースを使用して {{ic\|pkgver}} フィールドを更新しないため、VCS パッケージとして分類されません。

	以下のテンプレートをご覧ください。		以下のテンプレートを参照してください。
	{{hc\|1=PKGBUILD\|2=		{{hc\|1=PKGBUILD\|2=
	makedepends=(git)		makedepends=(git)
36行目:		36行目:
	}}		}}

	''hash_of_a_commit'' を必要な Gitのコミットハッシュに置き換えます。		{{ic\|''hash_of_a_commit''}} を必要な Git コミットハッシュに置き換え、パッケージ化するパッケージのニーズに合わせて {{ic\|pkgver()}} ステートメントを置き換えます ([[VCS パッケージガイドライン#Git]] を参照)

	ソースは ''git'' を使用してダウンロードされるため、他の VCS パッケージの場合と同様に、{{pkg\|git}} が makedepends にあり、チェックサムが 'SKIP' に設定されている必要があります。 {{ic\|pkgver()}} 関数を使用することを強くお勧めします。そのため、提供されるコミットハッシュに応じて {{ic\|pkgver}} を設定します。		ソースは ''git'' を使用してダウンロードされるため、他の VCS パッケージの場合と同様に、{{pkg\|git}} が makedepends にあり、チェックサムが {{ic\|'SKIP'}} に設定されている必要があります。 {{ic\|pkgver()}} 関数を使用することを強くお勧めします。そのため、提供されるコミットハッシュに応じて {{ic\|pkgver}} を設定します。

	{{ノート\|GNOME は以前は https://git.gnome.org, を使用していましたが、その後 https://gitlab.gnome.org [https://www.gnome.org/news/2018/05/gnome-moves-to-gitlab-2/] に移行しました。古いリンクは自動的に新しいgitlab.gnome.org ドメインにリダイレクトされますが、ソース URL を手動で更新することをお勧めします。}}		{{ノート\|GNOME は以前は https://git.gnome.org, を使用していましたが、その後 https://gitlab.gnome.org [https://www.gnome.org/news/2018/05/gnome-moves-to-gitlab-2/] に移行しました。古いリンクは自動的に新しいgitlab.gnome.org ドメインにリダイレクトされますが、ソース URL を手動で更新することをお勧めします。}}

Kgx: /* リリースされた tarball を使用する */ 同期

2024-12-23T12:20:42Z

リリースされた tarball を使用する: 同期

← 古い版		2024年12月23日 (月) 21:20時点における版
17行目:		17行目:
	<nowiki>source=("https://download.gnome.org/sources/$pkgname/${pkgver%.*}/$pkgname-$pkgver.tar.xz")</nowiki>		<nowiki>source=("https://download.gnome.org/sources/$pkgname/${pkgver%.*}/$pkgname-$pkgver.tar.xz")</nowiki>

	ここで、 ''$ {pkgver%。}'' は、{{ic\|pkgver}} のサフィックス (''micro''パッケージ) を削除することにより、''major'' ''minor'' パッケージバージョンを返します。) たとえば ''pkgver = 3.28.0''の場合 ''$ {pkgver%。}'' は ''3.28'' を返します。		ここで、{{ic\|${pkgver%.} }} は、{{ic\|pkgver}} のサフィックス (''micro''パッケージ) を削除することにより、''major'' ''minor'' パッケージバージョンを返します。) たとえば ''pkgver = 3.28.0''の場合 {{ic\|${pkgver%.} }} は ''3.28'' を返します。

	=== Git リポジトリからのコミットの使用 ===		=== Git リポジトリからのコミットの使用 ===

Kgx: 他言語へのリンクを修正

2024-12-23T12:18:25Z

他言語へのリンクを修正

← 古い版		2024年12月23日 (月) 21:18時点における版
1行目:		1行目:
	[[Category:パッケージ開発]]		[[Category:パッケージ開発]]
	[[en:GNOME package guidelines]]		[[en:GNOME package guidelines]]
	[[it:GNOME package guidelines]]		[[pt:GNOME package guidelines]]
			[[ru:GNOME package guidelines]]
	{{Package Guidelines}}		{{Package Guidelines}}

Kgx: /* ソース URL */ 情報を更新

2023-06-26T15:27:05Z

ソース URL: 情報を更新

← 古い版		2023年6月27日 (火) 00:27時点における版
6行目:		6行目:
	Arch Linux では [[GNOME]] パッケージは特定の決まり事に従っています。		Arch Linux では [[GNOME]] パッケージは特定の決まり事に従っています。

	==ソース URL ==		== ソース URL ==

			GNOME パッケージは通常、2 つのソース URL スキームに従います。GNOME の FTP サーバーに保存されているリリース済みの tarball と、ソフトウェアの Git リポジトリ内の特定のコミットです。
	このトピックには、[[公式リポジトリ]] と [[AUR]] の両方で GNOME パッケージによって使用される最も一般的なソース URL が含まれています。例として、公式リポジトリ [https://www.archlinux.org/packages/?q=gnome] および AUR [https://aur.archlinux.org/packages/?K=gnome で GNOME パッケージを検索してください。 ]

	===リリースされた tarball を使用する===		=== リリースされた tarball を使用する ===

	リリースされた tarball をダウンロードする場合、次のソース配列を使用して https://download.gnome.org から入手できます。		リリースされた tarball をダウンロードする場合、次のソース配列を使用して https://download.gnome.org から入手できます。
18行目:		18行目:
	ここで、 ''$ {pkgver%。}'' は、{{ic\|pkgver}} のサフィックス (''micro''パッケージ) を削除することにより、''major'' ''minor'' パッケージバージョンを返します。) たとえば ''pkgver = 3.28.0''の場合 ''$ {pkgver%。}'' は ''3.28'' を返します。		ここで、 ''$ {pkgver%。}'' は、{{ic\|pkgver}} のサフィックス (''micro''パッケージ) を削除することにより、''major'' ''minor'' パッケージバージョンを返します。) たとえば ''pkgver = 3.28.0''の場合 ''$ {pkgver%。}'' は ''3.28'' を返します。

	=== Git リポジトリからのコミットの使用===		=== Git リポジトリからのコミットの使用 ===

	もう1つの一般的な方法は、GNOME ソフトウェアのソースコードを git リポジトリから特定のコミットをソースとして使用することです。特定のコミットを設定する Pacman の機能 ({{man\|5\|PKGBUILD\|USING VCS SOURCES}} を参照) が PKGBUILD を最新の開発コミットに従わず、{{ic\|pkgver}} フィールドを更新しないため、VCS パッケージとして分類されません。代わりに指定されたコミットハッシュのソース。		もう1つの一般的な方法は、GNOME ソフトウェアのソースコードを git リポジトリから特定のコミットをソースとして使用することです。特定のコミットを設定する Pacman の機能 ({{man\|5\|PKGBUILD\|USING VCS SOURCES}} を参照) が PKGBUILD を最新の開発コミットに従わず、{{ic\|pkgver}} フィールドを更新しないため、VCS パッケージとして分類されません。代わりに指定されたコミットハッシュのソース。

Kgx: /* .install ファイル */ 情報を更新

2023-06-26T15:25:39Z

.install ファイル: 情報を更新

← 古い版		2023年6月27日 (火) 00:25時点における版
99行目:		99行目:
	}}		}}

	== ~~.install~~ ファイル ==		== AppStream およびメタ情報ファイル ==

			他の多くのアプリケーションと同様、ほとんどの GNOME アプリケーションは Freedesktop.org の [https://www.freedesktop.org/software/appstream/docs/AppStream 仕様] に準拠しており、アプリケーションの説明がアプリケーションセンターに表示されるようにメタ情報ファイルを提供しています。{{Pkg\|gnome-software}} や [https://flathub.org Flathub] など。
	以前は {{Ic\|glib-compile-schemas}}, {{Ic\|gtk-update-icon-cache}}, {{Ic\|update-desktop-database}} などのコマンドを呼び出してキャッシュやデータベースをインストール・更新するために GNOME パッケージの多くで {{ic\|.install}} ファイルが使われていました。pacman 5.0 になって[[Pacman#フック\|フック]]が実装されてからはパッケージのインストール時に自動的にコマンドが実行されるため不要になりました。

			GNOME アプリケーションは通常、[[Meson パッケージガイドライン#check()\|check()]] 関数で {{ic\|meson test}} が呼び出されたときに ''appstream-util'' ツールを使用してメタ情報ファイルを検証します。{{Pkg\|appstream-glib}} がインストールされていない場合、この特定の検証が実行されなくなるだけです (つまり、エラーが出てもビルドプロセスを中断しません)
	同じコマンドが2回実行されてしまうのを防ぐため、{{ic\|.install}} ファイルから上記のコマンドを削除するようにしてください。

			次の 2 つの方法を使用して、アプリケーションによって ''appstream-util'' が使用されていることを確認できます。
			* 1 つ目の方法は、{{ic\|grep -R appstream-util}} を実行するか、{{ic\|data/meson.build}} ファイルを調べて、''appstream-util'' のソースコードを調べることです。
			* もう 1 つの方法は、ビルドプロセスを読み取り、次を探します。{{bc\|Program appstream-util found: NO}}

			{{Pkg\|appstream-glib}} を checkdepends 配列に追加してメタ情報ファイルを検証します。

Kgx: /* .desktop ファイル */ 情報を更新

2023-06-26T15:19:22Z

.desktop ファイル: 情報を更新

← 古い版		2023年6月27日 (火) 00:19時点における版
91行目:		91行目:

	== .desktop ファイル ==		== .desktop ファイル ==
⚫	多くのパッケージは Freedesktop.org 互換の {{Ic\|.desktop}} ファイルをインストールして MimeType エントリを登録します。その~~ようなパッケージ~~は ~~{{Pkg\|desktop-file-utils}} を依存パッケ~~ージとする必要があります。

		⚫	多くのパッケージは、Freedesktop.org と互換性のある {{ic\|.desktop}} ファイルをインストールし、そのファイルに MimeType エントリを登録します。これらの情報はデータベースに保存され、追加または削除されるたびに更新する必要があります。これは ''update-desktop-database'' ツールの機能です。
	{{ic\|.install}} ファイルから {{Ic\|update-desktop-database}} を実行してはいけません。{{Pkg\|desktop-file-utils}}=0.22-2 からデータベースは [[Pacman#フック\|pacman フック]]によって自動的に更新されます。

			{{Note\|
			* {{Pkg\|desktop-file-utils}}=0.22- 以降、データベースは [[Pacman#フック\|pacman フック]] 経由で自動的に更新されるため、.install ファイルで ''update-desktop-database'' を呼び出さないでください。
			* この依存関係は {{Pkg\|gtk4}} などのパッケージによって満たされるため、パッケージは {{Pkg\|desktop-file-utils}} に依存する必要は ''ありません''。
			}}

	== .install ファイル ==		== .install ファイル ==

Kgx: /* GTK アイコンキャッシュ */ 情報を更新

2023-06-26T15:16:07Z

GTK アイコンキャッシュ: 情報を更新

← 古い版		2023年6月27日 (火) 00:16時点における版
82行目:		82行目:

	== GTK アイコンキャッシュ ==		== GTK アイコンキャッシュ ==
	パッケージが hicolor アイコンテーマにアイコンをインストールする場合があります。パッケージを {{Pkg\|gtk-update-icon-cache}} に依存するようにしてください。

	~~{{ic\|.install}}~~ ファイルから ~~{{Ic\|~~gtk-update-icon-cache}} を実行して~~はいけません。{{Pkg\|gtk-update-icon-cache}}=3.20.3-2 から~~アイコンキャッシュは ~~[[Pacman#フック\|pacman フック]]~~によって~~自動的に~~更新されます。		多くのグラフィカル GNOME アプリケーションはシステムにアイコンをインストールし、それらのアイコンは ''gtk-update-icon-cache'' ツールを介してアイコンキャッシュに含まれます。アイコンが追加または削除されるたびに、このツールを使用してキャッシュが更新されます。

			{{Note\|
			* {{ic\|.install}} ファイルから {{Ic\|gtk-update-icon-cache}} を実行してはいけません。{{Pkg\|gtk-update-icon-cache}}=3.20.3-2. からアイコンキャッシュは [[Pacman#フック\|pacman フック]] によって自動的に更新されます。
			* この依存関係は {{Pkg\|gtk4}} などのパッケージによって満たされるため、パッケージは {{Pkg\|gtk-update-icon-cache}} に依存する必要はありません。
			}}

	== .desktop ファイル ==		== .desktop ファイル ==

Kgx: /* Scrollkeeper ドキュメント */ 情報を更新

2023-06-26T15:12:58Z

Scrollkeeper ドキュメント: 情報を更新

← 古い版		2023年6月27日 (火) 00:12時点における版
74行目:		74行目:

	== Scrollkeeper ドキュメント ==		== Scrollkeeper ドキュメント ==

⚫	GNOME 2.20 から scrollkeeper を利用する必要はなくなりました。{{AUR\|rarian}} が直接 OMF ファイルを読み込みます。現在 Scrollkeeper-update はダミーになっています。~~makedepend~~ に {{AUR\|gnome-doc-utils}}~~>=0.11.2~~ を~~追加す~~ること~~以外は何もしなくてかまいません~~。
			現在、GNOME アプリケーションは [http://scrollkeeper.sourceforge.net/ ScrollKeeper] を使用していませんが、そのドキュメントを備えた GTK2 ベースのアプリケーションに遭遇する可能性があります。

		⚫	GNOME 2.20 から scrollkeeper を利用する必要はなくなりました。{{AUR\|rarian}} が直接 OMF ファイルを読み込みます。現在 Scrollkeeper-update はダミーになっています。唯一の要件は、makedepends 配列に {{AUR\|gnome-doc-utils}} を含めることです。

	{{ic\|./configure}} から {{Ic\|--disable-scrollkeeper}} スイッチを使うことで無効化できます。		{{ic\|./configure}} から {{Ic\|--disable-scrollkeeper}} スイッチを使うことで無効化できます。