「Arch build system」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(文字列「[[zh-TW:」を「[[zh-hant:」に置換)
(→‎ABS の使用方法: absの取得方法はsubversionに変更になったので、とりあえず原文を転記。)
77行目: 77行目:
 
== ABS の使用方法 ==
 
== ABS の使用方法 ==
   
  +
=== Prerequisites ===
abs を使ってパッケージをビルドするには以下の手順を踏みます:
 
#[[pacman]] で {{Pkg|abs}} パッケージをインストール。
 
#root で {{ic|abs}} を実行。Arch Linux サーバーと同期して ABS ツリーを作成します。
 
#ビルドファイル (通常 {{ic|/var/abs/<repo>/<pkgname>}} 下にあります) をビルドディレクトリにコピー。
 
#ビルドディレクトリまで移動して、PKGBUILD を (好みに・必要なら) 編集し、'''makepkg''' を実行。
 
#PKGBUILD の指示に従って、makepkg は適切なソース tarball をダウンロードし、それを解凍して、必要ならパッチを適用し、{{ic|makepkg.conf}} で指定された {{ic|CFLAGS}} を使ってコンパイル、そして最後にビルドファイルを圧縮して {{ic|.pkg.tar.gz}} か {{ic|.pkg.tar.xz}} の拡張子が付いたパッケージを作ります。
 
#インストールは {{ic|pacman -U <.pkg.tar.xz file>}} をするだけです。パッケージの削除も pacman で行います。
 
   
  +
[[Install]] the {{Pkg|subversion}} package.
=== ツールのインストール ===
 
   
  +
=== Non-recursive checkout ===
ABS を使うには、まず[[公式リポジトリ]]から {{Pkg|abs}} を[[pacman|インストール]]する必要があります。
 
   
  +
{{Warning|Do not download the whole repo; only follow the instructions below. The entire SVN repo is huge. Not only will it take an obscene amount of disk space, but it will also tax the archlinux.org server for you to download it. If you abuse this service, your address may be blocked. Never use the public SVN for any sort of scripting.}}
abs をインストールするだけで (その依存として) abs-sync スクリプトや様々なビルドスクリプト、そして [[rsync]] が入ります。
 
   
  +
To checkout the ''core'', ''extra'', and ''testing'' [[repositories]]:
ただし、実際に何かをビルドする前に、基本的なコンパイルツールも必要になります。これらは[[Pacman#パッケージグループのインストール|パッケージグループ]]として {{grp|base-devel}} にまとめられています。このグループは pacman でインストール可能です。
 
   
  +
$ svn checkout --depth=empty <nowiki>svn://svn.archlinux.org/packages</nowiki>
=== /etc/abs.conf ===
 
   
  +
To checkout the ''community'' and ''multilib'' repositories:
root で {{ic|/etc/abs.conf}} を編集して利用するリポジトリを指定してください。
 
   
  +
$ svn checkout --depth=empty <nowiki>svn://svn.archlinux.org/community</nowiki>
利用するリポジトリの前の {{ic|!}} を削除することでそのリポジトリを有効にします。例:
 
REPOS=(core extra community !testing)
 
   
  +
In both cases, it simply creates an empty directory, but it does know that it is an svn checkout.
=== ABS ツリー ===
 
   
  +
=== Checkout a package ===
ABS ツリーは {{ic|/var/abs}} 下に SVN のディレクトリ階層として以下のように存在しています:
 
   
  +
In the directory containing the svn repository you checked out (i.e., ''packages'' or ''community''), do:
{{bc|<nowiki>
 
| -- core/
 
| || -- acl/
 
| || || -- PKGBUILD
 
| || -- attr/
 
| || || -- PKGBUILD
 
| || -- abs/
 
| || || -- PKGBUILD
 
| || -- autoconf/
 
| || || -- PKGBUILD
 
| || -- ...
 
| -- extra/
 
| || -- acpid/
 
| || || -- PKGBUILD
 
| || -- apache/
 
| || || -- PKGBUILD
 
| || -- ...
 
| -- community/
 
| || -- ...
 
</nowiki>}}
 
   
  +
$ svn update ''package-name''
ABS ツリーはパッケージデータベースと全く同じ構造を持っています:
 
   
  +
This will pull the package you requested into your checkout. From now on, any time you ''svn update'' at the top level, this will be updated as well.
* 第一階層: リポジトリの名前
 
* 第二階層: パッケージ名のディレクトリ
 
* 第三階層: PKGBUILD (パッケージのビルドに必要な情報が含まれています) とその他関連ファイル (パッチなど、パッケージのビルドに必要なファイル)
 
   
  +
If you specify a package that does not exist, svn will not warn you. It will just print something like "At revision 115847", without creating any files. If that happens, check your spelling of the package name and that the package has not been moved to another repository (i.e. from community to the main repository).
パッケージのソースコードは ABS ディレクトリには存在しません。その代わり、'''PKGBUILD''' ファイルには、パッケージをビルドする時にどこの URL からソースコードをダウンロードすればいいか書かれています。そのため、abs ツリー自体のサイズはとても小さくなっています。
 
   
  +
{{Tip|To checkout an older version of a package, see [[#Checkout an older version of a package]].}}
==== ABS ツリーのダウンロード ====
 
root で次を実行してください:
 
# abs
 
   
  +
You should periodically update all of your checked out packages if you wish to perform rebuilds on more recent revisions of the repositories. To do so, do:
今、あなたの ABS ツリーは {{ic|/var/abs}} 下に作成されました。ABS ツリーの適切なブランチが作られ {{ic|/etc/abs.conf}} で指定されたものと対応していることに注意してください。
 
   
  +
$ svn update
公式リポジトリと同期し続けるために abs コマンドは定期的に実行するのがベターです。また、個々の ABS パッケージファイルをダウンロードすることもできます:
 
   
  +
=== Configure makepkg ===
# abs <repository>/<package>
 
こうすれば一つのパッケージをビルドするのに abs ツリー全体をチェックする必要がなくなります。
 
   
  +
See [[makepkg#Configuration]] on how to configure ''makepkg'' for building packages from the [[PKGBUILD]]'s you have checked out.
=== /etc/makepkg.conf ===
 
   
  +
=== Build package ===
{{ic|/etc/makepkg.conf}} ではグローバルの環境変数やコンパイルフラグを指定します。SMP なシステムを使っている等、最適化を指定したいと思った場合このファイルを編集してください。デフォルト設定は i686 と x86_64 に最適化が指定されていて、それぞれのアーキテクチャを使ったシングル CPU のシステムで問題なく動くようになっています (このデフォルト設定でも SMP マシンで動作はしますが、コンパイル時には一つのコア/CPU しか使われません -- [[makepkg|makepkg.conf]] を見て下さい)。
 
   
  +
Copy the directory containing the [[PKGBUILD]] you wish to modify to a new location. Then make the desired modifications. From there, use ''makepkg'' as described in [[makepkg#Usage]] to create and install the new package.
==== /etc/makepkg.conf で PACKAGER 変数を設定する ====
 
 
{{ic|/etc/makepkg.conf}} に PACKAGER 変数を設定することは任意ですが''強く推奨されています''。設定することでどのパッケージがあなたによってビルド・インストールされたかすぐわかるようにすることができるからです。community リポジトリの {{Pkg|expac}} を使うことで簡単にパッケージの見分けがつきます:
 
 
===== 全てのパッケージの表示 (AUR のパッケージを含む) =====
 
{{hc|$ grep myname /etc/makepkg.conf|2=PACKAGER="myname <myemail@myserver.com>"}}
 
 
{{hc|<nowiki>$ expac "%n %p" | grep "myname" | column -t</nowiki>|
 
archey3 myname
 
binutils myname
 
gcc myname
 
gcc-libs myname
 
glibc myname
 
tar myname
 
}}
 
 
===== リポジトリに含まれているパッケージのみを表示 =====
 
 
この例では {{ic|/etc/pacman.conf}} に定義されているリポジトリに含まれているパッケージだけを表示します:
 
 
{{hc|<nowiki>$ . /etc/makepkg.conf; grep -xvFf <(pacman -Qqm) <(expac "%n\t%p" | grep "$PACKAGER$" | cut -f1)</nowiki>|
 
binutils
 
gcc
 
gcc-libs
 
glibc
 
tar
 
}}
 
 
=== ビルドディレクトリの作成 ===
 
 
実際のコンパイルをするためのビルドディレクトリを作成することを推奨します。ABS ツリーに変更を加えても、ABS のアップデートによってデータは (上書きされて) ロストしてしまうからです。あなたの home ディレクトリを使うのがグッドプラクティスです。ただし Arch ユーザーには {{ic|/var/abs/}} の下に通常ユーザーで所有された 'local' ディレクトリを作成するのを好む人もいます。
 
 
あなたのビルドディレクトリの作成。例:
 
 
$ mkdir -p $HOME/abs
 
 
ツリー ({{ic|/var/abs/<repository>/<pkgname>}}) から ABS をビルドディレクトリにコピーしてください。
 
 
=== パッケージのビルド ===
 
 
ここでは、例として ''slim'' ディスプレイマネージャのパッケージをビルドすることにします。
 
 
slim ABS を ABS ツリーからビルドディレクトリにコピー:
 
$ cp -r /var/abs/extra/slim/ ~/abs
 
 
ビルドディレクトリに移動:
 
$ cd ~/abs/slim
 
 
PKGBUILD を修正。コンポーネントのサポートを追加・削除したり、パッチをあてたり、パッケージバージョンの変更などをする。(任意):
 
$ nano PKGBUILD
 
 
通常ユーザーで makepkg を実行 ({{ic|-s}} スイッチをつけると自動的に依存関係を解決します):
 
$ makepkg -s
 
 
{{Note|依存関係が欠けていることに文句を言う前に、全ての Arch Linux システムで {{Grp|base}} グループがインストールされていることを思い出してください。'''makepkg''' でビルドするときは "base-devel" グループがインストールされているのが前提となっています。[[#ツールのインストール]]を見てください。}}
 
 
root でインストール:
 
# pacman -U slim-1.3.0-2-i686.pkg.tar.xz
 
 
これで完了です。ソースから slim をビルドして pacman でインストールする手順はこの通りです。パッケージの削除も pacman によって行います ({{ic|pacman -R slim}})。
 
 
ABS を使うことで利便性の向上と自動化を達成しながら、ビルドとインストールの関数を PKGBUILD に含めることでコントロールを失うことなく完全な透明性を維持することができます。
 
   
 
==== fakeroot ====
 
==== 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|/}}) にインストールします。
 
 
=== 修正を加えたパッケージを保護する ===
 
pacman でシステムを更新すると、公式リポジトリの同じ名前のパッケージで ABS で作ったパッケージが置き換えられてしまいます。これを回避するには以下の方法を見て下さい。
 
 
group 行を PKGBUILD に挿入して、パッケージを {{ic|modified}} という名前のグループに追加してください。
 
 
{{hc|PKGBUILD|
 
<nowiki>groups=('modified')</nowiki> }}
 
 
そしてこのグループを {{ic|/etc/pacman.conf}} の {{ic|IgnoreGroup}} セクションに追加してください。
 
   
  +
{{Deletion|I'm not sure the point of this section}}
{{hc|/etc/pacman.conf|
 
<nowiki>IgnoreGroup = modified</nowiki>}}
 
   
  +
Essentially, the same steps are being executed in the traditional method (generally including the {{ic|./configure, make, make install}} steps) but the software is installed into a ''fake root'' environment. (A ''fake root'' is simply a subdirectory within the build directory that functions and behaves as the system's root directory. In conjunction with the '''fakeroot''' program, ''makepkg'' creates a fake root directory, and installs the compiled binaries and associated files into it, with '''root''' as owner.) The ''fake root'', or subdirectory tree containing the compiled software, is then compressed into an archive with the extension {{ic|.pkg.tar.xz}}, or a ''package''. When invoked, pacman then extracts the package (installs it) into the system's real root directory ({{ic|/}}).
システムアップデートで公式リポジトリにパッケージの新しいバージョンがあっても、pacman は IgnoreGroup セクションにパッケージがあるため更新をスキップすると表示します。部分的なアップグレードにならないようにここでパッケージを ABS からビルドしなおす必要があります。
 
   
 
== 他のツール ==
 
== 他のツール ==

2017年5月31日 (水) 13:25時点における版

関連記事

この記事では 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 も Ports に似たシステムで、/var/abs ディレクトリ下に、カテゴリ - パッケージ名の順番で、ツリー状のフォルダ群 (ABS ツリー) を保存しています。これには Arch Linux の公式ソフト すべてのパッケージが含まれます (Ports と同様に、ソースコードやバイナリパッケージを含んでいないのでサイズはそんなに大きくありません)。パッケージ名 (例えば、'ABS') のフォルダを開いたとします。すると、中にはソフトウェアパッケージやソースはなく、代わりに PKGBUILD というファイルが含まれています。PKGBUILD は簡潔な Bash スクリプトで、ソースコードのダウンロード元や、コンパイル、パッケージ作成に必要なコマンドが記述してあります。ABS の makepkg を実行することで、ソフトウェアはコンパイル・パッケージングされビルド用ディレクトリにパッケージが作成されます。後は pacman を使って、ソフトウェアを簡単に管理することが可能です。

ABS の概要

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

ABS ツリー
ABS のディレクトリ構造; あなたの(ローカル)マシンの /var/abs/ 下の SVN 階層のことです。/etc/abs.conf で設定したリポジトリにある全ての公式 Arch Linux ソフトウェア毎にサブディレクトリが存在します。ただしパッケージ自体は含まれていません。このツリーは pacmanabs パッケージをインストールして abs スクリプトを実行した後に作られます。
ノート: 実際のパッケージは svngit リポジトリにあり、abs スクリプトは rsync を使ってダウンロードしています。
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 でビルドされることを前提としています。汚いビルド環境でソフトウェアをビルドしても上手くいかなかったり、動作時に予期せぬ挙動が起こったりすることがあります。ビルドシステムは依存関係を動的に検出して、ビルド環境に存在するパッケージによって結果が変わるためです。

ABS を使う理由

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

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

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

ABS の使用方法

Prerequisites

Install the subversion package.

Non-recursive checkout

警告: Do not download the whole repo; only follow the instructions below. The entire SVN repo is huge. Not only will it take an obscene amount of disk space, but it will also tax the archlinux.org server for you to download it. If you abuse this service, your address may be blocked. Never use the public SVN for any sort of scripting.

To checkout the core, extra, and testing repositories:

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

To checkout the community and multilib repositories:

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

In both cases, it simply creates an empty directory, but it does know that it is an svn checkout.

Checkout a package

In the directory containing the svn repository you checked out (i.e., packages or community), do:

$ svn update package-name

This will pull the package you requested into your checkout. From now on, any time you svn update at the top level, this will be updated as well.

If you specify a package that does not exist, svn will not warn you. It will just print something like "At revision 115847", without creating any files. If that happens, check your spelling of the package name and that the package has not been moved to another repository (i.e. from community to the main repository).

ヒント: To checkout an older version of a package, see #Checkout an older version of a package.

You should periodically update all of your checked out packages if you wish to perform rebuilds on more recent revisions of the repositories. To do so, do:

$ svn update

Configure makepkg

See makepkg#Configuration on how to configure makepkg for building packages from the PKGBUILD's you have checked out.

Build package

Copy the directory containing the PKGBUILD you wish to modify to a new location. Then make the desired modifications. From there, use makepkg as described in makepkg#Usage to create and install the new package.

fakeroot

This article or section is being considered for deletion.
Reason: I'm not sure the point of this section (Discuss)

Essentially, the same steps are being executed in the traditional method (generally including the ./configure, make, make install steps) but the software is installed into a fake root environment. (A fake root is simply a subdirectory within the build directory that functions and behaves as the system's root directory. In conjunction with the fakeroot program, makepkg creates a fake root directory, and installs the compiled binaries and associated files into it, with root as owner.) The fake root, or subdirectory tree containing the compiled software, is then compressed into an archive with the extension .pkg.tar.xz, or a package. When invoked, pacman then extracts the package (installs it) into the system's real root directory (/).

他のツール

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