Relintai/pandemonium_engine
1
0
Fork 0
mirror of https://github.com/Relintai/pandemonium_engine.git synced 2024-12-29 23:27:12 +01:00
Code Issues Packages Projects Releases Wiki Activity
7ecfdf8765
pandemonium_engine/misc/dist/docker/README.md

2.2 KiB
Raw Blame History

A Docker image to build Linux, Windows and Android pandemonium binaries.

The main reason to write this, is to provide a simple way in all platforms to integrate external pandemonium modules and build a custom version of pandemonium.

usage

  1. Install docker on Linux or docker toolbox on Windows or Mac.
  2. Open a terminal on linux or "Docker Quickstart Terminal" on Windows or Mac.
  3. Run command:
    • Linux: cd
    • Windows: cd /c/Users/YOUR_USERNAME
    • Mac: cd /Users/YOUR_USERNAME
  4. Get pandemonium source code: git clone https://github.com/Relintai/pandemonium_engine
  5. Run command: cd pandemonium/tools/docker
  6. Run command: docker build -t pandemonium .(In Linux run Docker commands with sudo or add your user to docker group before run the Docker commands). The pandemonium docker image will be build after a while.
  7. Run command:
    • Linux: docker run -it --name=pandemonium-dev -v /home/YOUR_USERNAME/pandemonium:/pandemonium-dev/pandemonium pandemonium
    • Windows: docker run -it --name=pandemonium-dev -v /c/Users/YOUR_USERNAME/pandemonium:/pandemonium-dev/pandemonium pandemonium
    • Mac: docker run -it --name=pandemonium-dev -v /Users/YOUR_USERNAME/pandemonium:/pandemonium-dev/pandemonium pandemonium You are in the pandemonium-dev container and /pandemonium-dev directory now.
  8. Run ./install-android-tools to download and install all android development tools.
  9. Run command: source ~/.bashrc
  10. Run command: cd pandemonium
  11. Run command: scons p=android target=release to test everything is ok. You can set platform to x11, windows, android, haiku and server.

After use and exit, you can use this environment again by open terminal and type commands: docker start pandemonium-dev && docker attach pandemonium-dev.

Windows and Mac stuffs:

  • Speed up compilation:

    • Exit from container.
    • Run command: docker-machine stop
    • Open "Oracle VM VirtualBox".
    • In settings of default VM increase CPU cores and RAM to suitable values.
    • Run command: docker-machine start
    • Run command: docker start pandemonium-dev && docker attach pandemonium-dev

  • ssh to VM(can be useful sometimes):

    • docker-machine ssh

Check docker and boot2docker projects for more details.