dnSpy调试工具二次开发1-新增菜单

news2024/12/23 3:41:04

测试环境：

window 10

visual studio 2019 版本号：16.11.15

.net framework 4.8 开发者工具包下载 .NET Framework 4.8 | 免费官方下载

.net 5开发者工具包

下载 .NET 5.0 (Linux、macOS 和 Windows)

利用git拉取代码(源码地址：GitHub - dnSpy/dnSpy: .NET debugger and assembly editor)：

git clone --recursive https://github.com/dnSpy/dnSpy.git

假设你已经成功拉取了代码，用visual studio 2019打开并等待包下载完毕即可，可能时间会比较长

先看一下实现的最终效果：

测试步骤如下：

1 在名为dnSpy的项目下Menus目录的类MenuConstants新增一级菜单相关常数

/// <summary>新增的一级菜单</summary>
public const string APP_MENU_NEW_GUID = "D9E5C206-37C3-4DDA-B65D-D82A19062735";
/// <summary>新增的菜单Order</summary>
public const double ORDER_APP_MENU_NEW = 1002000;

2 在名为dnSpy的项目下Properties目录的资源文件dnSpy.Resources.zh-CN.resx新增字符串资源(这里配置不同国家语言的资源文件，我的操作系统是中文，所以编辑的是dnSpy.Resources.zh-CN.resx)，键的名称：Menu_TestNew 键值：测试新增

3 在名为dnSpy的项目下Menus目录的类文件AppMenus.cs新增一级菜单类

	[ExportMenu(OwnerGuid = MenuConstants.APP_MENU_GUID, Guid = MenuConstants.APP_MENU_NEW_GUID, 
		Order = MenuConstants.ORDER_APP_MENU_NEW, Header = "res:Menu_TestNew")]
	sealed class NewMenu : IMenu { }

其实上面的Header就是绑定到资源对应的中文名称，所以这个一级菜单的名称将会是：测试新增

注意：想要显示这个一级菜单，必须至少有一个二级菜单，不然显示不出来

4 在名为dnSpy的项目下Menus目录的类MenuConstants新增二级菜单相关常数

/// <summary>二级菜单常数</summary>
public const string GROUP_APP_MENU_TEST_NEW = "1002000,D9E5C206-37C3-4DDA-B65D-D82A19062735";

字符串的值格式尽量保持为：ORDER_APP_MENU_NEW,APP_MENU_NEW_GUID

5 在名为dnSpy的项目下MainApp目录新增NewTestScreen.cs并编辑如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using dnSpy.Contracts.Menus;

namespace dnSpy.MainApp {
	[ExportMenuItem(OwnerGuid = MenuConstants.APP_MENU_NEW_GUID, Header = "res:Menu_TestNew", Group = MenuConstants.GROUP_APP_MENU_TEST_NEW, Order = MenuConstants.ORDER_APP_MENU_NEW)]
	class NewTestScreen : MenuItemBase {
		public override void Execute(IMenuItemContext context) {
			MessageBox.Show("测试新增");
		}
	}
}

为了偷懒，二级菜单的名称和一级菜单的中文名称一样

6 生成项目并运行，最终效果如下图：

好了，本文到此结束，如果本文对你有帮助，资助2毛钱作为鼓励呗