插件 - V君的博客

用C#为Notepad++写插件：解决在VS2017生成导出函数不全——起手式

作者：V君发布于：2019-1-5 3:27 Saturday 分类：折腾手记

TL;DR

1) 寻找项目模板, 从 MarkdownViewerPlusPlus 插件源代码中提取模板,相对官方模板较完善
2) 用 3F 的 DllExport 代替模板中的 NppPlugin.DllExport.MSBuild, 补全导出函数
3) 编码调试, Enjoy!

嫌TL;DR太少看不懂? 那就稍稍写个示例来解剖一下青蛙吧!

新建一个类库项目，这次起名 HellpNppPlugin(源代码)。然后从 MarkdownViewerPlusPlus 插件源代码中把插件基础设施 (PluginInfrastructure) 目录中除了 DllExport 文件夹之外的全部代码文件搬进项目中。

修改 UnmanagedExports.cs 去掉 NppPlugin.DllExport 命名空间引用，这时候的源代码是不能通过编译的，不要急，保存解决方案继续。

下载 3F 的 DllExport 批处理，放到解决方案根目录。打开一个命令行转到这里，加参数 -action Configure 执行，稍等片刻就会弹出一个小窗口，下拉选择要操作的项目，点击 Installed 复选框，这时候窗口展开许多选项，中间填命名空间的下拉文本框选择 System.Runtime.InteropServices 然后点击右上角的 Apply 按钮。命令行刷出几行日志，窗口消失了。回到VS提示文件被外部修改，点击重新加载。打开项目属性，允许不安全代码，增加两个系统库程序集引用，分别是 Winform 和 Drawing。

准备工作不多，接下来就到令人心动的具体实现了!

把 Class1.cs 重命名成 Main.cs 包括里面的类也跟着重名名，回到 UnmanagedExports.cs 引入 Main 的命名空间，在 Main 添加导出函数需要的成员。分别是1个指定插件名称的字符串和4个方法。在 CommandMenuInit 方法增加下面这行代码:

PluginBase.SetCommand(0, "Say hello", () => MessageBox.Show("Hello NppPlugin by C#!"));

编译，去 debug 目录找 DLL 会发现 DllExport 已经帮我们分别生成了32和64位的 DLL。复制对应版本到 NPP 的插件目录，启动 NPP，Plugins 菜单第一个就是咱们插件的名称，展开子菜单「Say hello」点击可以弹出 Hello 消息框。

示例到此结束!

～吐槽时间～

最近工作上需要写技术文档，想用 MarkDown 撰写后或导出 PDF。找了大半天并没有发现太好用的本地编辑器，主要是对界面太挑剔，我想要预览窗格在左边，而文本编辑窗格在右边，筛选下来的就只有 Smark 和这次提到的 NPP 插件。他们都有不同程度的问题：S 的编辑器很糟糕，而且经常会崩溃；NPP插件渲染斜体不工作而且导出PDF的中文显示方框乱码，用起来仍然不便。意外发现这个NPP插件居然是100%用C#实现，这下有意思了，看看能不能自己造个轮子，我要用 Cef 来渲染！

一拍脑门想到还有 vs code，用它来写 Markdown 带实时预览(预览窗格也能拖到左边)，通过插件导出可以改变预览样式也能导出 html，就纠结要不要弃坑…… 还是继续吧，用 NPP 更轻更习惯一些。另外 NPP 能把停靠的窗格从主窗体拆离出来，这一点 vs code 做不到，只能勉强开新的实例。继续折腾还能长姿势!

一开始就栽了个大跟头，官方 C# 插件项目模板根本不能正常生成，一番折腾之后生成出来的 dll 放进插件目录不能正确加载。咕狗发现有人提到依赖特定VS版本才能生成完整的导出函数，回来用CFF分析工具查看果然导出函数不全。即使是相对完善的 MarkdownViewerPlusPlus 插件源代码，生成出来的导出函数依然不全，难道只能用低版本的 VS? 不! 应该还能再抢救一下。

抱着「C# DllExport」去咕狗，啃各种流程原理，原来要先反编译成 il 然后魔改，再用 VC++ 工具链中的 lib.exe 掺一脚，最后才能生成带导出函数的托管 DLL。再继续找就发现了 3F 的看起来像是脚手架一样的批处理。用它成功地在 VS2017 编译出完整导出函数的 DLL。NPP 插件的开发终于得以继续进行。

原来托管的 DLL 也能添加导出函数给原生应用程序调用，长姿势了！

标签: 软件开发插件 C# Interop

评论(0) 引用(0) 浏览(1766)