[BUG] - I can't make Oqtane.Maui working on a mac

[vnetonline]

Oqtane Info

Version - 10.0.3
Render Mode - Static
Interactivity - Server
Database - SQL Server

Describe the bug

When i try and build the project i am geting the following error

Expected Behavior

Should be able to build and run the project

Steps To Reproduce

Anything else?

When create a new Maui Blazor Hybrid App that works fine

[sbwalker]

@vnetonline the .NET MAUI project builds fine in Visual Studio 2026:

Also note that by default it is only configured to build the Windows platform (*.csproj):

<PropertyGroup>
    <TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net10.0-windows10.0.19041.0</TargetFrameworks>
    <!-- Uncomment to also build android, ios, and maccatalyst -->
    <!-- <TargetFrameworks>net10.0-android;net10.0-ios;net10.0-maccatalyst</TargetFrameworks> -->

[vnetonline]

I am using Rider as the IDE on mac and it doesn't work on the mac but like i said if i create a Blazor Hybrid App solution from Rider that complies and works.

I have checked the config everything matches

[sbwalker]

@vnetonline I have no idea and I do not have access to a Mac. Please share the solution if you are able to resolve the problem.

[vnetonline]

what i have noticed is some dependencies are missing and i am not sure how to add them in rider

as you can see in the above image

• .Net 10.0 (andriod)
• .Net 10.0 (ios)
• .Net 10.0 (maccatalyst)

any ideas any one, so we are clear i have uncommented the below in the (*.csproj)

<PropertyGroup>
    <TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net10.0-windows10.0.19041.0</TargetFrameworks>
    <!-- Uncomment to also build android, ios, and maccatalyst -->
    <TargetFrameworks>net10.0-android;net10.0-ios;net10.0-maccatalyst</TargetFrameworks>

[vnetonline]

Okay so after a week of tinkering I have managed to get the Oqtane.Maui running

Basically what I did was I used my windows machine with Visual Studio 2026 to connect to my Mac using the Pair to Mac feature

I also had to install docker on my mac with SQL Server 2022 and run the Oqtane.Server on the Mac.

On the windows machine i then run the Oqtane.Maui and run it in simulator

however the result I get is, seems like static files are not loading in sumilator and the CSS is broken

any help with this wold be great

[mdmontesinos]

@vnetonline Unfortunately, Oqtane is not 100% "compatible" with MAUI by default. Basically, all the static assets (css, js, icons, etc) are requested locally in the client app instead of from the remote server. Therefore, you need to copy all the assets to the MAUI solution. Apart from that, images inserted in the HtmlText module use relative paths, so they are also requested locally and not from the server, and this has not an easy solution.

There are some approaches to try to fix this, but no solution yet.

Check these issues for more info about the topic: #5041, #5797

[sbwalker]

@vnetonline actually what @mdmontesinos said is not entirely true. Currently Oqtane detects if it is running in .NET MAUI and if so, it creates links to static assets (css, js, icons) as absolute paths (ie. it includes the bath path using the property alias.BaseUrl). This way static assets are loaded from the server rather than from the local device. It is only relative links which are assumed to be local to the .NET MAUI device (which is a default behavior of the .NET MAUI WebView). So by default, Oqtane will run in .NET MAUI and it will load static assets from the server (there are many online demos I have recorded where I have demonstrated Oqtane running as a .NET MAUI Windows app). However, if you are developing or using custom modules which do not follow the framework conventions (ie. alias.BaseUrl) and generate links with relative paths, then they will not work in .NET MAUI as expected. Another consideration is that if you are trying to run .NET MAUI in an emulator or as an external iPhone or Android app you may run into issues with content security policies (CSP) in the WebView ie. you cannot mix secure and insecure links in your page content.

[mdmontesinos]

@sbwalker So why are the Oqtane assets still copied into the MAUI solution and synchronized? If they are always requested from the server shouldn't you be able to remove them?

And about custom modules/themes, yes, you need to be extremely careful when designing them to make it MAUI compatible. But IIRC, the HtmlText module also suffers form these problems.

[sbwalker]

@mdmontesinos I believe you are referring to the fact that some of the core framework static assets are included in the .NET MAUI client project:

These are included with the .NET MAUI client for performance reasons.

However, all static assets identified in themes/modules are loaded from the server using an absolute path. And the HtmlText module is also designed to include absolute paths for image urls so that they are loaded from the server (the Utilities.FormatContent() method references alias.BaseUrl so I am not sure why it would not behave properly).

[sbwalker]

@mdmontesinos I will also say that when .NET MAUI support was added to Oqtane way back in 2023, I was not 100% satisfied with the fact that all links had to be translated to absolute paths when running in .NET MAUI. This solution works but it felt overly intrusive on the framework and on developers, and seemed to me like it should be delegated to the WebView component. I logged an issue in the ASP.NET repo related to this problem and it resulted in the new feature offered in .NET 10 (https://learn.microsoft.com/en-us/dotnet/maui/whats-new/dotnet-10?view=net-maui-10.0#intercept-web-requests). I do think the enhancement you suggested in #5797 which uses this new feature is worth exploring - however I don't think it will resolve some of the other security/networking problems related to CSP, latency, etc... when running on platforms like Android or iOS. These problems are not specific to Oqtane - they are fundamental issues with the hybrid webview approach when accessing external resources on different domains/protocols.

[mdmontesinos]

@mdmontesinos I believe you are referring to the fact that some of the core framework static assets are included in the .NET MAUI client project:

These are included with the .NET MAUI client for performance reasons.

However, all static assets identified in themes/modules are loaded from the server using an absolute path. And the HtmlText module is also designed to include absolute paths for image urls so that they are loaded from the server (the Utilities.FormatContent() method references alias.BaseUrl so I am not sure why it would not behave properly).

I might need to revisit some aspects about the integration with MAUI, as you're right about the Utilities.FormatContent() so I'm unsure about why it failed. It's been a while since I did some testing.

And I understand that these issues are not specific to Oqtane.