There are a few issues opened on the maui repo saying changing the app icon is not working.

This is a result of 2 things:

1. No Platform Docs

The docs do not say that the developer is supposed to actually go change values in the manifests. This is probably confusing because by default Windows updates the appxmanifest, but Android/iOS/Mac Catalyst do not. The fact Windows updates was just a byproduct of other things. The initial design was to take a more conservative approach and just generate icons.

However, regardless of what is happening, the docs need to include a section of editing the platform manifests on all platforms. This includes the Package.appxmanaifest on Windows, AndroidManifest on Android and Info.plist on iOS/Mac Catalyst.

2. Inconsistent Build Behavior

As mentioned above, Windows generates the correct manifest entries by default. The other platforms do not.

This is partially be addressed in dotnet/maui#7968

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 2fc2b28d-e403-c63e-b7c4-6639fcd05a89
• Version Independent ID: 2fc2b28d-e403-c63e-b7c4-6639fcd05a89
• Content: Add an app icon to a .NET MAUI app project - .NET MAUI
• Content Source: docs/user-interface/images/app-icons.md
• Product: dotnet-mobile
• Technology: dotnet-maui
• GitHub Login: @davidbritch
• Microsoft Alias: dabritch