Skip to main content

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:

Hybrid Licenses

You can restore the default splash using this image:

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:

Hybrid Licenses

You can restore the default app icons using these images:

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>
info

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=newest