クロスコンパイルツールパッケージガイドライン - 版の履歴

Kgx: 他言語へのリンクを追加

2023-06-28T08:42:57Z

他言語へのリンクを追加

← 古い版		2023年6月28日 (水) 17:42時点における版
1行目:		1行目:
	[[Category:パッケージ開発]]		[[Category:パッケージ開発]]
	[[en:Cross-compiling tools package guidelines]]		[[en:Cross-compiling tools package guidelines]]
			[[pt:Cross-compiling tools package guidelines]]
			[[ru:Cross-compiling tools package guidelines]]
	{{Package Guidelines}}		{{Package Guidelines}}

Kgx: その方法と理由を翻訳して追加

2023-06-28T08:40:25Z

その方法と理由を翻訳して追加

← 古い版		2023年6月28日 (水) 17:40時点における版
40行目:		40行目:

	== パッケージの名前 ==		== パッケージの名前 ==

	パッケージの名前の前に {{Ic\|cross-}} という単語は付けません (昔はそういった話もありましたが、パッケージの名前が長くなるという理由で公式パッケージには取り入れられませんでした)。パッケージ名には [https://wiki.debian.org/Multiarch/Tuples GNU triplet] によって付けられる名前を前に付けるだけでベンダーフィールドは入りませんしベンダーフィールドを "unknown" としたりはしません。例: {{Ic\|arm-linux-gnueabihf-gcc}}。さらに短い名前を付ける例もありますが (例: {{Ic\|mips-gcc}})、推奨されません。		パッケージの名前の前に {{Ic\|cross-}} という単語は付けません (昔はそういった話もありましたが、パッケージの名前が長くなるという理由で公式パッケージには取り入れられませんでした)。パッケージ名には [https://wiki.debian.org/Multiarch/Tuples GNU triplet] によって付けられる名前を前に付けるだけでベンダーフィールドは入りませんしベンダーフィールドを "unknown" としたりはしません。例: {{Ic\|arm-linux-gnueabihf-gcc}}。さらに短い名前を付ける例もありますが (例: {{Ic\|mips-gcc}})、推奨されません。

	== ファイルの保存場所 ==		== ファイルの保存場所 ==

	最新版の gcc や binutils は sysroot やライブラリのパスが衝突することはありません。実行ファイルは {{Ic\|/usr/bin/}} に置くことができます。衝突しないように実行ファイルにはアーキテクチャの名前を前に付けます。		最新版の gcc や binutils は sysroot やライブラリのパスが衝突することはありません。実行ファイルは {{Ic\|/usr/bin/}} に置くことができます。衝突しないように実行ファイルにはアーキテクチャの名前を前に付けます。

57行目:		59行目:

	== サンプル ==		== サンプル ==

	以下は MinGW 用の binutils の PKGBUILD です。特に参考になる点は:		以下は MinGW 用の binutils の PKGBUILD です。特に参考になる点は:
	*クロス環境のルートディレクトリを指定しています。		*クロス環境のルートディレクトリを指定しています。
102行目:		105行目:

	{{Note\|クロスコンパイルのツールチェインをビルドするときは専用のディレクトリから {{Ic\|configure}} と '''make''' コマンドを実行するようにして (いわゆる out-of-tree コンパイル)、[[PKGBUILD]] に変更を加えた後は {{Ic\|src}} ディレクトリを削除してください。}}		{{Note\|クロスコンパイルのツールチェインをビルドするときは専用のディレクトリから {{Ic\|configure}} と '''make''' コマンドを実行するようにして (いわゆる out-of-tree コンパイル)、[[PKGBUILD]] に変更を加えた後は {{Ic\|src}} ディレクトリを削除してください。}}

			== その方法と理由 ==

			=== /opt にインストールしない理由 ===

			2 つの理由:

			# まず、ファイル階層標準によれば、これらのファイルは {{ic\|/usr}} のどこかに属しているだけです。
			# 次に、{{ic\|/opt}} へのインストールは、他に選択肢がない場合の最後の手段です。

			=== "パス外の実行可能ファイル" とは何ですか? ===

			この奇妙な機能により、クロスコンパイルが容易になります。場合によっては、プロジェクト Makefile が {{ic\|CC}} & co を使用しないことがあります。変数を使用せず、代わりに '''gcc''' を直接使用してください。このようなプロジェクトをクロスコンパイルしたいだけの場合、Makefile の編集は非常に時間がかかる操作になる可能性があります。ただし、最初に ''私たちの'' 実行可能ファイルを使用するように {{ic\|$PATH}} を変更するのが非常に簡単な解決策です。次に、{{ic\|make}} の代わりに {{ic\|1=PATH=/usr/''arch''/bin/:$PATH make}} を実行します。

	== トラブルシューティング ==		== トラブルシューティング ==

Kusakata.bot2: Pkg/AUR テンプレートの更新

2020-12-31T05:48:47Z

Pkg/AUR テンプレートの更新

← 古い版		2020年12月31日 (木) 14:48時点における版
9行目:		9行目:
	== 特記事項 ==		== 特記事項 ==
	このページでは {{Ic\|[community]}} に入っている以下のパッケージに基づいた、新しいパッケージ方法を説明しています:		このページでは {{Ic\|[community]}} に入っている以下のパッケージに基づいた、新しいパッケージ方法を説明しています:
	{{~~AUR~~\|mingw-w64-gcc}} などの {{Ic\|mingw-w64-}} シリーズのパッケージ		{{Pkg\|mingw-w64-gcc}} などの {{Ic\|mingw-w64-}} シリーズのパッケージ
	{{Pkg\|arm-none-eabi-gcc}} などの {{Ic\|arm-none-eabi-}} シリーズのパッケージ		{{Pkg\|arm-none-eabi-gcc}} などの {{Ic\|arm-none-eabi-}} シリーズのパッケージ
	{{AUR\|arm-wince-cegcc-gcc}}{{Broken package link\|{{aur-mirror\|arm-wince-cegcc-gcc}}}} などの {{Ic\|arm-wince-cegcc-}} シリーズのパッケージ		{{AUR\|arm-wince-cegcc-gcc}}{{Broken package link\|{{aur-mirror\|arm-wince-cegcc-gcc}}}} などの {{Ic\|arm-wince-cegcc-}} シリーズのパッケージ

Kusakata.bot: 文字列「http://wiki.debian.org/」を「https://wiki.debian.org/」に置換

2018-02-06T14:44:50Z

文字列「http://wiki.debian.org/」を「https://wiki.debian.org/」に置換

← 古い版		2018年2月6日 (火) 23:44時点における版
40行目:		40行目:

	== パッケージの名前 ==		== パッケージの名前 ==
	パッケージの名前の前に {{Ic\|cross-}} という単語は付けません (昔はそういった話もありましたが、パッケージの名前が長くなるという理由で公式パッケージには取り入れられませんでした)。パッケージ名には [~~http~~://wiki.debian.org/Multiarch/Tuples GNU triplet] によって付けられる名前を前に付けるだけでベンダーフィールドは入りませんしベンダーフィールドを "unknown" としたりはしません。例: {{Ic\|arm-linux-gnueabihf-gcc}}。さらに短い名前を付ける例もありますが (例: {{Ic\|mips-gcc}})、推奨されません。		パッケージの名前の前に {{Ic\|cross-}} という単語は付けません (昔はそういった話もありましたが、パッケージの名前が長くなるという理由で公式パッケージには取り入れられませんでした)。パッケージ名には [https://wiki.debian.org/Multiarch/Tuples GNU triplet] によって付けられる名前を前に付けるだけでベンダーフィールドは入りませんしベンダーフィールドを "unknown" としたりはしません。例: {{Ic\|arm-linux-gnueabihf-gcc}}。さらに短い名前を付ける例もありますが (例: {{Ic\|mips-gcc}})、推奨されません。

	== ファイルの保存場所 ==		== ファイルの保存場所 ==

Kusakata.bot: 文字列「http://www.gnu.org/」を「https://www.gnu.org/」に置換

2018-02-06T14:08:14Z

文字列「http://www.gnu.org/」を「https://www.gnu.org/」に置換

← 古い版		2018年2月6日 (火) 23:08時点における版
76行目:		76行目:
	pkgdesc="MinGW Windows binutils"		pkgdesc="MinGW Windows binutils"
	arch=('i686' 'x86_64')		arch=('i686' 'x86_64')
	url="~~http~~://www.gnu.org/software/binutils/"		url="https://www.gnu.org/software/binutils/"
	license=('GPL')		license=('GPL')
	depends=('glibc>=2.10.1' 'zlib')		depends=('glibc>=2.10.1' 'zlib')

Kusakata.bot: Pkg/AUR テンプレートの更新

2018-01-18T13:04:47Z

Pkg/AUR テンプレートの更新

← 古い版		2018年1月18日 (木) 22:04時点における版
9行目:		9行目:
	== 特記事項 ==		== 特記事項 ==
	このページでは {{Ic\|[community]}} に入っている以下のパッケージに基づいた、新しいパッケージ方法を説明しています:		このページでは {{Ic\|[community]}} に入っている以下のパッケージに基づいた、新しいパッケージ方法を説明しています:
	{{~~Pkg~~\|mingw-w64-gcc}} などの {{Ic\|mingw-w64-}} シリーズのパッケージ		{{AUR\|mingw-w64-gcc}} などの {{Ic\|mingw-w64-}} シリーズのパッケージ
	{{Pkg\|arm-none-eabi-gcc}} などの {{Ic\|arm-none-eabi-}} シリーズのパッケージ		{{Pkg\|arm-none-eabi-gcc}} などの {{Ic\|arm-none-eabi-}} シリーズのパッケージ
	{{AUR\|arm-wince-cegcc-gcc}}{{Broken package link\|{{aur-mirror\|arm-wince-cegcc-gcc}}}} などの {{Ic\|arm-wince-cegcc-}} シリーズのパッケージ		{{AUR\|arm-wince-cegcc-gcc}}{{Broken package link\|{{aur-mirror\|arm-wince-cegcc-gcc}}}} などの {{Ic\|arm-wince-cegcc-}} シリーズのパッケージ

Kusakata: 翻訳

2016-11-11T12:43:06Z

翻訳

新規ページ

[[Category:パッケージ開発]]
[[en:Cross-compiling tools package guidelines]]
{{Package Guidelines}}

__TOC__

{{Tip|クロスコンパイラのパッケージを作成しなくても [http://crosstool-ng.org/ crosstool-ng] を使えば自分用のツールチェインを自動で作成することができます。crosstool-ng は {{AUR|crosstool-ng}} パッケージでインストールできます。}}

== 特記事項 ==
このページでは {{Ic|[community]}} に入っている以下のパッケージに基づいた、新しいパッケージ方法を説明しています:
*{{Pkg|mingw-w64-gcc}} などの {{Ic|mingw-w64-*}} シリーズのパッケージ
*{{Pkg|arm-none-eabi-gcc}} などの {{Ic|arm-none-eabi-*}} シリーズのパッケージ
*{{AUR|arm-wince-cegcc-gcc}}{{Broken package link|{{aur-mirror|arm-wince-cegcc-gcc}}}} などの {{Ic|arm-wince-cegcc-*}} シリーズのパッケージ

== バージョン互換性 ==
{{Warning|互換性がないバージョンのパッケージを使用してツールチェインをコンパイルすると必ず問題が起きます。基本的には全てのバージョンに互換性がないと考えてください。}}

以下の方針に従うことで互換性のあるバージョンの gcc, binutils, カーネル, C ライブラリを選択できます:
*一般的なルール:
**gcc と binutils のリリースには相関関係があります。同時にリリースされたバージョンを使ってください。
**libc をコンパイルするときは最新のカーネルヘッダーを使用したほうが良いですが {{Ic|--enable-kernel}} スイッチを使うことで古いカーネルでも動作するようになります (あくまで glibc の話で、他の C ライブラリでは事情が異なります)。
*[[公式リポジトリ]]: 修正や変更を加える必要がある場合もありますが、基本的には Arch Linux が使用しているバージョンを使うほうが動作する可能性が高くなります。
*ソフトウェアドキュメント: 全ての GNU ソフトウェアには {{Ic|README}} と {{Ic|NEWS}} ファイルが存在し、最低要件として必要とするソフトウェアのバージョンなどが記載されています。
*他のディストリビューション: 他のディストリビューションもクロスコンパイラを行っています。
*http://clfs.org にはクロスコンパイラをビルドするのに必要な手順や最新バージョンについて説明があります。

== クロスコンパイラのビルド ==
クロスコンパイラは一般的に以下の手順でビルドされます:
#binutils: クロスコンパイル用の binutils をビルド。
#headers: ターゲットアーキテクチャの C ライブラリとカーネルヘッダをインストール。
## リファレンスヘッダーとして {{Pkg|linux-api-headers}} を使用して '''make''' に {{Ic|1=ARCH=''target-architecture''}} と指定してください。
## libc ヘッダーパッケージの作成 (Glibc の場合は [http://sources.redhat.com/ml/crossgcc/2003-06/msg00170.html こちら] に手順が書かれています)。
#gcc-stage-1: 基本の (stage 1) gcc クロスコンパイラをビルド。C ライブラリをコンパイルするのに使用します。C ライブラリ以外のものをビルドすることはできません (C ライブラリが使えないため)。
#libc: クロスコンパイル用の C ライブラリをビルド (stage 1 のクロスコンパイラを使用)。
#gcc-stage-2: 完全な (stage 2) C クロスコンパイラをビルド。

ヘッダーや libc のソースはプラットフォームによって変わります。

{{Tip|あなたが何をしたいかによって実際の作業は大きく違ってきます。例えば、Arch Linux とカーネルや glibc のバージョンが同じであるクローン環境を作成したいのであれば、ヘッダーをビルドしたり {{Ic|configure}} に {{Ic|1=--with-build-sysroot=/}} と指定する手順は省けます。}}

== パッケージの名前 ==
パッケージの名前の前に {{Ic|cross-}} という単語は付けません (昔はそういった話もありましたが、パッケージの名前が長くなるという理由で公式パッケージには取り入れられませんでした)。パッケージ名には [http://wiki.debian.org/Multiarch/Tuples GNU triplet] によって付けられる名前を前に付けるだけでベンダーフィールドは入りませんしベンダーフィールドを "unknown" としたりはしません。例: {{Ic|arm-linux-gnueabihf-gcc}}。さらに短い名前を付ける例もありますが (例: {{Ic|mips-gcc}})、推奨されません。

== ファイルの保存場所 ==
最新版の gcc や binutils は sysroot やライブラリのパスが衝突することはありません。実行ファイルは {{Ic|/usr/bin/}} に置くことができます。衝突しないように実行ファイルにはアーキテクチャの名前を前に付けます。

基本的に {{Ic|./configure}} には最低でも以下のパラメータが必要です:

{{Bc|1=
_target=<your-target> # e.g. i686-pc-mingw32
_sysroot=/usr/lib/${_target}
...
./configure \
--prefix=${_sysroot} --sysroot=${_sysroot} \
--bindir=/usr/bin
}}

== サンプル ==
以下は MinGW 用の binutils の PKGBUILD です。特に参考になる点は:
*クロス環境のルートディレクトリを指定しています。
*{{Ic|${_pkgname} }}, {{Ic|${_target} }}, {{Ic|${_sysroot} }} 変数を使用してコードを読みやすいようにしています。
*重複・衝突するファイルを消しています。

{{bc|<nowiki>
# Maintainer: Allan McRae <allan@archlinux.org>

# cross toolchain build order: binutils, headers, gcc (pass 1), w32api, mingwrt, gcc (pass 2)

_target=i686-pc-mingw32
_sysroot=/usr/lib/${_target}

pkgname=${_target}-binutils
_pkgname=binutils
pkgver=2.19.1
pkgrel=1
pkgdesc="MinGW Windows binutils"
arch=('i686' 'x86_64')
url="http://www.gnu.org/software/binutils/"
license=('GPL')
depends=('glibc>=2.10.1' 'zlib')
options=('!libtool' '!distcc' '!ccache')
source=(http://ftp.gnu.org/gnu/${_pkgname}/${_pkgname}-${pkgver}.tar.bz2)
md5sums=('09a8c5821a2dfdbb20665bc0bd680791')

build() {
cd ${srcdir}/${_pkgname}-${pkgver}
mkdir binutils-build && cd binutils-build

../configure --prefix=${_sysroot} --bindir=/usr/bin \
--with-sysroot=${_sysroot} \
--build=$CHOST --host=$CHOST --target=${_target} \
--with-gcc --with-gnu-as --with-gnu-ld \
--enable-shared --without-included-gettext \
--disable-nls --disable-debug --disable-win32-registry
make
make DESTDIR=${pkgdir}/ install

# clean-up cross compiler root
rm -r ${pkgdir}/${_sysroot}/{info,man}
}
</nowiki>}}

{{Note|クロスコンパイルのツールチェインをビルドするときは専用のディレクトリから {{Ic|configure}} と '''make''' コマンドを実行するようにして (いわゆる out-of-tree コンパイル)、[[PKGBUILD]] に変更を加えた後は {{Ic|src}} ディレクトリを削除してください。}}

== トラブルシューティング ==

=== コンパイルが失敗したときのメッセージの意味がわからない ===

{{Ic|configure}} の実行時に発生するエラーについては {{Ic|$srcdir/''pkgname''-build/config.log}} を読んでください。コンパイル時に発生するエラーについてはコンソールのログを上まで見るか "error" という単語で検索するしかありません。

=== よくあるエラーの原因 ===

* コンパイルフラグが多すぎるか少なすぎる。問題ないとわかっているフラグを使ってみてください。
* 依存関係が壊れている。例えば binutils のファイルが欠けていたり保存場所が間違っていると gcc の configure 時に謎めいたエラーが発生します。
* {{Ic|build()}} 関数に {{Ic|1=export CFLAGS=""}} を追加していない (GCC Bugzilla の [http://gcc.gnu.org/bugzilla/show_bug.cgi?id=25672 bug 25672] を参照)。
* {{Ic|--prefix}}/{{Ic|--with-sysroot}} で指定したディレクトリに書き込む権限がない (clfs のガイドでわかりにくいところです)。
* sysroot にカーネルや libc のヘッダーが存在しない。
* Google で検索しても解決しない場合、今の構成を諦めて、もっと安定している、動作することが確認されている設定を使ってみてください。

=== ファイルが間違った場所にインストールされる ===

{{Ic|make install}} を実行するときの作法は様々であり結果も違います。例えば、プラットフォームによっては {{Ic|DESTDIR}} がサポートされておらず代わりに {{Ic|install_root}} を使う必要があります。{{Ic|tooldir}} や {{Ic|prefix}} などの引数も同じです。環境変数のかわりに引数としてパラメータを指定することもあります。例えば以下のようにするところを:
CC=arm-elf-gcc ./configure
以下のように実行することがあります:
./configure CC=arm-elf-gcc
逆にすることでコンパイル結果が変わります (configure/make が再帰的に自己実行されることが原因です)。

== 参照 ==
* http://wiki.osdev.org/GCC_Cross-Compiler