SharpDevelop Addin(插件树)使用方法-让SharpDevelop的插件树运行在自己

  • A+
所属分类:C#

SharpDevelop Addin(插件树)使用方法-让SharpDevelop的插件树运行在自己_Taotesea_新浪博客

5d35250daa62ea11d2000051_html_.gif

SharpDevelop Addin(插件树)使用方法-让SharpDevelop的插件树运行在自己

SharpDevelop Addin(插件树) 使用方法

在经历了N多次的迷茫和郁闷后,今天终于明白了Addin这个东东怎么使用。下面为大家总结一下我研究的过程,希望大家看过我的文档后,研究Addin这个的东西不再这么痛苦拉。而且可以更快的了解插件树是怎么运行的.好了,废话不多说了,下面言归正传。

Addin作为SharpDevelop的核心组件,它提供了一种插件树的机制来调用插件组成整个应用程序。我将把Addin的核心代码从SharpDevelop中分离出来,然后作为单独的工程。

全部的过程大概分这么两个部分:
一、 从SharpDevelop中分离出Addin的代码。
二、 新建一个工程作为调用插件树的主程序。
三、 新建一个插件以供程序调用。
第一部分 分离出插件树的核心代码
那么首先来讲讲怎么从SharpDevelop中导出Core工程到2003

  1. 我们要导出代码首先就必须得到它的源码,源码可以在SharpDevelop的官方网站http://www.icsharpcode.com/OpenSource/SD/Download/ 中下载。

  2. 在下载完程序之后你可以在src\Main\Core 目录下找到Core.prjx这个文件(此文件是SharpDevelop的工程文件),使用SharpDevelop打开此文件,这时候整个Core项目就加载到SharpDevelop(Core为整个SharpDevelop的核心工程,其中包括了插件树、服务和属性)。由于SharpDevelop目前调试还没有.net2003方便,所以我们把程序导出为.Net2003的格式可以通过SharpDevelop的 “文件-》输出工程——》选择你要输出的文件夹”来导出整个项目。

  3. 在输出成功后用.Net2003加载刚才输出的解决方案然后编译,这样就可以在输出目录下的bin\debug目录下找到ICSharpCode.Core.dll这个文件了(此文件为整个插件树的核心组件,在后面的插件树应用中全部都是引用的该组件)。

  4. 拷贝CoreKey.key这个文件到当前项目的目录下。
    在经过上述三个步骤之后,整个Addin的代码就从SharpDevelop代码中分离出来了,是不是很简单啊 ^_^。
    第二部分 建造一个新工程来利用插件树的机制加载插件
    刚才第一部分我们讲解了如何分离出插件树的核心代码,此部分我将讲解怎么在应用程序中利用插件树的机制来加载插件。
    1. 首先新建一个Windows应用程序AddinMain。
    2. 在刚才新建的项目中删除Form1然后添加一个类AddinsMain。
    3. 引用ICSharpCode.Core.dll组件(要得到此组件请看第一部分)。
    4. 当上述三个步骤完成后就开始编码工作了,把下面的代码Copy到AddinsMain类中。

using System;
using System.IO;
using System.Diagnostics;
using System.Reflection;
using System.Drawing;
using System.Collections;
using System.Windows.Forms;
using System.Resources;
using System.Xml;
using System.Threading;
using System.Runtime.Remoting;
using System.Security.Policy;
//引用Core的命名空间
using ICSharpCode.Core.Properties;
using ICSharpCode.Core.AddIns.Codons;
using ICSharpCode.Core.AddIns;
using ICSharpCode.Core.Services;
namespace AddinMain
{
///
/// AddinsMain 的摘要说明。
///
public class AddinsMain
{
public AddinsMain()
{
//
// TODO: 在此处添加构造函数逻辑
//
}
///
/// 整个程序的入口点
///
[STAThread()]
public static void Main(string[] args)
{
//查找ADDIN的主目录 默认情况下目录为当前目录的../Addin/
bool ignoreDefaultPath = false;

string [] addInDirs = AddInSettingsHandler.GetAddInDirectories(out ignoreDefaultPath);

AddInTreeSingleton.SetAddInDirectories(addInDirs, ignoreDefaultPath);
ArrayList commands = null;
try
{
//启动默认的系统服务
ServiceManager.Services.AddService(new Resource());
//启动后台服务
ServiceManager.Services.InitializeServicesSubsystem("/Workspace/Services");
//在程序开始运行时首先加载的插件

commands = AddInTreeSingleton.AddInTree.GetTreeNode("/Workspace/Autostart").BuildChildItems(null);

for (int i = 0; i < commands.Count; ++i)
{
((ICommand)commands[i]).Run();
}
}
catch (XmlException e)
{
MessageBox.Show("不能加载 XML :" + Environment.NewLine + e.Message);
return;
}
catch (Exception e)
{
MessageBox.Show("加载出错 :" + Environment.NewLine + e.ToString());
return;
}
}
}
}
下面为大家解释一下这段代码的意思
bool ignoreDefaultPath = false;

string [] addInDirs = AddInSettingsHandler.GetAddInDirectories(out ignoreDefaultPath);

AddInTreeSingleton.SetAddInDirectories(addInDirs, ignoreDefaultPath);

此段代码的意思是查找插件树配置文件的路径,它首先去调用AddInSettingsHandler.GetAddInDirectories() 方法(AddInSettingsHandler类在后面介绍)查找App.Config中的AddInDirectories这一项,如果在配置文件中不存在这一项的话就返回空值。

当调用AddInTreeSingleton.SetAddInDirectories(addInDirs, ignoreDefaultPath)方法时如果addInDirs为空的话那么插件树配置文件的默认路径为 ../Addin/。

ServiceManager.Services.AddService(new Resource());
在找到插件树配置文件路径后首先要启动一个默认的资源服务Resource(该服务为系统的默认服务,必须启动,否则程序将无法运行)。
ServiceManager.Services.InitializeServicesSubsystem("/Workspace/Services");
在启动完程序的默认服务后就开始启动自定义服务了。所有默认服务都是在配置文件的/Workspace/Services扩展点中。

commands = AddInTreeSingleton.AddInTree.GetTreeNode("/Workspace/Autostart").BuildChildItems(null);

for (int i = 0; i < commands.Count; ++i)
{
((ICommand)commands[i]).Run();
}

这段代码就是程序启动时加载前台插件了,/Workspace/Autostart是系统自动运行命令的扩展点路径,定义在这个路径下的插件会在系统启动的时候自动运行。

5. 经过上述的步骤后插件就可以被加载了,不过这个时候程序还不能编译,应为我们的Resource类和AddInSettingsHandler类都没有添加。
下面我们首先添加AddInSettingsHandler类,该类为插件树控制类。
代码如下:

using System;
using System.Configuration;
using System.Collections;
using System.Xml;
namespace AddinMain
{
///
/// AddInSettingsHandler 的摘要说明。
///

public class AddInSettingsHandler : System.Configuration.IConfigurationSectionHandler

{
public AddInSettingsHandler()
{
}

public object Create(object parent, object configContext, System.Xml.XmlNode section)

{
ArrayList addInDirectories = new ArrayList();
XmlNode attr = section.Attributes.GetNamedItem("ignoreDefaultPath");
if (attr != null)
{
try
{
addInDirectories.Add(Convert.ToBoolean(attr.Value));
}
catch (InvalidCastException)
{
addInDirectories.Add(false);
}
}
else
{
addInDirectories.Add(false);
}
XmlNodeList addInDirList = section.SelectNodes("AddInDirectory");
foreach (XmlNode addInDir in addInDirList)
{
XmlNode path = addInDir.Attributes.GetNamedItem("path");
if (path != null)
{
addInDirectories.Add(path.Value);
}
}
return addInDirectories;
}
public static string[] GetAddInDirectories(out bool ignoreDefaultPath)
{

ArrayList addInDirs = System.Configuration.ConfigurationSettings.GetConfig("AddInDirectories") as ArrayList;

if (addInDirs != null)
{
int count = addInDirs.Count;
if (count <= 1)
{
ignoreDefaultPath = false;
return null;
}
ignoreDefaultPath = (bool) addInDirs[0];
string [] directories = new string[count-1];
for (int i = 0; i < count - 1; i++)
{
directories[i] = addInDirs[i+1] as string;
}
return directories;
}
ignoreDefaultPath = false;
return null;
}
}
}
添加完AddInSettingsHandler类后下面我们将添加资源服务类。

首先在项目中添加一个AddInSettingsHandler类,然后COPY下列代码到该类中,该类继承了AbstractService类和实现了IResourceService接口。

using System;
using System.IO;
using System.Windows.Forms;
using System.Collections;
using System.Threading;
using System.Resources;
using System.Drawing;
using System.Diagnostics;
using System.Reflection;
using System.Xml;
using ICSharpCode.Core.Properties;
using ICSharpCode.Core.AddIns.Codons;
using ICSharpCode.Core.AddIns;
using ICSharpCode.Core.Services;
namespace AddinMain
{
///
/// Resource 的摘要说明。
///
public class Resource:AbstractService,IResourceService
{
public Resource()
{
//
// TODO: 在此处添加构造函数逻辑
//
}

region IResourceService 成员

public void RegisterAssembly(Assembly assembly)
{
// TODO: 添加 Resource.RegisterAssembly 实现
}
public string GetString(string name)
{
// TODO: 添加 Resource.GetString 实现
return null;
}

endregion

}
}
在完成上述步骤后编译程序,怎么样,是不是编译成功了,嘻嘻!写的好累啊,抽支烟回来!
第三部分 新建一个插件
在经过第一部分和第二部分之后下面将新建一个插件给AddMain调用。
1.在刚才的解决方案中添加一个类库项目HelloWorld。
2.在HelloWorld项目中新建一个窗体Form1。
3.再新建一个类HelloWorldCommand,该类是作为反射来调用HelloWorld窗体用的,代码如下:
using System;
using System.Windows.Forms;
using System.CodeDom.Compiler;
using ICSharpCode.Core.AddIns;
using ICSharpCode.Core.AddIns.Codons;
namespace HelloWorld
{
///
/// HelloFormCommand 的摘要说明。
///
public class HelloFormCommand:ICSharpCode.Core.AddIns.Codons.ICommand
{
public HelloFormCommand()
{
//
// TODO: 在此处添加构造函数逻辑
//
}

region ICommand 成员

public object Owner
{
get
{
// TODO: 添加 HelloFormCommand.Owner getter 实现
return null;
}
set
{
// TODO: 添加 HelloFormCommand.Owner setter 实现
}
}
public void Run()
{
// TODO: 添加 HelloFormCommand.Run 实现
Application.Run(new Form1());
}

endregion

}
}
该类实现了ICSharpCode.Core.AddIns.Codons.ICommand接口。
public void Run()
{
// TODO: 添加 HelloFormCommand.Run 实现
Application.Run(new Form1());
}
这里面最重要的就是Run方法了,在该方法中运行我们刚刚新建的Form1窗体。

好了,到了这个时候我们只差最后100米的距离了就是插件树的配置文件了。刚刚我们讲过插件树的配置文件默认路径是../Addin/目录下,那么我们在该目录下建立一个Hello. Addin文件,下面我们来讲解下该文件的格式。

author = "SimonLiu"
copyright = "GPL"
url = "http://www.icsharpcode.net"
description = "Display AddinTree"
version = "1.0.0">
class = "HelloWorld.HelloCommand"/>

在配置文件中,Runtime节指定了插件功能模块所在的库文件HelloWorld.dll的具体路径,在Extension节中指定了扩展点路径/Workspace/Autostart(该路径是指在程序运行时自动运行该插件),然后在Extension内指定了它的ID、Command类名。保存此配置文件运行程序,是不是Form1出来了啊,呵呵 很简单吧。

总结

经过我的“废话连篇”想必各位都看烦了吧不过最后还是得罗嗦最后几句,回顾整个过程,首先我们从SharpDevelop中分离出了Addin的核心代码,然后新建了一个主体工程利用Addin的机制来调用插件,最后我们新建了一个插件然后被调用,应为SharpDevelop本身的代码有些复杂,而且我也只像分离出他的插件树代码来用,所以我精简啦很多SharpDevelop的代码。为了方便起见我在这里只是作了一个最简单的示例程序,当然了大家可以扩展这个示例程序。至于怎么像SharpDevelop那样把所有的插件挂接到一个主界面中,本人正在研究ing…,等研究出来后马上会把研究的心得贴上来,敬请期待。

  • 我的微信
  • 这是我的微信扫一扫
  • weinxin
  • 我的微信公众号
  • 我的微信公众号扫一扫
  • weinxin