energye / energy

README.md

Energy is a framework for Go to build desktop applications based on CEF

中文 | English

Project Introduction

Energy is a framework by Golang based on CEF(Chromium Embedded Framework), embedded CEF binary

energy is a framework developed by Golang based on CEF(Chromium Embedded Framework), embedded with CEF binary

Use Go and Web technology (HTML+CSS+JavaScript) to build cross-platform desktop applications that support Windows, Linux and MacOS

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, based on IPC communication, Go and Web can call each other quality.

Esource loading: You can either read local resources or resources build into execution files without http services, or you can load resources using 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 Download address

During the installation process, you can optionally install the following frameworks and tools, or you can download the resources yourself.

Name	Platform	illustrate
Golang	ALL	Golang Development Environment
CEF, liblcl	ALL	CEF Framework
NSIS	Windows	Windows Installation package production tool
UPX	All	Execute file compression tool
7z	Windows, Linux	CEF Framework compression 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 UsingnsisCreate exe installation package
- linux UsingdpkgCreate deb installation package
- macos Generatexxx.app

System support

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