Lorca


A very small library to build modern HTML5 desktop apps in Go. It uses Chrome
browser as a UI layer. Unlike Electron it doesn't bundle Chrome into the app
package, but rather reuses the one that is already installed. Lorca
establishes a connection to the browser window and allows calling Go code
from the UI and manipulating UI from Go in a seamless manner.
Features
Pure Go library (no cgo) with a very simple API
Small application size (normally 5-10MB)
Best of both worlds - the whole power of HTML/CSS to make your UI look
good, combined with Go performance and ease of development
Expose Go functions/methods and call them from JavaScript
Call arbitrary JavaScript code from Go
Asynchronous flow between UI and main app in both languages (async/await and Goroutines)
Supports loading web UI from the local web server or via data URL
Supports testing your app with the UI in the headless mode
Supports multiple app windows
Supports packaging and branding (e.g. custom app icons). Packaging for all
three OS can be done on a single machine using GOOS and GOARCH variables.
Also, limitations by design:
Requires Chrome/Chromium >= 70 to be installed.
No control over the Chrome window yet (e.g. you can't remove border, make it
transparent, control position or size).
No window menu (tray menus and native OS dialogs are still possible via
3rd-party libraries)
If you want to have more control of the browser window - consider using
webview library with a similar API, so
migration would be smooth.
Example
ui, _ := lorca.New("", "", 480, 320)
defer ui.Close()
// Bind Go function to be available in JS. Go function may be long-running and
// blocking - in JS it's represented with a Promise.
ui.Bind("add", func(a, b int) int { return a + b })
// Call JS function from Go. Functions may be asynchronous, i.e. return promises
n := ui.Eval(`Math.random()`).Float()
fmt.Println(n)
// Call JS that calls Go and so on and so on...
m := ui.Eval(`add(2, 3)`).Int()
fmt.Println(m)
// Wait for the browser window to be closed

Also, see examples for more details about binding functions and packaging binaries.
Hello World
Here are the steps to run the hello world example.
cd examples/counter
go get
go run ./
How it works
Under the hood Lorca uses Chrome DevTools Protocol to instrument on a Chrome instance. First Lorca tries to locate your installed Chrome, starts a remote debugging instance binding to an ephemeral port and reads from stderr for the actual WebSocket endpoint. Then Lorca opens a new client connection to the WebSocket server, and instruments Chrome by sending JSON messages of Chrome DevTools Protocol methods via WebSocket. JavaScript functions are evaluated in Chrome, while Go functions actually run in Go runtime and returned values are sent to Chrome.
What's in a name?
There is kind of a legend, that before his execution Garcia Lorca have seen a
sunrise over the heads of the soldiers and he said "And yet, the sun rises...".
Probably it was the beginning of a poem. (J. Brodsky)
Lorca is an anagram of Carlo, a
project with a similar goal for Node.js.
License
Code is distributed under MIT license, feel free to use it in your proprietary
projects as well.
Lorca是一个小型的Go库,用于构建基于HTML5的桌面应用程序,利用已安装的Chrome浏览器作为UI层。它提供纯Go接口,简单API,应用体积小,结合了HTML/CSS的美观和Go的高性能。Lorca支持与JavaScript交互,异步流程,本地服务器或数据URL加载Web UI,还支持头less模式测试和多窗口。不过,它要求已安装Chrome/Chromium 70+,并有一些设计上的限制,如无法控制窗口样式和菜单。

被折叠的 条评论
为什么被折叠?



