mirror of
https://github.com/bensuperpc/dockcross.git
synced 2024-12-23 00:54:26 +01:00
Merge pull request #555 from bensuperpc/Update_tools
Update Readme and tools scripts
This commit is contained in:
commit
f84173c7e4
27
README.md
27
README.md
@ -13,13 +13,14 @@ Cross compiling toolchains in Docker images.
|
|||||||
- Most images also contain an emulator for the target system.
|
- Most images also contain an emulator for the target system.
|
||||||
- Clean separation of build tools, source code, and build artifacts.
|
- 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).
|
- 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** etc) are set to point to the appropriate tools in the container.
|
- Make variables **CC**, **CXX**, **LD**, **AS** etc) are set to point to the appropriate tools in the container.
|
||||||
- Recent [CMake](https://cmake.org) and ninja are precompiled.
|
- Recent [CMake](https://cmake.org) and ninja are precompiled.
|
||||||
- [Conan.io](https://www.conan.io) can be used as a package manager.
|
- [Conan.io](https://www.conan.io) can be used as a package manager.
|
||||||
- Toolchain files configured for CMake.
|
- Toolchain files configured for CMake.
|
||||||
- Current directory is mounted as the container\'s workdir, `/work`.
|
- 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/).
|
- 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.
|
- 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
|
## Examples
|
||||||
|
|
||||||
@ -40,26 +41,32 @@ 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:
|
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
|
docker run --rm CROSS_COMPILER_IMAGE_NAME > ./dockcross
|
||||||
chmod +x ./dockcross
|
chmod +x ./dockcross
|
||||||
mv ./dockcross ~/bin/
|
mv ./dockcross ~/bin/
|
||||||
|
```
|
||||||
|
|
||||||
Where **CROSS_COMPILER_IMAGE_NAME** is the name of the cross-compiler toolchain Docker instance, e.g: **dockcross/linux-armv7**.
|
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
|
## Usage
|
||||||
|
|
||||||
For the impatient, here\'s how to compile a hello world for armv7:
|
For the impatient, here\'s how to compile a hello world for armv7:
|
||||||
|
|
||||||
|
```bash
|
||||||
cd ~/src/dockcross
|
cd ~/src/dockcross
|
||||||
docker run --rm dockcross/linux-armv7 > ./dockcross-linux-armv7
|
docker run --rm dockcross/linux-armv7 > ./dockcross-linux-armv7
|
||||||
chmod +x ./dockcross-linux-armv7
|
chmod +x ./dockcross-linux-armv7
|
||||||
./dockcross-linux-armv7 bash -c '$CC test/C/hello.c -o hello_arm'
|
./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:
|
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...]
|
./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.
|
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.
|
||||||
|
|
||||||
@ -73,6 +80,7 @@ The dockcross script will execute the given command-line inside the container, a
|
|||||||
| dockcross/android-x86 | x86 | Clang | Android |
|
| dockcross/android-x86 | x86 | Clang | Android |
|
||||||
| dockcross/android-x86_64 | x86_64 | Clang | Android |
|
| dockcross/android-x86_64 | x86_64 | Clang | Android |
|
||||||
| dockcross/linux-arm64 | ARMv8 | GCC | Linux |
|
| dockcross/linux-arm64 | ARMv8 | GCC | Linux |
|
||||||
|
| dockcross/linux-arm64-full | ARMv8 | GCC | Linux |
|
||||||
| dockcross/linux-arm64-musl | ARMv8 | GCC + musl | Linux |
|
| dockcross/linux-arm64-musl | ARMv8 | GCC + musl | Linux |
|
||||||
| dockcross/linux-armv5 | ARMv5 | GCC | Linux |
|
| dockcross/linux-armv5 | ARMv5 | GCC | Linux |
|
||||||
| dockcross/linux-armv5-musl | ARMv5 | GCC + musl | Linux |
|
| dockcross/linux-armv5-musl | ARMv5 | GCC + musl | Linux |
|
||||||
@ -140,6 +148,12 @@ The Android NDK standalone toolchain for the x86_64 architecture.
|
|||||||
|
|
||||||
Cross compiler for the 64-bit ARM platform on Linux, also known as AArch64.
|
Cross compiler for the 64-bit ARM platform on Linux, also known as AArch64.
|
||||||
|
|
||||||
|
### dockcross/linux-arm64-full
|
||||||
|
|
||||||
|
![Docker Image Size (tag)](https://img.shields.io/docker/image-size/dockcross/linux-arm64-full/latest) ![Docker Pulls](https://img.shields.io/docker/pulls/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
|
### dockcross/linux-arm64-musl
|
||||||
|
|
||||||
![Docker Image Size (tag)](https://img.shields.io/docker/image-size/dockcross/linux-arm64-musl/latest) ![Docker Pulls](https://img.shields.io/docker/pulls/dockcross/linux-arm64-musl)
|
![Docker Image Size (tag)](https://img.shields.io/docker/image-size/dockcross/linux-arm64-musl/latest) ![Docker Pulls](https://img.shields.io/docker/pulls/dockcross/linux-arm64-musl)
|
||||||
@ -349,12 +363,13 @@ cross-compiler Docker image or the dockcross script itself.
|
|||||||
|
|
||||||
To easily download all images, the convenience target `display_images`
|
To easily download all images, the convenience target `display_images`
|
||||||
could be used:
|
could be used:
|
||||||
|
```bash
|
||||||
curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile
|
curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile
|
||||||
for image in $(make -f dockcross-Makefile display_images); do
|
for image in $(make -f dockcross-Makefile display_images); do
|
||||||
echo "Pulling dockcross/$image"
|
echo "Pulling dockcross/$image"
|
||||||
docker pull dockcross/$image
|
docker pull dockcross/$image
|
||||||
done
|
done
|
||||||
|
```
|
||||||
|
|
||||||
## Install all dockcross scripts
|
## Install all dockcross scripts
|
||||||
|
|
||||||
@ -362,6 +377,7 @@ To automatically install in `~/bin` the dockcross scripts for each
|
|||||||
images already downloaded, the convenience target `display_images` could
|
images already downloaded, the convenience target `display_images` could
|
||||||
be used:
|
be used:
|
||||||
|
|
||||||
|
```bash
|
||||||
curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile
|
curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile
|
||||||
for image in $(make -f dockcross-Makefile display_images); do
|
for image in $(make -f dockcross-Makefile display_images); do
|
||||||
if [[ $(docker images -q dockcross/$image) == "" ]]; then
|
if [[ $(docker images -q dockcross/$image) == "" ]]; then
|
||||||
@ -372,6 +388,7 @@ be used:
|
|||||||
docker run dockcross/$image > ~/bin/dockcross-$image && \
|
docker run dockcross/$image > ~/bin/dockcross-$image && \
|
||||||
chmod u+x ~/bin/dockcross-$image
|
chmod u+x ~/bin/dockcross-$image
|
||||||
done
|
done
|
||||||
|
```
|
||||||
|
|
||||||
## Dockcross configuration
|
## Dockcross configuration
|
||||||
|
|
||||||
@ -416,17 +433,21 @@ In order to extend Dockcross images with your own commands, one must:
|
|||||||
|
|
||||||
An example Dockerfile would be:
|
An example Dockerfile would be:
|
||||||
|
|
||||||
|
```
|
||||||
FROM dockcross/linux-armv7
|
FROM dockcross/linux-armv7
|
||||||
|
|
||||||
ENV DEFAULT_DOCKCROSS_IMAGE my_cool_image
|
ENV DEFAULT_DOCKCROSS_IMAGE my_cool_image
|
||||||
RUN apt-get install nano
|
RUN apt-get install nano
|
||||||
|
```
|
||||||
|
|
||||||
And then in the shell:
|
And then in the shell:
|
||||||
|
|
||||||
|
```
|
||||||
docker build -t my_cool_image . ## Builds the dockcross image.
|
docker build -t my_cool_image . ## Builds the dockcross image.
|
||||||
docker run my_cool_image > linux-armv7 ## Creates a helper script named linux-armv7.
|
docker run my_cool_image > linux-armv7 ## Creates a helper script named linux-armv7.
|
||||||
chmod +x linux-armv7 ## Gives the script execution permission.
|
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.
|
./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** ?
|
## What is the difference between **dockcross** and **dockbuild** ?
|
||||||
|
|
||||||
|
23
tools/dockcross-make-builder.sh
Executable file
23
tools/dockcross-make-builder.sh
Executable file
@ -0,0 +1,23 @@
|
|||||||
|
#!/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
|
Loading…
Reference in New Issue
Block a user