energye / energy Goto Github PK

Energy is a framework developed by Go language based on CEF (Chromium Embedded Framework) for developing cross-platform desktop applications for Windows, Mac OS X, and Linux

Home Page: https://energy.yanghy.cn

License: Apache License 2.0

Go 99.49% Batchfile 0.05% Makefile 0.02% Roff 0.13% Raku 0.01% NSIS 0.22% Shell 0.07%

go golang linux macos windows browser v8 cef chromium macosx

energy's Introduction

Energy is a GUI framework developed by Go, based on LCL and CEF

中文 | English

Project Introduction

Energy is a GUI framework developed in Go, based on LCL and CEF(Chromium Embedded Framework), which is used to develop cross-platform desktop applications for Windows, MacOS, and Linux.
LCL alone can create lightweight native applications, or can be combined with CEF to create more feature-complete applications.
Construct cross-platform desktop applications that support Windows, Linux, and MacOS using Go and web technologies (HTML + CSS + JavaScript).

Characteristic

Rich CEF API and LCL system native widgets
Development environment is simple and the compilation speed is fast. Only need Go and Energy.
Cross-Platform: You can package your code as Windows, domestic UOS, Deepin, Kylin, MacOS and Linux
Responsibilities
- Go: Go is responsible for creating Windows, configuring CEF and implementing functions, creating various UI components, calling the low level of the system and some functions that JS cannot handle, such as: file flow, security encryption, high-performance processing, etc.
- Web: HTML + CSS + JavaScript is responsible for the function of the client interface, you can make any interface you want.
Front-end technology: Support mainstream frameworks, such as Vue, React, Angular or pure HTML+CSS+JS.
Event driven: High performance event driven communication based on IPC allowing intercommunication between Go and Web.
Resource loading: You can either read local resources or resources built into execution files either with or without HTTP services.

Built-in dependency&integration

Development Environment

Basic needs

Golang >= 1.18
Energy (CEF, liblcl)

Environmental installation

Automatic installation development environment using the energy command-line tool

Guide to Start - Link

Quick Start

Using energy command line tools to install the complete development environment automatically.

Run a simple application by three steps

Install development environment: energy install .
Initiate an Application: energy init .
Run the Application: go run main.go

sample code

main.go

package main

import (
	"github.com/energye/energy/v2/cef"
)

func main() {
	//Global initialization
	cef.GlobalInit(nil, nil)
	//Create an application
	app := cef.NewApplication()
	//Specify a URL address or local HTML file directory
	cef.BrowserWindow.Config.Url = "https://energy.yanghy.cn"
	//Run Application
	cef.Run(app)
}

Build

Build：energy build .
Package：energy package .
Package Type：
- windows: Using nsis create exe installation package
- linux: Using dpkg create deb installation package
- macos: Generate xxx.app

System support

	32 Bit	64 Bit	Test System Version
Windows			Windows XP SP3、 7、10、11
MacOSX			MacOSX 10.15
MacOS M1 M2			MacOS M2
Linux			Deepin20.8、Ubuntu18.04、LinuxMint21
Linux ARM			Kylin-V10-SP1-2107

Related Projects

Welcome to join

join energy throwing in the process of construction, there are many things that cannot be completed alone, if there are interested students who want to participate in the realization or learning of energy, you can contact me through WeChat or QQ.

If this project is helpful to you, please give me a star

ENERGY QQ Group & WeChat

Thanks Jetbrains

Project screenshot

Windows-10

Windows-7 32 & 64

Windows-XP-SP3

Linux - Deepin

Linux - Kylin ARM

Linux - Ubuntu

MacOSX

Public License

Contributors

energy's People

Contributors

Stargazers

Watchers

Forkers

shibingli nauy1216 kshdb xwt-alone linecode zmggit izouxv barryzxy esword618 jangocheng barremian mzky zhaojunliing reghtml chwjbn ddkwork betashepherd jeremyrenjw tuwibu

energy's Issues

如何调用chrome的静默打印

如何调用chrome的静默打印？

[Bug] Issue of rendering process deadlock caused by IPC nested calls

Issue of rendering process deadlock caused by IPC nested calls

JS triggers the Go event, and within the Go event, JS events are triggered

v1.107.1.11 later, Linux Bug, GTK2 and GTK3 coexist

v1.107.1.11, failed to start properly under linux due to the co-existence of GTK2 and GTK3, which required an upstream fix to resolve.

You can install the previous version of the environment by command

energy install -v=v1.106.1.1 .

[bug] a fatal error when create a new browser window

CEF 118
Windows 11

go.mod:

module main

go 1.22.0

require (
	github.com/dustin/go-humanize v1.0.1
	github.com/energye/energy/v2 v2.3.6
)

require (
	github.com/energye/golcl v1.0.10 // indirect
	github.com/godbus/dbus/v5 v5.1.0 // indirect
	github.com/tevino/abool v0.0.0-20220530134649-2bfc934cb23c // indirect
	golang.org/x/sys v0.17.0 // indirect
)

package main

import (
	"fmt"
	"runtime"

	"github.com/dustin/go-humanize"
	"github.com/energye/energy/v2/cef"
	"github.com/energye/energy/v2/logger"
	"github.com/energye/energy/v2/consts"

)

const BrowserVersion = "118"

func main() {
	logger.SetEnable(true)
	logger.SetLevel(logger.CefLog_Debug) 
	fmt.Printf("\nVersion:%s", runtime.Version())
	fmt.Printf("\nCompiler:%s", runtime.Compiler)
	fmt.Printf("\nNo. of CPU:%v\n", runtime.NumCPU())
	fmt.Printf("\nGOOS:%s", runtime.GOOS)
	fmt.Printf("\nGOARCH:%s", runtime.GOARCH)
	fmt.Printf("\nGOROOT:%s\n", runtime.GOROOT())
	fmt.Printf("\nBrowserVersion:%s\n", BrowserVersion)

	//global initialization must be called by every application, then create application
	cef.GlobalInit(nil, nil)
	cefApp := cef.NewApplication()
	cefApp.SetEnableGPU(true)
	cefApp.SetAllowInsecureLocalhost(true)
	cefApp.SetLocale(consts.LANGUAGE_en_US)


	cef.BrowserWindow.Config.EnableCenterWindow= false
	cef.BrowserWindow.Config.X=1
	cef.BrowserWindow.Config.Y=1
	cef.BrowserWindow.Config.Height= 900
	cef.BrowserWindow.Config.Width= 1800
	cef.BrowserWindow.Config.ChromiumConfig().SetEnableMenu(true) //Enable right-click menu
	cef.BrowserWindow.Config.ChromiumConfig().SetEnableDevTools(true) //Enabling Developer Tools

	fmt.Printf("ChromeBuild:%s\n", cefApp.ChromeVersion())
	fmt.Printf("LibVersion:%s\n", cefApp.LibVersion())
	fmt.Printf("LibCefVersion:%s\n", cefApp.LibCefVersion())
	fmt.Printf("TotalSystemMemory:%s\n", humanize.Bytes(cefApp.TotalSystemMemory()))
	fmt.Printf("UsedMemory::%s\n", humanize.Bytes(cefApp.UsedMemory()))

	// Set the i18n resource loading method here, use the built-in to exe method here.
	//i18n.SetLocalFS(&resources, "resources")
	//i18n.Switch(consts.LANGUAGE_en_US)

	//specify a URL address, or a local html file directory
	cef.BrowserWindow.Config.Url = "https://html.com/attributes/a-target/"
	cef.BrowserWindow.Config.Title = "ENERGY 2.3.6 Test"

	//run application
	cef.Run(cefApp)
}

click at the link at the page
Code Example
The home page will open in another tab.

And you get some error:

PS C:\Users\JS\Desktop\VSCode\chromium\chromium-118 2-3-6\examples> ./main.exe

Version:go1.22.0
Compiler:gc
No. of CPU:12