Skip to content

Latest commit

 

History

History
147 lines (99 loc) · 9.66 KB

get-started.md

File metadata and controls

147 lines (99 loc) · 9.66 KB
Raw
uid
Uno.GetStarted

Quick Start

  1. Run Uno.Check to install all the pre-requisites

  2. Download the Uno Platform extension for your IDE:

    Visual Studio 2022

    Get the VSIX from the marketplace

    Visual Studio Code

    Install the VSIX from the marketplace

    JetBrains Rider

    Get the extension from the marketplace

Get Started

Uno Platform allows you to create single-codebase, cross-platform applications that run on iOS, Android, Web, macOS, Linux and Windows. You'll be creating cross-platform .NET applications with XAML and/or C# in no time.

The following sections will guide you through your development environment setup, a simple Hello World app, and more advanced tutorials.

To set up your development environment, first select the operating system you're developing on.

I am developing on...

Windows

If you're developing on Windows, we recommend you use Visual Studio 2022, for the richest XAML development experience and broadest platform coverage.

If you already use and love JetBrains Rider or Visual Studio Code, you can also use them to develop Uno Platform applications. Check the support matrix below to see which target platforms they support.

Choose the IDE you want to use:

  • Visual Studio 2022
  • VS Code, Codespaces and GitPod
  • Rider

To help you choose the appropriate IDE, the following table shows the compatibility of different development environments with various target platforms:

Visual Studio VS Code Codespaces / Gitpod JetBrains Rider
Windows 10/11 (UWP/WinUI) ✔️ ❌ ❌ ✔️
Android ✔️ ✔️ ❌ ✔️
iOS ✔️† ✔️†† ❌ ❌
Web (WebAssembly) ✔️ ✔️ ✔️ ✔️†††
mac Catalyst ❌ ✔️†† ❌ ❌
Skia Desktop ✔️ ✔️ ✔️ ✔️
  • † You will need to be connected to a Mac to run and debug iOS apps from Windows.
  • †† You will need to be connected to a Mac using Remote - SSH
  • ††† WebAssembly debugging is not yet supported

macOS

You can use Visual Studio Code or JetBrains Rider, to build Uno Platform applications on macOS. See the support matrix below for supported target platforms.

Choose the IDE you want to use:

  • Get started with VS Code, Codespaces and GitPod
  • Get started with Rider

To help you choose the appropriate IDE, the following table shows the compatibility of different development environments with various target platforms:

VS Code Codespaces / Gitpod JetBrains Rider
Windows 10/11 (UWP/WinUI) ❌ ❌ ❌
Android ✔️ ❌ ✔️
iOS ✔️ ❌ ✔️
Web (WebAssembly) ✔️ ✔️ ✔️
mac Catalyst ✔️ ❌ ✔️
Skia Desktop ✔️ ✔️ ✔️

The latest macOS release and Xcode version are required to develop with Uno Platform for iOS and Mac Catalyst targets. If you have older Mac hardware that does not support the latest release of macOS, see the section for Developing on older Mac hardware.

Linux

You can use either JetBrains Rider or Visual Studio Code to build Uno Platform applications on Linux. See the support matrix below for supported target platforms.

Choose the IDE you want to use:

  • Get started with Visual Studio Code, Codespaces and GitPod
  • Get started with Rider

To help you choose the appropriate IDE, the following table shows the compatibility of different development environments with various target platforms:

VS Code Codespaces / Gitpod JetBrains Rider
Windows 10/11 (UWP/WinUI) ❌ ❌ ❌
Android ✔️ ❌ ✔️
iOS ❌ ❌ ❌
Web (WebAssembly) ✔️ ✔️ ✔️†
mac Catalyst ❌ ❌ ❌
Skia Desktop ✔️ ✔️ ✔️

Notes:

Questions

For questions about Uno Platform, refer to the general FAQ or see the troubleshooting section for common issues and their solutions.

Next Steps

Choose the IDE to Learn more about:

  • Visual Studio 2022
  • VS Code, Codespaces and GitPod
  • Rider