Crummy Wizard!

Gondar is a project that aims to allow users to download one of our latest CloudReady releases and burn it onto a USB stick for immediate use.

We're primarily targeting Windows 10 for compatibility.

Run make. This will build Gondar for Linux by default, as well as run the tests. The actual build uses CMake, so you can also do the usual mkdir build && cd build && cmake .. && make dance.

There are a number of environment variables you can pass to the top-level Makefile to control how it gets built. These are printed out at the beginning of the build (look for "Build config").

To make a build in one step, run:

./package.py

package.py will handle building everything for you using mxe in a docker container. Check out docker/gondar-win32.Dockerfile to see how that happens.

• Get MXE git clone https://github.com/mxe/mxe

• Build required packages for mxe make qtbase in mxe dir

• CMAKE=/path/to/mxe/usr/bin/i686-w64-mingw32.static-cmake make

Fedora:

dnf install cmake qt5-qtbase-devel

Ubuntu/Debian:

apt install build-essential cmake libmicrohttpd-dev qtbase5-dev zlib1g-dev

LLVM's clang-format tool is used to keep the code style consistent. Conveniently, that tool has a preset for Chromium code, and since we mostly work on Chromium code that seems like a nice default.

To format all the source files run make format. You can also run clang-format directly.

Download and decompress the Windows image (this is only accessible to Neverware employees):

aws s3 cp s3://windows-installed-images/win10-installed.raw.lz4 .
lz4 win10-installed.raw.lz4

Create the backing image for the emulated USB device:

qemu-img create -f raw fakeusb.raw 16G

TODO(nicholasbishop): could probably also set up a device passthrough for testing on actual USB devices...

Run the VM with three drives: the emulated USB device, the Windows installation, and the UEFI firmware:

qemu-kvm \
  -m 4G \
  -smp 4 \
  -usbdevice tablet \
  -device usb-storage,drive=fakeusb,removable=yes \
  -drive if=none,id=fakeusb,file=fakeusb.raw \
  -drive format=raw,file=../windows-vm/win10-installed.raw \
  -drive if=pflash,format=raw,file=../windows-vm/ovmf.fd \
  -net nic -net user,smb=/path/to/gondar

The -net options enable a Samba server to share your gondar build between the host and the guest. (Your host must have the Samba server installed for this to work.) Set smb= to the absolute path on your host where your gondar build lives.

Within the guest you can access the shared drive via \\10.0.2.4\qemu.