https://github.com/damienaicheh/mvvmcodegenerator
Mvvm generator C#
https://github.com/damienaicheh/mvvmcodegenerator
csharp generator mvvm
Last synced: about 1 year ago
JSON representation
Mvvm generator C#
- Host: GitHub
- URL: https://github.com/damienaicheh/mvvmcodegenerator
- Owner: damienaicheh
- License: mit
- Created: 2019-07-17T18:47:57.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-09-15T19:39:12.000Z (almost 7 years ago)
- Last Synced: 2025-04-02T06:51:10.749Z (about 1 year ago)
- Topics: csharp, generator, mvvm
- Language: C#
- Homepage: https://damienaicheh.github.io/nuget/xamarin/xamarin.forms/dotnet/2019/07/31/a-complete-overview-of-mvvmcodegenerator-en.html
- Size: 575 KB
- Stars: 26
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
MVVM code generator tool for .NET.
## Install
Available on [NuGet](https://www.nuget.org/packages/MvvmCodeGenerator).
## Why ?
I decided to create this tool to avoid having to always write boilerplate code for my ViewModels. This NuGet is built on top of the [Rosyln .NET compiler](https://github.com/dotnet/roslyn).
The advantages of using it are :
* Reduce the amount of code in your ViewModels
* The ViewModels only contains the more important code
* Migrate from one MVVM Framework to another easily
## Features
This NuGet allows you to generate your ViewModels with the Properties and Commands specified in your XML file. The code generated will depend on the Mvvm Frameworks you like.
This tool now support these MVVM Frameworks:
* [MvvmLightLibs](https://www.nuget.org/packages/MvvmLightLibs/)
* [MvvmCross](https://www.nuget.org/packages/MvvmCross/)
* [Mvvmicro](https://www.nuget.org/packages/Mvvmicro/)
* [FreshMvvm](https://www.nuget.org/packages/FreshMvvm/)
* [Prism.Core](https://www.nuget.org/packages/Prism.Core/)
## Tutorial
You will find a complete tutorial here:
##### English version :
[https://damienaicheh.github.io/nuget/xamarin/xamarin.forms/dotnet/2019/07/31/a-complete-overview-of-mvvmcodegenerator-en](https://damienaicheh.github.io/nuget/xamarin/xamarin.forms/dotnet/2019/07/31/a-complete-overview-of-mvvmcodegenerator-en)
##### French version :
[https://damienaicheh.github.io/nuget/xamarin/xamarin.forms/dotnet/2019/07/31/a-complete-overview-of-mvvmcodegenerator-fr](https://damienaicheh.github.io/nuget/xamarin/xamarin.forms/dotnet/2019/07/31/a-complete-overview-of-mvvmcodegenerator-fr)
## Usage
### Setup
First of all, install the [NuGet](https://www.nuget.org/packages/MvvmCodeGenerator) package to your .NetStandard project for example.
Then create a new file called `MvvmCodeGenMapper.xml` at the root of your library project. This file will contain the definition of your ViewModels.
### Configure your generator
Now it's time to define which generator we want to use, 4 options are available:
* mvvmlightlibs
* mvvmcross
* mvvmicro
* freshmvvm
* prismcore
Choose the one you like and declare it inside your `MvvmCodeGenMapper.xml` like this:
```xml
```
### Create your ViewModels
Let's define the ViewModels inside the `ViewModels` tags. You can define as many `ViewModels` tags as needed. Here is an example:
```xml
```
As you can see above, you can specify a list of ViewModels for a specific namespace and destination folder.
This XML will generate the 2 ViewModels with their **.g.cs** class associated:
The `RootViewModel.cs`:
```csharp
namespace MvvmCodeGenerator.Sample
{
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using GalaSoft.MvvmLight.Command;
public partial class RootViewModel
{
}
}
```
The `RootViewModel.interface.g.cs`:
```csharp
//------------------------------------------------------------------------------
//
// This code was generated by MvvmCodeGenerator.
// Runtime Version:4.0.30319.42000
//
// Changes to this file may cause incorrect behavior and will be lost if
// the code is regenerated.
//
//------------------------------------------------------------------------------
namespace MvvmCodeGenerator.Sample
{
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using GalaSoft.MvvmLight.Command;
public interface IRootViewModel : System.ComponentModel.INotifyPropertyChanged
{
System.Boolean IsLoading
{
get;
}
}
}
```
The `RootViewModel.part.g.cs`:
```csharp
//------------------------------------------------------------------------------
//
// This code was generated by MvvmCodeGenerator.
// Runtime Version:4.0.30319.42000
//
// Changes to this file may cause incorrect behavior and will be lost if
// the code is regenerated.
//
//------------------------------------------------------------------------------
namespace MvvmCodeGenerator.Sample
{
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using GalaSoft.MvvmLight.Command;
public partial class RootViewModel : GalaSoft.MvvmLight.ViewModelBase, MvvmCodeGenerator.Sample.IRootViewModel
{
private System.Boolean isLoading;
///
// Gets or sets the loader property.
///
public System.Boolean IsLoading
{
get => this.isLoading;
set => this.Set(ref this.isLoading, value);
}
}
}
```
The `DashboardViewModel.cs` where you will implement the Commands declared:
```csharp
Folder destination ./MvvmCodeGenerator.Dev/ViewModel
namespace MvvmCodeGenerator.Sample
{
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using GalaSoft.MvvmLight.Command;
public partial class DashboardViewModel
{
}
}
```
The `DashboardViewModel.interface.g.cs`:
```csharp
//------------------------------------------------------------------------------
//
// This code was generated by MvvmCodeGenerator.
// Runtime Version:4.0.30319.42000
//
// Changes to this file may cause incorrect behavior and will be lost if
// the code is regenerated.
//
//------------------------------------------------------------------------------
namespace MvvmCodeGenerator.Sample
{
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using GalaSoft.MvvmLight.Command;
public interface IDashboardViewModel : MvvmCodeGenerator.Sample.IRootViewModel
{
System.String Title
{
get;
}
System.Windows.Input.ICommand BuyCommand
{
get;
}
System.Boolean IsConsultationCommandRunning
{
get;
}
System.Windows.Input.ICommand ConsultationCommand
{
get;
}
}
}
```
The `DashboardViewModel.part.g.cs`:
```csharp
//------------------------------------------------------------------------------
//
// This code was generated by MvvmCodeGenerator.
// Runtime Version:4.0.30319.42000
//
// Changes to this file may cause incorrect behavior and will be lost if
// the code is regenerated.
//
//------------------------------------------------------------------------------
namespace MvvmCodeGenerator.Sample
{
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using GalaSoft.MvvmLight.Command;
public partial class DashboardViewModel : MvvmCodeGenerator.Sample.RootViewModel, MvvmCodeGenerator.Sample.IDashboardViewModel
{
private System.String title;
private System.Boolean isConsultationCommandRunning;
private GalaSoft.MvvmLight.Command.RelayCommand buyCommand;
private GalaSoft.MvvmLight.Command.RelayCommand consultationCommand;
///
// Gets or sets the title.
///
public System.String Title
{
get => this.title;
set => this.Set(ref this.title, value);
}
///
// Gets or sets the value to know if the associated async command is running.
///
public System.Boolean IsConsultationCommandRunning
{
get => this.isConsultationCommandRunning;
set => this.Set(ref this.isConsultationCommandRunning, value);
}
///
// Gets or sets the command to buy a boat
///
public System.Windows.Input.ICommand BuyCommand
{
get => this.buyCommand ?? (this.buyCommand = new GalaSoft.MvvmLight.Command.RelayCommand(ExecuteBuyCommand)); // You must implement the following method(s): ExecuteBuyCommand and OnExecuteBuyCommandAsyncError
}
///
// Gets or sets the command to consult my orders
///
public System.Windows.Input.ICommand ConsultationCommand
{
get => this.consultationCommand ?? (this.consultationCommand = new GalaSoft.MvvmLight.Command.RelayCommand(async (value) =>
{
try
{
this.IsConsultationCommandRunning = true;
await ExecuteConsultationCommandAsync(value);
}
catch (System.Exception ex)
{
OnExecuteConsultationCommandAsyncError(ex);
}
finally
{
this.IsConsultationCommandRunning = false;
}
}
, CanExecuteConsultationCommand)); // You must implement the following method(s): ExecuteConsultationCommandAsync and the CanExecuteConsultationCommand and OnExecuteConsultationCommandAsyncError
}
}
}
```
Now you juste have to implement the commands in each *ViewModel.cs* file.
A *IsRunning* property is added in the case of **MvvmLightLibs** and **FreshMvvm** async commands for you. **MvvmCross** and **Mvvmicro** already have this kind of mechanism.
### Define your ViewModels and ItemViewModels
Each `ViewModel` tag has different properties :
* **Key** : The ViewModel name prefix
* **Base** : The ViewModel name prefix of the parent class
If you want to generate an ItemViewModel for each items of a listview for example, just use the `ItemViewModel` tag instead of `ViewModel`. You will have the same properties than the `ViewModel` tag available.
You can specify the **Properties** and **Commands** for each ViewModels:
For the **Properties** you have the ability to define it using the `Property` tag:
* **Name** : The name of the property
* **Description** : The comment associated to the property
* **Type** : The type of the property
You have different options to specify the **Type** of your property
Here the list of base types that can be used:
* **string**
* **int**
* **long**
* **bool**
* **float**
* **object**
* **double**
* **DateTime**
* **DateTimeOffset**
* **TimeSpan**
If the type you need is not in this list, you can just specify it using the complete namespace for example:
```xml
```
You can also declare a list like this:
```xml
```
For the **Commands** you have the ability to define:
* Synchronous command using the `Command` tag
* Asynchronous command using the `AsyncCommand` tag
Each command tag has different properties:
* **Name** : The name of the command
* **Parameter** : The parameter type of the command
* **CanExecute** : A boolean to know if the command must have a can execute method or not
* **Description** : The comment associated to the command
### Visual Studio display
If you build your project now, you will have this kind of result:
If your files are not grouped correctly like above, please check if the `MvvmCodeGenMapper.g.targets` file was imported correctly in your *.csproj* associated to your project. If it's not the case you can do it manually by adding this line:
```xml
```
Relaod your project and you will be good to go.
You will find a full example in the `Xamarin.Sample` project [here](https://github.com/damienaicheh/MvvmCodeGenerator/tree/master/Sources/Xamarin.Sample)
## Contributions
Contributions are welcome! If you find a bug or if you want a feature please report it.
If you want to contribute create a branch from the current master branch and when your code is ready create a pull request.
### License
© [Damien Aicheh](https://damienaicheh.github.io/)