Cross-compiling tools package guidelines (Русский)
32-bit – CLR – CMake – Cross – DKMS – Eclipse – Electron – Font – Free Pascal – GNOME – Go – Haskell – Java – KDE – Kernel – Lisp – Meson – MinGW – Node.js – Nonfree – OCaml – Perl – PHP – Python – R – Ruby – Rust – Shell – VCS – Web – Wine
Данная статья описывает создание пакетов с инструментами для кросс-компиляции. Другим способом кросс-компиляции является использование distcc на смешанных архитектурах. Смотрите distcc#Cross compiling with distcc.
Важная заметка
На этой странице описан новый принцип работы, основанный на следующих пакетах:
- mingw-w64-gcc и другие пакеты из
mingw-w64-*
серии - arm-none-eabi-gcc и другие пакеты из
arm-none-eabi-*
серии - другие пакеты из
arm-wince-cegcc-*
серии
Совместимость версий
Следующая стратегия позволяют выбирать совместимые версии gcc, binutils, ядра и библиотеки C:
- Основные правила:
- существует корреляция между выпусками gcc и binutils, используйте одновременно выпущенные версии;
- лучше использовать последние заголовки ядра для компиляции libc, но использовать переключатель
--enable-kernel
(специфично для glibc, другие библиотеки C могут использовать другие соглашения) для обеспечения работы на старых ядрах;
- Официальные репозитории: вам, возможно, придётся использовать дополнительные исправления и хаки, но версии, используемые в Arch Linux (или специфичные ответвления для архитектуры), скорее всего, можно заставить работать вместе;
- Документация по программному обеспечению: все программы GNU имеют файлы
README
иNEWS
, документирующие такие вещи, как минимально необходимые зависимости; - Другие дистрибутивы: они тоже делают кросс-компиляцию
- https://trac.clfs.org описывает шаги, необходимые для сборки кросс-компилятора, и упоминает несколько актуальных версий зависимостей.
Сборка кросс-компилятора
Общий подход к созданию кросс-компилятора:
- binutils: Создание cross-binutils, которая связывает и обрабатывает для целевой архитектуры
- headers: Установите набор библиотеки C и заголовками ядра для целевой архитектуры
- используйте linux-api-headers в качестве образца и передайте
ARCH=target-architecture
для make - создайте пакет заголовков libc (для Glibc процесс описан здесь)
- используйте linux-api-headers в качестве образца и передайте
- gcc-stage-1: Создайте базовый (этап 1) gcc кросс-компилятор. Будет использоваться для компиляции библиотеки C. Он не сможет собирать почти что угодно другое (потому что он не сможет слинковаться с библиотекой C, которой на данном этапе ещё нет).
- libc: Соберите библиотеку C (используя кросс-компилятор из этапа 1).
- gcc-stage-2: Сборка полного кросс-компилятора C (этап 2)
Источник заголовков и libc будет отличаться для разных платформ.
--with-build-sysroot=/
в configure
.Наименование пакета
В имени пакета не должно быть префикса со словом cross-
(было предложено ранее, но не было принято в официальных пакетах, возможно, из-за дополнительной длины имен), и должно состоять из имени пакета с префиксом GNU triplet без поля поставщика или со значением "unknown" в поле поставщика; пример: arm-linux-gnueabihf-gcc
. Если существует более короткое соглашение об именах (например, mips-gcc
), его можно использовать, но это не рекомендуется.
Размещение файлов
Последние версии gcc и binutils используют не конфликтующие пути для sysroot и библиотек. Исполняемые файлы должны быть помещены в /usr/bin/
, чтобы предотвратить возникновение конфликтов, перед всеми ними необходимо указать префикс имени архитектуры.
Как правило, ./configure
будет иметь по крайней мере следующие параметры:
_target=your_target _sysroot=/usr/lib/${_target} ... ./configure \ --prefix=${_sysroot} \ --sysroot=${_sysroot} \ --bindir=/usr/bin
где your_target
может быть, например, "i686-pc-mingw32".
Пример
Это PKGBUILD для binutils для MinGW. Вещи, на которые стоит обратить внимание:
- указание корневого каталога кросс-окружения
- использование переменных
${_pkgname}
,${_target}
и${_sysroot}
, чтобы сделать код более читабельным - удаление дублированных / конфликтующих файлов
# 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} }
configure
и make в отдельном каталоге (out-of-tree compilation) и удаляйте весь каталог src
после малейшего изменения в PKGBUILD.Как и почему
Почему бы не устанавливать в /opt
Две причины:
- Во-первых, согласно File Hierarchy Standard, эти файлы просто должны быть в
/usr
. И точка! - Во-вторых, установка в
/opt
является крайней мерой, когда других вариантов нет.
Что за "out-of-path executables"?
Размещение исполняемых файлов за пределами path — эта такая странная штука, которая облегчает кросс-компиляцию. В некоторых проектах Makefile не использует CC
и другие подобные переменные, а вместо них напрямую используют gcc. Если вы просто хотите попробовать выполнить кросс-компиляцию такого проекта, то редактирование Makefile может оказаться весьма долгой операцией. Однако изменение $PATH
на использование в первую очередь «наших» исполняемых файлов — очень быстрое решение. Вместо простого make
можно запустить что-то вроде PATH=/usr/архитектура/bin/:$PATH make
, и тогда при сборке будет использоваться инструментарий кросс-компиляции.
Решение проблем
Что делать, если компиляция не удалась без внятного сообщения об ошибке?
Если ошибка возникла во время выполнения configure
, почитайте $srcdir/pkgname-build/config.log
. Для ошибки, произошедшей во время компиляции, прокрутите лог консоли вверх или поищите слово "error".
Что означает эта ошибка [error message]?
Скорее всего, вы допустили некоторые неочевидные ошибки:
- Слишком много или слишком мало флагов конфигурации. Попробуйте использовать уже проверенный набор флагов.
- Зависимости повреждены. Например, отсутствующие или размещённые не там файлы binutils могут привести к загадочной ошибке во время настройки gcc.
- Вы не добавили
export CFLAGS=""
в свою функциюbuild()
(см. bug 25672 в GCC Bugzilla). - Для некоторых комбинаций
--prefix
/--with-sysroot
может потребоваться, чтобы каталоги были доступны для записи (что не очевидно из руководства clfs). - В sysroot нет заголовков ядра или libc.
- Если вдумчивое гугление не помогает, отмените текущую конфигурацию и попробуйте более стабильную/проверенную.
Почему файлы устанавливаются в неправильных местах?
Различные методы запуска make install
приводят к разным результатам. Например, некоторые цели make могут не обеспечивать поддержку DESTDIR
, а вместо этого требуют использования install_root
. То же самое для tooldir
, prefix
и других подобных аргументов. Иногда предоставление параметров в качестве аргументов вместо переменных окружения, например
./configure CC=arm-elf-gcc
вместо
CC=arm-elf-gcc ./configure
и наоборот, может привести к различным результатам (часто вызванным рекурсивным самовывозом configure/make).