[[Category:パッケージ開発]]
[[en:VCS package guidelines]]
[[it:VCS package guidelines]]
[[zh-hans:VCS package guidelines]]
[[zh-hant:VCS package guidelines]]
{{Package Guidelines}}

[[Wikipedia:ja:バージョン管理システム|バージョン管理システム]]は通常の安定版のパッケージと最新の (trunk) 開発版のブランチ、どちらのソースコードの取得にも使うことができます。この記事では両方のケースを説明しています。

== プロトタイプ ==
{{Pkg|pacman}} パッケージに含まれている PKGBUILD のプロトタイプだけを使うようにしてください ({{ic|/usr/share/pacman}} の {{ic|PKGBUILD-split.proto}}, {{ic|PKGBUILD-vcs.proto}}, {{ic|PKGBUILD.proto}})。

== ガイドライン ==

* {{Ic|pkgname}} の末尾に {{Ic|-cvs}}, {{Ic|-svn}}, {{Ic|-hg}}, {{Ic|-darcs}}, {{Ic|-bzr}}, {{Ic|-git}} などを付けて下さい。パッケージが特定のリリースを取得する場合は別です。

* 依存関係, URL, ソースなどの変更を行なったことで作られるパッケージが異なるようになった時は {{Ic|pkgrel}} の値を増やして下さい。{{ic|pkgver}} を変える必要はありません。

* {{Ic|--holdver}} を使うことで [[makepkg|makepkg]] が {{ic|pkgver}} を更新するのを止めることができます (参照: [https://www.archlinux.org/pacman/makepkg.8.html makepkg(8)])

* パッケージに conflicts と provides を含めて下さい (例えば {{AUR|fluxbox-git}} なら: {{Ic|1=conflicts=('fluxbox')}} と {{Ic|1=provides=('fluxbox')}})。

* {{Ic|1=replaces=()}} は一般的に不必要な問題を起こすので使わないで下さい。

* cvsroot を使う場合、空のパスワードや {{Ic|anonymous:password@}} を入力するのを避けるために {{Ic|anonymous@}} ではなく {{Ic|anonymous:@}} を使って下さい。

* {{Ic|1=makedepends=()}} に適当な VCS ツールを含めて下さい ({{pkg|cvs}}, {{pkg|subversion}}, {{pkg|git}}, ...)。

* ソースが固定されないので、チェックサムは {{ic|1=md5sums=()}} に {{ic|'SKIP'}} を追加してスキップしてください。

=== VCS ソース ===
{{Note|Pacman 4.1 は以下の VCS ソースをサポートしています: {{ic|bzr}}, {{ic|git}}, {{ic|hg}}, {{ic|svn}}。サポートされている VCS の一覧は {{ic|man PKGBUILD}} の {{ic|fragment}} セクションや [https://www.archlinux.org/pacman/PKGBUILD.5.html PKGBUILD(5)] を見て下さい。}}

{{Pkg|pacman}} 4.1 から、VCS ソースは {{ic|1=source=()}} に指定することになり他のソースと同じように扱われるようになりました。{{ic|makepkg}} はリポジトリを {{ic|$SRCDEST}} ([https://www.archlinux.org/pacman/makepkg.conf.5.html makepkg.conf(5)] の設定がない場合は {{ic|$startdir}} と同じ) に複製・チェックアウト・ブランチして {{ic|$srcdir}} にコピーします (それぞれの VCS に合わせた方法を使います)。ローカルリポジトリは変更がされないので、{{ic|-build}} ディレクトリを作る必要はありません。

VCS の {{ic|1=source=()}} の一般的なフォーマットは:
source=('[folder::][vcs+]url[#fragment]')

* {{ic|folder}} (任意) はデフォルトのリポジトリ名を ({{ic|trunk}} など) 無関係な名前から他の名前に変更するため、もしくは以前のソースを維持するために使われます。
* {{ic|vcs+}} は VCS のタイプを表さない URL で必要です (例: {{ic|git+http://some_repo}})。
* {{ic|url}} はリモートやローカルのリポジトリの URL です。
* {{ic|#fragment}} (任意) は特定のブランチやコミットを pull するのに必要です。各 VCS で使えるフラグメントの詳細は {{ic|man PKGBUILD}} を見て下さい。

Git の source の例:
<nowiki>source=('project_name::git+http://project_url#branch=project_branch')</nowiki>

=== 関数 pkgver() ===
{{ic|pkgver()}} 関数を使うことで {{ic|pkgver}} を自動で更新することが可能です。これによって {{ic|pkgver}} をより良くコントロールすることが出来るようになります。メンテナは {{ic|pkgver}} を意味あるものに扱うべきです。

次のバージョンフォーマットが推奨されています: ''RELEASE.rREVISION''。''REVISION'' はソースツリーの変更毎に増える番号です (VCS のリビジョンと同じ)。最新の VCS タグは ''RELEASE'' に使うことができます。公開リリースやリポジトリのタグがない場合、ゼロをリリース番号に使ったり ''RELEASE'' を完全に省いて ''rREVISION'' のようにバージョンを使って下さい。公開リリースが存在してリポジトリにタグがないときは開発者はプロジェクトファイルのパースなどによってリリースバージョンを取得します。

リビジョン番号の区分け (REVISION の前の "r") は重要です。開発元が初めてリリースを行うことを決めたり、別のバージョン方式によるバージョンを付けるようになった場合に問題を避けることができます。例えばリビジョン "455" で、上流がバージョン 0.1 をリリースした場合、リビジョンの区分けをしていれば問題なくバージョンアップが認識されます ({{ic|0.1.r456 > r454}})。区分けがないとバージョンアップと認識されません ({{ic|0.1.456 < 454}})。

以下は''意図した''出力を行うサンプルです:

==== Git ====

最後のコミットの注釈付きタグを使う:

{{hc|<nowiki>pkgver() {
cd "$pkgname"
git describe --long | sed 's/$[^-]*-g$/r\1/;s/-/./g'
}</nowiki>|
2.0.r6.ga17a017
}}

最後のコミットの注釈が付かないタグを使う:

{{hc|<nowiki>pkgver() {
cd "$pkgname"
git describe --long --tags | sed 's/$[^-]*-g$/r\1/;s/-/./g'
}</nowiki>|
0.71.r115.gd95ee07
}}

git タグにダッシュが含まれていない場合、sed はもっとシンプルにできます: {{ic|sed 's/-/.r/;s/-/./'}}。

タグに {{ic|v}} やプロジェクト名などが付いている場合、取り除きます:

{{hc|<nowiki>
pkgver() {
cd "$pkgname"
# cutting off 'foo-' prefix that presents in the git tag
git describe --long | sed 's/^foo-//;s/$[^-]*-g$/r\1/;s/-/./g'
}</nowiki>|
6.1.r3.gd77e105
}}

タグが存在しない場合、最初から数えたリビジョンの数を使ってください:

{{hc|<nowiki>pkgver() {
cd "$pkgname"
printf "r%s.%s" "$(git rev-list --count HEAD)" "$(git rev-parse --short HEAD)"
}</nowiki>|
r1142.a17a017
}}

バージョンとコミット/リビジョン番号のみ (SHA1 は省かれます。ただし、バージョンを忘れると実際のリビジョンがわからなくなります):

git describe --long | sed -r 's/-([0-9,a-g,A-G]{7}.*)//' | sed 's/-/./'

両方を組み合わせて、タグが最初に付かないリポジトリに対応することもできます (bashism を使用):

{{hc|<nowiki>
pkgver() {
cd "$pkgname"
( set -o pipefail
git describe --long 2>/dev/null | sed 's/$[^-]*-g$/r\1/;s/-/./g' ||
printf "r%s.%s" "$(git rev-list --count HEAD)" "$(git rev-parse --short HEAD)"
)
}</nowiki>|
0.9.9.r27.g2b039da # if tags exist
r1581.2b039da # else fallback
}}

==== Subversion ====
{{hc|<nowiki>pkgver() {
cd "$pkgname"
local ver="$(svnversion)"
printf "r%s" "${ver//[[:alpha:]]}"
}</nowiki>|
r8546
}}

{{Note|プロジェクトにリリースがある場合は {{ic|0.}} の代わりにそれを使って下さい。}}

==== Mercurial ====
{{hc|<nowiki>pkgver() {
cd "$pkgname"
printf "r%s.%s" "$(hg identify -n)" "$(hg identify -i)"
}</nowiki>|
r2813.75881cc5391e
}}

==== Bazaar ====
{{hc|<nowiki>pkgver() {
cd "$pkgname"
printf "r%s" "$(bzr revno)"
}</nowiki>|
r830
}}

==== Fallback ====
リポジトリから {{ic|pkgver}} が全く得られない場合は、現在の日付を使うことができます:

{{hc|<nowiki>pkgver() {
date +%Y%m%d
}</nowiki>|
20130408
}}

ソースツリーの状態を一意に示しているのではないので、出来る限り使わないで下さい。

== ヒントとテクニック ==

=== Git の PKGBUILD のサンプル ===
# Maintainer: Dave Reisner <d@falconindy.com>
# Contributor: William Giokas (KaiSforza) <1007380@gmail.com>

pkgname=expac-git
pkgver=0.0.0
pkgrel=1
pkgdesc="Pacman database extraction utility"
arch=('i686' 'x86_64')
url="https://github.com/falconindy/expac"
license=('MIT')
depends=('pacman')
makedepends=('git')
conflicts=('expac')
provides=('expac')
# The git repo is detected by the 'git:' or 'git+' beginning. The branch
# '$pkgname' is then checked out upon cloning, expediating versioning:
#source=('git+https://github.com/falconindy/expac.git'
source=("$pkgname"::'git://github.com/falconindy/expac.git'
'expac_icon.png')
# Because the sources are not static, skip Git checksum:
md5sums=('SKIP'
'020c36e38466b68cbc7b3f93e2044b49')

pkgver() {
cd "$srcdir/$pkgname"
# Use the tag of the last commit
git describe --long | sed -E 's/([^-]*-g)/r\1/;s/-/./g'
}

build() {
cd "$srcdir/$pkgname"
make
}

package() {
cd "$srcdir/$pkgname"
make PREFIX=/usr DESTDIR="$pkgdir" install
install -Dm644 "$srcdir/expac_icon.png" "$pkgdir/usr/share/pixmaps/expac.png"
}

=== Git サブモジュール ===
Git サブモジュールは少しトリッキーなことをする必要があります。サブモジュールの URL を直接 source に加えて、それから prepare() でそれらを使うようにしてください。以下のようになります:

source=("git://somewhere.org/something/something.git"
"git://somewhere.org/mysubmodule/mysubmodule.git")

prepare() {
cd something
git submodule init
git config submodule.mysubmodule.url $srcdir/mysubmodule
git submodule update
}

Plymouth

2019-07-26T05:55:50Z

Hayao0819: LTSカーネルについて追記

[[Category:ブートスプラッシュ]]
[[cs:Plymouth]]
[[fa:Plymouth]]
[[en:Plymouth]]
[[es:Plymouth]]
[[it:Plymouth]]
[[pt:Plymouth]]
[[ru:Plymouth]]
[[zh-hans:Plymouth]]
[https://www.freedesktop.org/wiki/Software/Plymouth Plymouth] は Fedora のフリッカーフリーなグラフィカルブートプロセスを提供するためのプロジェクトです。[[Kernel Mode Setting]] (KMS) を使って出来るだけ早い段階でディスプレイの最大解像度に設定し、ログインマネージャが表示されるまで、キレイなスプラッシュスクリーンを提供します。

==準備==
まず、Plymouth は [[Kernel Mode Setting|KMS]] (Kernel Mode Setting) を使ってグラフィックを表示します。（プロプライエタリドライバを使っているなどの理由で）あなたが KMS を使えない場合、代わりに[[フレームバッファ]]を使う必要があります。EFI/UEFI 環境の場合、plymouth は EFI フレームバッファを利用します。BIOS 環境の場合、ワイド画面を機能させることができる [[Uvesafb]] が推奨されます。

KMS もフレームバッファも使えない場合、Plymouth はテキストモードになります。

==インストール==
Plymouth は {{AUR|plymouth}} パッケージでインストールできます。開発版を使いたい場合は {{AUR|plymouth-git}} をインストールしてください。

[[GDM]] を使用する場合、{{AUR|gdm-plymouth}} をインストールして、plymouth のサポートを有効にして gdm をコンパイルしてください。

===plymouth フック===

{{ic|plymouth}} を [[mkinitcpio.conf]] の HOOKS 行に追加してください。必ず {{ic|base}} と {{ic|udev}} の後に追加してください:

{{hc|/etc/mkinitcpio.conf|2=HOOKS="base udev plymouth [...] "}}

{{Warning|
* {{ic|encrypt}} フックで [[dm-crypt]] を使用する場合、{{ic|encrypt}} フックは {{ic|plymouth-encrypt}} に置き換えてください。置き換えないと TTY のパスワードプロンプトが表示されなくなります。
* {{ic|1=cryptdevice=}} パラメータで PARTUUID や PARTLABEL を使用すると {{ic|plymouth-encrypt}} フックが機能しなくなります。
}}

{{ic|plymouth-encrypt}} フックの追加後に、入力したテキストがパスワードプロンプトではなく後ろに行ってしまう場合、initramfs に（カーネル）グラフィックドライバーを追加する必要があります。例えば、Intel のグラフィックを使っている場合:

{{hc|/etc/mkinitcpio.conf|2=MODULES="i915 [...]"}}

===別の plymouth フック (systemd)===
[[mkinitcpio.conf]] で {{ic|systemd}} フックを使用している場合、{{ic|plymouth}} を {{ic|sd-plymouth}} に置き換えてください。さらに、ハードドライブ暗号化を使っている場合、{{ic|encrypt}} や {{ic|plymouth-encrypt}} のかわりに {{ic|sd-encrypt}} を使ってください:

{{hc|/etc/mkinitcpio.conf|2=HOOKS="base systemd sd-plymouth [...] sd-encrypt [...]"}}

===カーネルコマンドライン===

ブートローダーのカーネルコマンドラインパラメータに {{ic|quiet splash}} を設定してください。詳しくは[[カーネルパラメータ]]を参照。

設定したら initrd イメージを再生成してください (詳しくは [[mkinitcpio]] の記事を参照):

# mkinitcpio -p linux
LTSカーネルを使用している場合は以下のようにする必要があります。
# mkinitcpio -p linux-lts

==設定==

===スムーズな移行===

スムーズな移行を有効にするには:

#[[ディスプレイマネージャ]]のユニットを無効化してください。例: {{ic|systemctl disable gdm.service}}。
#各ディスプレイマネージャに対応する plymouth のユニットを有効にしてください ([[GDM]], [[LXDM]], [[SLiM]], [[LightDM]], [[SDDM]] のユニットが存在します)。例: {{ic|systemctl enable gdm-plymouth.service}}。

===起動を遅らせる===

バージョン 0.9.0 から、plymouth には {{ic|/etc/plymouth/plymouthd.conf}} に設定できる新しいオプションが存在します:

{{hc|/etc/plymouth/plymouthd.conf|2=
[Daemon]
Theme=spinner
ShowDelay=5
}}

起動が早い環境では、ディスプレイマネージャやログイン画面が表示される前にスプラッシュ画面が一瞬しか表示されない場合があります。ShowDelay を設定することで秒数単位で起動を長くすることができます。デフォルトは5秒間ですが、短くすることでスプラッシュ画面が早く表示されるようになります。

===テーマの変更===

Plymouth には以下のテーマが付属しています:

#'''Fade-in''': 光る星がフェードイン・アウトするシンプルなテーマ。
#'''Glow''': ブートプログレスのパイチャートが表示されロゴが浮かび上がるテーマ。
#'''Script''': スクリプトサンプルプラグイン (ナイスな Arch ロゴテーマ)。
#'''Solar''': 青い炎が上がる星と宇宙のテーマ。
#'''Spinner''': ロードの歯車が表示されるシンプルなテーマ。
#'''Spinfinity''': 画面の中央に無限マークが表示されるシンプルなテーマ。
#''('''Text''': 3色のプログレスバーのテキストモードテーマ)''
#''('''Details''': 古臭いフォールバックテーマ)''

[[AUR]] から他のテーマを追加でインストールすることもできます。{{AUR|plymouth}} に依存しているパッケージを見てください。

インストールされているテーマは以下のコマンドで確認できます:

$ plymouth-set-default-theme -l

または:

{{hc|$ ls /usr/share/plymouth/themes|
details glow solar spinner tribar
fade-in script spinfinity text
}}

デフォルトでは '''spinner''' テーマが使われます。テーマは {{ic|/etc/plymouth/plymouthd.conf}} を編集することで変更できます。例:

{{hc|/etc/plymouth/plymouthd.conf|2=
[Daemon]
Theme=spinner
ShowDelay=5
}}

{{ic|Ctrl+Alt+F2}} を押してコンソールを切り替えて、root でログインしてから以下のコマンドを実行することで一時的にテーマを確認できます:

# plymouthd
# plymouth --show-splash

プレビューを終了するには {{ic|Ctrl+Alt+F2}} をまた押してから以下のコマンドを実行してください:

# plymouth --quit

テーマを変更したら、カーネルイメージを再生成する必要があります:

# plymouth-set-default-theme -R <theme>

再起動して変更を適用してください。

==ヒントとテクニック==

====カーネルメッセージの表示====
"Home" (または "Escape") キーを押すことで起動時のカーネルメッセージの表示を切り替えることができます。

===Arch ロゴを置き換えてカスタムテーマを作る===

次のテーマは Plymouth によって提供されている Arch Linux ロゴ ({{ic|/usr/share/plymouth/arch-logo.png}}) を使用します: fade-in, script, solar, spinfinity。他のロゴを使いたい場合、テーマの {{ic|*.plymouth}} ファイルを編集してください ({{ic|*.script}} も編集する必要があることもあります)。そしてロゴを置き換えたい画像に置き換えてください。テーマを新しく作成したらパッケージを作成する必要があります。{{ic|/usr/share/plymouth}} に変更を加えてもパッケージのアップグレードで置き換わってしまう可能性があるためです。

テーマをインストール・選択したら、initrd イメージを再生成して新しいスプラッシュを使ってください。

==参照==

*[https://fedoraproject.org/wiki/Releases/FeatureBetterStartup Original Spec]
*[https://bbs.archlinux.org/viewtopic.php?id=81406 Plymouth のフォーラムスレッド]