WSL2 WSL2 is used in conjunction with Docker to predefine a build environment for Asuro.
Docker for Windows Docker is used to ensure a predefined environment with the correct versions of; Freepascal, Binutils, NASM, Make, xorriso & grub-mk-rescue installed is used for compilation. An ISO will be generated at the end of the build process.
Git (Obviously) I don't think this needs an explaination.
VSCode (Optional, but highly recommended) Visual Studio code is our IDE of choice, and we have a number of recommended plugins.
- C# Plugin by Microsoft This plugin gives you the ability to use the 'coreclr' task type, allowing the automatic launching of virtualbox with the resulting image generated during compilation of Asuro.
VirtualBox Virtualbox is our Virtualisation environment of choice, don't ask why, it just is.

Installation (correct as of 2021/06/20)

Install WSL2 as described in the article linked above & ensure Virtualization is enabled in the BIOS.
Ensure WSL2 is used by default with the following command:
```
wsl --set-default-version 2
```
Install Docker for Windows.
Install Git for Windows.
Install VSCode & the listed plugins.
Install VirtualBox.
Clone this repository.
Run the following command in the root of the repo to build the docker image:
```
docker-compose build builder
```
Run the following command to compile Asuro:
```
docker-compose run builder
```
Create a new virtual machine in Virtualbox and mount the Asuro.iso generated in step 9 as a boot image.
Add the virtualbox installation directory to your %PATH% environment variable, usually:
```
%PROGRAMFILES%\Oracle\VirtualBox
```

Naviage to your virtualbox machines folder, this is usually the following

%userprofile%\VirtualBox VMs\<VM Name>

Open the Virtual Machine Definition file (.vbox) in your text editor of choice and find the following line:

<Machine uuid="{7d395c96-891c-4139-b77d-9b6b144b0b93}" name="Asuro" OSType="Linux" snapshotFolder="Snapshots" lastStateChange="2021-06-20T20:33:07Z">

Copy the uuid, in our case 7d395c96-891c-4139-b77d-9b6b144b0b93 and replace the uuid found in .vscode\launch.json under args, so that it looks something like this:

{
    "configurations": [
        {
            "name":"Run",
            "request": "launch",
            "type": "coreclr",
            "preLaunchTask": "Build",
            "program": "VBoxSDL",
            "args": [
                "--comment", 
                "Asuro", 
                "--startvm", 
                "<YOUR UUID HERE>"
            ],
            "cwd": "${workspaceFolder}",
            "console": "internalConsole",
            "internalConsoleOptions": "neverOpen"
        }
    ]
}

This will allow VSCode to automatically launch VirtualBox once Asuro has been compiled.

Open your project folder in VSCode, use CTRL+SHIFT+B to build & F5 to build + run in VBox.
Congratulations! You can now play with Asuro!

Gotchas

It was noted that Windows builds above 20H2 seem to have issues installing WSL2. We may have to wait for a patch from Microsoft to fix this. Our devs are currently using build 20H2.

Description

An x86 Operating System that started development in 2015 as somewhat of an academic project. Written almost entirely in Freepascal, with NASM used only for bootstrapping & minimal low-level routines, Asuro is a purely hobbyist operating system that differs quite majorly in design from any mainstream OS.

https://asuro.xyz

Readme Pixar 52 MiB