Skip to content

get-started-with-linux.md

Latest commit

 

History

History
109 lines (93 loc) · 4.2 KB

get-started-with-linux.md

File metadata and controls

109 lines (93 loc) · 4.2 KB

Additional setup for Linux or WSL

The Uno Platform for Linux current comes with a rendering backend using Skia, and a shell support with Gtk3.

It is possible to develop :

  • Using Visual Studio on Windows directly, or using the Windows Subsystem for Linux (WSL).
  • Using VS Code under Linux

Setting for Windows and WSL

Using VS 2019 16.6 or later:

  • Install WSL Ubuntu 18.04 or later
  • Install the prerequisites for Linux mentioned in the next section, in your installed distribution using the Ubuntu shell
  • On Windows 10, Install vcXsrv, an X11 server for Windows
    • You'll need to start the server in "Multiple windows" mode, starting with "no client" mode.
  • On Windows 11, Wayland is supported and nothing needs to be installed
  • Install the GTK3 runtime.
  • Using the WSL 1 mode is generally best for performance and ease of use for the X11 server
    • You can switch between versions of a distribution using wsl --set-version "Ubuntu-20.04" 1
    • You can list your active distributions with wslconfig /l and change the default with wslconfig /s "Ubuntu-20.04"
    • You can change the used distribution with the "distributionName": "Ubuntu-20.04" launch profile parameter of the VS WSL 2 Extension.
    • If you have a insider preview of Windows 10, you may use the wayland server.
    • If you still want to use WSL 2 anyways, you can try following those steps.
  • Install the dotnet new templates: 
    dotnet new -i Uno.ProjectTemplates.Dotnet
  • Then create a new project using: 
    dotnet new unoapp -o MyUnoApp

Now let's run the application:

  • Open the solution using Visual Studio
  • In the debugger menu, next to the green arrow, select WSL (or WSL 2 depending on the visual studio version)
  • In the launch profile file, set:
"environmentVariables": {
    "DISPLAY": ":0",
    "GDK_GL": "gles", // use this line when running under WSL on Windows 11
},
  • Start the debugger session
  • Visual Studio may ask you to install .NET 6 and the Linux debugger, press OK and let the installation finish, then restart the debugging session.

Setting up for Linux

Ubuntu 18.04

  • Install GTK3: 
    sudo apt update
sudo apt-get install gtk+3.0 mesa-utils libgl1-mesa-glx ttf-mscorefonts-installer
  • Install .NET 6

Ubuntu 20.04

  • Install GTK3: 
    sudo apt update
sudo apt install libgtk-3-dev mesa-utils libgl1-mesa-glx ttf-mscorefonts-installer
  • Install .NET 6

ArchLinux 5.8.14 or later / Manjaro

  • Update system and packages 
    pacman -Syu
  • Install the necessary dependencies 
    sudo pacman -S gtk3 dotnet-targeting-pack dotnet-sdk dotnet-host dotnet-runtime mono python mono-msbuild ninja gn aspnet-runtime
  • Install the dotnet new templates: 
    dotnet new -i Uno.ProjectTemplates.Dotnet

You may also need to install the Microsoft fonts manually.

[!includegetting-help]

Install the templates and create the application

  • Install the dotnet new templates: 
    dotnet new -i Uno.ProjectTemplates.Dotnet
  • Then create a new project using: 
    dotnet new unoapp -o MyUnoApp

Now let's run the GTK based application:

  • Open the folder created by dotnet new
  • In the terminal, build and run the application: 
    cd MyUnoApp.Skia.Gtk
dotnet run

And run the WebAssembly head with: bash cd .. cd MyUnoApp.Wasm dotnet run

[!includegetting-help]