教程五 在Go中使用Energy创建跨平台GUI - 执行开发者工具方法

教程-示例-文档 

---

介绍

本文介绍在Energy中如何执行开发者工具方法

开发者工具方法，可以设置浏览器头，模拟仿真设备等.

---

使用方式

• 字典对象创建

cef.NewCefDictionaryValue()

• 字典对象是key=value方式, chromium定义的字典名称和对应的值，通过字典对象设置执行的参数
  • 字典对象有五种类型
  1. 字典本身类型 ICefDictionaryValue
  2. 字符串 String
  3. 整型  Int
  4. 浮点  Double
  5. 布尔  Boolean

• 示例 - 创建字典

//字典对象
var dict = cef.NewCefDictionaryValue()
//根据chromium字典设置
dict.SetInt("width", 500)
dict.SetBoolean("mobile", true)
dict.SetDouble("deviceScaleFactor", 1)
dict.SetString("type", "portraitPrimary")
TempDict := cef.NewCefDictionaryValue()
dict.SetDictionary("screenOrientation", TempDict)

---

• 执行开发者工具方法

Chromium().ExecuteDevToolsMethod(messageId, name, dict)

• 示例 - 调用访真设备方法

//字典对象
var dict = cef.NewCefDictionaryValue()
//根据chromium字典设置
dict.SetInt("width", 500)
dict.SetInt("height", 768)
dict.SetInt("x", 100)
dict.SetInt("y", 100)
dict.SetBoolean("mobile", true)
dict.SetDouble("deviceScaleFactor", 1)
TempDict := cef.NewCefDictionaryValue()
TempDict.SetString("type", "portraitPrimary")
TempDict.SetInt("angle", 0)
dict.SetDictionary("screenOrientation", TempDict)
//执行方法
windowInfo.Chromium().ExecuteDevToolsMethod(0, "Emulation.setDeviceMetricsOverride", dict)

• 示例 - 设置浏览器 userAgent

dict := cef.NewCefDictionaryValue()
dict.SetString("userAgent", "Mozilla/5.0 (Linux; Android 11; M2102K1G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.101 Mobile Safari/537.36")
windowInfo.Chromium().ExecuteDevToolsMethod(0, "Emulation.setUserAgentOverride", dict)

完整示例

一如既往先配置好go和energy环境, 然后创建一个main函数来创建应用

这个示例稍微有点复杂，使用了事件机制、内置资源和内置http服务。

内置http服务

启用了Energy简单的内置http服务-参考: 示例-内置http服务

//在主进程启动成功之后执行
//在这里启动内置http服务
//内置http服务需要使用 go:embed resources 内置资源到执行程序中
cef.SetBrowserProcessStartAfterCallback(func(b bool) {
		fmt.Println("主进程启动 创建一个内置http服务")
		//通过内置http服务加载资源
		server := assetserve.NewAssetsHttpServer()
		server.PORT = 22022               //服务端口号
		server.AssetsFSName = "resources" //必须设置目录名和资源文件夹同名
		server.Assets = &resources
		go server.StartHttpServer()
})

事件监听

在应用初始化时使用 SetOnEvent 函数，监听Go消息事件

ipc.IPC.Browser().SetOnEvent(func(event ipc.IEventOn) {
})

通过 event.On 来监听一个事件

event.On(eventName, func(context ipc.IIPCContext){
})

事件触发

在web端使用js代码，ipc.emit 触发go监听的事件

ipc.emit(eventName,[callback function]);

• Go示例代码

package main

import (
	"embed"
	"fmt"
	"github.com/energye/energy/cef"
	"github.com/energye/energy/common/assetserve"
	"github.com/energye/energy/ipc"
)

//资源目录，内置到执行程序中
//go:embed resources
var resources embed.FS

func main() {
	//全局初始化 每个应用都必须调用的
	cef.GlobalCEFInit(nil, &resources)
	//创建应用
	cefApp := cef.NewApplication(nil)
	//主窗口的配置
	//指定一个URL地址，或本地html文件目录
	cef.BrowserWindow.Config.DefaultUrl = "http://localhost:22022/execute-dev-tool-method.html"
	//chromium配置
	config := cef.NewChromiumConfig()
	config.SetEnableMenu(true)     //启用右键菜单
	config.SetEnableDevTools(true) //启用开发者工具
	cef.BrowserWindow.Config.SetChromiumConfig(config)
	//这里演示使用ipc通信实现js和go互相调用，在go监听事件中执行开发者工具方法
	//使用内置http服务和自定义页面
	//这里执行的方法是仿真移动端
	//1. js使用ipc.emit触发 go事件
	//2. go中"execute-dev-method"事件执行，通过context获得browserId
	//3. 通过browserId获得chromium
	//4. 使用字典对象传递方法参数
	//5. 点击Note链接
	ipc.IPC.Browser().SetOnEvent(func(event ipc.IEventOn) {
		event.On("execute-dev-method", func(context ipc.IIPCContext) {
            //获得当前窗口信息
			windowInfo := cef.BrowserWindow.GetWindowInfo(context.BrowserId())
			//字典对象
			var dict = cef.NewCefDictionaryValue()
			//根据chromium字典设置
			dict.SetInt("width", 500)
			dict.SetInt("height", 768)
			dict.SetInt("x", 100)
			dict.SetInt("y", 100)
			dict.SetBoolean("mobile", true)
			dict.SetDouble("deviceScaleFactor", 1)
			TempDict := cef.NewCefDictionaryValue()
			TempDict.SetString("type", "portraitPrimary")
			TempDict.SetInt("angle", 0)
			dict.SetDictionary("screenOrientation", TempDict)
			windowInfo.Chromium().ExecuteDevToolsMethod(0, "Emulation.setDeviceMetricsOverride", dict)
			//设置浏览器 userAgent
			dict = cef.NewCefDictionaryValue()
			dict.SetString("userAgent", "Mozilla/5.0 (Linux; Android 11; M2102K1G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.101 Mobile Safari/537.36")
			windowInfo.Chromium().ExecuteDevToolsMethod(0, "Emulation.setUserAgentOverride", dict)
		})
	})
	//在主进程启动成功之后执行
	//在这里启动内置http服务
	//内置http服务需要使用 go:embed resources 内置资源到执行程序中
	cef.SetBrowserProcessStartAfterCallback(func(b bool) {
		fmt.Println("主进程启动 创建一个内置http服务")
		//通过内置http服务加载资源
		server := assetserve.NewAssetsHttpServer()
		server.PORT = 22022               //服务端口号
		server.AssetsFSName = "resources" //必须设置目录名和资源文件夹同名
		server.Assets = &resources
		go server.StartHttpServer()
	})
	//运行应用
	cef.Run(cefApp)
}

• html示例代码

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>执行开发者工具方法</title>
    <script type="application/javascript">
        //按钮点击事件
        function devMethod() {
            //使用ipc.emit触发Go中监听的事件
            ipc.emit("execute-dev-method");
        }
    </script>
</head>
<body style="overflow: hidden;margin: 0px;padding: 0px;">
<button style="margin: 50px 50px 50px 50px;" onclick="devMethod()">dev-method-仿真</button>
<a href="https://note.yanghy.cn">Note</a>
</body>
</html>

示例效果图