О проекте

Fyne — это удобный инструментарий для создания графического интерфейса и API приложений, написанный на Go. Он предназначен для создания приложений, работающих на десктопах и мобильных устройствах с одним набором кода.

Предварительные требования

Чтобы создавать приложения с использованием Fyne, вам потребуется Go версии 1.17 или выше, компилятор C и средства разработки вашей системы. Если вы не уверены, что все эти компоненты установлены, или не знаете, как установить их, обратитесь к нашей инструкции по началу работы.

Используя стандартные инструменты Go, вы можете установить основную библиотеку Fyne следующим образом:

go get fyne.io/fyne/v2@latest

После импорта нового модуля выполните следующую команду перед первым компиляцией кода. Избегайте её выполнения до того, как начнете писать код, использующий этот модуль, чтобы случайно не удалить зависимости:

go mod tidy

Демонстрация виджетов

Чтобы запустить демонстрацию возможностей Fyne выполните следующее:

go install fyne.io/fyne/v2/cmd/fyne_demo@latest
fyne_demo

Вы должны увидеть что-то вроде этого (после нажатия нескольких кнопок):

Или если вы используете светлую тему:

А также запущенный на мобильном устройстве:

Начало работы

Fyne создан так, чтобы было очень просто работать с ним. Если вы выполнили предварительные шаги выше, то вам нужна лишь среда разработки Go (или текстовый редактор).

Откройте новый файл и готовы к написанию своего первого приложения!

package main

import (
	"fyne.io/fyne/v2/app"
	"fyne.io/fyne/v2/container"
	"fyne.io/fyne/v2/widget"
)

func main() {
	a := app.New()
	w := a.NewWindow("Привет")

	hello := widget.NewLabel("Привет, Fyne!")
	w.SetContent(container.NewVBox(
		hello,
		widget.NewButton("Привет!", func() {
			hello.SetText("Добро пожаловать :)")
		}),
	))

	w.ShowAndRun()
}

Это можно запустить простым образом:

go run main.go

[!ЗАМЕЧАНИЕ] Первое компилирование Fyne на Windows может занять до 10 минут, в зависимости от вашего оборудования. В последующих сборках время будет значительно меньше.

Оно должно выглядеть вот так:

Запуск в режиме мобильной симуляции

Есть полезный режим мобильной симуляции, который показывает, как бы ваше приложение работало на мобильном устройстве:

go run -tags mobile main.go

Ещё один вариант использовать команду fyne, см. Упаковка для мобильных устройств.

Установка

Используя go install вы скопируете исполняемый файл в директорию bin Go. Чтобы установить приложение с иконками и другими элементами в стандартное место операционной системы, вы можете использовать утилиту fyne и подкоманду install.

go install fyne.io/fyne/v2/cmd/fyne@latest
fyne install

Упаковка для мобильных устройств

Чтобы запустить на мобильном устройстве, необходимо упаковать приложение. Для этого мы можем использовать подкоманду package утилиты fyne. Вам потребуется добавить подходящие параметры, как указано ниже, но базовая команда представлена ниже. После упаковки вы можете установить его с помощью средств разработки платформы или подкоманды install утилиты fyne.

fyne package -os android -appID my.domain.appname
fyne install -os android

Созданный Android-приложение может запускаться либо на реальном устройстве, либо в эмуляторе Android. Однако, сборка для iOS немного отличается. Если аргумент -os равен "ios", то сборка производится только для реального устройства iOS. Указание -os как "iossimulator" позволяет приложению запускаться в эмуляторе iOS:

fyne package -os ios -appID my.domain.appname
fyne package -os iossimulator -appID my.domain.appname

Подготовка выпуска

Используя подкоманду release утилиты fyne вы можете упаковать свое приложение для выпуска в магазины приложений и рынки. Убедитесь, что у вас установлены стандартные средства разработки и вы следовали руководству по настройке аккаунтов и подписи. Затем вы можете выполнить что-то вроде следующего, обратите внимание на параметр -os ios, который позволяет сборке iOS-приложения с компьютера macOS. Другие комбинации тоже работают :)

$ fyne release -os ios -certificate "Apple Distribution" -profile "My App Distribution" -appID "com.example.myapp"

Команда выше создаст файл .ipa, который затем можно загрузить в App Store iOS.

Документация

Более подробная документация доступна на сайте Fyne Developer или на pkg.go.dev.

ПримерыВы можете найти множество примеров приложений в репозитории примеров. Альтернативно список приложений, использующих Fyne, можно найти на нашем сайте www.fyne.io.

Распространение Fyne Toolkit

Все приложения Fyne будут работать без предустановленных библиотек, что делает их очень переносимыми. Однако, если вы хотите поддерживать Fyne более широко на вашей операционной системе, вы можете установить некоторые утилиты, которые помогут сделать опыт пользователя более полным.

Дополнительные приложения

Рекомендуется установить следующие дополнительные приложения:

Эти приложения являются необязательными, но могут помочь создать более полный опыт использования рабочего стола.

FyneDesk (Linux / BSD)

Чтобы полностью использовать Fyne на своем рабочем столе / ноутбуке, вы можете установить FyneDesk также :)