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

{% embed url="<https://docs.wisej.com/license/license-model-2023/hybrid-licenses>" %}

You can restore the default splash using this image:

{% file src="/files/hUg5A0Fx6VeemIWxwVfY" %}
Default Splash Image
{% endfile %}

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

{% embed url="<https://docs.wisej.com/license/license-model-2023/hybrid-licenses>" %}

You can restore the default app icons using these images:

{% file src="/files/DK4FvGMF0zCi1EtzRTLQ" %}
Default App Icons
{% endfile %}

```xml-doc
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.)'

{% content-ref url="/pages/27LZyPWLLyw0bQy8BCC0" %}
[Multiple Windows (Desktop)](/hybrid/development/multiple-windows-desktop.md)
{% endcontent-ref %}

## System.Drawing... is ambiguous

Add this to the project file:

```xml
<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](https://learn.microsoft.com/en-us/dotnet/core/deploying/trimming/trimming-options), linking or Ahead-of-Time (AOT) compilation at the moment. Please ensure all of these features are disabled when compiling a release build.

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

{% hint style="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.
{% endhint %}

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"

{% embed url="<https://developercommunity.visualstudio.com/t/Blazor-maui-app-The-ALToolValidate-tas/10616007?space=41&sort=newest>" %}


---

# 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/start/troubleshooting.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.