comsgn/mipschrome repository overview

⁠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
   

   Copy
   • 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
   

   Copy

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' .
   

   Copy

⁠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 predefined configurations in chr/configs were tested with "baikal-rootfs-chromedeps" sysyroot that can be downloaded at [todo add link to ftp]
• First time build.sh called it will automatically download chromium sources to chr/chromium/src. Chromium repo have huge size(about 17GB), so it may take long time.