Please note that this page content refers to a pre-release version of software. Please read the information below thoroughly for more information.
M-Files have published to nuget templates for use with the
dotnet new CLI. These templates can be used outside of Visual Studio to create VAF applications that are then maintained using IDEs such as Visual studio Code or JetBrains Rider.
M-Files currently provide a single template (
vaf-latest-empty), but we may include more in the package in the future.
Installing and managing the templates
Installing the templates only needs to be done once.
To install the templates, open a command line and use the
dotnet new --install command:
dotnet new --install MFiles.ProjectTemplates
You should see a message indicating that the template(s) were installed.
Uninstalling the templates
If you ever need to uninstall the templates, open a command line and use the
dotnet new --uninstall command:
dotnet new --uninstall MFiles.ProjectTemplates
Updating the templates
To check for updates to all templates, open a command line and use the
dotnet new --update-check command:
dotnet new --update-check
To apply any incoming changes to all templates, open a command line and use the
dotnet new --update-apply command:
dotnet new --update-apply
When creating a project from the template, the CLI may indicate whether an update to the template is available.
Creating projects from the templates
This section deals with using the templates via the command line. Some IDEs, such as JetBrains Rider, provide user interfaces to allow these templates to be more easily used.
Projects can be created from the templates using the
dotnet new command:
- Open a command prompt.
- If using the templates for the first time, install the templates.
- Navigate to the folder into which you would like to create your project. Your folder name will be used for the project name, so ensure that it complies with standard .NET project naming rules (a good rule of thumb is to only use alphanumeric characters, and ensure that your project does not start with a number).
dotnet new vaf-latest-emptyto create the solution, project, and supporting files.
Using Visual Studio Code
Once a project is created, the folder can be opened using Visual Studio Code. Visual Studio Code automatically understands the C# project format and should automatically provide IntelliSense for the referenced items.
Using JetBrains Rider
JetBrains Rider contains deep integration into the
dotnet new templating system.
Once the templates have been installed, creating a new solution using JetBrains Rider should provide the option of “M-Files Vault Application 2.3” in the list on the left, under “Other”.