自定义系统右键菜单工具-使用说明

时间:2020-12-04 23:18:07

自定义系统右键菜单工具-使用说明

说在前头

这个系统右键菜单一直都想做,但是苦于工作太忙根本无暇设计,后来一直等到来了新人,刚好交给他练手。最初的版本是用C++语言写的,但是一开始版本不稳定总是会造成资源管理器崩溃,用着用着explorer就挂了,比较头疼。这是1.0版本。

后来就让他把功能用脚本代替实现,菜单只实现界面,功能调Python脚本来派发实现,这样即使功能有问题也不会造成资源管理器的崩溃。而且为了考虑可扩展性,增加了一个子级菜单,也就是“插件”那一级菜单。这是2.0版本。

随着新人能力渐长,大家多提BUG反馈,这工具也慢慢打磨的稳定了,虽然偶尔有一些小BUG,但总归频率低了,大家也都慢慢愿意使用起来,现在基本部门里的同事都在使用了。

后来,新人走了,工具没人维护,有一个查壳的功能需要更新特征修复BUG等,由于C++代码较多,功能糅合的不太喜欢看。于是动手重新设计了下。

原有设计上的一些痛点:

  • 版本分x64和x86两个版本,维护的代码也都有许多重复部分。
  • 安装卸载不便,更新发布不便。
  • 有时会造成explorer的崩溃。
  • 界面与功能没有完全分离。
  • 虽然功能部分使用了脚本,但是总体可扩展性太差。

结合以上几点,设计解决方案如下:

  • 菜单界面部分采用C#语言编写,release时使用any cpu选项,兼容x64和x86平台,不用再维护两个版本。
  • 菜单UI与功能完全分离,脚本部分提交到GitHub,人人可写人人可完善,提交维护方便。
  • 菜单UI可扩展,通过编辑menu.xml菜单配置文件来动态生成菜单项。
  • 一键安装一键卸载。
  • 更新版本时,先一键卸载然后GitHub更新代码,再一键安装即可。

现在等下一个新人,DLL部分就不让他维护了,直接把对应的脚本功能完善好即可,提交到GitHub我这边就是新版本了。

一、所需环境

.NET Framework v4.0

下载地址:Download Microsoft .NET Framework 4(独立安装程序) from Official Microsoft Download Center

Python2.7

由于菜单响应事件是由py编写的,所以需要安装Python,选择的版本是2.7,下载地址:Python 2.7.0 Release | Python.org

star库

由于菜单响应事件是由py编写的,且使用了三方的star库,所以需要安装一下,具体步骤:

在Python安装目录的lib文件夹下(如D:\Python27\Lib),直接gitclone地址:https://github.com/pythonstar/star.git

二、安装

务必**以管理员身份运行**reg.bat进行注册,注册原理见其源码:

@echo off

set dir=%~dp0

rem 判断64位系统和32位系统
if /i %PROCESSOR_IDENTIFIER:~0,3%==x86 (
echo 32位操作系统
%windir%\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe %dir%bin/CustomContextMenu.dll /CodeBase
) else (
echo 64位操作系统
%windir%\Microsoft.NET\Framework64\v4.0.30319\RegAsm.exe %dir%bin/CustomContextMenu.dll /CodeBase
)
pause

输出含有以下内容时为注册成功:

Types registered successfully

成功注册了类型

三、卸载

务必**以管理员身份运行**unreg.bat进行卸载,卸载原理见其源码:

@echo off

set dir=%~dp0

rem 判断64位系统和32位系统
if /i %PROCESSOR_IDENTIFIER:~0,3%==x86 (
echo 32位操作系统
%windir%\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe /unregister %dir%bin/CustomContextMenu.dll /CodeBase
) else (
echo 64位操作系统
%windir%\Microsoft.NET\Framework64\v4.0.30319\RegAsm.exe /unregister %dir%bin/CustomContextMenu.dll /CodeBase
)

taskkill /f /im explorer.exe

explorer.exe

输出含有以下内容时为卸载成功:

Types un-registered successfully

成功注销了类型

由于是重启了explorer.exe,所以卸载后dll文件可以操作。

四、自定义菜单配置

菜单配置文件

在bin目录下修改menu.xml,默认给出了一个模板:

<?xml version="1.0"?>
<menu name="安卓右键工具" icon="icon\logo.png">
<menu name="复制路径" icon="icon\copypath.png" tag="copypath"/>
<menu name="DEX 》JAR" icon="icon\dex2jar.png" tag="dex2jar"/>
<menu name="Manifest 》TXT | AXML 》TXT" icon="icon\m2txt.png" tag="axml2txt"/>
<menu name="查看APK信息" icon="icon\apkinfo.png" tag="viewapk"/>
<menu name="查看签名信息" icon="icon\signinfo.png" tag="viewsign"/>
<menu name="签名" tag="sign" icon="icon\sign.png"/>
<menu/>
<menu name="安装(卸载安装)" icon="icon\install.png" tag="installd"/>
<menu name="安装(替换安装)" icon="icon\installr.png" tag="installr"/>
<menu name="卸载" icon="icon\uninstall.png" tag="uninstall"/>
<menu name="查壳" icon="icon\detect.png" tag="viewwrapper"/>
<menu name="手机信息" icon="icon\phone.png" tag="phone"/>
<menu name="手机截图" icon="icon\photo.png" tag="photo"/>
<menu name="提取图标" icon="icon\extracticon.png" tag="icon"/>
<menu name="zipalign优化" icon="icon\align.png" tag="zipalign"/>
<menu name="反编译" icon="icon\decom.png" tag="baksmali"/>
<menu name="回编译" icon="icon\build.png" tag="smali"/>
<menu name="自定义插件" icon="icon\plug.png">
<menu name="插件1" tag="plug1"/>
<menu name="插件2" tag="plug2"/>
<menu name="插件3" tag="plug3"/>
</menu>
<menu name="关于" icon="icon\about.png" tag="about"/>
</menu>

菜单配置说明

  • 一个菜单项三个属性,分别为name,icon和tag。
  • 如果name为空,则该菜单项为分隔条,例如配置分隔条可以这样配置:
  • icon指示了菜单项的图标文件,以相对路径填写,相对于dll的所在目录。例如:icon\logo.png,若不填写或者指示的图标文件不存在或者加载失败,则条菜单项前面不会出现图标,问题不大。为了加快菜单的加载速度,也可以全部不配置图标文件。
  • tag:如果该项菜单没有子菜单,也不是分隔条,那么就要响应事件,则tag指示了响应的事件名称,最终会被传递到oncommand.py中。
  • 如果菜单含有子菜单项,则按示例menu.xml添加即可。最多支持二级菜单项,不支持更深层次的子菜单。

五、如何响应事件

当用户点击菜单项时,菜单的tag名称会被传递到oncommand.py中,参数形式为:

oncommand.py tag file [files]

如果用户只选择了一个文件,则参数形式为:

oncommand.py tag file

如果用户只选择了多个文件,则参数形式为:

oncommand.py tag file files

也即出现开关files,也可以认为多了一个参数标志。当出现这个标志时,file是一个纯文本的文件全路径,内容是用户选择的多个文件列表,逐行列出。可以在py文件中自行处理多个文件的菜单响应事件,这里并没有实现。

六、效果截图

自定义系统右键菜单工具-使用说明

自定义系统右键菜单工具-使用说明