SettingsMaui 1.0.2
See the version list below for details.
dotnet add package SettingsMaui --version 1.0.2
NuGet\Install-Package SettingsMaui -Version 1.0.2
<PackageReference Include="SettingsMaui" Version="1.0.2" />
paket add SettingsMaui --version 1.0.2
#r "nuget: SettingsMaui, 1.0.2"
// Install SettingsMaui as a Cake Addin #addin nuget:?package=SettingsMaui&version=1.0.2 // Install SettingsMaui as a Cake Tool #tool nuget:?package=SettingsMaui&version=1.0.2
MauiSettings
A nuget to improve settings storage (locally and eventually in the cloud) on .NET MAUI projects.
The plugin idea is based on the Advexp.Settings.Local nuget by Alexey Ivakin</br> Repo: https://bitbucket.org/advexp/component-advexp.settings/src/master/</br> License: Apache-2.0 (https://licenses.nuget.org/Apache-2.0)</br>
This project was created from scratch, however uses the basic idea to keep all Settings in the static object. All taken and changed files have been marked so.
Nuget
Get the latest version from nuget.org<br>
Usage
Settings Object
In the .NET MAUI project, create a new Class
(for instance SettingsApp.cs
) holding your setting properties.
public partial class SettingsApp : MauiSettings<SettingsApp>
{
#region Settings
#region Version
[MauiSetting(Name = nameof(App_SettingsVersion))]
public static Version App_SettingsVersion { get; set; } = new("1.0.0");
#endregion
#region CloudSync
[MauiSetting(Name = nameof(Cloud_ShowInitialPrompt), DefaultValue = true)]
public static bool Cloud_ShowInitialPrompt { get; set; }
[MauiSetting(Name = nameof(Cloud_ShowInitialPrompt), DefaultValue = SettingsStaticDefault.Cloud_EnableSync)]
public static bool Cloud_EnableSync { get; set; }
#endregion
#region Theme
[MauiSetting(Name = nameof(Theme_UseDeviceDefaultSettings), DefaultValue = SettingsStaticDefault.General_UseDeviceSettings)]
public static bool Theme_UseDeviceDefaultSettings { get; set; }
[MauiSetting(Name = nameof(Theme_UseDarkTheme), DefaultValue = SettingsStaticDefault.General_UseDarkTheme)]
public static bool Theme_UseDarkTheme { get; set; }
[MauiSetting(Name = nameof(Theme_PrimaryThemeColor), DefaultValue = SettingsStaticDefault.Theme_PrimaryThemeColor)]
public static string Theme_PrimaryThemeColor { get; set; }
#endregion
#region Localization
[MauiSetting(Name = nameof(Localization_CultureCode), DefaultValue = SettingsStaticDefault.Localization_Default)]
public static string Localization_CultureCode { get; set; }
#endregion
#endregion
}
Load
To load the settings from the storage, call SettingsApp.LoadSettings()
(mostly in the App
constructor of your App.xmls file. The project uses the Maui.Storage.Preferences
in order to store the settings on the corresponding device.
Save
Whenever you do make changes to a settings property of your class, call SettingsApp.SaveSettings()
. This will write the settings to the storage.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net7.0 is compatible. net7.0-android was computed. net7.0-android33.0 is compatible. net7.0-ios was computed. net7.0-ios16.1 is compatible. net7.0-maccatalyst was computed. net7.0-maccatalyst16.1 is compatible. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net7.0-windows10.0.19041 is compatible. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net7.0
- Newtonsoft.Json (>= 13.0.2)
-
net7.0-android33.0
- Newtonsoft.Json (>= 13.0.2)
-
net7.0-ios16.1
- Newtonsoft.Json (>= 13.0.2)
-
net7.0-maccatalyst16.1
- Newtonsoft.Json (>= 13.0.2)
-
net7.0-windows10.0.19041
- Newtonsoft.Json (>= 13.0.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.