Editing and Building the Source Code

Introduction

On this page you'll learn how to set up the MicroOS project in your desired IDE as well as how to build your MicroOS project.

Setting up the MicroOS project in VS Code

1. Download the MakeCode Arcade extension for Visual Studio Code.
2. Download and unzip the source code or alternatively clone the repository with git.
3. Open the source code folder in Visual Studio Code.
4. Head over to the Asset Explorer tab on the sidebar.
5. Select Install Project Dependencies from the actions menu.

Setting up the MicroOS project on the MakeCode Website

1. Head over to the Microsoft MakeCode Arcade website.
2. Select import

Without signing into GitHub

4. Select Import URL...
5. Input your GitHub repository url.

Important

If you are not using the MicroOS repository, ensure your GitHub repository is public.

6. Select Go Ahead!

With signing into GitHub (Recommended)

4. Select Your GitHub Repo...
5. Sign in with GitHub.
6. Select your GitHub repository.

Building the Operating System

Note

You can skip steps 1-6 if you set up the project in the MakeCode Arcade Website and you can skip step 1 if you're not planning on making any changes.

1. Upload the source code to a GitHub repository.

Important

Ensure the main branch is named master

2. Head over to the Microsoft MakeCode Arcade website.
3. Select import

Without signing into GitHub

4. Select Import URL...
5. Input your GitHub repository url.

Important

If you are not using the MicroOS repository, ensure your GitHub repository is public.

6. Select Go Ahead!

With signing into GitHub (Recommended)

4. Select Your GitHub Repo...
5. Sign in with GitHub.
6. Select your GitHub repository.

Once you've opened the Operating System in MakeCode you can continue with the following steps.

7. Click the 3 dots next to the Download button.
8. Select Choose hardware
9. Select your hardware.
10. Click the Download button.

After you're done you can safely delete the project from the MakeCode Arcade site.