（翻译）LearnVSXNow! #12- “VsxLibrary” 和“HowToPackage”

前面的11篇文章涉及到了在VSX开发中最重要的知识，利用这些知识，我们已经可以开始开发VSPackage了。但是，还有很多重要的主题我们并没有涉及到（例如Package Load Key、部署和安装、属性页，自定义编辑器、项目树，文档窗口等等）。

通过前面这些文章的读者反馈来看，现在是进行下一个主题的时候了。但在这之前，让我先对比一下软件开发和潜水运动…

不仅仅我的昵称叫作DeepDiver，我本身也是一个海底潜水的爱好者。在匈牙利，我们只有能见度非常低的湖泊，对于潜水新手来说，在这些湖里面潜水可不是什么有趣的事情，但如果跟着潜水教练的话，即使是新手也会在能见度非常低的湖泊里找到乐趣。如果在能见度非常高的大海里潜水的话，即便没有教练跟着，你也会觉得自己能够潜的非常棒，但是一旦回到了湖里，你就会失去刚刚建立起来的自信。摆脱这一困境的方法是多学和多练，直到你变成一个潜水教练或者潜水高手。

我现在已经是一个潜水教练了，我们经常和其他人一起练习，并学习了很多理论基础（物理学和生理学）和实践技能（常规任务、自救、应急操作等等）。我们有一个”伙伴系统”：当潜水的时候，伙伴之间要相互帮助。现在，不管是在匈牙利的冰冷的湖里，还是在红海里，我都能潜的很自如。如果你非要问我更喜欢哪一个，我会告诉你这两个我都喜欢：喜欢红海的壮观，喜欢湖泊的冷静和挑战。

我为什么要和你们说这个呢？因为我感觉我自己在.NET编程方面是一个专家，但在VSX开发中却只是一个新手，但我希望自己两个都能精通，所以我还要做很多学习和练习。我猜如果有个“伙伴系统”的话，事情会变得简单很多，所以，如果你想的话，成为我的伙伴吧！

在这篇文章里我准备继续我们的系列。这一次我们创建一个新的package，这个package用于放置“How To”示例，但我并不是简单的添加示例，我还会把一些公用的代码抽取出来，变成可重用的托管代码，从而简化VSX的开发。

创建VsxLibrary和HowToPackage项目

在第10篇中，我创建了一个叫VsxToolset的类库项目，那个时候我想着这个东西可以作为将来开发VSX的真正工具集（甚至框架）的很好的基础。开发工具集有下面几个原则：

工具集里的类型必须减少噪音。我希望能够以更简单的方式访问VS IDE底层的COM互操作类型和方法。我会减少代码行数，加强类型安全，并能够利用托管代码的强大威力。例如第10篇中关于ActivityLog的处理。

COM类型转换成.NET的类型。VS IDE的对象模型是成熟的，但它是用COM技术实现的，由于COM技术和.NET有很大不同，所以对.NET开发人员来说会很不习惯。我想把VS IDE底层的service和类型转换成.NET的实现方式，这样.NET的很多特性和C#（甚至3.0)都可以用了。例如第10篇文章里关于OutputWindow和OutputWindowPane的处理。

在可能的地方采用声明式的方法。有很多地方都可以用声明式的开发风格。.在这些地方，可以用NET提供的属性（Attribute）、反射和元数据等技术把命令式的的代码转换成声明式的代码。例如第10篇文章中OutputPaneDefinition类上面就声明了很多属性（Attribute）。

持续不断的文档。我喜欢能够使软件开发变得简单和有效率的框架，但是很多框架都没有很好的文档说明，需要花费很长的时间才能搞清楚框架怎么用。我可不想我这个工具集也这样，所以我打算在这个工具集的开发过程中，遵循下面的原则：

1. 写好代码注释
2. 为每个特性编写示例代码
3. 写相关的文章来描述清楚特性的用法

我现在把VsxTools这个类库重命名为VsxLibrary了，并且同时创建了一个名为HowToPackage的项目，目的是在这个项目里可以演示以后的文章中涉及到的VSX开发方面的内容。这两个项目已经放到了CodePlex网站的LearnVSXNow项目上面了。

在这篇文章里，我们来做一下VsxLibrary和HowToPackage的简单的概述。

Solution文件的结构

下载了源代码之后，你会看到如下的目录结构：

创建初始代码

用VSPackage向导创建了HowToPackage项目之后，我添加了一个简单的菜单和工具窗。我不太喜欢向导生成的类和常数的名字，所以我用重构工具改了一些名字。另外，我也删了向导生成的大部分的注释。

创建了VsxLibrary项目之后，我打算根据VS IDE中服务的类型来组织我的目录。例如我把Output Window相关的代码放到了OutputWindow目录下，把MessageBox相关的功能放到了VsUIShell目录下。

VsxLibrary概览

我说过VsxLibrary是从原来的VsxTools的基础上创建的，在后面的文章里我会继续向这个类库里添加新功能，但现在我先给你展示一下这个类库里已有的功能。

Utility类

VsxLibrary会在任何可能的地方使用声明式的代码风格。使用声明式风格的关键是使用attribute。所以我创建了一些attribute的抽象类型：BoolAttribute、StringAttribute、Int32Attribute和UInt32Attribute。它们只有一个Value属性，这个属性的类型是和这几个attribute的名字相对应的，例如BoolAttribute的定义如下：

public abstract class BoolAttribute: Attribute{  private readonly bool _Value;    protected BoolAttribute(bool value)  {    _Value = value;  }    public bool Value  {    get { return _Value; }  }}

所有其他的attribute类继承上面这些相应的基类。如你所知，System.Attribute是不能用泛型的，所以我们不得不为每种attribute定义它的基类。

通过继承这些基类，只有一个属性的attribute（很多attitude都只有一个属性）就可以用很少的代码行来定义了：

[AttributeUsage(AttributeTargets.Class)]public sealed class PaneNameAttribute: StringAttribute{  public PaneNameAttribute(string value) : base(value)  {  }}  [AttributeUsage(AttributeTargets.Class)]public sealed class InitiallyVisibleAttribute: BoolAttribute{  public InitiallyVisibleAttribute(bool value): base(value)  {  }}

随着VsxLibrary的不断开发，其他的attribute基类也会添加进来。

另外一个utility类是VsxConverter静态类。在.NET基础类库和VS shell的互操作(interop)类之间，有很多含义一样但实现方式不同的常数或者枚举。例如在System.Windows.Forms命名空间下，有DialogResult这个枚举，相应的，在VS shell的互操作类里，用1到7来分别表示这个枚举值。再比如，Windows forms里有一个MessageBoxButtons的枚举，在VS Shell里，相应的有OLEMSGBUTTON这个枚举。

我认为.net开发人员比较喜欢.NET基础类库里的类型（枚举、常数等等），所以我创建了VsxConverter静态类，这个类负责在基础类型和VS Shell类型之间做转换。目前它已经有了几个方法了（会越来越多的），例如：

public static OLEMSGBUTTON ConvertToOleMsgButton(MessageBoxButtons buttons){  switch (buttons)  {    case MessageBoxButtons.AbortRetryIgnore:      return OLEMSGBUTTON.OLEMSGBUTTON_ABORTRETRYIGNORE;    case MessageBoxButtons.OKCancel:      return OLEMSGBUTTON.OLEMSGBUTTON_OKCANCEL;    case MessageBoxButtons.RetryCancel:      return OLEMSGBUTTON.OLEMSGBUTTON_RETRYCANCEL;    case MessageBoxButtons.YesNo:      return OLEMSGBUTTON.OLEMSGBUTTON_YESNO;    case MessageBoxButtons.YesNoCancel:      return OLEMSGBUTTON.OLEMSGBUTTON_YESNOCANCEL;    default:      return OLEMSGBUTTON.OLEMSGBUTTON_OK;  }}

我知道随着VsxLibrary的开发，会有越来越多的utility类型，一旦我添加了这些类，我会在相应的文章里介绍它们。

封装SVsUIShell服务

有很多服务提供了很多方法，例如SVsUIShell服务。我们可以在VsxLibrary类库里去封装它们。另外，SVsUIShell的某些方法，例如FindToolWindow和CreateToolWindow，已经在MPF里封装了（可以通过Package类来访问它们）。

当我们创建了一个带有菜单的package之后（例如第3篇里讲到的），它同时创建了用于显示一个消息框的代码：

IVsUIShell uiShell = (IVsUIShell)GetService(typeof(SVsUIShell));Guid clsid = Guid.Empty;int result;Microsoft.VisualStudio.ErrorHandler.ThrowOnFailure(  uiShell.ShowMessageBox(    0,    ref clsid,    "SimpleCommand",    string.Format(CultureInfo.CurrentCulture, "Inside {0}.MenuItemCallback()",       this.ToString()),    string.Empty,    0,    OLEMSGBUTTON.OLEMSGBUTTON_OK,    OLEMSGDEFBUTTON.OLEMSGDEFBUTTON_FIRST,    OLEMSGICON.OLEMSGICON_INFO,    0,        // false    out result));

这段代码很简单，但也很烦杂。所以为了让它更简单，我封装了VsUIShell。封装后，如果想显示消息框的话，只需要用下面简单的代码就行了：

VsUIShell.ShowMessageBox(  string.Format(CultureInfo.CurrentCulture,   "Inside {0}.MenuItemCallback()", this),  "SimpleCommand);

我是用非常简单的方式封装ShowMessageBox方法的。在VsUIShell类内部，我添加了一个叫作ShowMessageBoxInternal的私有方法，这个方法接受的是.NET基础类型，而不是VS Shell的类型：

private static DialogResult ShowMessageBoxInternal(string title, string message,   string helpFile, uint helpTopic, MessageBoxButtons buttons,   MessageBoxDefaultButton defButton, MessageBoxIcon icon, bool sysAlert){  Guid clsid = Guid.Empty;  int result;  ErrorHandler.ThrowOnFailure(UIShell.ShowMessageBox(             0,             ref clsid,             title,             message,              helpFile,             helpTopic,             VsxConverter.ConvertToOleMsgButton(buttons),             VsxConverter.ConvertToOleMsgDefButton(defButton),             VsxConverter.ConvertToOleMsgIcon(icon),             sysAlert ? 1 : 0,             out result));  return VsxConverter.Win32ResultToDialogResult(result);}

然后我创建了一些ShowMessageBox 的重载方法，就像MessageBox.Show系列方法那样。

总结

在这篇文章里，为了演示VSX开发，我创建了一个叫作HowToPackage的solution，并且打算在后面的文章里不断的扩展它。我在第9篇和第10篇文章里说过，如果能把VS Shell里的类型转换成.NET风格，并拥有CLR（例如元数据、attribute、泛型等等）和C#（例如扩展方法、LINQ等等）的特性，VSX开发就会变的简单很多。所以，在创建HowToPackage的同时，我也创建了一个很小的框架，叫作VsxLibrary。

在下一篇文章里，我们将继续探讨VSX的开发。