Create a new Delta Shell plugin

Exercise outline

The goal of this exercise is to show how a new plugin can be developed using the Delta Shell Application plugin Nuget package. The Delta Shell NuGet package will be used in order to make a quick start.

Create a new C# project

Start Visual Studio 2013 and create a new C# project (File | New | Project...) by configuring the project wizard as shown in the following image:

 

Afterwards, a solution should be created with a structure as shown in the following image:

The default class named Class1.cs can be removed.

Add the Delta Shell application plugin package to the project using NuGet

A Visual Studio extension called NuGet will be used to add the Delta Shell application plugin package to the newly created project.

The Delta Shell application plugin package is built on the TeamCity build server. We must add the build server package feed address to the package locations of NuGet. This can be done, by opening the options of Visual studio (click TOOLS | Options) and browse to the section Package Sources in the settings for the NuGet Package Manager.

In the Package Sources, add a new source by using the + button and add the following information :

It is also possible to use the packages from a local source, if you have the files on your system. In this case, the source would be the folder in the computer in which the NuGet package files can be found. For example:

In order to make use of the Delta Shell Application Plugin, open the NuGet package manager (right click the solution | Manage NuGet Packages for Solution...) and search for the Delta Shell application plugin package in the source that you want to use. For example, if you select TeamCityAuth, shown in a solid line in the figure, Visual Studio will contact the build server above indicated, and will show the available packages in there:

Alternatively, if you want to use your local source, simply select the previously indicated feed source, Local packages in a dashed line in the figure above.

In other versions of Visual Studio, the interface can be slightly different, for example in VS 2015, the source of the packages can be found in a drop down menu on the NuGet Solution view (highlighted in orange):

In either case, proceed to install the Delta Shel Application plugin.

In Visual Studio 2013, you will be asked to select the project into which you want to INSTALL the NuGet package. Select Deltashell.Plugins.VolumeModel :

Complete the install by pressing ok. This may take a while because Nuget will now download the DeltaShell framework and runs install scripts to configure your project for use as a deltashell plugin.

After installing the package your project will look something like this :

Remove postsharp from project

In this tutorial we don't use PostSharp because it needs a license. PostSharp is mostly used for automatically adding code for property and collection changed events and event bubbling.

To remove postsharp do the following :

1. Remove postsharp reference and "RequiresPostSharp.cs" from the project (see the selected items in previous image)
2. Open the packages.config and remove the postsharp reference "<package id="PostSharp" version="2.1.7.28" targetFramework="net40" />"
3. Unload the project (right click on project - Unload project)
   Edit project file (right click on project - Edit DeltaShell.Plugins.VolumeModel.csproj)
   Remove (near the end of the csproj) <Import Project="..\packages\PostSharp.2.1.7.28\tools\PostSharp.targets" Condition="Exists('..\packages\PostSharp.2.1.7.28\tools\PostSharp.targets')" />
   Load project

Set startup project

Start by building the project. This will copy DeltaShell to the bin folder next to your solution file (D:\VolumeModel\bin)
Now open the project properties and go to the debug page and change set the startup program to : D:\VolumeModel\bin\Debug\DeltaShell\DeltaShell.Gui.exe

Create an application plugin class

Add a class named "VolumeModelApplicationPlugin " to the project and add the following code describing the application part of the plugin:

using DelftTools.Shell.Core;
using Mono.Addins;

namespace DeltaShell.Plugins.VolumeModel
{
    [Extension(typeof(IPlugin))]
    public class VolumeModelApplicationPlugin : ApplicationPlugin
    {
        public override string Name
        {
            get { return "VolumeModelApplication"; }
        }
        public override string DisplayName
        {
            get { return "Volume model application"; }
        }
        public override string Description
        {
            get { return "Application plugin of the volume model application"; }
        }
        public override string Version
        {
            get { return "1.0"; }
        }
        public override string FileFormatVersion
        {
            get { return "1.0"; }
        }
    }
}

Created an gui plugin class

Create a class named "VolumeModelGuiPlugin" to the project and add the following code describing Gui part of the plugin:

using DelftTools.Shell.Core;
using DelftTools.Shell.Gui;
using Mono.Addins;
namespace DeltaShell.Plugins.VolumeModel
{
    [Extension(typeof(IPlugin))]
    public class VolumeModelGuiPlugin : GuiPlugin
    {
        public override string Name
        {
            get { return "VolumeModelApplicationUI"; }
        }
        public override string DisplayName
        {
            get { return "Volume model application (UI)"; }
        }
        public override string Description
        {
            get { return "Gui plugin of the volume model application"; }
        }
        public override string Version
        {
            get { return "1.0"; }
        }
        public override string FileFormatVersion
        {
            get { return "1.0"; }
        }
    }
}

Exercise results

Run the application and open the Plugins window (File | Plugins ). Ensure both the application plugin and the gui plugin are visible in the overview of loaded plugins: