Prepare your Mac to be a Xamarin/.NET MAUI build host without VS4MAC [Updated]

Microsoft will discontinue Visual Studio for Mac (VS4MAC) in 2024. To be able to compile for the App Store, we still need a Mac based build host. In this post, I’ll show you how to prepare a Mac without VS4MAC as such a host.
Connect-Mac-Build-Host-No-VS4MAC-Title

Overview

You can connect to a Mac Build host from your Windows machine without Visual Studio for Mac installed. All you need is to install the right packages, which are (luckily and for the time being), available to be downloaded separately. You just need to select the right versions that match your Visual Studio installation on Windows.

Install .NET

Of course, the first step is to install the .NET SDK. Head over to the .NET website and download the latest Release and/or Preview version.

https://dotnet.microsoft.com/en-us/download

Install Mono

As Xamarin and MAUI rely on the Mono framework, we also need to install it manually. I recommend the stable version. You’ll need to install it with right-click and selecting Open to unblock the installation file.

https://www.mono-project.com/download/stable/

Install Xamarin packages

The next step involves installing the Xamarin packages needed for compilation. Without them installed, the connection attempt will always fail. Only with them installed, the connection process can install the needed additional packages.

Xamarin.iOS and Xamarin.Mac

The Xamarin.iOS and Xamarin.Mac packages can be found on GitHub:

https://github.com/xamarin/xamarin-macios/blob/main/DOWNLOADS.md

Download and install the version that matches your Windows installation. In case you’re wondering about the Mac package – it seems to be a dependency for the build process. Only after installing it, I was able to connect from my VM.

Xamarin.Android

If you want to use a local Android emulator installed on your Mac, like I described here, you will need to install the Xamarin.Android package as well. The installer is on GitHub as well:

https://aka.ms/xamarin-android-commercial-d17-5-macos

You may need to download Android SDK tools as well:

https://developer.android.com/tools

Install MAUI workloads

If you want to compile .NET MAUI apps for the App Store, you will need to install also the MAUI workloads on your Mac. The process is well described in the Microsoft documentation:

https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload

Connect to the Mac

Once you have installed all the packages above, you should be able to connect with your Mac for compiling iOS applications:

VS2022 connected to a build host in the Pair to Mac dialog.

Conclusion

Even though Microsoft is killing VS4Mac, we still are able to connect from Windows machines to a Mac build host. The process is done in less than an hour and just involves some package installations. Of course, there is always the alternative of using other IDEs like Rider or VS Code (.NET MAUI support is still beta as of writing this post). I recommend keeping the downloaded packages in a save place (just in case). As always, I hope this post is helpful for some of you.

Until the next post, happy coding!

Update 2023-09-29: Added Mono installation step

Comments 1
Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Prev
How to use the Android emulator on a macOS host for debugging in a virtual machine with Windows
use-android-emu-mac-debug-windows-title

How to use the Android emulator on a macOS host for debugging in a virtual machine with Windows

Next
PSA: My side projects, time, and platforms
side-projects-time-title

PSA: My side projects, time, and platforms

You May Also Like

This website uses cookies. By continuing to use this site, you accept the use of cookies.  Learn more