Offer the whole environement for compiling your project for exaequOS. Note: An online Docker image exists at: https://hub.docker.com/repository/docker/lecrapouille/exaequos
- Install Docker engine: https://docs.docker.com/engine/install/
- Create a cache folder in your home folder:
mkdir -p ~/.cache/exaequos
If this folder is not created, the Docker will create one but with root priviledge and you do not want to have root folder inside your folders.
git clone https://github.com/baudaux/docker-exa.git
cd docker-exa
docker build -t exaequos .
- Go to you project folder first. Let suppose your user name is
Johnand the project name istest_project. - Then call exaequOS docker against your project:
cd /home/John/test_project
docker run -it -u $(id -u ${USER}):$(id -g ${USER}) -v $(pwd):$(pwd) -v ~/.cache/exaequos:/home/exaequos/emscripten-exa/cache -p 127.0.0.1:7777:7777 -w $(pwd) exaequos
Once inside your Docker, you will see this kind of prompt:
ExaequOS:720c9a20d6d4:/home/John/test_project$
If your project depends on graphical libs. You can download them:
ExaequOS:720c9a20d6d4:/home/John/test_project$ epm.py install exa-wayland glfw raylib
A folder exapkgs shall have been created. You can refer the path to pkg-config:
ExaequOS:720c9a20d6d4:/home/John/test_project$ export PKG_CONFIG_PATH=/home/John/test_project/exapkgs/pkgconfigs
Let compile test application. For example
ExaequOS:720c9a20d6d4:/home/John/test_project/src$ emcc test.c -o test.js
Use em++ for compiling C++ files and emar crs for creating static libs. Compilation flags are not shown here but are the same than gcc/g++.
If you need to install additional packages inside the docker, you can get the container id and connect to the docker container as root:
docker ps
docker exec -it -u root <container_id> /bin/bash
Once your application has been compiled, copy the test.js and test.wasm binaries inside the /home/John/test_project/media/localhost/test/exa folder (and test.worker.jsif you compiled the application with -pthread).
Create in this folder an exa.html file with the following content (Replace test.js by the real name of your application):
<!doctype html>
<html lang="en-us">
<head>
<meta charset="utf-8">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Emscripten-Generated Code</title>
<style>
html, body {
margin : 0;
padding: 0;
border: none;
width: 100%;
height: 100%;
}
</style>
</head>
<body>
<script async type="text/javascript" src="test.js"></script>
</body>
</html>
Start the node server at parent directory of media/locahost (/home/John/test_project/ in this example)
node /home/exaequos/emscripten-exa/third_party/server/server.js &
Go to https://www.exaequos.com/ start the console Havoc and type:
/media/localhost/test
Publish the docker image to Docker hub:
docker login
docker tag exaequos:latest lecrapouille/exaequos:latest
docker push lecrapouille/exaequos:latest