Commit 168c19f6 authored by Italo Nicola's avatar Italo Nicola
Browse files

Add instructions to install and build new apps/tools in borealis


Signed-off-by: Italo Nicola's avatarItalo Nicola <italonicola@collabora.com>
Reviewed-by: default avatarGert Wollny <gert.wollny@collabora.com>
parent e8c203bc
......@@ -153,10 +153,35 @@ cros deploy $DUT foo
Of couse you can also use `emerge-volteer-borealis`
## Update the borealis VM
The VM image is build by using Docker, so you will need to setup Docker on your build machine. Then you can follow the instructions in
[2](borealis-hacking) and `src/platform/borealis/docs/build-and-deploy.md`
## Updating the borealis VM / installing additional apps and tools
The VM image is build by using Docker, so you will need to setup Docker on your
build machine. Then you can follow the instructions in [2](borealis-hacking)
and `src/platform/borealis/docs/build-and-deploy.md`
I'd recommend to add the `--stage runtime_debug` flag to `./build_full.py` when
building borealis. This will install more libs/tools and make sure you can
build mesa inside the VM.
* To install additional tools/apps that are available in `apt` to borealis, you
just need to add something like this to build/Dockerfile, at the end of the
runtime_debug section:
* `RUN apt-get install <package>`
* But if you instead need to build something from source (either to get debug
symbols, change build flags or because `apt` doesn't have it), you can do:
* `RUN git clone <repo> <path> && cd <path> && <build_cmd> && <install_cmd>`
* If you do this, make sure you put everything in a single RUN command and
use an absolute prefix, so if you are building `glmark2`, it would look
something like this:
```
RUN git clone https://github.com/glmark2/glmark2.git /glmark2-git --depth 1 && \
cd /glmark2-git && \
meson setup build -Dflavors=drm-gl,drm-glesv2,wayland-gl,wayland-glesv2,x11-gl,x11-glesv2 && \
ninja -C build install
```
If you want to make changes to mesa and rebuild it inside borealis, you can
find the scripts to do so at `/opt/dev_tools/bin/build_mesa`.
## Where to get help:
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment