Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Build awesome Golang desktop apps and beautiful interfaces with Vue.js, React.js, Framework 7, and more...

License

NotificationsYou must be signed in to change notification settings

guark/guark

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Guark allows you to build beautiful user interfaces using modern web technologies such as Vue.js, React.js..., while your app logic handled and powered by the amazingGo.

Installation ❘Getting Started ❘Contributing ❘License

Guark Vue Template

🖳 About The Project

Guark is an open-source framework to build cross platform desktop GUI applications.

📢 What Guark stands for?

Go + Quark = Guark

🔮 Guark mission

Simplify cross platform desktop apps development.

🎸 How it works

Demo Video:https://youtu.be/_k_tq9sj-do

Guark backend and logic part handled by native Go code, while the user interfaces built with modern web technologies (Vue.js, React.js, etc...), and with Guark javascript API you can communicate between your Go and UI framework, and calling your exported Go functions and plugin(s) methods.

💌 Main Features

  • Desktop applications with GO ♥
  • One codebase for Gnu/Linux, macOS, and Windows.
  • UI Hot Reload.
  • You can use any front end framework.
  • Supports Chrome, and native webview engine or both.
  • Windows MSI bundler builtin.

📜 Installation

1. Install guark CLI tool:

go install github.com/guark/guark/cmd/guark@latest

2. Some Requirements:

// fedorasudo dnf install gtk3-devel webkit2gtk3-devel gcc-c++ pkgconf-pkg-config// Ubuntusudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev build-essential// Windows// https://jmeubank.github.io/tdm-gcc/download/

Open a console and make sure the tdm-gcc tools chain are in the PATH:

gcc --versiongcc (tdm64-1) 10.3.0Copyright (C) 2020 Free Software Foundation, Inc.This is free software; see the source for copying conditions.  There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Getting Started

After installing guark CLI tool, the next step is to create a new guark project based on the template that you like:

Create a new project

# cd to empty directory and run:guark init --template vue --mod github.com/username/appname

Start Dev Server

After creating new project run:

guark run

Export your first GO function to JS API

1. Create a new file inlib/funcs directory:
// lib/funcs/foo_bar.goimport ("github.com/guark/guark/app")funcFooBar(c app.Context) (interface{},error) {c.App.Log.Debug("Foo bar called")return"This is a my return value to javasript",nil}
2. Then export it to Guark JS API inlib/config.go file:
// Exposed functions to guark Javascript api.varFuncs= app.Funcs{"foo":funcs.FooBar,}
3. Then you can call your function in #"Permalink: 3. Then you can call your function in javascript:" href="#3-then-you-can-call-your-function-in-javascript">
importgfrom"guark"g.call("foo").then(res=>console.log(res)).catch(err=>console.error(err))

See Vue template as an example:https://github.com/guark/vue

Guark Engines:

You can change the engine inguark.yaml file.

  • webview: Uses native system webview.
  • chrome: Uses and requires google chrome.
  • hybrid: Uses chrome if exists in the system, if chrome not available guark will switch to native webview by default.

Build Your App

Configure the build

guark-build.yaml contains all configuration and path required for the build, like the compilers or default platform.

The C/C++ compilers are not using the PATH environment and need an absolute path to them, on linux it will use the default paths for Linux builds.

For cross platform build, it will look like:

linux:  ldflags: ""darwin:  ldflags: ""windows:  cc: /usr/bin/x86_64-w64-mingw32-gcc  cxx: /usr/bin/x86_64-w64-mingw32-g++  ldflags: "-H windowsgui"  windres: /usr/bin/x86_64-w64-mingw32-windres

Update these paths accordingly (check the GCC/distributions documentations for the right paths)

On Windows, make sure to have installed tdm-gcc, once done, update the guark-build.yaml:

# Guark build config file.setup:  - cmd: yarn install    dir: ui  - cmd: go mod download  - cmd: go mod tidy  - cmd: go mod verifylinux:  ldflags: ""darwin:  ldflags: ""windows:  cc: C:\apps\tdm-gcc1030\bin\gcc  cxx: C:\apps\tdm-gcc1030\bin\g++  ldflags: "-H windowsgui"  windres: C:\apps\tdm-gcc1030\bin\windres.exe

Build

You can build your app with

guark build

Bundle Windows App

After building your app you can bundle your windows app into msi using WIX.

guark bundle

Wix required!

Install it from:https://wixtoolset.org/

Cross Compiling To Windows From Gnu/Linux:

You can build windows app from your linux based system, usingmingw64

1. Install mingw64:

// Fedorasudo dnf install mingw64-gcc// Ubuntusudo apt install binutils-mingw-w64

2. Configureguark-build.yaml File:

Double check the binary paths inguark-build.yaml.

3. Build The App:

# this command will build and compile linux, and windows app. you can find your compiled apps in `dist/` directory.guark build --target linux --target windows

You can use any cross compiler for example:guark build --target darwin. just change the options inguark-build.yaml file.

Note

You can also bundle windows app into MSI file from your linux based system viaguark bundle, but you need to install wix tools:

# fedoradnf install msitools# Ubuntusudo apt-get install wixl

Contributing

PRs, issues, and feedback from ninja gophers are very welcomed.

License

Guark is provided under theMIT License.

[8]ページ先頭
©2009-2025 Movatter.jp