/docker-chrome

Docker images for building chrome

Primary LanguageC++

This repo contains tools to automate chromium builds for MIPS32.

Structure:

.
├── build.sh            # Main script to build chrome
├── chr                 # This dir will be attached as volume to the docker container
│   ├── buildchrome.sh  # This script runs in container and automates build
│   ├── chromium        
│   │   └── src         # Chromium source code 
│   ├── configs         # Configs for building various versions of chrome
│   │   ├── 56-gcc4.9   
│   │   ├── 56-gcc5.4
│   │   └── ....
│   ├── sysroots        # Must contain sysroots for builds
│   │   │── baikal-rootfs-chromedeps   # must be downloaded manualy
│   │   └── yocto-fp64-sysroot 
│   │   └── .....
│   └── toolchains      # Must contain toolchains
│       │── mipsel-gcc4.9-crosstool-ng
│       │── baikal-gcc5.2
│       └── .....
├── docker_image
│   └── Dockerfile      # Dockerfile for building docker image 
└── Readme.md

Usage

  1. Install docker and read this readme completely before start

  2. Clone this repo and cd into it.

  3. Unpack your sysroot in chr/sysroots/my_sysroot

  4. Install additional toolchains in chr/toolchains/my_custom_toolchain

  5. Run

    ./build.sh config_name build_name
    • First argument is dirname containing config (must not contain slashes)
    • Second argument is output dirname (must not contain slashes). Subdirectory with this name will be created in chr/chromium/src/out/. You can ommit it and in that case same value as config_name will be used.

    Example:

     ./build.sh 56-gcc5.4

  6. After build finishes you can make archive with build result:

    cd chr/chromium/src/out/my_build_name
tar -cvzf /dest/dir/my-custom-chromium-build.tar.gz --exclude='./obj' --exclude='./gen' --exclude='./clang_x86_v8_mipsel' --exclude='./x64'  --exclude='./clang_x86' .

Notes and recommendations

  • For the docker image automated build is configured at https://hub.docker.com/r/comsgn/mipschrome/
  • Docker container runs as nonroot user builder(uid=1000). Thus it is recommended to clone repo and run all commands with host user having same uid value. Also you can create new user in image having desired uid.
  • Docker image is built with dependencies for 56.0.2924.122 version of chrome. It is sufficient for building chromium of 54-57 versions, but may require update for newer chromiums versions.
  • Docker image already contains gcc-5.4 croos compilation toolchain. In order to build with other toolchains you must install them to chr/toolchains/
  • Most of the predefined configurations in chr/configs were tested with "baikal-rootfs-chromedeps" sysyroot that can be downloaded at [todo add link to ftp]
  • If directory chr/chromium/src missing, then build.sh will automatically clone chromium sources to chr/chromium/src. Chromium repo have huge size(about 17GB), so it may take long time. If you already have chromium checkout you can manualy copy (or symlink) it to chr/chromium.
  • Note that build script automatically makes checkout to specified commit/tag and discards all uncommited cahnges and removes all untracked files/dirs, so be carefull!