👁 Image
SharedMauiCoreLibrary 1.2.9

SharedMauiCoreLibrary

A shared library containing recurring features & utilities for .NET MAUI applications

Support me

If you want to support me, you can order over following affilate links (I'll get a small share from your purchase from the corresponding store).

• Prusa: http://www.prusa3d.com/#a_aid=AndreasReitberger *
• Jake3D: https://tidd.ly/3x9JOBp *
• Amazon: https://amzn.to/2Z8PrDu *
• Coinbase: https://advanced.coinbase.com/join/KTKSEBP * (10€ in BTC for you if you open an account)
• TradeRepublic: https://refnocode.trade.re/wfnk80zm * (10€ in stocks for you if you open an account)

(*) Affiliate link Thank you very much for supporting me!

Nuget

Get the latest version from nuget.org<br> 👁 NuGet
👁 NuGet
👁 NuGet

Setup

Add the MauiProgram.cs add following line.

MauiAppBuilder builder = MauiApp.CreateBuilder();
builder
 .UseMauiApp<App>()
 .UseMauiCommunityToolkit()
 .ConfigureSyncfusionCore()
 .ConfigureCoreLibrary() // <= add this
 //...

This will automatically initialize following extensions.

.UseMauiCommunityToolkit()
.ConfigureDispatching()
.ConfigureDispatchManager() // Inits the DispatchManager with the configured dispatcher

Available content

Please find a list of available content below.

Utilities

UserSecretsManager

The UserSecretsManager helps you to manage your user secrets in your application. It reads the secrets.json file stored in the user profile folder.

if (Assembly is null)
{
 Assembly = IntrospectionExtensions.GetTypeInfo(typeof(MauiProgram)).Assembly;
 UserSecretsManager.Settings = new UserSecretsManager.UserSecretsManagerBuilder()
 .WithAppNamespace("SharedMauiXamlStylesLibrary.SampleApp")
 .WithCustomAssambly(Assembly)
 .Build();
}

Behaviors

Namespace

xmlns:behaviors="clr-namespace:AndreasReitberger.Shared.Core.Behaviors;assembly=SharedMauiCoreLibrary"

EventToCommandBehavior

This Behavior executes a Command when the specified Event is fired.

<sliders:SfSlider
 Margin="0,4"
 Minimum="0" Maximum="{Binding LimitFan}"
 StepSize="1"
 MinorTicksPerInterval="100"
 ShowLabels="True"
 >
 <sliders:SfSlider.Behaviors>
 <behaviors:EventToCommandBehavior
 EventName="ValueChangeEnd"
 Command="{Binding SetFanCommand}"
 />
 </sliders:SfSlider.Behaviors>
</sliders:SfSlider>

Converters

Namespace

xmlns:converters="clr-namespace:AndreasReitberger.Shared.Core.Converters;assembly=SharedMauiCoreLibrary"

BooleanReverseVisibilityConverter & BooleanVisibilityConverter

This Converter converts a Boolean into a reverse and non-reverse visibility (if value is true, it returns false)

<Label
 Style="{StaticResource SmallLabelStyle}" 
 TextColor="{DynamicResource Error}"
 Text="{x:Static localization:Strings.NotAvailableDots}"
 IsVisible="{Binding HasDoubleExtruder, Converter={StaticResource BooleanReverseVisibilityConverter}}"
 />

ByteArrayToImageConverter

This Converter converts a byte[] into an Image

<Image 
 VerticalOptions="Start"
 Margin="{OnIdiom Phone='-4,0', Tablet='-62,0', Default='-4,0'}"
 Source="{Binding Thumbnail, Converter={StaticResource ByteArrayToImageConverter}}" 
 >
 <Image.Style>
 <Style TargetType="Image">
 <Setter Property="Aspect" Value="AspectFit"/>
 <Style.Triggers>
 <DataTrigger
 TargetType="Image"
 Binding="{Binding IsPortrait}"
 Value="False">
 <Setter Property="Aspect" Value="AspectFill"/>
 </DataTrigger>
 </Style.Triggers>
 </Style>
 </Image.Style>
</Image>

ColorToBlackWhiteConverter

This Converter converts a Color into Colors.White or Colors.Black. This helps to get the accurate oreground for a colored Background.

<Border
 Background="{Binding HexCode, Converter={StaticResource StringToColorConverter}, Mode=OneWay}"
 >
 <Label 
 Text="{Binding HexCode}"
 TextColor="{Binding Source={RelativeSource AncestorType={x:Type Border}}, Path=Background, Converter={StaticResource BrushToBlackWhiteConverter}, Mode=OneWay}"
 Style="{StaticResource LabelStyle}"
 VerticalTextAlignment="Center"
 HorizontalTextAlignment="Center"
 />
 </Border>

DoubleHoursToTimeSpanConverter

This Converter converts a Double into a TimeSpan.

<Label 
 LineBreakMode="WordWrap" Margin="2,10,0,10"
 VerticalTextAlignment="Center"
 FontSize="{OnIdiom Tablet=14, Default=12}"
 >
 <Label.Style>
 <Style TargetType="Label" BasedOn="{StaticResource TitleViewHeadlineLabelStyle}">
 <Setter Property="IsVisible" Value="False"/>
 <Style.Triggers>
 <MultiTrigger
 TargetType="Label">
 <MultiTrigger.Conditions>
 <BindingCondition Binding="{Binding IsPrinting, Mode=TwoWay}" Value="True"/>
 <BindingCondition Binding="{Binding ShowRemainingPrintTimeInTitleView}" Value="True"/>
 </MultiTrigger.Conditions>
 <Setter Property="IsVisible" Value="True"/>
 </MultiTrigger>
 </Style.Triggers>
 </Style>
 </Label.Style>
 <Label.FormattedText>
 <FormattedString>
 <Span Text="("/>
 <Span Text="{Binding RemainingPrintTime, Converter={StaticResource DoubleHoursToTimeSpanConverter}}"/>
 <Span Text=")"/>
 </FormattedString>
 </Label.FormattedText>
</Label>

DoubleHoursToTimeSpanConverter

This Converter converts a List<string> into a single String with the defined separator char.

LongToGigaByteConverter

This Converter converts a long into a Double. The result wil be in GigaBytes.

LongToMegaByteConverter

This Converter converts a long into a Double. The result wil be in MegaBytes.

StringToColorConverter

This Converter converts a String (hex formated string) into a Color.

UnixDateToDateTimeConverter

This Converter converts a Double (UNIX based) into a DateTime.

<Label 
 LineBreakMode="WordWrap" Margin="2,10,0,10"
 VerticalTextAlignment="Center"
 FontSize="{OnIdiom Tablet=14, Default=12}"
 >
 <Label.FormattedText>
 <FormattedString>
 <Span Text="("/>
 <Span Text="{Binding CurrentDateTime, Converter={StaticResource UnixDateToDateTimeConverter}}"/>
 <Span Text=")"/>
 </FormattedString>
 </Label.FormattedText>
</Label>

UnixDoubleHoursToTimeSpanConverter

This Converter converts a Double (UNIX based) into a TimeSpan.

<Label 
 LineBreakMode="WordWrap" Margin="2,10,0,10"
 VerticalTextAlignment="Center"
 FontSize="{OnIdiom Tablet=14, Default=12}"
 >
 <Label.FormattedText>
 <FormattedString>
 <Span Text="("/>
 <Span Text="{Binding RemainingPrintTime, Converter={StaticResource UnixDoubleHoursToTimeSpanConverter}}"/>
 <Span Text=")"/>
 </FormattedString>
 </Label.FormattedText>
</Label>

UriToStringConverter

This Converter converts a Uri into a String.

Helpers

Namespace

namespace AndreasReitberger.Shared.Core

ViewModelBase

This Class contains all needed properties for a ViewModel. You can inherit from this Class directly for your ViewModel, or create an own ViewModelBase and inherit there form this class.

public partial class BaseViewModel : ViewModelBase
 {
 #region Properties

 #region App
 bool _isBeta = SettingsStaticDefault.App_IsBeta;
 public new bool IsBeta
 {
 get { return _isBeta; }
 set { SetProperty(ref _isBeta, value); }
 }
 bool _isLightVersion = SettingsStaticDefault.App_IsLightVersion;
 public bool IsLightVersion
 {
 get { return _isLightVersion; }
 set { SetProperty(ref _isLightVersion, value); }
 }

 bool _isTabletMode = false;
 public bool IsTabletMode
 {
 get { return _isTabletMode; }
 set { SetProperty(ref _isTabletMode, value); }
 }
 #endregion

 #region Navigation
 bool _isViewShown = false;
 public bool IsViewShown
 {
 get { return _isViewShown; }
 set { SetProperty(ref _isViewShown, value); }
 }
 #endregion

 #region Connection
 bool _isConnecting = false;
 public bool IsConnecting
 {
 get { return _isConnecting; }
 set { SetProperty(ref _isConnecting, value); }
 }
 #endregion
 
 #endregion

 #region Constructor
 public BaseViewModel()
 {

 }
 #endregion

 #region LiveCycle
 public void OnDisappearing()
 {
 try
 {
 if (SettingsApp.SettingsChanged)
 {
 // Notify other modules
 MessagingCenter.Send(new AppMessageInfo(), AppMessages.OnSettingsChanged.ToString());
 SettingsApp.SaveSettings();
 SettingsApp.SettingsChanged = false;
 }
 }
 catch (Exception exc)
 {
 // Log error
 EventManager.Instance.LogError(exc);
 }
 }
 #endregion
 }

JsonConvertHelper

This Class uses Newtonsoft.JSON in order to serialize and deserialize objects to strings and vice reverse. This is helpful if you want to store Collections or custom objects in the MAUI.Preferences (Settings).

// Convert to a String
SettingsApp.WebCam_DefaultWebCamSettings = JsonConvertHelper.ToSettingsString(value);

// Convert back to an object
ObservableCollection<KlipperWebCamSettingsInfo> webcams = JsonConvertHelper.ToObject(SettingsApp.WebCam_Settings, new ObservableCollection<KlipperWebCamSettingsInfo>());