build-instructions.md

Build instructions

Uno is built using the command-line on Linux, macOS or Windows – or from inside an IDE.

Building from command-line

Prerequisites

• Mono / Visual Studio
• Bash and Make
• Node.js
• NuGet

Our cross-platform build scripts are written in bash, and make is a convenient way to invoke build tasks. Bash is included in Git for Windows.

On Windows, we need vswhere to locate your Visual Studio installation. Please make sure we can find vswhere in %PATH% or at %PROGRAMFILES(x86)%\Microsoft Visual Studio\Installer.

Build

make

This will build uno and standard library.

You can also try npm run build or bash scripts/build.sh for similar results.

Install and run

make install
uno --version

This will add your local-built uno to PATH and print version information.

You can also try npm link or <uno-root>/bin/uno for similar results.

Additional make commands

Command	Description
make lib	Build projects in lib/ only (instead of a full build).
make release	Build in release configuration.
make clean	Remove build artifacts.
make check	Run test suite.

Additional npm commands

Command	Description
npm pack	Build package tarball.
npm test	Run test suite.
npm version	Increment version number.

Building from an IDE

Open uno.sln in an IDE that supports C# (Visual Studio or JetBrains Rider?).

Make sure to set tool/uno as startup project when launching uno.

See also disasm.sln (Windows only) and runtime.sln (multi-platform).

Building the standard library

Try one of the following methods.

Pass doctor as parameter to tool/uno when launching from your IDE.

Run <uno-root>/bin/uno doctor.

Run npm run uno doctor.

Run make lib.