Chrome 小工具: 启动本地应用 (Native messaging)

时间 2019-11-20

标签 chrome 工具启动本地应用 native messaging 栏目 Chrome 繁體版

原文原文链接

最近遇到一个新的问题。须要使用Chrome 插件, 从咱们对咱们当地的一个网站之一启动C#应用，同时经过本申请值执行不一样的操做。javascript

在这里记录下解决的过程。以便之后查找html

首先咱们需要新建一个google的插件这个插件包括了三个文件java

manifest.json(名字不可改, 建插件必须文件),background.js(文件名称可改, 后台文件),content.js(content script文件负责与站点页面交互)web

首先咱们来看看manifest.json 这个文件chrome

<span style="font-family:SimSun;font-size:18px;">{
	"name" : "FastRun",
	"version" : "1.0.1",
	"description" : "Launch APP ",
	"background" : { "scripts": ["background.js"] },

	"permissions" : [
		"nativeMessaging",
		"tabs",
		"http://xxx/*"
	],
	"content_scripts": [
    {
      "matches": ["http://xxx/*"],
      "js": ["content.js"]
    }
	],
	"minimum_chrome_version" : "6.0.0.0",
	"manifest_version": 2
}</span>

里面的premissions很重要, 他表示咱们的插件在什么条件执行, "nativeMessaging" 表明要在这个插件中赞成调用这样的方法json

"xxx"填入你想要的加载的网址 app

"content_scripts" 中"xxx" 表示在什么网页下执行咱们与界面交互的script.post

再来看看后台文件网站

background.js
google

var port = null; 
chrome.runtime.onMessage.addListener(
  function(request, sender, sendResponse) {
     if (request.type == "launch"){
       	connectToNativeHost(request.message);
    }
	return true;
});


//onNativeDisconnect
function onDisconnected()
{
	console.log(chrome.runtime.lastError);
	console.log('disconnected from native app.');
	port = null;
}

function onNativeMessage(message) {
	console.log('recieved message from native app: ' + JSON.stringify(message));
}

//connect to native host and get the communicatetion port
function connectToNativeHost(msg)
{
	var nativeHostName = "com.my_company.my_application";
	console.log(nativeHostName);
 	port = chrome.runtime.connectNative(nativeHostName);
	port.onMessage.addListener(onNativeMessage);
	port.onDisconnect.addListener(onDisconnected);
	port.postMessage({message: msg});	
 }

在这个文件中有两个方法很重要

chrome.runtime.onMessage.addListener

和

connectToNativeHost

先来看第一个方法。

是一个响应事件。当接收到类型为"launch"的消息时, 调用 connectToNativeHost方法并传入数据。

com.my_company.my_application

这个是咱们以后需要注冊在Regestry和Native Messaging里面的名字以后会讲到。

runtime.connectNative这种方法链接咱们的Native Messaging而后利用 postMessage 去发送咱们要的信息给咱们的本地应用

固然这里咱们可以替换为 sendNativeMessage 直接给本地应用传值详见

https://developer.chrome.com/extensions/runtime#method-connectNative

咱们在来看看ContentScript: content.js这个文件

<span style="font-family:SimSun;"><span style="font-size:18px;">var launch_message;
document.addEventListener('myCustomEvent', function(evt) {
chrome.runtime.sendMessage({type: "launch", message: evt.detail}, function(response) {
  console.log(response)
});
}, false);</span><strong>
</strong></span>

很是easy, 响应了一个页面中的事件"myCustomEvent", 同一时候公布一个消息给咱们的后台文件background.js，这个消息包括了消息标示 "launch" 和咱们要传的值 evt.detail

关于Content Script 的信息详见 https://developer.chrome.com/extensions/content_scripts

到这里咱们的google插件部分就作好了

别忘了在Chrome 插件里开启开发人员模式并载入这个插件

-------------------------------------切割线-------------------------------------

咱们在来看看 Native Messaging 部分咱们再建一个 json 文件我这里也叫作manifest.json(名字可以不是这个) 存在了我本地C:/Native文件夹下

<span style="font-family:SimSun;font-size:18px;">{
	"name": "com.my_company.my_application",
	"description": "Chrome sent message to native app.",
	"path": "C:\\MyApp.exe",
	"type": "stdio",
	"allowed_origins": [
		"chrome-extension://ohmdeifpmliljjdkaehaojmiafihbbdd/"
	]
}</span>

这里咱们定义了 Native Messaging 的名字, 在path中定义了咱们要执行的本地应用程序, allowed_origins 中长串的字符是咱们插件的id 可以在安装插件后从google chrome 插件里看到(安装插件可以在chrome中插件开启开发人员模式并加载咱们以前的插件文件包)

完毕这步之后咱们需要在WIndows 注冊表中增长google 项目详细例如如下:

执行-> Regedit -> HKEY_Current_User->Software->Google->Chrome->新建一个叫NativeMessagingHosts的项->新建一个叫com.my_company.my_application的项, 同一时候在这个项里默认值设置为咱们Native Messaging 的位置 C:\\Native\\manifest.json

这样咱们就完毕了NativeMessaging的设置

-------------------------------------我是切割线-------------------------------------

咱们再来看看这个插件怎样和咱们的站点交互

先建一个简单的网页内容例如如下

<span style="font-family:SimSun;font-size:18px;"><!DOCTYPE HTML>

<html>
<head>
<script>
function startApp() {
	var evt = document.createEvent("CustomEvent");
	evt.initCustomEvent('myCustomEvent', true, false, "im information");
	// fire the event
	document.dispatchEvent(evt);
}

</script>
</head>
<body>

<button type="button" onClick="startApp()" id="startApp">startApp</button>
</body>
</html>
</span>

里面有一个简单的button，这个button会启动方法, 新建一个名叫"myCustomEvent"的事件, 同一时候附带有咱们要传的信息, 并公布这个事件。这样咱们插件中的Content.js 就可以接收并响应这个事件了!

-------------------------------------我是切割线-------------------------------------

咱们最后再来看看C#程序, 随便作一个很easy的程序, 放到了

C://MyApp.exe这里

在Main里面咱们可以增长如下这种方法, 利用Console.OpenStandardInput这个咱们可以接收到由页面传到咱们应用的值并进行咱们想要的一些操做, 在这里咱们用一个log4net 记录咱们程序执行状况

[assembly: log4net.Config.XmlConfigurator(Watch = true)]
namespace MyApp
{
    static class Program
    {
        public static log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
        [STAThread]
        static void Main(string[] args)
        {
            
            if (args.Length != 0)
            {
                string chromeMessage = OpenStandardStreamIn();
                log.Info("--------------------My application starts with Chrome Extension message: " + chromeMessage + "---------------------------------");
	        }
	    }

        private static string OpenStandardStreamIn()
        {
            //// We need to read first 4 bytes for length information
            Stream stdin = Console.OpenStandardInput();
            int length = 0;
            byte[] bytes = new byte[4];
            stdin.Read(bytes, 0, 4);
            length = System.BitConverter.ToInt32(bytes, 0);

            string input = "";
            for (int i = 0; i < length; i++)
            {
                input += (char)stdin.ReadByte();
            }

            return input;
        }
    }
}

点击咱们在页面上增长的button, 而后检查log文件:

2014-07-30 09:23:14,562 [1] INFO MyApp.Program ----------------------------------------My application starts with Chrome Extension message: {"message":"im information"}---------------------------------

最后一张图总结下整个过程

假设想要在安装咱们本地软件时安装这个插件, 咱们需要把咱们的插件先公布到Chrome web store上详见https://developer.chrome.com/extensions/external_extensions

我将不赘述