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

削除された内容追加された内容

インライン

2016年1月12日 (火) 17:52時点における版

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

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

Arch Linux の KDE パッケージは特定の形式に従っています。

ビルドディレクトリ

CMake パッケージをビルドするときはプロジェクトのルート以外にビルドディレクトリを作成して、そのディレクトリから cmake を実行することが推奨されます。この場合 PKGBUILD は以下のようになります:

prepare() {
  mkdir -p build
}

build() {
  cd build
  cmake ../${pkgname}-${pkgver}
}

インストールプレフィックス

全てのパッケージには CMAKE_INSTALL_PREFIX 変数を設定する必要がありますが、KDE のカスタムビルドも受け入れるように、以下を使って下さい:

-DCMAKE_INSTALL_PREFIX=$(kde4-config --prefix)

パッケージを [extra] や [community] に移動したときは、以下のように変更します:

-DCMAKE_INSTALL_PREFIX=/usr

ビルドタイプ

ビルドタイプを指定してください。sed ルールを使ってデバッグシンボルを付けてパッケージを再ビルドするのが簡単になります。

-DCMAKE_BUILD_TYPE=Release

Qt4 の強制

KDE4

qt4 と qt5-base の両方がインストールされている環境では、`qmake` は 5.x バージョンを参照するので、以下のように Qt4 を使うように cmake を設定します:

export QT_SELECT=4

もしくは cmake で以下のオプションを使って下さい:

-DQT_QMAKE_EXECUTABLE=/usr/bin/qmake-qt4

KF5

KDE4 と同じように、KF5 の場合は Qt4 の代わりに Qt5 を使うように cmake を設定してください:

export QT_SELECT=5

KDE4 パッケージの命名

KDE Config Module

KDE Config Module パッケージの名前は kcm-module としてください。

Plasma ウィジェット

Plasma ウィジェット (旧名 Plasmoid) パッケージの名前は kdeplasma-applets-widgetname として KDE 関連のパッケージだとわかるようにしてください。公式パッケージと見分けるのにも役立ちます。

ランナー

Plasma の runners パッケージの名前は kdeplasma-runners-runnername として KDE 関連のパッケージだとわかるようにしてください。公式パッケージと見分けるのにも役立ちます。

サービスメニュー

サービスメニューのパッケージは kde-servicemenus-servicename として KDE 関連のパッケージだとわかるようにしてください。

テーマ

Plasma テーマのパッケージ名は kdeplasma-themes-themename として KDE 関連のパッケージだとわかるようにしてください。

KF5 パッケージの命名

Plasma ウィジェット

Plasma ウィジェット (旧名 Plasmoid) パッケージは plasma5-applets-widgetname として Plasma 関連のパッケージだとわかるようにしてください。公式パッケージと見分けるのにも役立ちます。

ランナー

Plasma ランナーパッケージは plasma5-runners-runnername として Plasma 関連のパッケージだとわかるようにしてください。公式パッケージと見分けるのにも役立ちます。

サービスメニュー

サービスメニューパッケージは kf5-servicemenus-servicename として KF5 関連のパッケージだとわかるようにしてください。

テーマ

Plasma テーマパッケージは plasma5-themes-themename として Plasma 関連のパッケージだとわかるようにしてください。

.install ファイル

大抵の KDE パッケージでは、.install ファイルはどれもほとんど同じです。hicolor アイコンテーマにアイコンをインストールするパッケージもあります。(qt4 の依存パッケージとなっている) xdg-utils パッケージに含まれている xdg-icon-resource ユーティリティを使用します。以下のコマンドを使って下さい:

xdg-icon-resource forceupdate --theme hicolor &> /dev/null

多くのパッケージでは Freedesktop.org 互換の .desktop ファイルをインストールして MimeType エントリを登録します。post_install で update-desktop-database を実行することを推奨します。このツールは (qt4 の依存パッケージとなっている) desktop-file-utils パッケージに含まれています。以下のコマンドを使って下さい:

update-desktop-database -q

@@ 1行目: / 1行目: @@
+[[Category:パッケージ開発]]
-#redirect[[en:KDE package guidelines]]
+[[en:KDE package guidelines]]
+{{Package Guidelines}}
+Arch Linux の [[KDE]] パッケージは特定の形式に従っています。
+== ビルドディレクトリ ==
+[[Wikipedia:CMake|CMake]] パッケージをビルドするときはプロジェクトのルート以外にビルドディレクトリを作成して、そのディレクトリから cmake を実行することが推奨されます。この場合 [[PKGBUILD]] は以下のようになります:
+{{bc|
+prepare() {
+  mkdir -p build
+}
+build() {
+  cd build
+  cmake ../${pkgname}-${pkgver}
+}
+}}
+== インストールプレフィックス ==
+全てのパッケージには {{Ic|CMAKE_INSTALL_PREFIX}} 変数を設定する必要がありますが、KDE のカスタムビルドも受け入れるように、以下を使って下さい:
+ -DCMAKE_INSTALL_PREFIX=$(kde4-config --prefix)
+パッケージを [extra] や [community] に移動したときは、以下のように変更します:
+ -DCMAKE_INSTALL_PREFIX=/usr
+== ビルドタイプ ==
+ビルドタイプを指定してください。sed ルールを使ってデバッグシンボルを付けてパッケージを再ビルドするのが簡単になります。
+ -DCMAKE_BUILD_TYPE=Release
+== Qt4 の強制 ==
+=== KDE4 ===
+{{Pkg|qt4}} と {{Pkg|qt5-base}} の両方がインストールされている環境では、`qmake` は 5.x バージョンを参照するので、以下のように Qt4 を使うように cmake を設定します:
+ export QT_SELECT=4
+もしくは cmake で以下のオプションを使って下さい:
+ -DQT_QMAKE_EXECUTABLE=/usr/bin/qmake-qt4
+=== KF5 ===
+KDE4 と同じように、KF5 の場合は Qt4 の代わりに Qt5 を使うように cmake を設定してください:
+ export QT_SELECT=5
+== KDE4 パッケージの命名 ==
+=== KDE Config Module ===
+KDE Config Module パッケージの名前は {{Ic|kcm-''module''}} としてください。
+=== Plasma ウィジェット ===
+Plasma ウィジェット (旧名 Plasmoid) パッケージの名前は {{Ic|kdeplasma-applets-''widgetname''}} として [[KDE]] 関連のパッケージだとわかるようにしてください。公式パッケージと見分けるのにも役立ちます。
+=== ランナー ===
+Plasma の runners パッケージの名前は {{Ic|kdeplasma-runners-''runnername''}} として [[KDE]] 関連のパッケージだとわかるようにしてください。公式パッケージと見分けるのにも役立ちます。
+=== サービスメニュー ===
+サービスメニューのパッケージは {{Ic|kde-servicemenus-''servicename''}} として [[KDE]] 関連のパッケージだとわかるようにしてください。
+=== テーマ ===
+Plasma テーマのパッケージ名は {{Ic|kdeplasma-themes-''themename''}} として [[KDE]] 関連のパッケージだとわかるようにしてください。
+== KF5 パッケージの命名 ==
+=== Plasma ウィジェット ===
+Plasma ウィジェット (旧名 Plasmoid) パッケージは {{Ic|plasma5-applets-''widgetname''}} として [[Plasma]] 関連のパッケージだとわかるようにしてください。公式パッケージと見分けるのにも役立ちます。
+=== ランナー ===
+Plasma ランナーパッケージは {{Ic|plasma5-runners-''runnername''}} として [[Plasma]] 関連のパッケージだとわかるようにしてください。公式パッケージと見分けるのにも役立ちます。
+=== サービスメニュー ===
+サービスメニューパッケージは {{Ic|kf5-servicemenus-''servicename''}} として [[Plasma|KF5]] 関連のパッケージだとわかるようにしてください。
+=== テーマ ===
+Plasma テーマパッケージは {{Ic|plasma5-themes-''themename''}} として [[Plasma]] 関連のパッケージだとわかるようにしてください。
+== .install ファイル ==
+大抵の [[KDE]] パッケージでは、{{Ic|.install}} ファイルはどれもほとんど同じです。hicolor アイコンテーマにアイコンをインストールするパッケージもあります。({{Pkg|qt4}} の依存パッケージとなっている) {{Pkg|xdg-utils}} パッケージに含まれている {{Ic|xdg-icon-resource}} ユーティリティを使用します。以下のコマンドを使って下さい:
+ xdg-icon-resource forceupdate --theme hicolor &> /dev/null
+多くのパッケージでは Freedesktop.org 互換の {{Ic|.desktop}} ファイルをインストールして MimeType エントリを登録します。{{Ic|post_install}} で {{Ic|update-desktop-database}} を実行することを推奨します。このツールは ({{Pkg|qt4}} の依存パッケージとなっている) {{Pkg|desktop-file-utils}} パッケージに含まれています。以下のコマンドを使って下さい:
+ update-desktop-database -q