Skip to main content

MacOS Desktop Development

info

Developing and compiling a Wisej.NET Hybrid application for macOS requires Visual Studio Code for macOS and the .NET MAUI Visual Studio Code extension.

Also ensure a compatible .NET Runtime and .NET MAUI workload is installed on the Mac.

Hybrid targets macOS through Mac Catalyst, not a separate AppKit target. Install the .NET SDK, matching MAUI workloads and a compatible Xcode version; a runtime alone cannot build the client. Follow the selected example's global.json and project targets. The current 4.1 examples use net9.0-maccatalyst where that platform is included. See Examples and Platform Capabilities.

Remote Hybrid​

To develop a Hybrid Remote application for macOS:

  1. Copy over the Hybrid Client project to the Mac development machine.
  2. Open the folder in Visual Studio Code for mac.
  3. Ensure a .NET MAUI run target is set:

  1. Select the project's Mac Catalyst target when building, for example dotnet build YourHybridClient.csproj -f net9.0-maccatalyst for a .NET 9 client.
  2. Run the project

Local Hybrid​

Local Hybrid applications are a bit more complex to build and deploy. The Wisej.NET designer is not supported on mac and Visual Studio Code.

The suggested approach is to build and develop the application on Windows and only copy over to mac when ready for distribution.

To debug a Local Hybrid application on mac:

  1. Copy over the Hybrid Client and Hybrid Local projects to the Mac development machine.
  2. Open the folder in Visual Studio Code for mac.
  3. Ensure a .NET MAUI run target is set:

  1. Build the client's Mac Catalyst target and ensure its referenced local projects provide compatible targets. Follow the selected sample's project files.
  2. Run the project.