# Fyne
**Repository Path**: eddylapis/Fyne
## Basic Information
- **Project Name**: Fyne
- **Description**: Fyne 是一个 Go 语言开发的易用的 UI工具包，提供基于 OpenGL 的跨平台图形界面应用开发支持
- **Primary Language**: Go
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 22
- **Created**: 2019-04-01
- **Last Updated**: 2024-04-25
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# About
[Fyne](http://fyne.io) is an easy to use UI toolkit and app API written in Go. We use OpenGL (through the go-gl and go-glfw projects) to provide cross platform graphics.
The 1.0 release is now out and we encourage feedback and requests for the next major release :).
# Getting Started
Fyne is designed to be really easy to code with. Here are the steps to your first app.
## Prerequisites
As Fyne uses CGo you will require a C compiler (typically gcc).
If you don't have one set up the instructions at [Compiling](https://github.com/fyne-io/fyne/wiki/Compiling) may help.
By default Fyne uses the [gl golang bindings](https://github.com/go-gl/gl) which means you need a working OpenGL configuration.
Debian/Ubuntu based systems may also need to install the `libgl1-mesa-dev` and `xorg-dev` packages.
Using the standard go tools you can install Fyne's core library using:
go get fyne.io/fyne
## Code
And then you're ready to write your first app!
```go
package main
import (
"fyne.io/fyne/widget"
"fyne.io/fyne/app"
)
func main() {
app := app.New()
w := app.NewWindow("Hello")
w.SetContent(widget.NewVBox(
widget.NewLabel("Hello Fyne!"),
widget.NewButton("Quit", func() {
app.Quit()
}),
))
w.ShowAndRun()
}
```
And you can run that simply as:
go run main.go
It should look like this:
> Note that Windows applications load from a command prompt by default, which means if you click an icon you may see a command window.
> To fix this add the parameters `-ldflags -H=windowsgui` to your run or build commands.
# Scaling
Fyne is built entirely using vector graphics, which means applications
written with Fyne will scale to any value beautifully (not just whole number values).
The default scale value is calculated from your screen's DPI - and if you move
a window to another screen it will re-scale and adjust the window size accordingly!
We call this "auto scaling", and it is designed to keep an app GUI the same size as you change monitor.
You can override this behaviour by setting a specific scale using the FYNE_SCALE environment variable.
Standard size |
FYNE_SCALE=0.5 |
FYNE_SCALE=2.5 |
# Themes
Fyne ships with two themes by default, "light" and "dark". You can choose
which to use with the environment variable ```FYNE_THEME```.
The default is dark:
If you prefer a light theme then you could run:
FYNE_THEME=light go run main.go
It should then look like this:
# Widget demo
To run a showcase of the features of Fyne execute the following:
cd $GOPATH/src/fyne.io/fyne/cmd/fyne_demo/
go build
./fyne_demo
And you should see something like this (after you click a few buttons):
Or if you are using the light theme:
# Declarative API
Fyne also provides a declarative API.
The following is exactly the same as the code above but in a declarative style.
```go
package main
import (
"fyne.io/fyne"
"fyne.io/fyne/app"
"fyne.io/fyne/widget"
)
func main() {
app := app.New()
w := app.NewWindow("Hello")
w.SetContent(&widget.Box{Children: []fyne.CanvasObject{
&widget.Label{Text: "Hello Fyne!"},
&widget.Button{Text: "Quit", OnTapped: func() {
app.Quit()
}},
}})
w.ShowAndRun()
}
```
# Examples
The main examples have been moved - you can find them in their [own repository](https://github.com/fyne-io/examples/).