Creating an app with Visual Studio 2022 for Windows

Note

Make sure to setup your environment first by following our instructions.

Create the App

To create an Uno Platform app:

  1. Create a new C# solution using the Uno Platform App template, from Visual Studio's Start Page, then click the Next button

    Visual Studio - Get started - Selecting create a new project option
    Visual Studio - Create a new project - Selecting Uno Platform App option

  2. Configure your new project by providing a project name and a location, check the "Place solution and project in the same directory" option, then click the Create button

    Visual Studio - Configure project name and location

  3. Choose a template preset to build your application

    Visual Studio - Configure your new project

    Tip

    For a detailed overview of the Uno Platform project template wizard and all its options, see this.

  4. Click the create button

  5. Ensure that the lower left IDE icon shows a check mark and says "Ready" A checkmark with a text saying ready. This ensures that the projects have been created, and their dependencies have been restored completely.

  6. A Windows Firewall window may appear. If you do not intend to do Linux development with WSL, check "Private networks" only. Otherwise, check "Public networks" and "Private networks".

  7. A banner at the top of the editor may ask to reload projects, click Reload projects:
    Visual Studio - A banner indicating to reload projects

Debug the App

To debug your Uno Platform Desktop target:

  • Directly on Windows:

    • In the Debug toolbar drop-down, select the profile MyApp (Desktop)

      Visual Studio - "Debug toolbar" drop-down selecting the "net8.0-desktop" framework

    • Press F5 to debug.

  • Using WSL with X11:

    • In the Debug toolbar drop-down, select the profile MyApp (Desktop WSL2)

      Visual Studio - "Debug toolbar" drop-down selecting the "net8.0-desktop" framework

    • Then press F5 or the green arrow to start debugging the app

You're all set!

Next Steps

Now that you're Created and Debug the App.

Learn more about: