Building Uno.UI for macOS using Visual Studio for Mac
Building Uno.UI for the macOS platform using vs4mac requires Visual Studio for Mac 8.1 or later.
Make sure to create the
crosstargeting_override.propsfile and set
Uno.UI-vs4mac.slnto for iOS/Android/macOS heads or
Uno.UI-vs4mac-macOS-only.slnfor macOS only.
SamplesApp.macOSproject as the Startup Project.
Launch the application.
Support for building the
Uno.UI solution is still somewhat unstable, this is a list of known issues and troubleshooting steps:
You may get a message like
Error while trying to load the project '/Users/user/src/uno/build/Uno.UI.Build.csproj': Index has to be between upper and lower bound of the array.when you open the solution. You can safely ignore this error.
If NuGet restore fails when building from the IDE, or if it gets stuck for some other reason, try building from the command line. Open a terminal session in the
uno/srcfolder and use the following command:
msbuild /m /r SamplesApp/SamplesApp.macOS/SamplesApp.macOS.csproj
Then reopen Visual Studio and try to launch the sample again.
If you get an error when building the
Uno.UI.Lottieproject complaining about typescript errors, you may need to install
Node.json your Mac. The easiest way to do this is to install the Homebrew package manager and then use Homebrew to install Node.
Beware: VS for Mac currently makes many unwanted "changes" to the
.csproj files (like adding package version numbers explicitly, switching attributes to elements and vice-versa). Please do not commit these changes in your Pull Requests.
- Make sure to apply the workarounds specified in https://github.com/unoplatform/uno/issues/3609, otherwise VS4Mac will fail to load the solution.
- In order to successfully debug an external application, use cross-targeting overrides and make sure to enable "Step into external code" in the "Projects / Debugger" options in VS4mac.