Get Started on Visual Studio 2022 For Mac
While it is easier to create apps using Uno Platform on Windows, you can also create all but UWP/WinUI apps on your Mac.
Prerequisites
- Visual Studio 2022 for Mac Preview
- Xcode 14.1 or higher
- An Apple ID
- GTK+3 for running the Skia/GTK projects
Finalize your environment
Open a Terminal.
a. Install the tool by running the following command from the command prompt:
dotnet tool install -g uno.check
b. To update the tool, if you already have an existing one:
dotnet tool update -g uno.check
Run the tool from the command prompt with the following command:
uno-check
If the above command fails, use the following:
~/.dotnet/tools/uno-check
Follow the instructions indicated by the tool
You can find additional information about uno-check here.
Installing the dotnet new templates
In order to create a new Uno Project, you'll need to install the dotnet new
Uno Platform templates.
Create a new project using the IDE
To create a new project, from the command line:
cd src dotnet new unoapp -o MyApp01
Once created, open the
MyApp-vsmac.slnf
file- This
slnf
is called a solution filter, which automatically excludes projects which are not compatible with Visual Studio 2022 for Mac. - If you have a warning symbol on your iOS project, make sure you have the minimum version of Xcode installed.
\
- This
To update, go to Visual Studio > Preferences > Projects > SDK Locations > Apple
and select Xcode 13.3 or higher.
Restart Visual Studio.
- You can now run on iOS, Android, macOS, and Skia.GTK projects by changing your startup project and starting the debugger.
Note
You will not be able to build the UWP and WPF projects on a Mac. All changes to this project must be made on Windows.
Important
As of .NET 6 Mobile RC3, the macOS head can fail to build with issues related to the AOT compiler. You can run the Catalyst app on a mac.
Create other projects types using the command line
You can create a new Uno Platform solution with the following terminal command:
bash dotnet new unoapp -o MyProject --wasm=false
Once created, you can open it using Visual Studio 2022 for Mac.
Build and Run for WebAssembly
Building for WebAssembly takes a few more steps:
- Set
MyProject.Wasm
to startup project - Build the project
- In the terminal, navigate to your build output path. This will typically be:
MyProject.Wasm > bin > Debug > net7.0 > dist
- Install
dotnet serve
:dotnet tool install -g dotnet-serve
- Once installed type
dotnet serve
(or~/.dotnet/tools/dotnet-serve
). - Navigate to the URL presented by the tool to run your application
Getting Help
If you continue experiencing issues with Uno Platform, please visit our GitHub Discussions or Discord - #uno-platform channel where our engineering team and community will be able to help you.