Prepare .NET MAUI application with CommunityToolkit.MAUI to release

Prepare .NET MAUI application with CommunityToolkit.MAUI to release

04 October 2022

.NET MAUI/Xamarin

Buy Me A Coffee

FadeAnimation, GravatarImageSource, StatusBar color. All these features are available with CommunityToolkit.MAUI 1.3.0. And that's not all.

Usually, to start working with the .NET MAUI Community Toolkit, you need to initialize it with MauiAppBuilder by calling the UseMauiCommunityToolkit method:

Starting from this release you can get even more control over the ComminityToolkit.Maui library and CommunityToolkit.Maui.Options can help you with that:

There are 3 new options available right now to prevent your application from crashing.

SetShouldSuppressExceptionsInConverters

When set to true, if a converter is implementing CommunityToolkit.Maui.Converters.BaseConverter throws an Exception, the Exception will be caught and a predetermined default value will be returned.

A default value can be set from both the Convert and ConvertBack methods using the DefaultConvertReturnValue and DefaultConvertBackReturnValue properties respectively.

SetShouldSuppressExceptionsInAnimations

Similar to the SetShouldSuppressExceptionsInConverters, when set to true, if an Animation is implementing CommunityToolkit.Maui.Behaviors.AnimationBehavior throws an Exception, the Exception will be caught.

With this option, you don't need to worry about unexpected crashes of your application.

SetShouldSuppressExceptionsInBehaviors

The last but not least option is for behaviors. When set to true, if a Behavior is implementing CommunityToolkit.Maui.Behaviors.BaseBehavior throws an Exception, the Exception will be caught.

Release mode recommendation

All that settings are disabled by default. it happened because of back-compatibility and easier migration for Xamarin users.

It is definitely up to the developer, to enable or disable these options in the app, but I recommend the next code:

In Debug we can enable all exceptions and notify the developer at the earliest stage if something goes wrong.

In all other cases, we should avoid application crashes and try to notify users in a friendlier form.

More details can be found on the Microsoft Docs.

Happy coding without crashes and bugs!

Buy Me A Coffee

Related:

Customize map pins in .NET MAUI

Customize map pins in .NET MAUI.

Azure Active Directory authentication in .NET MAUI

Create a small mobile application, which requires user authentication, using .NET MAUI (AD and AD B2C).

An unhandled error has occurred. Reload

🗙