「Arch User Repository」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(Kusakata がページ「Arch User Repository (日本語)」を「Arch User Repository」に移動しました)
(校正(でき・出来))
 
(8人の利用者による、間の57版が非表示)
1行目: 1行目:
[[Category:Arch User Repository (日本語)]]
+
[[Category:Arch について]]
[[Category:Package development (日本語)]]
+
[[Category:パッケージ開発]]
[[Category:Package management (日本語)]]
+
[[Category:パッケージ管理]]
[[ar:Arch User Repository]]
 
[[cs:Arch User Repository]]
 
[[da:Arch User Repository]]
 
 
[[de:Arch User Repository]]
 
[[de:Arch User Repository]]
[[el:Arch User Repository]]
 
 
[[en:Arch User Repository]]
 
[[en:Arch User Repository]]
 
[[es:Arch User Repository]]
 
[[es:Arch User Repository]]
  +
[[fr:Arch User Repository]]
[[fi:AUR]]
 
[[fr:AUR]]
 
[[it:Arch User Repository]]
 
[[nl:Arch User Repository]]
 
[[pl:Arch User Repository]]
 
 
[[pt:Arch User Repository]]
 
[[pt:Arch User Repository]]
[[ro:AUR]]
 
 
[[ru:Arch User Repository]]
 
[[ru:Arch User Repository]]
[[sr:Arch User Repository]]
 
[[tr:Arch_Kullanıcı_Deposu]]
 
 
[[uk:Arch User Repository]]
 
[[uk:Arch User Repository]]
[[zh-CN:Arch User Repository]]
+
[[zh-hans:Arch User Repository]]
{{Related articles start (日本語)}}
+
{{Related articles start}}
  +
{{Related|makepkg}}
{{Related2|AUR Helpers (日本語)|AUR ヘルパー}}
 
{{Related|AurJson}}
+
{{Related|pacman}}
  +
{{Related|PKGBUILD}}
{{Related2|AUR Trusted User Guidelines (日本語)|AUR Trusted User ガイドライン}}
 
  +
{{Related|.SRCINFO}}
{{Related2|PKGBUILD (日本語)|PKGBUILD}}
 
  +
{{Related|Aurweb RPC インターフェース}}
{{Related2|makepkg (日本語)|makepkg}}
 
  +
{{Related|AUR 投稿ガイドライン}}
{{Related2|pacman (日本語)|pacman}}
 
  +
{{Related|AUR Trusted User ガイドライン}}
{{Related2|AUR Metadata (日本語)|AUR Metadata}}
 
{{Related2|Official Repositories (日本語)|公式リポジトリ}}
+
{{Related|公式リポジトリ}}
{{Related2|Arch Build System (日本語)|Arch Build System}}
+
{{Related|Arch Build System}}
  +
{{Related|パッケージの作成}}
  +
{{Related|AUR ヘルパー}}
  +
{{Related|AUR クリーンアップデー}}
 
{{Related articles end}}
 
{{Related articles end}}
   
Arch User Repository (AUR) はコミュニティによって運営されている Arch ユーザーのためのリポジトリです。パッケージの詳細について書かれたファイル ([[PKGBUILD (日本語)|PKGBUILD]]) がれており、[[makepkg (日本語)|makepkg]] を使ってソースからパッケージを作り、それを [[pacman (日本語)|pacman]] でインストールすることができます。コミュニティ手で新しいパッケージを共有することで、[[#.5Bcommunity.5D|[community]]] リポジトリ人気のあるパッケージの取り込み促進することを目的にAUR は作られました。このページでは AUR のアクセス・使用方法を説明します。
+
Arch User Repository (AUR) はコミュニティによって運営されているArch ユーザーのためのリポジトリです。パッケージのビルド方法が書かれたファイル ([[PKGBUILD]]) がまとて置かれており、[[makepkg]] を使ってソースからパッケージを作り、生成したパッケージを [[pacman#その他のコマンド|pacman]] でインストールすることができます。人気あるパッケージ[[extra|extra リポジトリ]]に取り込まれるように、コミュニティ手で新しいパッケージを共有することを目的に AUR は作られました。このページでは AUR の使用方法を説明します。
   
AUR から始まっ多くの新しいパッケージ公式リポジトリに取り込まれています。AUR では、ユーザーはパッケージビルド (PKGBUILD と関連ファイル) を投稿することができます。AUR コミュニティ には AUR に存在するパッケージに対して投票する機能があります。投票が十分に集まると — ライセンスに問題がなくきちんとパッケージ化されているならば — [community] リポジトリに取り込まれます ([[pacman (日本語)|pacman]] や [[Arch Build System (日本語)|abs]] で直接獲得できるようになります)。
+
AUR に投稿された新しいパッケージの一部は公式リポジトリに取り込まれています。AUR では、ユーザーはパッケージビルド (PKGBUILD と関連ファイル) を投稿することができます。AUR コミュニティには AUR に存在するパッケージに対して投票する機能があります。投票が十分に集まると (ライセンスに問題がなくきちんとパッケージ化されているならば) ''extra'' リポジトリに取り込まれます ([[pacman]] や [[Arch Build System|abs]] で直接入手できるようになります)。
  +
  +
{{Warning|AUR のパッケージはユーザによって提供されているものです。それらの {{ic|PKGBUILD}} は完全に非公式であり、綿密に検査されていません。AUR から提供されているファイルの使用は自己責任となります。}}
   
 
== はじめに ==
 
== はじめに ==
   
[https://aur.archlinux.org AUR Web Interface] で PKGBUILD を検索し、ダウンロードすることができます。PKGBUILD は [[makepkg (日本語)|makepkg]] を使ってパッケージすることができ、pacman でインストールできます。
+
[https://aur.archlinux.org AUR ウェブインターフェイス] で [[PKGBUILD]] を検索したり、ダウンロードしたりすることができます。''makepkg'' を使って {{ic|PKGBUILD}} からパッケージを生成することができ、''pacman'' でインストールできます。
   
* {{Grp|base-devel}} グループパッケージがインストールされている必要があります ({{ic|pacman -S --needed base-devel}})
+
* {{Pkg|base-devel}} が[[インストール]]されていることを確認してください
  +
* 一般的な質問に対する答えはほとんど [[#FAQ]] に載っています。
* この記事の下に、AUR パッケージをインストールする簡単なチュートリアルがあります。
 
  +
* {{ic|/etc/makepkg.conf}} を調整することで、AUR からパッケージをビルドするときに、あなたの使用しているプロセッサに最適化することができます。マルチコアプロセッサを搭載しているシステム上では、{{ic|MAKEFLAGS}} 変数を調整したり、圧縮に複数のコアを使ったり、別の圧縮アルゴリズムを使ったりすることで、パッケージのビルドタイムを劇的に短縮できる可能性があります。また、{{ic|CFLAGS}} 変数を使うことでハードウェア固有のコンパイラ最適化を有効化することもできます。詳しくは [[makepkg#ヒントとテクニック]] を見てください。
* アップデート情報や問題を知るために [https://aur.archlinux.org AUR Web Interface] を訪れましょう。AUR で利用可能なパッケージの最新リストを見ることができます。
 
* よくある質問の答えはほとんど [[#FAQ]] に載っています。
 
* {{ic|/etc/makepkg.conf}} を修正することで、あなたのプロセッサに最適化して AUR からパッケージをビルドすることができます。特にマルチコア・プロセッサを使っている場合、MAKEFLAGS を調整することでコンパイル時間を大きく短縮することができるかもしれません。また、CFLAGS の設定で GCC に対してハードウェア個別の最適化を設定できます。詳しくは [[makepkg (日本語)|makepkg.conf]] を見て下さい。
 
   
  +
また、SSH から AUR にアクセスすることもできます: 利用可能なコマンドをリストアップするには {{ic|ssh aur@aur.archlinux.org help}} を入力してください。
== 歴史 ==
 
   
  +
== パッケージをインストール・アップグレードする ==
以下の情報は歴史を語るためだけに存在しています。incoming と TUR は AUR により一新されて、すでに使われていません。
 
   
  +
AUR からパッケージをインストールする手順は比較的単純です。基本的には:
当初、{{ic|<nowiki>ftp://ftp.archlinux.org/incoming</nowiki>}} というサーバーがあり、人々は PKGBUILD やビルドに必要なファイル、ビルド済みのパッケージをアップロードしていました。[[Arch Terminology (日本語)#パッケージメンテナ|パッケージメンテナ]]が採用するまでプログラムはここに置かれたままでした。
 
   
  +
# ビルドファイルを取得する。[[PKGBUILD]] や、[[systemd]] ユニットやパッチなどの (しばしば、実際のコードではない) 他の必要なファイルを含みます。
その後、Trusted User リポジトリが誕生しました。コミュニティから許可された人のリポジトリを、誰でも使えるようにするためのリポジトリです。これを基礎として、より柔軟に使いやすくするために拡張されたものが AUR です。今でも、AUR のメンテナは TU (Trusted User) と呼ばれます。
 
  +
# {{ic|PKGBUILD}} とそれに付属しているファイルが、悪意のある、または信頼できないものでないことを検証する。
  +
# それらのファイルが保存されているディレクトリ内で {{ic|makepkg}} を実行する。これは、コードをダウンロードし、コンパイルし、パッケージングします。
  +
# {{ic|pacman -U ''package_file''}} を実行し、パッケージをシステムにインストールする。
   
== 検索 ==
+
=== 要件 ===
   
  +
まず、{{Pkg|base-devel}} をインストールして、必須のツールをインストールしましょう。この[[メタパッケージ]]には、ソースからコンパイルするために必要な {{pkg|make}} などのツールが依存パッケージとして含まれています。
AUR のウェブインタフェースは[https://aur.archlinux.org/ こちら]です。スクリプト(など)によってアクセスするのに適しているインターフェースは[https://aur.archlinux.org/rpc.php こちら]になります。
 
   
  +
{{Note|AUR のパッケージは、{{Pkg|base-devel}} がビルド環境にインストールされていることを想定しています。}}
MySQL に似た構文をつかってパッケージの名前と説明を検索します。これによって柔軟に検索条件を指定することが可能になります(例えば {{ic|tool like grep}} の代わりに {{ic|tool%like%grep}} と検索してみてください)。{{ic|%}} を含む文字列を検索するときは、{{ic|/%}} とエスケープしてください。
 
   
  +
次に、適切なビルドディレクトリを選択してください。ビルドディレクトリは、パッケージがソースから作成/ビルドされるディレクトリであり、任意のディレクトリを使うことができます。以下のセクションでは例として {{ic|~/builds}} をビルドディレクトリとして使用します。
== パッケージのインストール ==
 
   
  +
=== ビルドファイルを取得する ===
AUR からパッケージをインストールする手順は比較的単純です。基本は:
 
   
  +
AUR 内の対象パッケージの場所を特定します。[https://aur.archlinux.org/ AUR ホームページ]の検索フィールドを使って行うことができます。検索リスト内のアプリケーションの名前をクリックして、そのパッケージの情報ページを開きます。説明欄を読んで、それがあなたの求めているパッケージであることを確認してください。パッケージの最終更新日時とコメントも確認してください。
# [[PKGBUILD (日本語)|PKGBUILD]] と systemd のユニットやパッチなど他の必要なファイル(ソースコードではない場合が多い)が含まれた tarball を取得します。
 
# {{ic|tar -xvf hoge.tar.gz}} で tarball を解凍します(なるべく AUR 用に作ったフォルダで行ってください)。
 
# ファイルが入ったディレクトリの中で {{ic|makepkg}} を実行します({{ic|makepkg -s}} で依存関係を自動的に解決します)。自動でソースコードをダウンロード、コンパイルしてまとめます。
 
# {{ic|src/}} 内の README ファイルを探します。もしかしたら後で必要な操作が書かれているかもしれません。
 
# 作られたパッケージを [[pacman (日本語)|pacman]] でインストールします:
 
   
  +
パッケージのビルドファイルを取得する方法は複数存在します:
: {{bc|# pacman -U /path/to/pkg.tar.xz}}
 
   
  +
* そのパッケージの [[git]] リポジトリをクローンする。URL は、そのパッケージの AUR ページの「パッケージの詳細」の「Git クローン URL」にあります。これは推奨される方法です。利点としては、{{ic|git pull}} を実行すれば、パッケージを簡単にアップデートできます。
[[AUR Helpers (日本語)|AUR Helper]] を使って AUR へのアクセスをもっと簡単にできます。ものによって機能は多少異なりますが、AUR の PKGBUILD の検索・獲得・ビルド・インストールを楽にするものです。全ての AUR Helper のスクリプトは AUR にあります。
 
  +
: {{bc|$ git clone <nowiki>https://aur.archlinux.org/</nowiki>''package_name''.git}}
  +
* スナップショットをダウンロードする。パッケージの AUR ページの右側にある「パッケージアクション」内の「スナップショットのダウンロード」リンクをクリックするか、ターミナルで以下を実行してください:
  +
: {{bc|$ curl -L -O <nowiki>https://aur.archlinux.org/cgit/aur.git/snapshot/</nowiki>''package_name''.tar.gz}}
  +
: {{Note|スナップショットのファイルは圧縮されています。なので、展開する必要があります (できれば、AUR ビルド用のディレクトリ内で): {{ic|tar -xvf ''package_name''.tar.gz}}}}
  +
* [https://github.com/archlinux/aur archlinux/aur GitHub] 上の読み取り専用ミラーを使う。1つのブランチ内に1つのパッケージが存在しています。1つのブランチのみをクローンすることが推奨されます (リポジトリ全体は大きすぎるので、パフォーマンスが低下するでしょう)。これを行う方法として、以下の2つがあります:
  +
** {{ic|1=git clone --single-branch}} を使う: {{bc|$ git clone --branch ''package_name'' --single-branch <nowiki>https://github.com/archlinux/aur.git</nowiki>}}
  +
** このリポジトリの[[Git|部分クローン]]を行い ({{ic|1=git clone --depth=1}})、選択的に[[Git#ブランチの作成|ブランチを追加する]]:
  +
:: {{bc|<nowiki>$ git clone --depth=1 https://github.com/archlinux/aur.git;</nowiki> cd aur<br>$ git remote set-branches --add origin ''package_name''<br>$ git fetch<br>$ git checkout ''package_name''}}
   
  +
=== 必要であれば PGP 公開鍵を取得する ===
{{Note|AUR からパッケージをインストールする''公式の''仕組みはありませんし今後も作られることはありません。'''全てのユーザーはビルドプロセスに慣れる必要があります。'''}}
 
   
  +
[[PKGBUILD]] の source 配列に ''.sig'' や ''.asc'' という形式の署名ファイルがあるか確認してください。それがある場合、PKGBUILD の [[PKGBUILD#validpgpkeys|validpgpkeys]] 配列内にリストアップされている公開鍵のうち1つを取得してください。詳細は [[makepkg#署名チェック]] を参照してください。
以下は "hoge" というパッケージをインストールするときの詳細な説明です。
 
   
  +
=== パッケージをビルドする ===
=== 必須要件 ===
 
   
  +
パッケージの [[PKGBUILD]] が含まれているディレクトリに移動してください:
まず必要なツールがインストールされているか確かめましょう。{{grp|base-devel}} パッケージグループは絶対に必要です。{{pkg|make}} などの(ソースコードからの)コンパイルに必要なツールが含まれています。
 
   
  +
$ cd ''package_name''
{{Warning|AUR のパッケージは {{grp|base-devel}} グループがインストールされているのを前提としているので、ビルドするにはこのグループのインストールが不可欠なのに関わらず、AUR パッケージはこのグループを依存のリストに挙げません。ビルドが失敗したら不満を言う前にこのグループがインストールされているか確認しましょう。}}
 
   
  +
{{Warning|{{ic|PKGBUILD}} ファイルや ''.install'' ファイル、パッケージの git リポジトリ内のすべてのファイルを注意深く見て、悪意のある/危険なコマンドがないかチェックしてください。疑わしい場合、パッケージをビルドせずに、フォーラムやメーリングリストで[[一般的なトラブルシューティング#他者のサポート|助言を得ましょう]]。以前、悪意のあるコードがパッケージ内で見つかったことがあります。[https://lists.archlinux.org/archives/list/aur-general@lists.archlinux.org/thread/FFCMZGL4UQODYKZGUY7KTN3UBF3XN66P/]}}
# pacman -S --needed base-devel
 
   
  +
提供されているファイルすべての内容を確認してください。例えば、''less'' を使って {{ic|PKGBUILD}} を見るには:
次に適当なビルドディレクトリを選択します。ビルドディレクトリは単純にパッケージが作られる(または"ビルド"される)ディレクトリで、どのディレクトリでもかまいません。例えばこのようなディレクトリが使われます:
 
   
  +
$ less PKGBUILD
~/builds
 
   
  +
{{Tip|パッケージをアップデートしようとしているならば、最後のコミットとの変更点を見るべきかもしれません。
ABS ([[Arch Build System (日本語)|Arch Build System]]) を使う場合は:
 
  +
* 最後の git コミットとの変更点を見るには、{{ic|git show}} を使うことができます。
  +
* ''vimdiff'' を使って最後のコミットとの変更点を見るには、{{ic|git difftool @~..@ vimdiff}} を実行してください。''vimdiff'' の利点は、何が変更されたかを示すインジケータと共に各ファイルの内容全体を見ることができることです。}}
   
  +
パッケージを作成します。手動でファイルの内容を確認したあとで、[[makepkg]] を通常ユーザとして実行してください。いくつか便利なフラグがあります:
/var/abs/local
 
   
  +
* {{ic|-s}}/{{ic|--syncdeps}} は、ビルド前に自動的に依存関係を解決し、[[pacman]] を使って依存パッケージをインストールします。パッケージが他の AUR パッケージに依存している場合、まずその AUR パッケージを手動でインストールする必要があります。
ABS に関する詳細情報は [[Arch Build System (日本語)]] を読んで下さい。ここでは {{ic|~/builds}} をビルドディレクトリとして使います。
 
  +
* {{ic|-i}}/{{ic|--install}} は、ビルドが成功した場合にパッケージをインストールします。このフラグを使えば、通常手動で行う次の手順をスキップすることができます。
  +
* {{ic|-r}}/{{ic|--rmdeps}} は、ビルド後に、ビルド時の依存パッケージを削除します (なぜなら、それらはもはや必要ないからです)。しかし、これらの依存パッケージは、パッケージがアップデートされたときに再インストールする必要があるでしょう。
  +
* {{ic|-c}}/{{ic|--clean}} は、ビルド後に一時ビルドファイルをクリーンアップします (なぜなら、それらはもはや必要ないからです)。通常、これらのファイルはビルドプロセスをデバッグするときにだけ必要になります。
   
  +
{{Tip|{{ic| git clean -dfx}} を使えば、git によって追跡されていないファイルをすべて削除できます。つまり、以前ビルドされたパッケージをすべて削除します。}}
=== ビルドファイルを獲得 ===
 
   
  +
=== パッケージをインストールする ===
AUR からパッケージを入手します。検索機能([https://aur.archlinux.org/ AUR home page] の上部の検索ボックス)をつかってください。検索して出てきたリストからアプリケーションの名前をクリックしパッケージ情報のページを出します。説明を読んでそのパッケージをインストールすべきか決めて下さい。パッケージが最近更新されているなら、コメントも読んでおきましょう。
 
   
  +
これで、pacman を使ってパッケージをインストールできます:
必要なビルドファイルをダウンロードします。パッケージ情報のページから、右にある "Package actions" 下の "Download tarball" リンクをクリックしてダウンロードします。ダウンロードしたファイルはビルドディレクトリに移してください。ここでは、"hoge.tar.gz" という名前のファイルということにします (標準フォーマットは ''pkgname''.tar.gz です)。
 
   
  +
# pacman -U ''package_name''-''version''-''architecture''.pkg.tar.zst
=== パッケージのビルド ===
 
   
  +
{{Note|
tarball を解凍します。ビルドディレクトリに {{ic|cd}} してビルドファイルを解凍してください。
 
  +
* {{ic|makepkg.conf}} 内の {{ic|PKGEXT}} を変更している場合、パッケージファイルの名前も若干異なる場合があります。
  +
* 上記の例は、ビルドプロセスの概略です。詳細は [[makepkg]] と [[ABS]] の記事を見ることを'''強く'''推奨します。
  +
}}
   
  +
=== パッケージをアップグレードする ===
$ cd ~/builds
 
$ tar -xvf hoge.tar.gz
 
   
  +
パッケージの [[PKGBUILD]] を含むディレクトリ内で、まず最初に以下のコマンドを使ってファイルと変更を更新しなければなりません:
ビルドディレクトリの中に "hoge" という名前の新しいディレクトリが作られるはずです。
 
   
  +
$ git pull
{{Warning|'''全てのファイルを注意してチェックしてください。'''新しく作られたディレクトリに {{ic|cd}} した後、{{ic|PKGBUILD}} と全ての {{ic|.install}} ファイルを見て、悪意のあるコマンドが含まれていないかチェックします。{{ic|PKGBUILD}} は {{ic|makepkg}} で実行される bash スクリプトです: 有効な Bash 構文 やコマンドでありさえすれば''どんな''コマンドも含むことができます、つまり作者の悪意や過失によって {{ic|PKGBUILD}} に危険なコマンドが含まれていることがあるのです。{{ic|makepkg}} は fakeroot を使うので(よって root で実行してはいけません)、ある程度の防護策は取られていますがそれに頼るのは危険です。疑わしいことがあれば、パッケージをビルドするのは中断してフォーラムやメーリングリストでアドバイスを求めましょう。}}
 
   
  +
次に、前述のビルドとインストールの指示に従ってください。
$ cd hoge
 
$ nano PKGBUILD
 
$ nano hoge.install
 
   
  +
=== パッケージをアップデートする ===
パッケージを作ります。ファイルが正しいか確認したあと、ビルドディレクトリにおいて通常ユーザーで [[makepkg (日本語)|makepkg]] を実行します:
 
   
  +
AUR はサポート外のものなので、あなたがインストールしたパッケージは、pacman ではなく ''あなたの責任で'' アップデートすることになっています。公式リポジトリ内のパッケージがアップデートされた場合、それらのライブラリに依存している AUR パッケージをすべてビルドし直す必要があります。
$ makepkg -s
 
   
  +
== アカウントステータス ==
{{ic|-s}} スイッチは [[sudo (日本語)|sudo]] を使って依存パッケージをインストールします。sudo を使うのが望ましくない場合は、手動で依存性を解決して上のコマンドから {{ic|-s}} を外して実行してください。
 
   
=== インストールする ===
+
=== 休止 (Suspension) ===
   
  +
Trusted User としてユーザを編集するとき、休止 (Suspended) フィールドをセットできます。これは、対象のユーザを休止させます。'''ユーザが休止しているとき、以下のことはできなくなります:'''
pacman を使ってパッケージをインストールします。次のような名前を持った tarball が作られているはずです:
 
   
  +
* https://aur.archlinux.org へのログイン
<''application name''>-<''application version number''>-<''package revision number''>-<''architecture''>.pkg.tar.xz
 
  +
* 通知の受け取り
  +
* git インターフェイスとの対話
   
  +
=== 活動休止 (Inactivity) ===
作られたパッケージは、pacman の "upgrade" コマンドを使ってインストールできます:
 
   
  +
あなた自身のアカウントを編集するときや、Trusted User としてユーザを編集するとき、活動休止 (Inactive) フィールドをセットできます。活動休止中のアカウントは2つの理由により使用されます:
# pacman -U hoge-0.1-1-i686.pkg.tar.xz
 
   
  +
* アカウントページに活動休止になった日付を表示する。
こうやって手動でインストールされたパッケージは foreign package と呼ばれます &mdash; pacman に知らせていないリポジトリから作られたパッケージという意味です。全ての foreign package を表示するには:
 
  +
* 新しい提案のために、活動休止になっているかどうかで現在アクティブな Trusted User の数を生成する。
$ pacman -Qm
 
 
{{Note|以上の例はパッケージをビルドする手順の簡単な概略です。[[makepkg (日本語)|makepkg]] と [[Arch Build System (日本語)|ABS]] のページにはもっと詳しい解説が載っています、初めて使うユーザーはぜひ読んで下さい。}}
 
   
 
== フィードバック ==
 
== フィードバック ==
   
  +
=== パッケージにコメントする ===
[https://aur.archlinux.org AUR Web Interface] にはコメント機能がありユーザーは PKGBUILD の作成者に提案やフィードバックをすることができます。パッチや PKGBUILD はコメントに書かないようにしてください: 鮮度がすぐ落ちて、無駄にスペースを埋めることになるからです。代わりにメンテナにメールを送るか、[[List of Applications (日本語)#Pastebin クライアント|pastebin]] を使って下さい。
 
   
  +
[https://aur.archlinux.org AUR ウェブインターフェイス]にはコメント機能があり、[[PKGBUILD]] の貢献者にコメントで提案やフィードバックを提供することができます。
'''全ての''' Arch ユーザーにできる一番簡単な活動は、AUR のオンラインインターフェースを使ってお気に入りのパッケージに '''vote''' することです。全てのパッケージは TU によって [community] に取り込まれる資格があり、vote の数が理由の1つになります。また、投票数はみんなが気にしていることでもあります。
 
   
  +
{{Tip|コメント欄にパッチや {{ic|PKGBUILD}} をペーストするのは避けてください。それらはすぐに古くなり、不必要にスペースを圧迫するだけになります。代わりに、それらのファイルをメンテナにメールするか、[[アプリケーション一覧#Pastebin サービス|pastebin]] を使ってください。}}
== パッケージの共有 ==
 
   
  +
[https://python-markdown.github.io/ Python-Markdown] は、コメントをフォーマットする基本的な [[Wikipedia:ja:Markdown|Markdown]] 構文を提供します。
ユーザーは AUR の中で大事な役目をおっています、ユーザーコミュニティの参加・貢献なくしては AUR の真価は発揮されません。AUR パッケージのライフサイクルはユーザー次第であり様々な方法での貢献が求められます。
 
   
  +
{{Note|
ユーザーは Arch User Repository を使って PKGBUILD を'''シェア'''することができます。AUR にはバイナリパッケージはありませんが PKGBUILD をアップロードすることで他のユーザーもそれを使うことができるのです。これらの PKGBUILD は完全に非オフィシャルなものであり徹底して管理されてはいないので、自己責任において使うことになります。
 
  +
* この実装は、公式の[https://daringfireball.net/projects/markdown/syntax 構文規則]とは一部異なる場合があります。
  +
* パッケージの [[Git]] リポジトリへのコミットハッシュと、[[Flyspray]] チケットへの参照は、自動的にリンクに変換されます。
  +
* 長いコメントは短く表示され、必要に応じて全文を表示できます。
  +
}}
   
=== パッケージ稿する ===
+
=== パッケージする ===
   
  +
'''すべての''' Arch ユーザにとって最も簡単なアクティビティの1つとして、AUR のオンラインインターフェイスによる AUR のブラウズや、お気に入りのパッケージへの'''投票'''があります。すべてのパッケージは、TU によって[[公式リポジトリ#extra|extra リポジトリ]]に取り込まれる可能性があり、得票数はその過程で考慮されます。また、投票数はみんなが気にしていることでもあります。
AUR ウェブインタフェースにログイン後、ユーザーはパッケージのビルドファイルが入ったディレクトリを圧縮した tarball ({{ic|.tar.gz}}) を[https://aur.archlinux.org/pkgsubmit.php 投稿]できます。ディレクトリには [[PKGBUILD (日本語)|PKGBUILD]]、[[AUR Metadata (日本語)|.AURINFO]]、{{ic|.install}} ファイル、パッチなどを含めることができます(バイナリは'''絶対に'''入れないで下さい)。もし [[Arch Build System (日本語)|Arch Build System]] がインストールされているのならディレクトリの中がどのようになるか {{ic|/var/abs}} で見ることができます。
 
   
  +
パッケージのブラウジングで「このパッケージに投票する」オプションを利用できるようにするには、[https://aur.archlinux.org/ AUR のウェブサイト]にサインアップしてください。サインアップ後、{{AUR|aurvote}}、{{AUR|aurvote-git}}、{{AUR|aur-auto-vote-git}} を使ってコマンドラインからも投票できるようになります。
tarball は次のコマンドで作って下さい ({{Pkg|pkgbuild-introspection}} パッケージに入っています):
 
   
  +
あるいは、[[AUR 投稿ガイドライン#認証|ssh 認証]]がセットアップ済みである場合、あなたの ssh 鍵を使ってコマンドラインから直接投票できます。これはつまり、AUR パスワードを保存・入力する手間が省けることを意味します。
$ mkaurball
 
   
  +
$ ssh aur@aur.archlinux.org vote ''package_name''
仮に ''libhoge'' という名のパッケージを投稿する場合、ファイルはこのようになるはずです:
 
   
  +
=== パッケージに out-of-date フラグを立てる ===
{{hc|$ tar tf libhoge-0.1-1.src.tar.gz|
 
libhoge/
 
libhoge/.AURINFO
 
libhoge/PKGBUILD
 
libhoge/libhoge.install}}
 
   
  +
まず、そのパッケージに ''out-of-date'' フラグを立て、そのパッケージが out-of-date である理由の詳細や、できればリリースのアナウンスや新しいリリースの [[アーカイブと圧縮#アーカイブのみ|tarball]] へのリンクを含めてください。
{{Note|".AURINFO" ファイルにはソースパッケージのメタデータが含まれています。詳しくは [[AUR Metadata (日本語)|AUR Metadata]] を見て下さい。}}
 
   
  +
また、メンテナに email で直接連絡を取ってみるべきです。''2周間''経ってもメンテナから応答がない場合、''孤児''リクエストを提出することができます。詳細は [[AUR 投稿ガイドライン#リクエスト]] を見てください。
パッケージを投稿する際には、以下のルールを守りましょう:
 
   
  +
{{Note|[[VCS パッケージガイドライン|VCS パッケージ]]は、{{ic|pkgver}} が変更されても、out-of-date とは見なされません。VCS パッケージにはフラグを建てないでください。立てても、メンテナは単にフラグを解除し、あなたを無視するでしょう。AUR メンテナは単なる {{ic|pkgver}} のバージョンアップをコミットするべきではありません。}}
* そのパッケージが[https://www.archlinux.org/packages/ パッケージデータベース]にすでに存在してないかチェックしてください。存在しているのなら、そのパッケージを'''投稿してはいけません'''。もし既にあるパッケージが壊れていたり機能していないのなら[https://bugs.archlinux.org/ バグレポート]で報告してください。
 
* そのパッケージが AUR にすでに存在してないかチェックしてください。メンテナンスされているパッケージがあるのならば、コメントからメンテナに修正を求めることができます。パッケージが既にメンテナンスされていないのなら、作ったパッケージに差し替えることができます。パッケージを重複させないでください。
 
* あなたがアップロードするファイルを注意して問題ないかチェックしてください。全ての投稿者は PKGBUILD を書くときに [[Arch Packaging Standards (日本語)]] を読まなくてはなりません。AUR の効率的な運営と一般的な目的のために重要なことです。悪い PKGBUILD で利用者を苦しませているようではあなたの評判や名誉はうまれないでしょう。
 
* バイナリを含んでいたり全く不十分のパッケージは警告なしで削除されることがあります。
 
* もしパッケージ(やビルド・投稿プロセス)に自信がないときは、PKGBUILD を [https://mailman.archlinux.org/mailman/listinfo/ AUR Mailing List] や [https://bbs.archlinux.org/viewforum.php?id=4 AUR Forum] に投稿して見てもらってから AUR に加えてください。
 
* そのパッケージが役に立つか考えて下さい。他の誰かがそのパッケージを使おうと考えるでしょうか?あまりにも特殊化しすぎていませんか?そのパッケージが役に立つと一般的な人が思うようなものであれば、投稿するのにふさわしいでしょう。
 
* AUR と公式リポジトリは一般的に、ソフトウェアやソフトウェアに関連するコンテンツをインストールするパッケージのためにあります、それには以下のものが含まれます: 実行可能ファイル、設定ファイル、特定のソフトウェアもしくは Arch Linux ディストリビューション全体のオンライン・オフラインのドキュメント、ソフトウェアによって直接使用されるメディア。
 
* パッケージを投稿しようとする前に経験をつみましょう。いくつかパッケージをビルドして手順を学んでから投稿してください。
 
* '{{ic|package}}' という名前のファイルを含んだ {{ic|package.tar.gz}} を投稿するとエラーが表示されます: 'Could not change to directory {{ic|/home/aur/unsupported/package/package}}'。これを修正するには、ファイルの '{{ic|package}}' という名前を何か他の名前に変えてください、例えば、'{{ic|package.rc}}'。{{ic|pkg}} ディレクトリにインストールされたときに名前を '{{ic|package}}' に戻すことができます。[[Arch Packaging Standards (日本語)#パッケージを AUR に投稿する]]も読んで下さい。
 
   
=== パッケージのメンテナン===
+
== パッケージのビルドプロセをデバッグする ==
   
  +
# 何かをビルドする前に[[Pacman#パッケージのアップグレード|アップグレード]]してビルド環境が最新であることを確認してください。
* メンテしている PKGBUILD をアップデートしたいと思った時は、それを再投稿してください。
 
  +
# {{Pkg|base-devel}} がインストールされていることを確認してください。
* 他のユーザーからのコメントやフィードバックをチェックして、ときには提案を汲み上げるようにしましょう。学習過程だと考えて下さい。
 
  +
# ビルドプロセスを始める前に、{{ic|makepkg}} で {{ic|-s}} オプションを使って、必要とされているすべての依存関係をチェック・インストールしてください。
* パッケージを更新する度にバージョン番号を含むコメントを投稿するのはやめてください。コメント欄は上記の意味ある内容のために使って下さい。更新の確認には [[AUR Helpers (日本語)|AUR ヘルパー]]の方が適しています。
 
  +
# デフォルトの [https://gitlab.archlinux.org/archlinux/packaging/packages/pacman/-/blob/main/makepkg.conf makepkg の設定]を試してください。
* パッケージを投稿したらそのまま放置するのはやめてください。アップデートをチェックし、PKGBUILD を修正してパッケージをメンテナンスするのがメンテナの仕事です。
 
  +
# 一般的な問題については [[Makepkg#トラブルシューティング]] を見てください。
* 何らかの理由でパッケージのメンテナンスが続けられない場合は、AUR ウェブインタフェースでパッケージを {{ic|disown}} するかメーリングリストでことづてしてください。
 
   
  +
パッケージのビルドで問題が発生する場合、まず、そのパッケージの [[PKGBUILD]] とそのパッケージの AUR ページのコメントを読んでください。
=== その他 ===
 
   
  +
{{ic|PKGBUILD}} が全員の環境で壊れている場合もあり得ます。ひとりで解決できない場合、問題をメンテナに報告してください (例えば、[[#パッケージにコメントする|発生するエラーを AUR ページのコメント欄に投稿する]]など)。また、[https://bbs.archlinux.org/viewforum.php?id=38 AUR Issues, Discussion & PKGBUILD Requests フォーラム]で助けを得ることもできるかもしれません。
* disown リクエストや消去リクエストは右側の"パッケージアクション"の下にある"リクエストを送る"リンクをクリックして作成することができます。リクエストが作成されると自動的に通知メールがパッケージの現在のメンテナと [https://mailman.archlinux.org/mailman/listinfo/aur-requests aur-requests メーリングリスト]に送信されます。その後 [[Trusted Users|Trusted User]] がリクエストの承認・却下を行います。
 
* disown リクエストは通るのに2週間ほどかかることがあります。現在のメンテナにメールで連絡が行ってから、反応がないか待つためです。
 
* '''パッケージのマージも受け付けています'''、ユーザーはまず新しい名前でパッケージを再投稿して、古いバージョンのコメントや投票のマージをリクエストしてください。
 
* 消去リクエストには以下の情報が必要です:
 
** パッケージ名と AUR ページの URL
 
** 消去する理由、最低でも短いメモ書き <br> '''注意:''' パッケージのコメント欄をパッケージの削除の理由を書くのに使うことはできません。TU ができるだけ早く行動するために、そのような情報は aur-requests メーリングリストに書かれるべきです。
 
** 補足事項を加えて下さい、仮にあなたがメンテナならば、他のパッケージで提供されるようになった、パッケージ名を変えて元の管理者が認めた、など。
 
** マージリクエストの場合: マージ先のパッケージベースの名前。
 
   
  +
結局、原因が些細なことではない場合もあります。カスタムの {{ic|CFLAGS}}、{{ic|LDFLAGS}}、{{ic|MAKEFLAGS}} フラグは失敗を引き起こす可能性があります。あなたのシステム構成によって引き起こされる問題を回避するには、パッケージを[[:en:DeveloperWiki:Building in a clean chroot|クリーンな chroot]] 内でビルドしてください。ビルドプロセスがクリーンな chroot 内でも失敗する場合、原因はおそらく {{ic|PKGBUILD}} にあるのでしょう。
消去リクエストは認められないことがあります、その場合、他のパッケージメンテナに移すためにパッケージを disown するようアドバイスされるかもしれません。
 
   
  +
{{ic|namcap}} の使用に関しては [[パッケージの作成#パッケージの正常性のテスト]] を見てください。{{ic|PKGBUILD}} をレビューしてもらいたいならば、[https://lists.archlinux.org/mailman3/lists/aur-general.lists.archlinux.org/ aur-general メーリングリスト]に投稿して TU やフェロー AUR メンバーからフィードバックをもらうか、[https://bbs.archlinux.org/viewforum.php?id=4 Creating & Modifying Packages フォーラム]に投稿してください。また、[https://libera.chat Libera Chat] ネットワーク上の [[IRC チャンネル]] [ircs://irc.libera.chat/archlinux-aur #archlinux-aur] で助けを乞うこともできます。
== [community] ==
 
   
  +
== パッケージを投稿する ==
[[Trusted Users]] によって管理されている [community] リポジトリには AUR から取り込まれた多くの人気パッケージが含まれています。[community] リポジトリはデフォルトで {{ic|/etc/pacman.conf}} で有効にされています。[community] を無効or削除されている時は、以下の2行をアンコメントor追加すれば有効にできます:
 
   
  +
ユーザは、Arch User Repository を使って [[PKGBUILD]] を共有できます。詳細は [[AUR 投稿ガイドライン]] を見てください。
{{hc|/etc/pacman.conf|2=
 
...
 
[community]
 
Include = /etc/pacman.d/mirrorlist
 
...}}
 
   
  +
== ウェブインターフェイスの翻訳 ==
このリポジトリは、AUR とは違い、バイナリパッケージのリポジトリであり [[pacman (日本語)|pacman]] によって直接インストールすることができますし、ビルドファイルに [[Arch Build System (日本語)|ABS]] でアクセスすることもできます。開発者によって、ディストリビューションの重要な地位を占めていると考えられるパッケージは、[core] もしくは [extra] リポジトリに移されることもあります。
 
   
  +
[https://aur.archlinux.org AUR ウェブインターフェイス]の翻訳の作成とメンテナンスについては AUR ソースツリーの [https://gitlab.archlinux.org/archlinux/aurweb/-/blob/master/doc/i18n.txt i18n.txt] を見てください。
ユーザーは [community] ビルドファイルに {{ic|/etc/abs.conf}} を編集して [community] リポジトリ を {{ic|REPOS}} で有効にすることによってもアクセス可能です。
 
   
== Git リポジトリ ==
+
== 歴史 ==
  +
  +
当初、{{ic|<nowiki>ftp://ftp.archlinux.org/incoming</nowiki>}} というサーバーがあり、人々は [[PKGBUILD]] やビルドに必要なファイル、ビルド済みのパッケージをそのサーバにアップロードしていました。パッケージやそれに関連するファイルは、[[パッケージメンテナ]]がプログラムを見て取り入れるまで、そこに置かれていました。
  +
  +
その後、Trusted User リポジトリが誕生しました。コミュニティの特定の個人が、誰でも使えるリポジトリをホストすることを許可されていました。これを基礎として、より柔軟に使いやすくするために拡張されたものが AUR です。今でも、AUR のメンテナは TU (Trusted User) と呼ばれます。
   
  +
2015年6月8日から2015年8月8日までの間に AUR はバージョン 3.5.1 から 4.0.0 に移行し、PKGBUILD を公開するために Git リポジトリが使われるようになりました。
AUR の Git リポジトリは {{ic|<nowiki>git://pkgbuild.com/aur-mirror.git</nowiki>}} にあります。1日にすくなくとも1回の頻度で更新されています。[http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History commit 履歴] が必要ない場合は、{{ic|1=--depth=1}} オプションを使うことで高速に複製することができます:
 
  +
既存のパッケージは、メンテナによって新しいインフラに手動で移行されない限り、ドロップされました。
   
  +
=== AUR3 パッケージの Git リポジトリ ===
<nowiki>$ git clone --depth=1 git://pkgbuild.com/aur-mirror.git</nowiki>
 
   
  +
GitHub 上の [https://github.com/aur-archive AUR Archive] には、移行時に AUR3 内にあったすべてのパッケージが保存されているリポジトリです。
詳しくは: [http://pkgbuild.com/git/aur-mirror.git/ Web interface], [https://bbs.archlinux.org/viewtopic.php?id=113099 forum thread]。
 
  +
あるいは、同じものを提供する [https://github.com/felixonmars/aur3-mirror/ aur3-mirror] リポジトリもあります。
   
 
== FAQ ==
 
== FAQ ==
   
=== AUR とは何ですか ===
+
=== どのような種類のパッケージが AUR に置かれていますか? ===
   
  +
AUR にあるパッケージはたんに"ビルドスクリプト"、つまり pacman 用にバイナリをビルドするレシピにすぎません。ほとんどの場合、[[AUR 投稿ガイドライン#投稿の規則|有用性と範囲のガイドライン]]を条件として、コンテンツのライセンスの問題がない限り、すべてのものが置くことを許されています。他の場合、ダウンロードにリンクできない、つまり再配布が禁止されている時は、ソースとしてファイル名だけを使うことができます。よってパッケージをビルドするには、ユーザーによってビルドディレクトリにその制限されたソースを入れておく必要があります。どちらかわからない場合は、尋ねて下さい。
AUR (Arch User Repository) は、Arch Linux コミュニティがアップロードした、アプリケーションやライブラリの [[PKGBUILD (日本語)|PKGBUILD]] をコミュニティ全体で共有するスペースです。ユーザー同士でお気に入りのパッケージに投票することができ、場合によっては、[community] リポジトリに移されてバイナリ形式で Arch Linux ユーザー間に共有されます。
 
   
=== どのよな種類のパッケージが AUR 置かれていますか ===
+
=== どうすれば AUR 内のパッケージに投票できますか? ===
   
  +
[[#パッケージに投票する]] を見てください。
AUR にあるパッケージはたんに"ビルドスクリプト"、つまり pacman 用にバイナリをビルドするレシピにすぎません。ほとんどの場合、上述の有用性と範囲のガイドラインを条件として、コンテンツのライセンスの問題がない限り、すべてのものが置くことを許されています。他の場合、ダウンロードにリンクできない、つまり再配布が禁止されている時は、ソースとしてファイル名だけを使うことができます。よってパッケージをビルドするには、ユーザーによってビルドディレクトリにその制限されたソースを入れておく必要があります。どちらかわからない場合は、尋ねて下さい。
 
   
=== TU とはどのような人ですか ===
+
=== Trusted User / TU とはですか? ===
   
[[AUR Trusted User Guidelines (日本語)|TU (Trusted User)]] とは、AUR と [community] リポジトリを監督するように選ばれた人のことです。彼らは [community] に入っている人気の PKGBUILD を管理していて、みんなで AUR を運営し続けています。
+
[[AUR Trusted User ガイドライン|Trusted User]] (略して TU) とは、AUR と [[extra リポジトリ]]を監督するように選ばれた人のことです。彼らは ''extra'' に入っている人気の [[PKGBUILD]] を管理していて、みんなで AUR を運営し続けています。
   
=== Arch User Repository と [community] の違いは ===
+
=== Arch User Repository と extra リポジトリの違いは何ですか? ===
   
Arch User Repository にはユーザーが投稿した全ての PKGBUILD が保存されており、利用するには手動で [[makepkg (日本語)|makepkg]] を使ってビルドしなくてはなりません。PKGBUILD に一定数投票ると、パッケージは [community] リポジトリに移され TU が管理するバイナリパッケージとなり、[[pacman (日本語)|pacman]] によってインストールできるようになります。
+
Arch User Repository にはユーザーが投稿した全ての [[PKGBUILD]] が保存されており、利用するには手動で [[makepkg]] を使ってビルドしなくてはなりません。{{ic|PKGBUILD}}コミュニティ十分な関心集まると、パッケージは [[extra リポジトリ]]に移され TU が管理するバイナリパッケージとなり、[[pacman]] によってインストールできるようになります。
   
=== どれくらい投票で PKGBUILD [community] に移されますか ===
+
=== AUR Hoge古くなっています、どうするべきでしょう? ===
   
  +
[[#パッケージに out-of-date フラグを立てる]] を見てください。
通常、少なくとも 10 の投票が [community] に移されるのに必要です。しかし、TU がパッケージをサポートしたいと望んだ時は、投票数にかかわらず [community] に入ることがしばしばあります。
 
   
  +
その間、ローカルで [[PKGBUILD]] を自分で編集してパッケージをアップデートしてみることもできます。アップデートにビルドプロセスの変更が必要ない場合もあり、この場合、{{ic|pkgver}} か {{ic|source}} 配列を更新するだけで十分です。
=== どうやって PKGBUILD を作るのですか? ===
 
   
  +
=== AUR の Hoge を makepkg でコンパイルすることができません。どうしたらいいですか? ===
作り方は [[Creating Packages (日本語)]] にあります。同じものをダブらせてしまわないように PKGBUILD を作る前に AUR を調べるのを忘れないようにしましょう。
 
   
  +
何か些細なことを見逃しているのかもしれません。[[#パッケージのビルドプロセスをデバッグする]] を見てください。
=== [community] にあるパッケージを "pacman -S hoge" したのですがインストールされません ===
 
   
  +
=== ERROR: One or more PGP signatures could not be verified! この場合、どうすればよいですか? ===
おそらく {{ic|/etc/pacman.conf}} で [community] を有効にしていないのではないでしょうか。当該行をアンコメントしてください。
 
{{ic|/etc/pacman.conf}} の [community] が有効になっていたのなら、{{ic|pacman -Syu}} で pkgcache を同期してからパッケージを再度取得してみてください。
 
   
  +
最もあり得るのは、ダウンロードしたファイルを検証するために必要な公開鍵があなたの個人キーリング内に存在しないことです。詳細は [[Makepkg#署名チェック]] を見てください。
=== AUR の Hoge が古くなっています、どうするべきでしょうか? ===
 
   
  +
=== どうやって PKGBUILD を作るのですか? ===
第一歩として、パッケージの out-of-date フラグを立てることができます。パッケージが延長した時間になっても out-of-date のままの場合、最良の解決策はメンテナにメールをすることです。2週間たってもメンテナから何の反応も得られないときは、孤児リクエストを作成してください。3ヶ月以上 out-of-date のままでいっこうにアップデートされる気配のないパッケージがあるのならば、孤児リクエストに加えて下さい。
 
   
  +
[[AUR 投稿ガイドライン#投稿の規則]] を見て、次に [[パッケージの作成]] を見てください。
=== PKGBUILD を作って投稿したいと思っています。エラーがないか誰かチェックしてくれるでしょうか? ===
 
   
  +
=== PKGBUILD を作って投稿したいと思っています。エラーがないか誰かチェックしてくれるでしょうか? ===
あなたの PKGBUILD を批評してもらいたいのなら、aur-general メーリングリストに投稿して、TU や AUR メンバーからの反応をみてはいかがでしょう。[[ArchChannel|IRC channel]], #archlinux on irc.freenode.net からも助けを得ることができます。[[namcap (日本語)|namcap]] を使って PKGBUILD や作られるパッケージにエラーがないかチェックすることも可能です。
 
   
  +
パッケージをレビューのために提出できるチャネルが複数存在します。[[#パッケージのビルドプロセスをデバッグする]] を見てください。
=== AUR の Hoge を makepkg でコンパイルすることができません。どうしたらいいですか? ===
 
   
  +
=== どうすれば PKGBUILD が extra リポジトリに移されるのですか? ===
おそらく些細なことを見逃していると思われます。
 
   
  +
通常、パッケージを [[extra リポジトリ]] に移すには最低 10 票必要です。しかし、[[TU]] がパッケージをサポートしたいと望んだときは、''extra'' リポジトリに入ることがしばしばあります。
# {{ic|makepkg}} でコンパイルする前に {{ic|pacman -Syyu}} をしてみてください。あなたのシステムが最新でないことが問題かもしれません。
 
# "base" と "base-devel" グループがインストール済みか確認してください。
 
# ビルドプロセスをはじめる前に {{ic|makepkg}} に "{{ic|-s}}" オプションを使って必要な依存パッケージがインストールされているかチェックしてみてください。
 
   
  +
必要な最低投票数に到達することは唯一の要件ではありません。そのパッケージをメンテナンスしてもよいという TU がいなければなりません。たとえパッケージに数千もの投票があったとしても、TU は ''extra'' リポジトリにそのパケージを移す必要はないのです。
まずはじめに PKGBUILD やパッケージの AUR ページのコメントを読むようにしてください。問題がカスタムした CFLAGS, LDFLAGS, MAKEFLAGS が問題を起こしているのかもしれません。その PKGBUILD が全ての人にとって壊れているかもしれません。もし自分で解決できない問題なら、AUR ページのコメントに書き込むなどしてメンテナにそれを報告してください。
 
   
  +
通常、非常に人気なパッケージが AUR に残っている理由としては:
=== ビルドの速度を速めるにはどうすればいいですか? ===
 
   
  +
* Arch Linux のリポジトリ内にパッケージの他のバージョンがすでに存在するから
gcc を使って頻繁にコードをコンパイルする場合 (git や SVN パッケージなど)、[[ccache (日本語)|ccache]] ("compiler cache" の略) が役にたつかもしれません。
 
  +
* ライセンスで再配布が禁止されているから
  +
* そのパッケージが、ユーザによって投稿された [[PKGBUILD]] の取得を補助するものだから。[[AUR ヘルパー]] は、当然、[https://bbs.archlinux.org/viewtopic.php?pid=828310#p828310 サポートされていません]。
   
  +
[[AUR Trusted User ガイドライン#extra リポジトリにパッケージを入れるときのルール|extra リポジトリにパッケージを入れるときのルール]] も見てください。
=== どうすればサポートされていないパッケージにアクセスできますか? ===
 
   
  +
=== 繰り返されるビルドプロセスを速めるにはどうすればよいですか? ===
[[#パッケージのインストール]]を見て下さい。
 
   
  +
[[Makepkg#コンパイル時間を短縮する]] を見てください。
=== ウェブインタフェースを使わずに AUR にアップロードするにはどうすればいいですか? ===
 
   
  +
=== foo と foo-git パッケージは何が違うのですか? ===
{{pkg|burp}}, ''aurploader'' ({{AUR|python3-aur}}) や {{AUR|aurup}} などのコマンドラインプログラムが使えます。
 
  +
  +
多くの AUR パッケージには安定バージョン ("stable") と開発バージョン ("unstable") が存在します。開発版のパッケージには大抵、バージョン管理システムを示す[[VCS パッケージガイドライン|接尾辞]]が付いており、通常の使用を意図していません。しかし、それらは新しい機能やバグフィックスを提供している場合があります。
  +
  +
{{ic|makepkg}} を実行した時、これらのパッケージは最新のソースをダウンロードするので、{{ic|pkgver()}} は必ずしも上流と合っていません。同じく、これらのパッケージは、如何なる [[VCS パッケージガイドライン#VCS ソース|VCS ソース]]のチェックサムの確認もできません。
  +
  +
[[システムメンテナンス#実績のあるソフトウェアパッケージを使用する]] も見てください。
  +
  +
=== Foo が AUR から消えたのはなぜですか? ===
  +
  +
パッケージが [[TU]] によって引き取られ、現在は [[extra リポジトリ]] に存在している可能性があります。
  +
  +
また、[[AUR 投稿ガイドライン#投稿の規則|投稿の規則]]に違反していたため、削除されてしまった可能性もあります。削除の理由は、[https://lists.archlinux.org/archives/list/aur-requests@lists.archlinux.org/ aur-requests アーカイブ] を見てください。
  +
  +
{{Note|削除されたパッケージの git リポジトリは、通常、利用可能なままになります。詳細は [[AUR 投稿ガイドライン#リクエスト]] を見てください。}}
  +
  +
そのパッケージが AUR3 に存在していた場合、[https://lists.archlinux.org/archives/list/aur-general@lists.archlinux.org/message/NJN6TPVF6MWGF7BCHBMBYFZ5JDAPOHP5/ AUR4 に移行]されなかったのかもしれません。そのようなパッケージが保存されている場所である [[#AUR3 パッケージの Git リポジトリ]] を見てください。
  +
  +
=== インストール済みのパッケージが AUR から消えてしまっているかどうかを確かめるには? ===
  +
  +
最もシンプルな方法は、そのパッケージの AUR ページの HTTP ステータスをチェックすることです:
  +
  +
$ comm -23 <(pacman -Qqm | sort) <(curl https://aur.archlinux.org/packages.gz | gzip -cd | sort)
  +
  +
=== 全ての AUR パッケージのリストを入手するには? ===
  +
  +
* https://aur.archlinux.org/packages.gz
  +
* {{aur|python3-aur}} の {{ic|aurpkglist}} を使ってください
   
 
== 参照 ==
 
== 参照 ==
 
* [https://aur.archlinux.org AUR ウェブインターフェイス]
 
* [https://aur.archlinux.org AUR ウェブインターフェイス]
* [https://www.archlinux.org/mailman/listinfo/aur-general AUR メーリングリスト]
+
* [https://lists.archlinux.org/mailman3/lists/aur-general.lists.archlinux.org/ AUR メーリングリスト]
  +
* [http://pkgbuild.com/git/aur-mirror.git/ AUR Mirror Git リポジトリ]
 
  +
{{TranslationStatus|Arch User Repository|2023-06-14|779733}}

2024年7月10日 (水) 20:11時点における最新版

関連記事

Arch User Repository (AUR) はコミュニティによって運営されている、Arch ユーザーのためのリポジトリです。パッケージのビルド方法が書かれたファイル (PKGBUILD) がまとめて置かれており、makepkg を使ってソースからパッケージを作り、生成したパッケージを pacman でインストールすることができます。人気のあるパッケージが extra リポジトリに取り込まれるように、コミュニティの手で新しいパッケージを共有することを目的に AUR は作られました。このページでは AUR の使用方法を説明します。

AUR に投稿された新しいパッケージの一部は公式リポジトリに取り込まれています。AUR では、ユーザーはパッケージビルド (PKGBUILD と関連ファイル) を投稿することができます。AUR コミュニティには AUR に存在するパッケージに対して投票する機能があります。投票が十分に集まると (ライセンスに問題がなくきちんとパッケージ化されているならば) extra リポジトリに取り込まれます (pacmanabs で直接入手できるようになります)。

警告: AUR のパッケージはユーザによって提供されているものです。それらの PKGBUILD は完全に非公式であり、綿密に検査されていません。AUR から提供されているファイルの使用は自己責任となります。

目次

はじめに

AUR ウェブインターフェイスPKGBUILD を検索したり、ダウンロードしたりすることができます。makepkg を使って PKGBUILD からパッケージを生成することができ、pacman でインストールできます。

  • base-develインストールされていることを確認してください。
  • 一般的な質問に対する答えはほとんど #FAQ に載っています。
  • /etc/makepkg.conf を調整することで、AUR からパッケージをビルドするときに、あなたの使用しているプロセッサに最適化することができます。マルチコアプロセッサを搭載しているシステム上では、MAKEFLAGS 変数を調整したり、圧縮に複数のコアを使ったり、別の圧縮アルゴリズムを使ったりすることで、パッケージのビルドタイムを劇的に短縮できる可能性があります。また、CFLAGS 変数を使うことでハードウェア固有のコンパイラ最適化を有効化することもできます。詳しくは makepkg#ヒントとテクニック を見てください。

また、SSH から AUR にアクセスすることもできます: 利用可能なコマンドをリストアップするには ssh aur@aur.archlinux.org help を入力してください。

パッケージをインストール・アップグレードする

AUR からパッケージをインストールする手順は比較的単純です。基本的には:

  1. ビルドファイルを取得する。PKGBUILD や、systemd ユニットやパッチなどの (しばしば、実際のコードではない) 他の必要なファイルを含みます。
  2. PKGBUILD とそれに付属しているファイルが、悪意のある、または信頼できないものでないことを検証する。
  3. それらのファイルが保存されているディレクトリ内で makepkg を実行する。これは、コードをダウンロードし、コンパイルし、パッケージングします。
  4. pacman -U package_file を実行し、パッケージをシステムにインストールする。

要件

まず、base-devel をインストールして、必須のツールをインストールしましょう。このメタパッケージには、ソースからコンパイルするために必要な make などのツールが依存パッケージとして含まれています。

ノート: AUR のパッケージは、base-devel がビルド環境にインストールされていることを想定しています。

次に、適切なビルドディレクトリを選択してください。ビルドディレクトリは、パッケージがソースから作成/ビルドされるディレクトリであり、任意のディレクトリを使うことができます。以下のセクションでは例として ~/builds をビルドディレクトリとして使用します。

ビルドファイルを取得する

AUR 内の対象パッケージの場所を特定します。AUR ホームページの検索フィールドを使って行うことができます。検索リスト内のアプリケーションの名前をクリックして、そのパッケージの情報ページを開きます。説明欄を読んで、それがあなたの求めているパッケージであることを確認してください。パッケージの最終更新日時とコメントも確認してください。

パッケージのビルドファイルを取得する方法は複数存在します:

  • そのパッケージの git リポジトリをクローンする。URL は、そのパッケージの AUR ページの「パッケージの詳細」の「Git クローン URL」にあります。これは推奨される方法です。利点としては、git pull を実行すれば、パッケージを簡単にアップデートできます。
$ git clone https://aur.archlinux.org/package_name.git
  • スナップショットをダウンロードする。パッケージの AUR ページの右側にある「パッケージアクション」内の「スナップショットのダウンロード」リンクをクリックするか、ターミナルで以下を実行してください:
$ curl -L -O https://aur.archlinux.org/cgit/aur.git/snapshot/package_name.tar.gz
ノート: スナップショットのファイルは圧縮されています。なので、展開する必要があります (できれば、AUR ビルド用のディレクトリ内で): tar -xvf package_name.tar.gz
  • archlinux/aur GitHub 上の読み取り専用ミラーを使う。1つのブランチ内に1つのパッケージが存在しています。1つのブランチのみをクローンすることが推奨されます (リポジトリ全体は大きすぎるので、パフォーマンスが低下するでしょう)。これを行う方法として、以下の2つがあります:
    • git clone --single-branch を使う:
      $ git clone --branch package_name --single-branch https://github.com/archlinux/aur.git
    • このリポジトリの部分クローンを行い (git clone --depth=1)、選択的にブランチを追加する:
$ git clone --depth=1 https://github.com/archlinux/aur.git; cd aur
$ git remote set-branches --add origin package_name
$ git fetch
$ git checkout package_name

必要であれば PGP 公開鍵を取得する

PKGBUILD の source 配列に .sig.asc という形式の署名ファイルがあるか確認してください。それがある場合、PKGBUILD の validpgpkeys 配列内にリストアップされている公開鍵のうち1つを取得してください。詳細は makepkg#署名チェック を参照してください。

パッケージをビルドする

パッケージの PKGBUILD が含まれているディレクトリに移動してください:

$ cd package_name
警告: PKGBUILD ファイルや .install ファイル、パッケージの git リポジトリ内のすべてのファイルを注意深く見て、悪意のある/危険なコマンドがないかチェックしてください。疑わしい場合、パッケージをビルドせずに、フォーラムやメーリングリストで助言を得ましょう。以前、悪意のあるコードがパッケージ内で見つかったことがあります。[1]

提供されているファイルすべての内容を確認してください。例えば、less を使って PKGBUILD を見るには:

$ less PKGBUILD
ヒント: パッケージをアップデートしようとしているならば、最後のコミットとの変更点を見るべきかもしれません。
  • 最後の git コミットとの変更点を見るには、git show を使うことができます。
  • vimdiff を使って最後のコミットとの変更点を見るには、git difftool @~..@ vimdiff を実行してください。vimdiff の利点は、何が変更されたかを示すインジケータと共に各ファイルの内容全体を見ることができることです。

パッケージを作成します。手動でファイルの内容を確認したあとで、makepkg を通常ユーザとして実行してください。いくつか便利なフラグがあります:

  • -s/--syncdeps は、ビルド前に自動的に依存関係を解決し、pacman を使って依存パッケージをインストールします。パッケージが他の AUR パッケージに依存している場合、まずその AUR パッケージを手動でインストールする必要があります。
  • -i/--install は、ビルドが成功した場合にパッケージをインストールします。このフラグを使えば、通常手動で行う次の手順をスキップすることができます。
  • -r/--rmdeps は、ビルド後に、ビルド時の依存パッケージを削除します (なぜなら、それらはもはや必要ないからです)。しかし、これらの依存パッケージは、パッケージがアップデートされたときに再インストールする必要があるでしょう。
  • -c/--clean は、ビルド後に一時ビルドファイルをクリーンアップします (なぜなら、それらはもはや必要ないからです)。通常、これらのファイルはビルドプロセスをデバッグするときにだけ必要になります。
ヒント: git clean -dfx を使えば、git によって追跡されていないファイルをすべて削除できます。つまり、以前ビルドされたパッケージをすべて削除します。

パッケージをインストールする

これで、pacman を使ってパッケージをインストールできます:

# pacman -U package_name-version-architecture.pkg.tar.zst
ノート:
  • makepkg.conf 内の PKGEXT を変更している場合、パッケージファイルの名前も若干異なる場合があります。
  • 上記の例は、ビルドプロセスの概略です。詳細は makepkgABS の記事を見ることを強く推奨します。

パッケージをアップグレードする

パッケージの PKGBUILD を含むディレクトリ内で、まず最初に以下のコマンドを使ってファイルと変更を更新しなければなりません:

$ git pull

次に、前述のビルドとインストールの指示に従ってください。

パッケージをアップデートする

AUR はサポート外のものなので、あなたがインストールしたパッケージは、pacman ではなく あなたの責任で アップデートすることになっています。公式リポジトリ内のパッケージがアップデートされた場合、それらのライブラリに依存している AUR パッケージをすべてビルドし直す必要があります。

アカウントステータス

休止 (Suspension)

Trusted User としてユーザを編集するとき、休止 (Suspended) フィールドをセットできます。これは、対象のユーザを休止させます。ユーザが休止しているとき、以下のことはできなくなります:

活動休止 (Inactivity)

あなた自身のアカウントを編集するときや、Trusted User としてユーザを編集するとき、活動休止 (Inactive) フィールドをセットできます。活動休止中のアカウントは2つの理由により使用されます:

  • アカウントページに活動休止になった日付を表示する。
  • 新しい提案のために、活動休止になっているかどうかで現在アクティブな Trusted User の数を生成する。

フィードバック

パッケージにコメントする

AUR ウェブインターフェイスにはコメント機能があり、PKGBUILD の貢献者にコメントで提案やフィードバックを提供することができます。

ヒント: コメント欄にパッチや PKGBUILD をペーストするのは避けてください。それらはすぐに古くなり、不必要にスペースを圧迫するだけになります。代わりに、それらのファイルをメンテナにメールするか、pastebin を使ってください。

Python-Markdown は、コメントをフォーマットする基本的な Markdown 構文を提供します。

ノート:
  • この実装は、公式の構文規則とは一部異なる場合があります。
  • パッケージの Git リポジトリへのコミットハッシュと、Flyspray チケットへの参照は、自動的にリンクに変換されます。
  • 長いコメントは短く表示され、必要に応じて全文を表示できます。

パッケージに投票する

すべての Arch ユーザにとって最も簡単なアクティビティの1つとして、AUR のオンラインインターフェイスによる AUR のブラウズや、お気に入りのパッケージへの投票があります。すべてのパッケージは、TU によってextra リポジトリに取り込まれる可能性があり、得票数はその過程で考慮されます。また、投票数はみんなが気にしていることでもあります。

パッケージのブラウジングで「このパッケージに投票する」オプションを利用できるようにするには、AUR のウェブサイトにサインアップしてください。サインアップ後、aurvoteAURaurvote-gitAURaur-auto-vote-gitAUR を使ってコマンドラインからも投票できるようになります。

あるいは、ssh 認証がセットアップ済みである場合、あなたの ssh 鍵を使ってコマンドラインから直接投票できます。これはつまり、AUR パスワードを保存・入力する手間が省けることを意味します。

$ ssh aur@aur.archlinux.org vote package_name

パッケージに out-of-date フラグを立てる

まず、そのパッケージに out-of-date フラグを立て、そのパッケージが out-of-date である理由の詳細や、できればリリースのアナウンスや新しいリリースの tarball へのリンクを含めてください。

また、メンテナに email で直接連絡を取ってみるべきです。2周間経ってもメンテナから応答がない場合、孤児リクエストを提出することができます。詳細は AUR 投稿ガイドライン#リクエスト を見てください。

ノート: VCS パッケージは、pkgver が変更されても、out-of-date とは見なされません。VCS パッケージにはフラグを建てないでください。立てても、メンテナは単にフラグを解除し、あなたを無視するでしょう。AUR メンテナは単なる pkgver のバージョンアップをコミットするべきではありません。

パッケージのビルドプロセスをデバッグする

  1. 何かをビルドする前にアップグレードしてビルド環境が最新であることを確認してください。
  2. base-devel がインストールされていることを確認してください。
  3. ビルドプロセスを始める前に、makepkg-s オプションを使って、必要とされているすべての依存関係をチェック・インストールしてください。
  4. デフォルトの makepkg の設定を試してください。
  5. 一般的な問題については Makepkg#トラブルシューティング を見てください。

パッケージのビルドで問題が発生する場合、まず、そのパッケージの PKGBUILD とそのパッケージの AUR ページのコメントを読んでください。

PKGBUILD が全員の環境で壊れている場合もあり得ます。ひとりで解決できない場合、問題をメンテナに報告してください (例えば、発生するエラーを AUR ページのコメント欄に投稿するなど)。また、AUR Issues, Discussion & PKGBUILD Requests フォーラムで助けを得ることもできるかもしれません。

結局、原因が些細なことではない場合もあります。カスタムの CFLAGSLDFLAGSMAKEFLAGS フラグは失敗を引き起こす可能性があります。あなたのシステム構成によって引き起こされる問題を回避するには、パッケージをクリーンな chroot 内でビルドしてください。ビルドプロセスがクリーンな chroot 内でも失敗する場合、原因はおそらく PKGBUILD にあるのでしょう。

namcap の使用に関しては パッケージの作成#パッケージの正常性のテスト を見てください。PKGBUILD をレビューしてもらいたいならば、aur-general メーリングリストに投稿して TU やフェロー AUR メンバーからフィードバックをもらうか、Creating & Modifying Packages フォーラムに投稿してください。また、Libera Chat ネットワーク上の IRC チャンネル #archlinux-aur で助けを乞うこともできます。

パッケージを投稿する

ユーザは、Arch User Repository を使って PKGBUILD を共有できます。詳細は AUR 投稿ガイドライン を見てください。

ウェブインターフェイスの翻訳

AUR ウェブインターフェイスの翻訳の作成とメンテナンスについては AUR ソースツリーの i18n.txt を見てください。

歴史

当初、ftp://ftp.archlinux.org/incoming というサーバーがあり、人々は PKGBUILD やビルドに必要なファイル、ビルド済みのパッケージをそのサーバにアップロードしていました。パッケージやそれに関連するファイルは、パッケージメンテナがプログラムを見て取り入れるまで、そこに置かれていました。

その後、Trusted User リポジトリが誕生しました。コミュニティの特定の個人が、誰でも使えるリポジトリをホストすることを許可されていました。これを基礎として、より柔軟に使いやすくするために拡張されたものが AUR です。今でも、AUR のメンテナは TU (Trusted User) と呼ばれます。

2015年6月8日から2015年8月8日までの間に AUR はバージョン 3.5.1 から 4.0.0 に移行し、PKGBUILD を公開するために Git リポジトリが使われるようになりました。 既存のパッケージは、メンテナによって新しいインフラに手動で移行されない限り、ドロップされました。

AUR3 パッケージの Git リポジトリ

GitHub 上の AUR Archive には、移行時に AUR3 内にあったすべてのパッケージが保存されているリポジトリです。 あるいは、同じものを提供する aur3-mirror リポジトリもあります。

FAQ

どのような種類のパッケージが AUR に置かれていますか?

AUR にあるパッケージはたんに"ビルドスクリプト"、つまり pacman 用にバイナリをビルドするレシピにすぎません。ほとんどの場合、有用性と範囲のガイドラインを条件として、コンテンツのライセンスの問題がない限り、すべてのものが置くことを許されています。他の場合、ダウンロードにリンクできない、つまり再配布が禁止されている時は、ソースとしてファイル名だけを使うことができます。よってパッケージをビルドするには、ユーザーによってビルドディレクトリにその制限されたソースを入れておく必要があります。どちらかわからない場合は、尋ねて下さい。

どうすれば AUR 内のパッケージに投票できますか?

#パッケージに投票する を見てください。

Trusted User / TU とは何ですか?

Trusted User (略して TU) とは、AUR と extra リポジトリを監督するように選ばれた人のことです。彼らは extra に入っている人気の PKGBUILD を管理していて、みんなで AUR を運営し続けています。

Arch User Repository と extra リポジトリの違いは何ですか?

Arch User Repository にはユーザーが投稿した全ての PKGBUILD が保存されており、利用するには手動で makepkg を使ってビルドしなくてはなりません。PKGBUILD にコミュニティの十分な関心が集まると、パッケージは extra リポジトリに移され TU が管理するバイナリパッケージとなり、pacman によってインストールできるようになります。

AUR の Hoge が古くなっています、どうするべきでしょうか?

#パッケージに out-of-date フラグを立てる を見てください。

その間、ローカルで PKGBUILD を自分で編集してパッケージをアップデートしてみることもできます。アップデートにビルドプロセスの変更が必要ない場合もあり、この場合、pkgversource 配列を更新するだけで十分です。

AUR の Hoge を makepkg でコンパイルすることができません。どうしたらいいですか?

何か些細なことを見逃しているのかもしれません。#パッケージのビルドプロセスをデバッグする を見てください。

ERROR: One or more PGP signatures could not be verified! この場合、どうすればよいですか?

最もあり得るのは、ダウンロードしたファイルを検証するために必要な公開鍵があなたの個人キーリング内に存在しないことです。詳細は Makepkg#署名チェック を見てください。

どうやって PKGBUILD を作るのですか?

AUR 投稿ガイドライン#投稿の規則 を見て、次に パッケージの作成 を見てください。

PKGBUILD を作って投稿したいと思っています。エラーがないか誰かチェックしてくれるでしょうか?

パッケージをレビューのために提出できるチャネルが複数存在します。#パッケージのビルドプロセスをデバッグする を見てください。

どうすれば PKGBUILD が extra リポジトリに移されるのですか?

通常、パッケージを extra リポジトリ に移すには最低 10 票必要です。しかし、TU がパッケージをサポートしたいと望んだときは、extra リポジトリに入ることがしばしばあります。

必要な最低投票数に到達することは唯一の要件ではありません。そのパッケージをメンテナンスしてもよいという TU がいなければなりません。たとえパッケージに数千もの投票があったとしても、TU は extra リポジトリにそのパケージを移す必要はないのです。

通常、非常に人気なパッケージが AUR に残っている理由としては:

  • Arch Linux のリポジトリ内にパッケージの他のバージョンがすでに存在するから
  • ライセンスで再配布が禁止されているから
  • そのパッケージが、ユーザによって投稿された PKGBUILD の取得を補助するものだから。AUR ヘルパー は、当然、サポートされていません

extra リポジトリにパッケージを入れるときのルール も見てください。

繰り返されるビルドプロセスを速めるにはどうすればよいですか?

Makepkg#コンパイル時間を短縮する を見てください。

foo と foo-git パッケージは何が違うのですか?

多くの AUR パッケージには安定バージョン ("stable") と開発バージョン ("unstable") が存在します。開発版のパッケージには大抵、バージョン管理システムを示す接尾辞が付いており、通常の使用を意図していません。しかし、それらは新しい機能やバグフィックスを提供している場合があります。

makepkg を実行した時、これらのパッケージは最新のソースをダウンロードするので、pkgver() は必ずしも上流と合っていません。同じく、これらのパッケージは、如何なる VCS ソースのチェックサムの確認もできません。

システムメンテナンス#実績のあるソフトウェアパッケージを使用する も見てください。

Foo が AUR から消えたのはなぜですか?

パッケージが TU によって引き取られ、現在は extra リポジトリ に存在している可能性があります。

また、投稿の規則に違反していたため、削除されてしまった可能性もあります。削除の理由は、aur-requests アーカイブ を見てください。

ノート: 削除されたパッケージの git リポジトリは、通常、利用可能なままになります。詳細は AUR 投稿ガイドライン#リクエスト を見てください。

そのパッケージが AUR3 に存在していた場合、AUR4 に移行されなかったのかもしれません。そのようなパッケージが保存されている場所である #AUR3 パッケージの Git リポジトリ を見てください。

インストール済みのパッケージが AUR から消えてしまっているかどうかを確かめるには?

最もシンプルな方法は、そのパッケージの AUR ページの HTTP ステータスをチェックすることです:

$ comm -23 <(pacman -Qqm | sort) <(curl https://aur.archlinux.org/packages.gz | gzip -cd | sort)

全ての AUR パッケージのリストを入手するには?

参照

翻訳ステータス: このページは en:Arch User Repository の翻訳バージョンです。最後の翻訳日は 2023-06-14 です。もし英語版に 変更 があれば、翻訳の同期を手伝うことができます。