mirror of
https://github.com/bensuperpc/dockcross.git
synced 2025-06-18 17:09:25 +02:00
Compare commits
1 Commits
add_new_te
...
add_buildr
| Author | SHA1 | Date | |
|---|---|---|---|
| 3fd7ed4337 |
6
.github/workflows/main.yml
vendored
6
.github/workflows/main.yml
vendored
@ -53,9 +53,9 @@ jobs:
|
||||
linux-x64-clang, linux-s390x, linux-x64, linux-x86,
|
||||
linux-mips, linux-ppc64le, web-wasm,
|
||||
manylinux2014-x64, manylinux2014-x86,
|
||||
windows-static-x64, windows-static-x64-posix, windows-static-x86, windows-armv7,
|
||||
windows-shared-x64, windows-shared-x64-posix, windows-shared-x86, windows-arm64,
|
||||
linux-riscv64, linux-riscv32, linux-m68k-uclibc, linux-xtensa-uclibc, linux-x64-tinycc]
|
||||
windows-static-x64, windows-static-x64-posix, windows-static-x86,
|
||||
windows-shared-x64, windows-shared-x64-posix, windows-shared-x86,
|
||||
linux-riscv64, linux-riscv32, linux-m68k-uclibc, linux-xtensa-uclibc]
|
||||
steps:
|
||||
- uses: actions/checkout@v2
|
||||
- uses: actions/download-artifact@v2
|
||||
|
||||
10
Makefile
10
Makefile
@ -15,24 +15,24 @@ BIN = ./bin
|
||||
# These images are built using the "build implicit rule"
|
||||
STANDARD_IMAGES = android-arm android-arm64 android-x86 android-x86_64 \
|
||||
linux-x86 linux-x64 linux-x64-clang linux-arm64 linux-arm64-musl linux-arm64-full \
|
||||
linux-armv5 linux-armv5-musl linux-m68k-uclibc linux-s390x linux-x64-tinycc \
|
||||
linux-armv5 linux-armv5-musl linux-m68k-uclibc linux-s390x \
|
||||
linux-armv6 linux-armv6-lts linux-armv6-musl \
|
||||
linux-armv7l-musl linux-armv7 linux-armv7a \
|
||||
linux-mips linux-ppc64le linux-riscv64 linux-riscv32 linux-xtensa-uclibc \
|
||||
windows-static-x86 windows-static-x64 windows-static-x64-posix windows-armv7 \
|
||||
windows-shared-x86 windows-shared-x64 windows-shared-x64-posix windows-arm64
|
||||
windows-static-x86 windows-static-x64 windows-static-x64-posix \
|
||||
windows-shared-x86 windows-shared-x64 windows-shared-x64-posix
|
||||
|
||||
# Generated Dockerfiles.
|
||||
GEN_IMAGES = android-arm android-arm64 \
|
||||
linux-x86 linux-x64 linux-x64-clang linux-arm64 linux-arm64-musl linux-arm64-full \
|
||||
manylinux2014-x64 manylinux2014-x86 \
|
||||
web-wasm linux-mips windows-arm64 windows-armv7 \
|
||||
web-wasm linux-mips \
|
||||
windows-static-x86 windows-static-x64 windows-static-x64-posix \
|
||||
windows-shared-x86 windows-shared-x64 windows-shared-x64-posix \
|
||||
linux-armv7 linux-armv7a linux-armv7l-musl \
|
||||
linux-armv6 linux-armv6-lts linux-armv6-musl \
|
||||
linux-armv5 linux-armv5-musl linux-ppc64le linux-s390x \
|
||||
linux-riscv64 linux-riscv32 linux-m68k-uclibc linux-x64-tinycc linux-xtensa-uclibc
|
||||
linux-riscv64 linux-riscv32 linux-m68k-uclibc linux-xtensa-uclibc
|
||||
|
||||
GEN_IMAGE_DOCKERFILES = $(addsuffix /Dockerfile,$(GEN_IMAGES))
|
||||
|
||||
|
||||
48
README.md
48
README.md
@ -13,14 +13,13 @@ Cross compiling toolchains in Docker images.
|
||||
- Most images also contain an emulator for the target system.
|
||||
- Clean separation of build tools, source code, and build artifacts.
|
||||
- Commands in the container are run as the calling user, so that any created files have the expected ownership, (i.e. not root).
|
||||
- Make variables **CC**, **CXX**, **LD**, **AS** etc) are set to point to the appropriate tools in the container.
|
||||
- Make variables **CC**, **CXX**, **LD** etc) are set to point to the appropriate tools in the container.
|
||||
- Recent [CMake](https://cmake.org) and ninja are precompiled.
|
||||
- [Conan.io](https://www.conan.io) can be used as a package manager.
|
||||
- Toolchain files configured for CMake.
|
||||
- Current directory is mounted as the container\'s workdir, `/work`.
|
||||
- Works with the [Docker for Mac](https://docs.docker.com/docker-for-mac/) and [Docker for Windows](https://docs.docker.com/docker-for-windows/).
|
||||
- Support using alternative container executor by setting **OCI_EXE** environment variable. By default, it searches for [docker](https://www.docker.com) and [podman](https://podman.io) executable.
|
||||
- [crosstool-ng](https://github.com/crosstool-ng/crosstool-ng) and [buildroot](https://github.com/buildroot/buildroot) configuration files.
|
||||
|
||||
## Examples
|
||||
|
||||
@ -41,32 +40,26 @@ This image does not need to be run manually. Instead, there is a helper script t
|
||||
|
||||
To install the helper script, run one of the images with no arguments, and redirect the output to a file:
|
||||
|
||||
```bash
|
||||
docker run --rm CROSS_COMPILER_IMAGE_NAME > ./dockcross
|
||||
chmod +x ./dockcross
|
||||
mv ./dockcross ~/bin/
|
||||
```
|
||||
|
||||
Where **CROSS_COMPILER_IMAGE_NAME** is the name of the cross-compiler toolchain Docker instance, e.g: **dockcross/linux-armv7**.
|
||||
|
||||
Only 64-bit x86_64 images are provided, a 64-bit x86_64 host system is required.
|
||||
Only 64-bit x86_64 images are provided; a 64-bit x86_64 host system is required.
|
||||
|
||||
## Usage
|
||||
|
||||
For the impatient, here\'s how to compile a hello world for armv7:
|
||||
|
||||
```bash
|
||||
cd ~/src/dockcross
|
||||
docker run --rm dockcross/linux-armv7 > ./dockcross-linux-armv7
|
||||
chmod +x ./dockcross-linux-armv7
|
||||
./dockcross-linux-armv7 bash -c '$CC test/C/hello.c -o hello_arm'
|
||||
```
|
||||
|
||||
Note how invoking any toolchain command (make, gcc, etc.) is just a matter of prepending the **dockcross** script on the commandline:
|
||||
|
||||
```bash
|
||||
./dockcross-linux-armv7 [command] [args...]
|
||||
```
|
||||
|
||||
The dockcross script will execute the given command-line inside the container, along with all arguments passed after the command. Commands that evaluate environmental variables in the image, like **$CC** or **$CXX** above, should be executed in [bash -c]. The present working directory is mounted within the image, which can be used to make source code available in the Docker container.
|
||||
|
||||
@ -80,7 +73,6 @@ The dockcross script will execute the given command-line inside the container, a
|
||||
| dockcross/android-x86 | x86 | Clang | Android |
|
||||
| dockcross/android-x86_64 | x86_64 | Clang | Android |
|
||||
| dockcross/linux-arm64 | ARMv8 | GCC | Linux |
|
||||
| dockcross/linux-arm64-full | ARMv8 | GCC | Linux |
|
||||
| dockcross/linux-arm64-musl | ARMv8 | GCC + musl | Linux |
|
||||
| dockcross/linux-armv5 | ARMv5 | GCC | Linux |
|
||||
| dockcross/linux-armv5-musl | ARMv5 | GCC + musl | Linux |
|
||||
@ -102,7 +94,6 @@ The dockcross script will execute the given command-line inside the container, a
|
||||
| dockcross/linux-x86 | x86 | GCC | Linux |
|
||||
| dockcross/linux-x64 | x86_64 | GCC | Linux |
|
||||
| dockcross/linux-x64-clang | x86_64 | Clang | Linux |
|
||||
| dockcross/linux-x64-tinycc | x86_64 | tcc + GCC | Linux |
|
||||
| dockcross/web-wasm | JS | LLVM | Web (JS) |
|
||||
| dockcross/windows-shared-x86 | x86 | GCC | Windows |
|
||||
| dockcross/windows-shared-x64 | x86_64 | GCC | Windows |
|
||||
@ -110,8 +101,6 @@ The dockcross script will execute the given command-line inside the container, a
|
||||
| dockcross/windows-static-x86 | x86 | GCC | Windows |
|
||||
| dockcross/windows-static-x64 | x86_64 | GCC | Windows |
|
||||
| dockcross/windows-static-x64-posix | x86_64 | GCC | Windows |
|
||||
| dockcross/windows-armv7 | ARMv7 | Clang | Windows |
|
||||
| dockcross/windows-arm64 | ARMv8 | Clang | Windows |
|
||||
|
||||
## Cross compilers
|
||||
|
||||
@ -151,12 +140,6 @@ The Android NDK standalone toolchain for the x86_64 architecture.
|
||||
|
||||
Cross compiler for the 64-bit ARM platform on Linux, also known as AArch64.
|
||||
|
||||
### dockcross/linux-arm64-full
|
||||
|
||||
 
|
||||
|
||||
Cross compiler for the 64-bit ARM platform on Linux, with cross-libs: SDL2, OpenSSL, Boost, OpenCV and Qt5 (minimal).
|
||||
|
||||
### dockcross/linux-arm64-musl
|
||||
|
||||
 
|
||||
@ -272,12 +255,6 @@ Linux clang x86_64/amd64 compiler. Since the Docker image is natively x86_64, th
|
||||
|
||||
Linux i686 cross compiler.
|
||||
|
||||
### dockcross/linux-x64-tinycc
|
||||
|
||||
 
|
||||
|
||||
Linux tcc compiler for C compiler, and GCC for C++ compiler, for linux x86_64/amd64 arch.
|
||||
|
||||
### dockcross/manylinux2014-x64
|
||||
|
||||
 
|
||||
@ -334,18 +311,6 @@ linking.
|
||||
|
||||
32-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with win32 threads and dynamic linking.
|
||||
|
||||
### dockcross/windows-armv7
|
||||
|
||||
 
|
||||
|
||||
ARMv7 32-bit Windows cross-compiler based on [LLVM/MinGW-w64](https://github.com/mstorsjo/llvm-mingw)
|
||||
|
||||
### dockcross/windows-arm64
|
||||
|
||||
 
|
||||
|
||||
ARMv8 64-bit Windows cross-compiler based on [llvm-mingw](https://github.com/mstorsjo/llvm-mingw)
|
||||
|
||||
## Summary legacy cross compilers
|
||||
|
||||
The list of docker images that are no longer supported or broken
|
||||
@ -384,13 +349,12 @@ cross-compiler Docker image or the dockcross script itself.
|
||||
|
||||
To easily download all images, the convenience target `display_images`
|
||||
could be used:
|
||||
```bash
|
||||
|
||||
curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile
|
||||
for image in $(make -f dockcross-Makefile display_images); do
|
||||
echo "Pulling dockcross/$image"
|
||||
docker pull dockcross/$image
|
||||
done
|
||||
```
|
||||
|
||||
## Install all dockcross scripts
|
||||
|
||||
@ -398,7 +362,6 @@ To automatically install in `~/bin` the dockcross scripts for each
|
||||
images already downloaded, the convenience target `display_images` could
|
||||
be used:
|
||||
|
||||
```bash
|
||||
curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile
|
||||
for image in $(make -f dockcross-Makefile display_images); do
|
||||
if [[ $(docker images -q dockcross/$image) == "" ]]; then
|
||||
@ -409,7 +372,6 @@ for image in $(make -f dockcross-Makefile display_images); do
|
||||
docker run dockcross/$image > ~/bin/dockcross-$image && \
|
||||
chmod u+x ~/bin/dockcross-$image
|
||||
done
|
||||
```
|
||||
|
||||
## Dockcross configuration
|
||||
|
||||
@ -454,21 +416,17 @@ In order to extend Dockcross images with your own commands, one must:
|
||||
|
||||
An example Dockerfile would be:
|
||||
|
||||
```
|
||||
FROM dockcross/linux-armv7
|
||||
|
||||
ENV DEFAULT_DOCKCROSS_IMAGE my_cool_image
|
||||
RUN apt-get install nano
|
||||
```
|
||||
|
||||
And then in the shell:
|
||||
|
||||
```
|
||||
docker build -t my_cool_image . ## Builds the dockcross image.
|
||||
docker run my_cool_image > linux-armv7 ## Creates a helper script named linux-armv7.
|
||||
chmod +x linux-armv7 ## Gives the script execution permission.
|
||||
./linux-armv7 bash ## Runs the helper script with the argument "bash", which starts an interactive container using your extended image.
|
||||
```
|
||||
|
||||
## What is the difference between **dockcross** and **dockbuild** ?
|
||||
|
||||
|
||||
@ -1,31 +0,0 @@
|
||||
FROM dockcross/base:latest
|
||||
MAINTAINER Matt McCormick "matt.mccormick@kitware.com"
|
||||
|
||||
RUN git clone --recurse-submodules https://repo.or.cz/tinycc.git \
|
||||
&& cd tinycc \
|
||||
&& ./configure --cpu=x86_64 \
|
||||
&& make -j$(nproc) \
|
||||
&& make test \
|
||||
&& make install
|
||||
|
||||
ENV PATH="/usr/local/bin:${PATH}"
|
||||
# Test if compiler work
|
||||
RUN tcc -v
|
||||
|
||||
ENV CROSS_TRIPLE x86_64-linux-gnu
|
||||
ENV CROSS_ROOT /usr/bin
|
||||
ENV AS=/usr/bin/${CROSS_TRIPLE}-as \
|
||||
AR=/usr/bin/${CROSS_TRIPLE}-ar \
|
||||
CC=/usr/local/bin/tcc \
|
||||
CPP=/usr/bin/${CROSS_TRIPLE}-cpp \
|
||||
CXX=/usr/bin/${CROSS_TRIPLE}-g++ \
|
||||
LD=/usr/bin/${CROSS_TRIPLE}-ld \
|
||||
FC=/usr/bin/${CROSS_TRIPLE}-gfortran
|
||||
|
||||
|
||||
COPY ${CROSS_TRIPLE}-noop.sh /usr/bin/${CROSS_TRIPLE}-noop
|
||||
|
||||
COPY Toolchain.cmake /usr/lib/${CROSS_TRIPLE}/
|
||||
ENV CMAKE_TOOLCHAIN_FILE /usr/lib/${CROSS_TRIPLE}/Toolchain.cmake
|
||||
|
||||
#include "common.label-and-env"
|
||||
@ -1,12 +0,0 @@
|
||||
set(CMAKE_SYSTEM_NAME Linux)
|
||||
set(CMAKE_SYSTEM_VERSION 1)
|
||||
set(CMAKE_SYSTEM_PROCESSOR x86_64)
|
||||
|
||||
set(cross_triple "x86_64-linux-gnu")
|
||||
|
||||
set(CMAKE_C_COMPILER $ENV{CC})
|
||||
set(CMAKE_CXX_COMPILER $ENV{CXX})
|
||||
set(CMAKE_Fortran_COMPILER $ENV{FC})
|
||||
set(CMAKE_ASM_COMPILER ${CMAKE_C_COMPILER})
|
||||
|
||||
set(CMAKE_CROSSCOMPILING_EMULATOR /usr/bin/${cross_triple}-noop)
|
||||
@ -1,2 +0,0 @@
|
||||
#!/bin/sh
|
||||
exec "$@"
|
||||
@ -1,23 +0,0 @@
|
||||
#!/usr/bin/env bash
|
||||
|
||||
if (( $# >= 1 )); then
|
||||
image=$1
|
||||
build_file=build-${image%:*}
|
||||
shift 1
|
||||
|
||||
make_arg=$*
|
||||
echo "make arg: $make_arg"
|
||||
|
||||
#echo "Pulling dockcross/$image"
|
||||
#docker pull dockcross/"$image"
|
||||
|
||||
echo "Make script dockcross-$image"
|
||||
docker run --rm dockcross/"$image" > ./dockcross-"$image"
|
||||
chmod +x ./dockcross-"$image"
|
||||
|
||||
echo "Build $build_file"
|
||||
./dockcross-"$image" bash -c 'make CXX=${CXX} CC=${CC} AR=${AR} AS=${AS} LD=${LD} CPP=${CPP} FC=${FC} '"$make_arg"
|
||||
else
|
||||
echo "Usage: ${0##*/} <docker imag (ex: linux-x64/linux-x64-clang/linux-arm64/windows-shared-x64/windows-static-x64...)> <make arg.>"
|
||||
exit 1
|
||||
fi
|
||||
@ -1,28 +0,0 @@
|
||||
FROM dockcross/base:latest
|
||||
MAINTAINER Matt McCormick "matt.mccormick@kitware.com"
|
||||
|
||||
ENV XCC_PREFIX /usr/xcc
|
||||
ENV CROSS_TRIPLE aarch64-w64-mingw32
|
||||
ENV CROSS_ROOT ${XCC_PREFIX}/${CROSS_TRIPLE}-cross
|
||||
|
||||
ARG DOWNLOAD_URL=https://github.com/mstorsjo/llvm-mingw/releases/download/20210423/llvm-mingw-20210423-msvcrt-ubuntu-18.04-x86_64.tar.xz
|
||||
ENV DOWNLOAD_URL=${DOWNLOAD_URL}
|
||||
|
||||
RUN mkdir -p ${CROSS_ROOT} && wget -qO- "${DOWNLOAD_URL}" | tar xJvf - --strip 1 -C ${CROSS_ROOT}/ > /dev/null
|
||||
|
||||
ENV AS=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-as \
|
||||
AR=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-ar \
|
||||
CC=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-gcc \
|
||||
CXX=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-g++ \
|
||||
LD=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-ld \
|
||||
FC=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-gfortran
|
||||
|
||||
COPY Toolchain.cmake ${CROSS_ROOT}/
|
||||
ENV CMAKE_TOOLCHAIN_FILE ${CROSS_ROOT}/Toolchain.cmake
|
||||
|
||||
# Linux kernel cross compilation variables
|
||||
ENV PATH ${PATH}:${CROSS_ROOT}/bin
|
||||
ENV CROSS_COMPILE ${CROSS_TRIPLE}-
|
||||
ENV ARCH arm64
|
||||
|
||||
#include "common.label-and-env"
|
||||
@ -1,19 +0,0 @@
|
||||
set(CMAKE_SYSTEM_NAME Linux)
|
||||
set(CMAKE_SYSTEM_VERSION 1)
|
||||
set(CMAKE_SYSTEM_PROCESSOR aarch64)
|
||||
|
||||
set(cross_triple $ENV{CROSS_TRIPLE})
|
||||
set(cross_root $ENV{CROSS_ROOT})
|
||||
|
||||
set(CMAKE_C_COMPILER $ENV{CC})
|
||||
set(CMAKE_CXX_COMPILER $ENV{CXX})
|
||||
set(CMAKE_Fortran_COMPILER $ENV{FC})
|
||||
|
||||
set(CMAKE_CXX_FLAGS "-I ${cross_root}/include/")
|
||||
|
||||
set(CMAKE_FIND_ROOT_PATH ${cross_root} ${cross_root}/${cross_triple})
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH)
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE BOTH)
|
||||
|
||||
set(CMAKE_CROSSCOMPILING_EMULATOR /usr/bin/qemu-aarch64)
|
||||
@ -1,28 +0,0 @@
|
||||
FROM dockcross/base:latest
|
||||
MAINTAINER Matt McCormick "matt.mccormick@kitware.com"
|
||||
|
||||
ENV XCC_PREFIX /usr/xcc
|
||||
ENV CROSS_TRIPLE armv7-w64-mingw32
|
||||
ENV CROSS_ROOT ${XCC_PREFIX}/${CROSS_TRIPLE}-cross
|
||||
|
||||
ARG DOWNLOAD_URL=https://github.com/mstorsjo/llvm-mingw/releases/download/20210423/llvm-mingw-20210423-msvcrt-ubuntu-18.04-x86_64.tar.xz
|
||||
ENV DOWNLOAD_URL=${DOWNLOAD_URL}
|
||||
|
||||
RUN mkdir -p ${CROSS_ROOT} && wget -qO- "${DOWNLOAD_URL}" | tar xJvf - --strip 1 -C ${CROSS_ROOT}/ > /dev/null
|
||||
|
||||
ENV AS=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-as \
|
||||
AR=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-ar \
|
||||
CC=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-gcc \
|
||||
CXX=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-g++ \
|
||||
LD=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-ld \
|
||||
FC=${CROSS_ROOT}/bin/${CROSS_TRIPLE}-gfortran
|
||||
|
||||
COPY Toolchain.cmake ${CROSS_ROOT}/
|
||||
ENV CMAKE_TOOLCHAIN_FILE ${CROSS_ROOT}/Toolchain.cmake
|
||||
|
||||
# Linux kernel cross compilation variables
|
||||
ENV PATH ${PATH}:${CROSS_ROOT}/bin
|
||||
ENV CROSS_COMPILE ${CROSS_TRIPLE}-
|
||||
ENV ARCH arm
|
||||
|
||||
#include "common.label-and-env"
|
||||
@ -1,19 +0,0 @@
|
||||
set(CMAKE_SYSTEM_NAME Linux)
|
||||
set(CMAKE_SYSTEM_VERSION 1)
|
||||
set(CMAKE_SYSTEM_PROCESSOR arm)
|
||||
|
||||
set(cross_triple $ENV{CROSS_TRIPLE})
|
||||
set(cross_root $ENV{CROSS_ROOT})
|
||||
|
||||
set(CMAKE_C_COMPILER $ENV{CC})
|
||||
set(CMAKE_CXX_COMPILER $ENV{CXX})
|
||||
set(CMAKE_Fortran_COMPILER $ENV{FC})
|
||||
|
||||
set(CMAKE_CXX_FLAGS "-I ${cross_root}/include/")
|
||||
|
||||
set(CMAKE_FIND_ROOT_PATH ${cross_root} ${cross_root}/${cross_triple})
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH)
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE BOTH)
|
||||
|
||||
set(CMAKE_CROSSCOMPILING_EMULATOR /usr/bin/qemu-arm)
|
||||
Reference in New Issue
Block a user