toys/adtools-light/docker

• Docker Environment for Cross Compilation
• • Steps

Docker Environment for Cross Compilation

This is a short tutorial about how to create a cross-compiling environment via the docker image and admake on Linux.

The simple way to build all the docker images: tools/build_docker.sh.

If you want to append a new Dockerfile for admake, you should know the name conventions, Dockerfile.<arch>.<tag> -> admake-cross-linux-<arch>:<tag>. Recently, we only support Linux image for cross-compiling.

Steps

I will construct an ARM64 cross-compiling environment based on ubuntu 18.04 as an example here.

1. Run the following command to build a docker image named admake-cross-linux-arm64:18.04.

   docker build -t admake-cross-linux-arm64:18.04 -f Dockerfile.arm64.18.04 .
   

2. Start a new cross-compiling environment for your project:

   # Build your project for ARM64 platforms in a x64 host
   admake build -p arm64
   # or append -c/--docker option, this option will ensure
   # the admake command use docker forcedly.
   admake build -p arm64 -c
   

3. If you want to install other dependencies(builtin in Ubuntu), you can start a new container and install them then commit this layer:

   docker run -it --name deps admake-cross-linux-arm64:18.04 /bin/bash
   
   # Now, assume that you are in the container
   # Install other dependencies
   apt update && apt install -y libxxx-dev:arm64 && rm -rf /var/lib/apt/lists/* && apt-get clean
   exit
   
   # In your host system
   # Commit this layer
   docker commit deps admake-cross-linux-arm64:18.04
   # Cleanup the exited container
   docker container prune -f
   

Here I also provide a script (arm64-env) as a demo to show how to wrapper the docker as a script tool. You can also use the docker command template that output by admake config -d directly.

#!/usr/bin/env bash
#
# Start a ARM64 Cross Compiling Environment in Docker
#
# Author: anjingyu <anjingyu@navinfo.com>

readonly IMAGE_NAME=${IMAGE_NAME:-"admake-cross-linux-arm64:18.04"}

bash -c "$(admake config -d ${IMAGE_NAME})"