# MacOS Desktop Development

{% hint style="info" %}
Developing and compiling a Wisej.NET Hybrid application for macOS requires [Visual Studio Code for macOS](https://code.visualstudio.com/download) and the [.NET MAUI Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.dotnet-maui).

Also ensure a compatible [.NET Runtime](https://dotnet.microsoft.com/en-us/download) and [.NET MAUI workload](https://learn.microsoft.com/en-us/dotnet/maui/get-started/installation?view=net-maui-8.0\&tabs=visual-studio-code) is installed on the Mac.
{% endhint %}

{% embed url="<https://youtu.be/-aDV2g8WrK0>" %}

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

<figure><img src="/files/ucQN9PgDbG1wSEjxNNFB" alt=""><figcaption></figcaption></figure>

4. Ensure only `net(TF)-maccatalyst` is listed under `<TargetFrameworks>` in the csproj file.
5. 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:

<figure><img src="/files/ucQN9PgDbG1wSEjxNNFB" alt=""><figcaption></figcaption></figure>

4. Ensure only `net(TF)-maccatalyst` is listed under `<TargetFrameworks>` in the csproj file for both projects (remove other targets).
5. Run the project.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wisej.com/hybrid/development/macos-desktop-development.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.