This is based on the initial tutorial series >> this YouTube tutorial series.
- A text editor such as VS Code.
- Docker for creating our build-environment.
- Qemu for emulating our operating system.
- Remember to add Qemu to the path so that you can access it from your command-line. (Windows instructions here)
Build an image for our build-environment:
docker build buildenv -t poloos-buildenv
Enter build environment:
- Linux or MacOS:
docker run --rm -it -v "$pwd":/root/env poloos-buildenv - Windows (CMD):
docker run --rm -it -v "%cd%":/root/env poloos-buildenv - Windows (PowerShell):
docker run --rm -it -v "${pwd}:/root/env" poloos-buildenv - NOTE: If you are having trouble with an unshared drive, ensure your docker daemon has access to the drive you're development environment is in. For Docker Desktop, this is in "Settings > Shared Drives" or "Settings > Resources > File Sharing".
Build for x86 (other architectures may come in the future):
make build-x86_64
To leave the build environment, enter exit.
You can emulate your operating system using Qemu: (Don't forget to add qemu to your path!). Note you may get an error regarding the BIOS, the -L switch should solve that.
qemu-system-x86_64 -cdrom dist/x86_64/kernel.iso -L "C:\Program Files\qemu"- NOTE: When building your operating system, if changes to your code fail to compile, ensure your QEMU emulator has been closed, as this will block writing to
kernel.iso.
Alternatively, you should be able to load the operating system on a USB drive and boot into it when you turn on your computer. (I haven't actually tested this yet.)
Remove the build-evironment image:
docker rmi poloos-buildenv -f
- 20210313: PoloOS.zip