Troubleshooting

This plan does not support using a custom splash. Please revert to the default splash.

This error will occur when trying to customize the Hybrid application's startup splash screen without a paid plan. You can view licensing options here:

https://docs.wisej.com/license/license-model-2023/hybrid-licensesdocs.wisej.com

You can restore the default splash using this image:

1008B

Splash.zip

archive

Open

Default Splash Image

Hybrid Client .csproj file

<!-- Splash Screen -->
<HybridSplashScreen Include="Resources\Splash\splash.svg" BaseSize="456,456" />

This plan does not support using a custom app icon. Please revert to the default splash.

This error will occur when trying to customize the Hybrid application's app icon without a paid plan. You can view licensing options here:

https://docs.wisej.com/license/license-model-2023/hybrid-licensesdocs.wisej.com

You can restore the default app icons using these images:

1KB

AppIcon.zip

archive

Open

Default App Icons

Hybrid Client .csproj file

<!-- App Icon -->
<MauiIcon Include="Resources\AppIcon\appicon.svg" ForegroundFile="Resources\AppIcon\appiconfg.svg" />

To build this project, the following workloads must be installed: android

This error occurs when the android workload is not installed.

Run dotnet workload install android from the command prompt.

To build this project, the following workloads must be installed: wasm-tools

This error occurs when wasm-tools are not installed.

Run dotnet workload install wasm-tools from the command prompt.

DEP0700: Registration of the app failed. [0x80073CF6] AppxManifest.xml(34,27): error 0x80070002: Cannot install or update package [PACKAGE] because the splash screen image [splashSplashScreen.png] cannot be located. Verify that the package contains an image that can be used as a splash screen for the application, and that the package manifest points to the correct location in the package where this splash screen image can be found.

This error can occur when the package is locked. Either wait a minute and rebuild or change the GUID of the project inside of the Hybrid Client csproj file.

System.IO.FileNotFoundException: 'Could not load file or assembly '.../Xamarin.HotReload.Contracts.dll' or one of its dependencies.'

and

System.IO.FileNotFoundException: 'Could not load file or assembly '.../Microsoft.VisualStudio.DesignTools.TapContract.dll' or one of its dependencies.'

The solution for these errors is to disable Hot Reload while debugging or disable Common Language Runtime Exceptions.

Go to Tools -> Options -> Debugging -> XAML Hot Reload -> Uncheck Android and iOS (.NET MAUI)

System.AggregateException: 'One or more errors occurred. (Only one usage of each socket address (protocol/network address/port) is normally permitted.)'

Multiple Windows (Desktop)

System.Drawing... is ambiguous

Add this to the project file:

<ItemGroup Condition="'$(TargetFramework)' != 'net48'">
    <PackageReference Include="System.Drawing.Common" Version="7.0.0" ExcludeAssets="All" />
</ItemGroup>

Application works in Debug mode but fails in Release mode configuration

Wisej.NET Hybrid Projects do not support trimming, linking or Ahead-of-Time (AOT) compilation at the moment. Please ensure all of these features are disabled when compiling a release build.

<PropertyGroup>
    <!-- All Platforms -->
    <Optimize>false</Optimize>
    <EnableAssemblyILStripping>false</EnableAssemblyILStripping>
    
    <!-- iOS -->
    <MtouchLink>None</MtouchLink>
    
    <!-- Android -->
    <MtouchUseLlvm>False</MtouchUseLlvm>
    <RunAOTCompilation>False</RunAOTCompilation>
</PropertyGroup>

If your .NET MAUI iOS app or ARM64-based Mac Catalyst app works correctly as a debug build but then crashes as a release build, try enabling the interpreter for your app's release build. It may be that your app, or one of its libraries, uses a feature that requires the interpreter.

Application Stuck when All Common Runtime Exceptions enabled

Ensure Options > General > Just My Code is enabled.

"ALToolValidate" task was not given a value for the required parameter "FilePath"

https://developercommunity.visualstudio.com/t/Blazor-maui-app-The-ALToolValidate-tas/10616007?space=41&sort=newestdevelopercommunity.visualstudio.com