4.1 多版本间切换及二次开发程序升级

描述
环境：VM4.2 + VS2013及以上
现象：电脑上安装完VM4.0或VM4.1之后（本篇文章主要以VM4.0为例，VM4.1二次开发程序升级与VM4.0操作相同），安装VM4.2，因此电脑上可能有两个及两个以上的VM版本，此时，客户则有版本间切换的需求，或者需求 VM4.0二次开发程序升级为VM4.2二次开发程序。
解答
针对这些需求，VM4.2开始提供了相应的工具。
1、版本安装。例如电脑安装完VM4.0之后，再安装VM4.2，算子路径默认在C盘，此时算子安装路径会自动备份VM4.0的算子。如下图所示，VM3.4就是备份VM4.0的算子的文件夹，有这个文件夹才能进行版本间切换。
在这里插入图片描述

2、版本间切换。版本切换工具是VM4.2新增，老版本并没有对应的处理工具。
版本切换工具路径：VisionMaster4.2.0\Applications\Tools\VersionSwitchAssistant\VersionSwitchAssistant.exe；启动后会根据注册表查找已安装版本，根据需要切换即可，切换前需要关闭VM后台程序和Visual Studio软件。从VM4.2切换到VM4.0之后，算子路径中自动会将VM4.0的算子从V3.4文件夹中拷贝出来，将VM4.2的算子打包到V4.2文件夹中。当安装了多版本无法定位VM问题时，也可以使用版本切换工具，点击【清除配置】，然后再点击相应版本。
在这里插入图片描述

3、二次开发程序升级。针对基于C#进行VM二次开发程序，当客户需求不再使用VM4.0时，需要将之前VM4.0的二次开发程序升级到VM4.2二次开发程序时。
首先，使用工具将项目debug文件夹中的内容进行备份，备份工具：VisionMaster4.2.0\Applications\Tools\4.0二次开发程序升级4.2版本工具\DevelopProcedureUpgradeTool.exe，这一步操作则是因为VM4.2二次开发环境不需要拷贝VM提供的二次开发dll，因此要清空项目生成路径debug文件夹，将VM提供的二次开发dll备份到另一个文件夹中。
在这里插入图片描述

然后，使用引用工具为程序添加引用，引用工具：VisionMaster4.2.0\Development\V4.x\ComControls\Tool\ImportRef.exe。至此就快速的完成了VM4.0二次开发程序到VM4.2二次开发程序的升级。
在这里插入图片描述

4、方案、流程升级。方案、流程升级。程序升级成功之后，用户则启动VM4.2二次开发程序，加载方案时会报错，此时则需要用VM4.2去打开用VM4.0搭建的方案或流程，进行一个升级，升级成功会有提示窗口，并将方案另存为xxx_V4.2.sol等，特殊情况有些模块、有些参数或全局变量需要检查并微调。
5、注意事项
（1）VM4.x二次开发程序启动的前提之一，VM4.x能够正常打开且方案能够正常运行，然后关闭VM后台程序，启动二次开发程序；
（2）VM4.2二次开发某些接口名称发生变化，基本上是兼容VM4.0二次开发接口，但推荐使用程序中提示的推荐接口，例如获取流程结果就需要修改一下代码；
（3）用户将VM控件封装到一个项目1中，然后在项目2中调用项目1，此时项目1也需要进行二次开发程序升级操作。
（4）安装VM4.0后再安装VM4.2后，4.0的算子会被备份。此时如果卸载VM4.2，算子路径会清空VM4.2的算子以及VM4.0备份的算子，此时VM4.0无法将无法使用。此时如果想使用VM4.0，删除VM4.2的时候，卸载项不勾选（加密狗驱动，相机sdk），再手动安装一下VM4.0的算子包，算子包路径VisionMaster4.x\Drivers\MVSAlgorithmSDK_STD.exe。
（5）针对基于C++进行VM二次开发的程序，由于不需要拷贝DLL，所以除了更改包含目录和库目录路径，还需要删除项目exe生成路径下VM相关dll。
（6）版本切换和升级是VM4.2新增功能。VMSDK程序升级步骤，主要针对VM 4.0和VM4.1版本的二次开发程序的升级。
问题根因
不熟悉的多版本间切换及二次开发程序升级