create-an-app-vs2022.md

uid
Uno.GettingStarted.CreateAnApp.VS2022

Creating an app with Visual Studio 2022 for Windows

Note

Make sure to setup your environment 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

   
   

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

   

3. Choose a template preset to build your application

   

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

4. Click the create button

5. Wait for the projects to be created, and their dependencies to be restored

6. A banner at the top of the editor may ask to reload projects, click Reload projects:
   

Debug the App

Windows

To run the Windows (WinAppSDK) head:

• In the debugger toolbar, click the down arrow to select MyApp (WinAppSDK Unpackaged)

  

• Press the MyApp (WinAppSDK Unpackaged) button to deploy the app

• If you've not enabled Developer Mode, the Settings app should open to the appropriate page. Turn on Developer Mode and accept the disclaimer.

WebAssembly

To run the WebAssembly (Wasm) head:

• In the debugger toolbar, click the down arrow to select MyApp (WebAssembly)

  

• Press the MyApp (WebAssembly) button to deploy the app

• To run/debug your WebAssembly app on a mobile device, you can utilize the Dev Tunnels feature of Visual Studio 2022 (see Microsoft Learn documentation to get started)

ASP.NET Hosted WebAssembly

To run the ASP.NET Hosted WebAssembly (Server) head, if you've selected the option in the Wizard:

• Right-click on the MyApp.Server project, select Set as startup project
• Press the MyApp.Server button to deploy the app

iOS

To debug for iOS:

Note

For information about connecting Visual Studio to a Mac build host to build iOS apps, see Pairing to a Mac for .NET iOS development. Catalyst apps are not supported in Visual Studio 2022 on Windows, you can use VS Code Remote SSH to enable this scenario.

• In the "Debug toolbar" drop-down, select framework net8.0-ios:

  

• Select:

  • An active device, if your IDE is connected to a macOS Host

  • A local device using Hot Restart, to debug your application without connecting to a mac

    [!NOTE] If no iOS devices are available, a Visual Studio 17.7+ issue may require unloading/reloading the project. Right-click on the MyApp project and select Unload Project then Load project.

Android

To debug the Android platform:

• In the Debug toolbar drop-down, select framework net8.0-android

  

• Select an active device in the "Device" sub-menu

  [!NOTE] If no android devices are available, a Visual Studio 17.7+ issue may require unloading/reloading the project. Right-click on the MyApp project and select Unload Project then Load project.

Desktop

To debug your Uno Platform Desktop target:

• Directly on Windows:

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

    

  • Press F5 to debug.

• Using WSL with X11:

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

    

  • 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:

• Uno Platform features and architecture
• Hot Reload feature
• Uno Platform App solution structure
• Troubleshooting
• How-tos and Tutorials See real-world examples with working code.
• List of views implemented in Uno for the set of available controls and their properties.