WebRunLocal 项目安装与使用教程

最新推荐文章于 2024-09-26 07:04:29 发布

经梦鸽

最新推荐文章于 2024-09-26 07:04:29 发布

阅读量364

点赞数 5

本文链接：https://blog.csdn.net/gitblog_00406/article/details/142239927

版权

WebRunLocal 项目安装与使用教程

WebRunLocal 网页调用本地程序，低耦合，兼容性强，全版本浏览器兼容，彻底解决网页调用本地程序出现的各种问题项目地址: https://gitcode.com/gh_mirrors/web/WebRunLocal

1. 项目介绍

WebRunLocal 是一个旨在实现网页（Web Page）和本地程序（Local App）之间动态调用的开源项目。它作为一个 Windows 本地托盘程序在客户端电脑运行，网页中使用 JavaScript 通过 HTTP 的方式调用 WebRunLocal 服务。WebRunLocal 服务根据传入的参数，动态调用本地程序并返回结果，方便在网页中进行解析。

该项目解决了在网页中调用本地程序时常见的兼容性问题，特别是随着现代浏览器对插件支持的减少，如 ActiveX 和 NPAPI 插件在高版本浏览器上无法正常使用的问题。WebRunLocal 通过增加一个中间服务层，既保证了网页对本地程序的正常调用，又降低了网页和本地程序之间的耦合度，增加了程序的可拓展性。

2. 项目快速启动

2.1 环境准备

Windows 7 或以上操作系统
.NET Framework 4.5 以上运行环境

2.2 下载与安装

克隆项目仓库到本地：

git clone https://github.com/wrxiang/WebRunLocal.git

解压软件包至实际磁盘。
双击运行 WRL.exe，在托盘程序中可以看到运行的插件管理程序。
程序默认已设置为开机自启动，保证随时在线可用。

2.3 配置与启动

配置文件位于软件包根目录下的 WRL.exe.config，可以通过它对本地系统服务进行一些配置，如 HTTP 监听端口、程序是否开机自启动等。
启动服务：
```
WRL.exe
```
在浏览器中打开测试网页 WebRunLocal测试.html，进行测试。

3. 应用案例和最佳实践

3.1 调用 Exe 可执行程序

在浏览器中打开 WebRunLocal测试.html，在文本框中输入如下内容，点击“发送消息”按钮，完成对测试用程序 CallExe.exe 的启动测试：

["TYPE": "2", "PATH": "Plugins\\CallExe\\CallExe.exe", "PARAM": [["VALUE": "1111"], ["VALUE": "222"], ["VALUE": "333"]]]

3.2 调用 DLL 插件

WebRunLocal 服务调用 DLL 采用了 C# 的动态编译功能，使用者不需要对本地程序进行二次封装，直接将本地程序放入 Plugins 目录即可使用。

例如，调用 CallDLL.dll 中的 add 方法：

["TYPE": "1", "PATH": "Plugins\\CallDLL\\CallDLL.dll", "METHOD": "add", "PARAM": [["TYPE": "int", "VALUE": "1", "MODE": "0"], ["TYPE": "int", "VALUE": "2", "MODE": "0"]], "RETRUN_TYPE": "int"]