rockbox

History

Franklin Wei 02a6985799 Add build code for Docker development environment This simplifies the tedious task of building all the Rockbox toolchains manually by providing a build code for a Docker container image. It's useful for quickly spinning up a build client with just a couple commands and no waiting to compile (though downloading takes a little while). I've built an image as built1n/rbclient on Docker Hub. All toolchains (even the weird ones) are included, except android16. Change-Id: I6b863628ffb397604f59ec6def2f8bb8c8c7185f		2019-07-28 21:13:56 +02:00
..
Dockerfile	Add build code for Docker development environment	2019-07-28 21:13:56 +02:00
README	Add build code for Docker development environment	2019-07-28 21:13:56 +02:00
runclient_modified.sh	Add build code for Docker development environment	2019-07-28 21:13:56 +02:00

README

This directory builds a Docker container image for a rockbox build
client with all toolchains except android.

There is a pre-built client available as built1n/rbclient on Docker
Hub if you would like to avoid having to build all the toolchains. See
the Docker documentation on how to pull and run it.

To build from scratch:

1. Make sure you have Docker installed and running.

2. Run:

  docker build . -t myclient

  This will build the image and tag it as `myclient.'

3. To run your client:

  docker run -e USER=your username -e PASS=anything -e NAME=clientname \
             myclient

  You can also run a bash shell interactively by issuing:

  docker run -it myclient bash

  This will drop you into a fully-equiped rockbox development
  environment.

It is also possible to pull straight from Docker Hub. Run:

  docker pull built1n/rbclient
  
Then you can use all the commands above, with `myclient' replaced with
`built1n/rbclient'.