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 build on the teamcity build server, and so we must add the build server package feed address to the package locations of nuget. Open the options of Visual studio (click TOOLS | Options) and browse to the Nuget package manager settings.

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

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 TeamCityAuth like shown in the following image:

Select the Deltashell.Plugins.VolumeModel project as project to add the Nuget package to :

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: