https://github.com/gurkengewuerz/cefgo

Go bindings for the Chromium Embedded Framework (CEF)
https://github.com/gurkengewuerz/cefgo

cef cefgo cgo chrome chromium go golang gui-toolkit

Last synced: about 2 months ago
JSON representation

Go bindings for the Chromium Embedded Framework (CEF)

• Host: GitHub
• URL: https://github.com/gurkengewuerz/cefgo
• Owner: Gurkengewuerz
• License: gpl-3.0
• Created: 2020-05-21T20:17:37.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-10-11T21:15:06.000Z (over 3 years ago)
• Last Synced: 2024-06-20T17:47:26.835Z (7 months ago)
• Topics: cef, cefgo, cgo, chrome, chromium, go, golang, gui-toolkit
• Language: Go
• Homepage:
• Size: 76.2 KB
• Stars: 23
• Watchers: 5
• Forks: 3
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# cefgo

These are simple bindings for [CEF](https://bitbucket.org/chromiumembedded/cef/src/master/) `C API` in Go.

It's not documented yet, but you can follow the [example](examples/main.go) to figure out how to use. It's pretty simple.  

In order to run the examples, the CEF supporting files must be placed beside the executable.

## Features

- JS to Go callbacks

- Go to JS eval

- frameless window

- single and sub executable support

- Tested on Windows and Linux (macOS should work using seperate processes)

- window functions (maximize, minimize, show, always on top, etc)

- application icon

## CEF Version and Compatibility

This lib is compiled against CEF 94.4.9+g09ee681+chromium-94.0.4606.71 / Chromium 94.0.4606.71 from https://cef-builds.spotifycdn.com/index.html

## Installation

1. Download the CEF SDK for your system from [Spotify](https://cef-builds.spotifycdn.com/index.html).

2. Locate your installation of cefgo (typically in $GOPATH/src/github.com/Gurkengewuerz/cefgo or $GOPATH/pkg/mod/github.com/Gurkengewuerz/cefgo), and extract the CEF SDK.  

    Copy include/* to cefgo/include  

    Copy Release/* to cefgo/Release  

    Copy Resources/* to cefgo/Release  

3. Run your binaries inside the Release folder

## Usage on macOS

Because i don't have the opportunity to test cefgo on a mac i need your help. Theoretically cefgo _should_ compile on macOS. Because macOS is different the application needs a bit more preperation.  

Please read the [CEF Wiki](https://bitbucket.org/chromiumembedded/cef/wiki/GeneralUsage#markdown-header-macos) carefully and set up your enviroment. Feel free to share your [experience](https://github.com/Gurkengewuerz/cefgo/issues/4).

## About JS callbacks

Callbacks need to be registered before browsers are created. Currently only basic type conversions are supported (undefined/null, bool, int/uint, double, string).

Objects and Arrays are possible, but not done. If you are running in multi-process mode (the default - as opposed to single-process) keep in mind the callback will be executed in the browser process and not in the main process.

## DevTools

Set the a `RemoteDebuggingPort` in the `Settings` struct. Start your application and point your browser to `http://127.0.0.1:`.

## Updating the CEF Version

The process for updating CEF to a newer version is relatively simple.

1. Download a new version from Spotify and extract.

2. Update the headers inside the include folder

3. Extract the new cef resources and libs to the Release folder

4. Try to compile the test application: ``go clean -cache -testcache && CGO_ENABLED=1 go build -o Release/test.exe examples/main.go``

5. Fix any incompatibilities with new APIs until the application compiles.

6. Push the new version, and update the version listed in this README.