「Arch build system」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(同期)
(同期)
(2人の利用者による、間の4版が非表示)
15行目: 15行目:
 
[[ro:ABS]]
 
[[ro:ABS]]
 
[[ru:Arch Build System]]
 
[[ru:Arch Build System]]
[[tr:Arch derleme sistemi]]
 
 
[[zh-hans:Arch Build System]]
 
[[zh-hans:Arch Build System]]
 
[[zh-hant:Arch Build System]]
 
[[zh-hant:Arch Build System]]
 
{{Related articles start}}
 
{{Related articles start}}
{{Related|ABS FAQ}}
 
 
{{Related|Arch パッケージングスタンダード}}
 
{{Related|Arch パッケージングスタンダード}}
 
{{Related|パッケージの作成}}
 
{{Related|パッケージの作成}}
33行目: 31行目:
 
この記事では Arch Build System の概要と、初心者のためのウォークスルーを提供しています。完全なリファレンスガイドではありません!ABS の簡単な手引きは、[[ABS FAQ]] を見て下さい。より詳しい情報が必要な場合は、man ページを参照してください。
 
この記事では Arch Build System の概要と、初心者のためのウォークスルーを提供しています。完全なリファレンスガイドではありません!ABS の簡単な手引きは、[[ABS FAQ]] を見て下さい。より詳しい情報が必要な場合は、man ページを参照してください。
 
{{Note|ABS の同期は日に一度行われます。そのためリポジトリで利用可能になっているものとラグが生じることがあります。}}
 
{{Note|ABS の同期は日に一度行われます。そのためリポジトリで利用可能になっているものとラグが生じることがあります。}}
  +
 
== Arch Build System について ==
 
== Arch Build System について ==
   
49行目: 48行目:
 
'ABS' という言葉は総称 (umbrella term) として使われることがあります。ABS は複数のものから構成されているからです; そのため、技術的には正確ではありませんが、'ABS' はツールキットとして以下のツールを意味します:
 
'ABS' という言葉は総称 (umbrella term) として使われることがあります。ABS は複数のものから構成されているからです; そのため、技術的には正確ではありませんが、'ABS' はツールキットとして以下のツールを意味します:
   
; SVN ツリー: ABS のディレクトリ構造; あなたの(ローカル)マシンの {{ic|/var/abs/}} 下の SVN 階層のことです。{{ic|/etc/abs.conf}} で設定したリポジトリにある全ての公式 Arch Linux ソフトウェア毎にサブディレクトリが存在します。ただしパッケージ自体は含まれていません。[https://www.archlinuxjp.org/svn/ svn] と [https://projects.archlinux.org/svntogit/packages.git/ git] リポジトリから利用可能です。
+
; SVN ツリー: ABS のディレクトリ構造; あなたの(ローカル)マシンの {{ic|/var/abs/}} 下の SVN 階層のことです。{{ic|/etc/abs.conf}} で設定したリポジトリにある全ての公式 Arch Linux ソフトウェア毎にサブディレクトリが存在します。ただしパッケージ自体は含まれていません。[https://www.archlinux.jp/svn/ svn] と [https://projects.archlinux.org/svntogit/packages.git/ git] リポジトリから利用可能です。
   
 
; [[PKGBUILD]]: ソースコードの URL とコンパイル・パッケージングの手順が入った [[Bash]] スクリプト。
 
; [[PKGBUILD]]: ソースコードの URL とコンパイル・パッケージングの手順が入った [[Bash]] スクリプト。
86行目: 85行目:
 
* パッケージがもう入手できなくなったので、ソフトウェアのソースから新しいパッケージを作成・インストールする ([[パッケージの作成]]を見て下さい)
 
* パッケージがもう入手できなくなったので、ソフトウェアのソースから新しいパッケージを作成・インストールする ([[パッケージの作成]]を見て下さい)
 
* ニーズにあわせて既存のパッケージをカスタマイズする (オプションを有効化・無効化、パッチをあてる)
 
* ニーズにあわせて既存のパッケージをカスタマイズする (オプションを有効化・無効化、パッチをあてる)
* FreeBSD 流に (à la FreeBSD)、自分で決めたコンパイルフラグを使ってシステム全体をリビルドする (例: [[pacbuilder]])
+
* FreeBSD 流に (à la FreeBSD)、自分で決めたコンパイルフラグを使ってシステム全体をリビルドする (例: [[pacbuilder]] や {{AUR|pacman-src-git}})
 
* カスタムカーネルをクリーンにビルド・インストールする ([[カーネル#コンパイル]]を見て下さい)
 
* カスタムカーネルをクリーンにビルド・インストールする ([[カーネル#コンパイル]]を見て下さい)
 
* カスタムカーネルと一緒に動作するカーネルモジュールを手に入れる
 
* カスタムカーネルと一緒に動作するカーネルモジュールを手に入れる
95行目: 94行目:
 
== ABS の使用方法 ==
 
== ABS の使用方法 ==
   
  +
ソースからパッケージをビルドするのに必要な [[PKGBUILD]] を取得する際、svntogit リポジトリのラッパーである {{pkg|asp}} パッケージを使って [[SVN]] あるいは [[Git]] で取得できます。以下では svn による方法と git による方法の両方を説明します。
=== 要件 ===
 
  +
  +
=== SVN を使って PKGBUILD ソースを取得 ===
  +
  +
==== 要件 ====
   
 
{{Pkg|subversion}} パッケージを[[インストール]]してください。
 
{{Pkg|subversion}} パッケージを[[インストール]]してください。
   
=== 非再帰的なチェックアウト ===
+
==== 非再帰的なチェックアウト ====
   
 
{{Warning|リポジトリ全体をダウンロードしないでください。SVN リポジトリの全体は巨大です。理不尽なほどのディスク容量を消費するばかりでなく、ダウンロードするのに archlinux.org サーバーに大きな負担をかけることになります。リポジトリ全体をダウンロードしてはいけません。以下で説明している方法だけにしてください。サービスに過度の負担をかける行為をした場合、あなたのアドレスがブロックされる可能性もあります。何らかのスクリプトで公の SVN を使わないようにしてください。}}
 
{{Warning|リポジトリ全体をダウンロードしないでください。SVN リポジトリの全体は巨大です。理不尽なほどのディスク容量を消費するばかりでなく、ダウンロードするのに archlinux.org サーバーに大きな負担をかけることになります。リポジトリ全体をダウンロードしてはいけません。以下で説明している方法だけにしてください。サービスに過度の負担をかける行為をした場合、あなたのアドレスがブロックされる可能性もあります。何らかのスクリプトで公の SVN を使わないようにしてください。}}
113行目: 116行目:
 
どちらの場合でも空のディレクトリが作成されますが、svn のチェックアウトとわかります。
 
どちらの場合でも空のディレクトリが作成されますが、svn のチェックアウトとわかります。
   
=== パッケージのチェックアウト ===
+
==== パッケージのチェックアウト ====
   
 
チェックアウトした svn リポジトリがあるディレクトリ (''packages'' または ''community'') で以下のコマンドを実行:
 
チェックアウトした svn リポジトリがあるディレクトリ (''packages'' または ''community'') で以下のコマンドを実行:
121行目: 124行目:
 
上記のコマンドでリクエストしたパッケージがチェックアウトされます。最上位のディレクトリで ''svn update'' を実行すると、アップデートされます。
 
上記のコマンドでリクエストしたパッケージがチェックアウトされます。最上位のディレクトリで ''svn update'' を実行すると、アップデートされます。
   
存在しないパッケージを指定しても、svn は警告を表示しません。"At revision 115847" のような出力がされるだけです。ファイルは作成されません。その場合、パッケージ名のスペルを確認したり、パッケージが別のリポジトリに移っていないか確認してください (community から main リポジトリなど)。
+
存在しないパッケージを指定しても、svn は警告を表示しません。"At revision 115847" のような出力がされるだけです。ファイルは作成されません。その場合:
  +
  +
* パッケージ名のスペルを確認してください。
  +
* パッケージが別のリポジトリに移っていないか確認してください (community から main リポジトリなど)。
  +
* https://www.archlinux.jp/packages を確認して他のベースパッケージからビルドされていないかチェックしてください (例えば {{Pkg|python-tensorflow}} は {{Pkg|tensorflow}} の PKGBUILD からビルドします)。
   
 
{{Tip|古いバージョンのパッケージをチェックアウトしたい場合、[[#旧リビジョンのパッケージをチェックアウト]]を参照してください。}}
 
{{Tip|古いバージョンのパッケージをチェックアウトしたい場合、[[#旧リビジョンのパッケージをチェックアウト]]を参照してください。}}
129行目: 136行目:
 
$ svn update
 
$ svn update
   
  +
=== Git を使って PKGBUILD ソースを取得 ===
=== makepkg の設定 ===
 
   
チェックアウトした [[PKGBUILD]] からパッケージをビルドするときに ''makepkg'' を設定する方法は [[makepkg#設定]]を見てください。
+
まず最初に {{Pkg|asp}} パッケージを[[インストール]]てください。
  +
  +
特定のパッケージの svntogit リポジトリを複製するには:
  +
$ asp checkout ''pkgname''
  +
  +
上記のコマンドで指定したパッケージの名前が付いたディレクトリに git リポジトリが複製されます。
  +
  +
複製した git リポジトリを更新するには {{ic|asp update}} を実行して git リポジトリの中で {{ic|git pull}} を行ってください。
  +
  +
また、他の git コマンドを使ってパッケージの古いバージョンをチェックアウトしたり変更を追跡することもできます。git の詳しい使い方については [[git]] のページを見てください。
  +
  +
最新の [[PKGBUILD]] のスナップショットをコピーしたいだけの場合、以下のコマンドを使ってください:
  +
$ asp export ''pkgname''
   
 
=== パッケージのビルド ===
 
=== パッケージのビルド ===
   
  +
チェックアウトした [[PKGBUILD]] からパッケージをビルドするときに ''makepkg'' を設定する方法は [[makepkg#設定]]を見てください。
[[PKGBUILD]] が含まれたディレクトリうをどこか好きなところにコピーしてください。それから必要な修正を加えてください。''makepkg'' を [[makepkg#使用方法]]に書かれているようにして使ってパッケージを作成・インストールします。
 
   
  +
[[PKGBUILD]] が含まれたディレクトリをどこか好きなところにコピーしてください。それから必要な修正を加えてください。''makepkg'' を [[makepkg#使用方法]]に書かれているようにして使ってパッケージを作成・インストールします。
==== fakeroot ====
 
基本的に、伝統的な方法と同じ手順 ({{ic|./configure, make, make install}}) を実行しますが、ソフトウェアは ''fake root'' 環境にインストールされます (''fake root'' はビルドディレクトリ内のサブディレクトリで、システムの root ディレクトリとして振る舞います。'''fakeroot''' プログラムと一緒に、makepkg は fake root ディレクトリを作成し、コンパイルしたバイナリと関連ファイルをそのディレクトリに、所有者 '''root''' としてインストールします)。そして ''fake root'' やコンパイルしたソフトウェアを含むサブディレクトリツリーは圧縮され {{ic|.pkg.tar.xz}} 拡張子の付くアーカイブ (もしくは''パッケージ'') になります。pacman はそのパッケージを展開してシステムの本当の root ディレクトリ ({{ic|/}}) にインストールします。
 
   
  +
== ヒントとテクニック ==
== Tips and tricks ==
 
   
 
=== 修正を加えたパッケージを保護する ===
 
=== 修正を加えたパッケージを保護する ===
171行目: 189行目:
 
日付を指定することもできます。指定された日付のリビジョンが存在しない場合、svn はその日付の直前のパッケージを取得します。例えば2009年3月3日からのリビジョンをチェックアウトするには:
 
日付を指定することもできます。指定された日付のリビジョンが存在しない場合、svn はその日付の直前のパッケージを取得します。例えば2009年3月3日からのリビジョンをチェックアウトするには:
   
$ svn update -r{20090303} ''package-name''
+
$ svn update -r'{20090303}' ''package-name''
   
 
他のリポジトリに移動される前のバージョンのパッケージをチェックアウトすることもできます。パッケージが移動された日付や最後のリビジョン番号をログで確認してください。
 
他のリポジトリに移動される前のバージョンのパッケージをチェックアウトすることもできます。パッケージが移動された日付や最後のリビジョン番号をログで確認してください。
177行目: 195行目:
 
== 他のツール ==
 
== 他のツール ==
   
* [http://xyne.archlinux.ca/projects/pbget/ pbget] - ウェブインターフェイスから直接パッケージの PKGBUILD を取得します。AUR にも対応。
+
* [https://xyne.archlinux.ca/projects/pbget/ pbget] - ウェブインターフェイスから直接パッケージの PKGBUILD を取得します。AUR にも対応。
 
* [https://github.com/falconindy/asp asp] - Arch Linux パッケージを作成するのに使われるビルドソースファイルを管理するツール。git インターフェイスを使用することで最新のソースを提供します。
 
* [https://github.com/falconindy/asp asp] - Arch Linux パッケージを作成するのに使われるビルドソースファイルを管理するツール。git インターフェイスを使用することで最新のソースを提供します。

2018年7月15日 (日) 19:14時点における版

関連記事

この記事では Arch Build System の概要と、初心者のためのウォークスルーを提供しています。完全なリファレンスガイドではありません!ABS の簡単な手引きは、ABS FAQ を見て下さい。より詳しい情報が必要な場合は、man ページを参照してください。

ノート: ABS の同期は日に一度行われます。そのためリポジトリで利用可能になっているものとラグが生じることがあります。

Arch Build System について

ABS とは Arch Build System の略で、FreeBSD などで採用されている ports に似ています。ABS はソースコードから .pkg.tar.xz 形式のバイナリパッケージを作成することができます。作られたパッケージは pacman によって、通常の(配布されている)バイナリパッケージと同様に管理することができます。

ports システムとは

'Ports' は BSD 系 UNIX によって採用されている、ソースコードからのソフトウェアのビルドを自動化するシステムです。port を使ってソフトウェアのソースコードのダウンロード・展開、パッチの適用、コンパイル、インストールを行います。'port' はただの小さなディレクトリで、それぞれの 'port' に対応する個々のソフト名が付けられており、中にはソフトウェアのビルド・インストールのための情報が書かれたファイルが入っています。ソフトウェアをインストールしたい時は、port のフォルダまで移動し make もしくは make install clean と入力するだけでパッケージのダウンロードからコンパイル、インストールまでを自動的に行います。

ABS の特徴

ABS はディレクトリツリーで構成されており SVN を使ってチェックアウトできます。ツリーは全ての公式 Arch ソフトウェアを表します (ソフトウェア自体が含まれているわけではありません)。サブディレクトリにはソフトウェアパッケージやソースコードのかわりに PKGBUILD ファイルとその他ファイルが含まれています。PKGBUILD が含まれているディレクトリで makepkg を実行することで、ソフトウェアはビルドディレクトリ内でコンパイルされパッケージになります。パッケージは pacman を使ってインストール・アップグレードできます。

ABS の概要

'ABS' という言葉は総称 (umbrella term) として使われることがあります。ABS は複数のものから構成されているからです; そのため、技術的には正確ではありませんが、'ABS' はツールキットとして以下のツールを意味します:

SVN ツリー
ABS のディレクトリ構造; あなたの(ローカル)マシンの /var/abs/ 下の SVN 階層のことです。/etc/abs.conf で設定したリポジトリにある全ての公式 Arch Linux ソフトウェア毎にサブディレクトリが存在します。ただしパッケージ自体は含まれていません。svngit リポジトリから利用可能です。
PKGBUILD
ソースコードの URL とコンパイル・パッケージングの手順が入った Bash スクリプト。
makepkg
PKGBUILD を読み込む ABS のシェルコマンドツール。自動的にソースをダウンロード・コンパイルし .pkg.tar* (形式は makepkg.confPKGEXT で設定) を作成します。makepkg を使って AUR やサードパーティのソースからカスタムパッケージを作成することも可能です (パッケージの作成を見て下さい)。
pacman
pacman は abs とは完全に切り離されています。ただし、ビルドしたパッケージをインストール・削除したり依存関係を解決するのには pacman が必要になります。pacman は makepkg によって実行されることもあります。
AUR
Arch User Repository は勿論 ABS とは別物ですが、AUR の(サポートがない) PKGBUILD をビルドするときには makepkg を使ってパッケージをコンパイル・作成します。ローカルマシン上の ABS ツリーと対照的に、AUR にはウェブインターフェースがあります。AUR にはユーザーによって投稿された沢山の PKGBUILD が含まれており、その PKGBUILD を使うことで公式の Arch リポジトリにないソフトウェアをインストールできます。公式の Arch ツリーにないパッケージをビルドする必要がある場合は、AUR を使うことになります。
警告: 公式の PKGBUILD ではパッケージはクリーンな chroot でビルドされることを前提としています。汚いビルド環境でソフトウェアをビルドしても上手くいかなかったり、動作時に予期せぬ挙動が起こったりすることがあります。ビルドシステムは依存関係を動的に検出して、ビルド環境に存在するパッケージによって結果が変わるためです。

SVN ツリー

core, extra, testing リポジトリpackages SVN リポジトリからチェックアウトできます。communitymultilib リポジトリは community SVN リポジトリに含まれています。

各パッケージにはサブディレクトリが存在します。サブディレクトリの中には repostrunk ディレクトリがあります。repos はリポジトリ名 (例: core) とアーキテクチャで分かれています。公式ビルドでは repos に入っている PKGBUILD とその他ビルドファイルが使われます。trunk のファイルは開発者によって使われ、その後 repos にコピーされます。

例えば、acl のツリーは以下のようになります:

acl
acl/repos
acl/repos/core-i686
acl/repos/core-i686/PKGBUILD
acl/repos/core-x86_64
acl/repos/core-x86_64/PKGBUILD
acl/trunk
acl/trunk/PKGBUILD

パッケージのソースコードは ABS ディレクトリに入っていません。かわりに PKGBUILD にはパッケージをビルドするときにソースコードの取得先となる URL が記述されています。

ABS を使う理由

Arch Build System の用途は以下の通りです:

  • 何らかの理由で、パッケージをコンパイル・リコンパイルする
  • パッケージがもう入手できなくなったので、ソフトウェアのソースから新しいパッケージを作成・インストールする (パッケージの作成を見て下さい)
  • ニーズにあわせて既存のパッケージをカスタマイズする (オプションを有効化・無効化、パッチをあてる)
  • FreeBSD 流に (à la FreeBSD)、自分で決めたコンパイルフラグを使ってシステム全体をリビルドする (例: pacbuilderpacman-src-gitAUR)
  • カスタムカーネルをクリーンにビルド・インストールする (カーネル#コンパイルを見て下さい)
  • カスタムカーネルと一緒に動作するカーネルモジュールを手に入れる
  • PKGBUILD 内のバージョン番号を変えることで Arch パッケージの新しい・古い・ベータ版の・開発版のバージョンを簡単にコンパイル・インストールする

ABS は Arch Linux を使うにあたって必須のものではありませんが、ソースコンパイルなどの作業の自動化に役立ちます。

ABS の使用方法

ソースからパッケージをビルドするのに必要な PKGBUILD を取得する際、svntogit リポジトリのラッパーである asp パッケージを使って SVN あるいは Git で取得できます。以下では svn による方法と git による方法の両方を説明します。

SVN を使って PKGBUILD ソースを取得

要件

subversion パッケージをインストールしてください。

非再帰的なチェックアウト

警告: リポジトリ全体をダウンロードしないでください。SVN リポジトリの全体は巨大です。理不尽なほどのディスク容量を消費するばかりでなく、ダウンロードするのに archlinux.org サーバーに大きな負担をかけることになります。リポジトリ全体をダウンロードしてはいけません。以下で説明している方法だけにしてください。サービスに過度の負担をかける行為をした場合、あなたのアドレスがブロックされる可能性もあります。何らかのスクリプトで公の SVN を使わないようにしてください。

core, extra, testing リポジトリをチェックアウト:

$ svn checkout --depth=empty svn://svn.archlinux.org/packages

communitymultilib リポジトリをチェックアウト:

$ svn checkout --depth=empty svn://svn.archlinux.org/community

どちらの場合でも空のディレクトリが作成されますが、svn のチェックアウトとわかります。

パッケージのチェックアウト

チェックアウトした svn リポジトリがあるディレクトリ (packages または community) で以下のコマンドを実行:

$ svn update package-name

上記のコマンドでリクエストしたパッケージがチェックアウトされます。最上位のディレクトリで svn update を実行すると、アップデートされます。

存在しないパッケージを指定しても、svn は警告を表示しません。"At revision 115847" のような出力がされるだけです。ファイルは作成されません。その場合:

  • パッケージ名のスペルを確認してください。
  • パッケージが別のリポジトリに移っていないか確認してください (community から main リポジトリなど)。
  • https://www.archlinux.jp/packages を確認して他のベースパッケージからビルドされていないかチェックしてください (例えば python-tensorflowtensorflow の PKGBUILD からビルドします)。
ヒント: 古いバージョンのパッケージをチェックアウトしたい場合、#旧リビジョンのパッケージをチェックアウトを参照してください。

リポジトリの最新のリビジョンをリビルドしたい場合、チェックアウトしたパッケージを定期的に更新してください。以下のコマンドで更新できます:

$ svn update

Git を使って PKGBUILD ソースを取得

まず最初に asp パッケージをインストールしてください。

特定のパッケージの svntogit リポジトリを複製するには:

$ asp checkout pkgname

上記のコマンドで指定したパッケージの名前が付いたディレクトリに git リポジトリが複製されます。

複製した git リポジトリを更新するには asp update を実行して git リポジトリの中で git pull を行ってください。

また、他の git コマンドを使ってパッケージの古いバージョンをチェックアウトしたり変更を追跡することもできます。git の詳しい使い方については git のページを見てください。

最新の PKGBUILD のスナップショットをコピーしたいだけの場合、以下のコマンドを使ってください:

$ asp export pkgname

パッケージのビルド

チェックアウトした PKGBUILD からパッケージをビルドするときに makepkg を設定する方法は makepkg#設定を見てください。

PKGBUILD が含まれたディレクトリをどこか好きなところにコピーしてください。それから必要な修正を加えてください。makepkgmakepkg#使用方法に書かれているようにして使ってパッケージを作成・インストールします。

ヒントとテクニック

修正を加えたパッケージを保護する

pacman でシステムを更新すると、公式リポジトリの同じ名前のパッケージで ABS で作ったパッケージが置き換えられてしまいます。これを回避するには以下の方法を見て下さい。

group 行を PKGBUILD に挿入して、パッケージを modified という名前のグループに追加してください。

PKGBUILD
groups=('modified') 

そしてこのグループを /etc/pacman.confIgnoreGroup セクションに追加してください。

/etc/pacman.conf
IgnoreGroup = modified

システムアップデートで公式リポジトリにパッケージの新しいバージョンがあっても、pacman は IgnoreGroup セクションにパッケージがあるため更新をスキップすると表示します。部分的なアップグレードにならないようにここでパッケージを ABS からビルドしなおす必要があります。

旧リビジョンのパッケージをチェックアウト

#非再帰的なチェックアウトで説明したチェックアウト済みの svn リポジトリ ("packages" または "community") で、ログを確認:

$ svn log package-name

履歴を確認して適切なリビジョンを見つけたら、チェックアウトするリビジョンを指定してください。例えば r1729 をチェックアウトするには:

$ svn update -r1729 package-name

既存の package-name の作業コピーが選択したリビジョンに更新されます。

日付を指定することもできます。指定された日付のリビジョンが存在しない場合、svn はその日付の直前のパッケージを取得します。例えば2009年3月3日からのリビジョンをチェックアウトするには:

$ svn update -r'{20090303}' package-name

他のリポジトリに移動される前のバージョンのパッケージをチェックアウトすることもできます。パッケージが移動された日付や最後のリビジョン番号をログで確認してください。

他のツール

  • pbget - ウェブインターフェイスから直接パッケージの PKGBUILD を取得します。AUR にも対応。
  • asp - Arch Linux パッケージを作成するのに使われるビルドソースファイルを管理するツール。git インターフェイスを使用することで最新のソースを提供します。