equadrat.Framework.Mvvm.Maui 6.4.3

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package equadrat.Framework.Mvvm.Maui --version 6.4.3                
NuGet\Install-Package equadrat.Framework.Mvvm.Maui -Version 6.4.3                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="equadrat.Framework.Mvvm.Maui" Version="6.4.3" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add equadrat.Framework.Mvvm.Maui --version 6.4.3                
#r "nuget: equadrat.Framework.Mvvm.Maui, 6.4.3"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install equadrat.Framework.Mvvm.Maui as a Cake Addin
#addin nuget:?package=equadrat.Framework.Mvvm.Maui&version=6.4.3

// Install equadrat.Framework.Mvvm.Maui as a Cake Tool
#tool nuget:?package=equadrat.Framework.Mvvm.Maui&version=6.4.3                

equadrat Framework Mvvm

The idea of the equadrat Framework is to provide APIs to build applications with an architecture of highly decoupled components. Every single component, aspect or pattern is represented by interfaces. The framework provides a standard implementation for these but each type can be replaced by a custom implementation.

The framework is not about reimplementing components, but making them available using common interfaces.

Getting started

You can use most of the components by simply instantiating them. This is maybe the easiest way to evaluate the framework.

If you're using an IOC/DI container such as Microsoft Extensions DependencyInjection or if you want to use the built-in IOC framework, you can use the bootstrapper and bootstrapper modules to register the framework to the IOC.

Usage

The only requirement for view models is to implement INotifyPropertyChanged.

Have a look at the example applications on my website: www.equadrat.net

Interesting components

This is a list of some (not all) components of the framework which might be interesting for you.

MVVM code generator

  • MvvmGeneratePropertyAttribute
    • Requires partial class
    • Requires MvvmViewModel base class
    • Use PropertyName & PropertyType to generate a property
    • Use DeclarationType to generate all properties of the specified type of interface

MVVM data container & helper

  • IMvvmDataContainerFactory
  • MvvmHelper

MVVM shell & navigation

  • IMvvmShellService
  • IMvvmNavigationService

MVVM views

  • IMvvmView
  • IMvvmViewFactory
  • IMvvmViewRegistry

MVVM view models

  • MvvmViewModel (optional to use)
    • Base implementation for view models
    • Event implementation
    • Creates a data container.

MVVM behaviors

  • MvvmViewModelPresenterBehavior
    • Creates the view for the assigned view model (context) of the current control.
  • MvvmViewModelProviderBehavior
    • Creates a view model and binds it to the control (context).
  • MvvmViewModelVisibilityBehavior
    • Synchronizes the view model "visibility" with the visibility of the current control.

Platforms

The MVVM implementation itself is platform agnostic, but there are supporting integrations for some major client GUI frameworks.

Compatibility

The plan is to keep the equadrat Framework compatible to these .net versions as long as possible.

.net version min max
Core 3.1 ≥ 8.x
Standard 2.0 ≥ 2.1
Framework 4.6.2 ≥ 4.8.x

Version scheme and breaking changes

Version change Scope
Major Overhaul of the project
Minor Some types have changed
Revision Fully backward compatible
Build Set in preview versions only

Additional documentation

You can find some guides regarding specific features on my website: www.equadrat.net

Feedback

You can contact me on my website: www.equadrat.net

License

Please respect the license and check equadrat.Framework.Mvvm.License.md before using the package.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on equadrat.Framework.Mvvm.Maui:

Package Downloads
equadrat.Framework.Mvvm.SinglePageView.Maui

A framework to extend the Microsoft .net framework with extra mvvm functionality.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
7.3.0 95 11/14/2024
7.2.1 116 9/21/2024
7.2.0 137 6/30/2024
7.1.0 139 4/20/2024
7.0.1 128 4/6/2024
7.0.0 128 4/1/2024
6.4.4 181 3/16/2024
6.4.3 140 3/9/2024
6.4.2 148 3/3/2024
6.4.1 149 2/10/2024
6.4.0 177 12/30/2023
6.3.3 200 11/15/2023
6.3.0 176 10/1/2023

====
v6.4.3
====
- Compatibility release.
====
v6.4.2
====
- Added code generator for MVVMP properties (equadrat.Framework.Mvvm.CodeGenerator) which can be configured using MvvmGeneratePropertyAttribute.
- Added platform package to support ASP.net WebAssembly.
- Added MvvmEventTracker component for Razor/WebAssembly to call ComponentBase.StateHasChanged when specific MVVM-related events are raised by an event source.
- Added MvvmViewModelVisibilitySetter component for Razor/WebAssembly to set the visibility of a view model while it is attached to a view and reset it on detach.
====
v6.4.1
====
- Added MvvmCloseWindowBehavior for Avalonia and WPF.
- Added IMvvmViewModelOptions.HandleIsModifiedChanged to configure a changed handler for the IsModified state of a view model.
====
v6.4.0
====
- Internal refacorings to use MaybeNullWhenAttribute when applicable.
====
v6.3.3
====
- Added .net 8 support.
====
v6.3.0
====
- Compatibility release.
====
v6.2.0
====
- Compatibility release.
====
v6.1.0
====
- Compatibility release.
====
v6.0.8
====
- Compatibility release.
- Upgraded Avalonia UI NuGet package references to v11.x.
====
v6.0.7
====
- Enabled IL trimming.
- Added README.md file to the NuGet package.
====
v6.0.3
====
- Compatibility release.
====
v6.0.2
====
- Internal release.
====
v6.0.1
====
- Renamed MvvmFrameworkBootstrapperModulesSelector to MvvmFrameworkBootstrapperModuleSelector.
====
v6.0.0
====
- Initial Release