Знакомство с Fyne: GUI на Go

Если вычесть маркетинг, что такое Fyne технически? Это тулкит и app-API, написанные на Go: сами виджеты, контейнеры, компоновщики и тема — обычный Go-код, который можно открыть и читать, а не обёртка над Qt или GTK, как в предыдущих поколениях Go-GUI. Слово «чистый» требует одной честной оговорки: для сборки нужен C-компилятор и системные инструменты разработки, потому что вывод на экран идёт через cgo-привязки к OpenGL и библиотеке GLFW. Но весь код, с которым вы работаете как автор приложения, — Go. README формулирует назначение одной строкой: «easy-to-use UI toolkit and app API» для десктопа и мобильных из единой кодовой базы. Вторая мажорная версия с обновлённым API вышла в январе 2021-го, актуальная ветка — v2.8. Визуальный язык вдохновлён Material Design, с оговоркой самой документации: базовая плотность у Fyne другая, иконка высотой 18 соответствует 24 в материальном Android-приложении. Важное следствие подхода «рисуем всё сами»: на Windows, macOS и Linux приложение выглядит одинаково — и это не нативный вид каждой системы, а единая тема тулкита. Кому-то это минус, кому-то наоборот: дизайн перестаёт зависеть от версии ОС у пользователя.

Разберём каркас по слоям. app.New() создаёт приложение: за ним стоит драйвер платформы, который умеет открывать окна, собирать ввод и рисовать; для мобильных и настроек есть вариант app.NewWithID с идентификатором. myApp.NewWindow("Заголовок") — окно, а window.SetContent(...) задаёт корневой объект содержимого. Самая важная строка — последняя: ShowAndRun() — сокращение для window.Show() и myApp.Run() подряд. Run запускает цикл событий, run loop: он принимает клики и нажатия клавиш, перерисовывает экран и не даёт программе завершиться. Документация формулирует два жёстких правила. Первое: Run вызывается ровно один раз — цикл в приложении один, повторный вызов приводит к ошибкам. Второе: управление после Run вы получите только когда приложение закроется, поэтому функции, написанные после него, выполнятся в самом конце жизни программы. App.Quit() прерывает работу, но только в десктопных средах — на мобильных такой возможности нет. А если Run никто не вызвал, setup-код доходит до конца main, и процесс завершается — об этом отдельное задание ниже.

У каждого окна есть canvas — область рисования, доступ даёт window.Canvas(). Всё, что можно нарисовать, — от прямоугольника до кнопки — является реализацией интерфейса fyne.CanvasObject: у объекта есть размер, позиция, видимость и метод Refresh() для перерисовки. Примитивы — canvas.Rectangle, canvas.Circle, canvas.Line, canvas.Text, canvas.Image — живут в пакете canvas, и из них, по формулировке документации, собран весь тулкит. Виджеты — особый вид CanvasObject: fyne.Widget добавляет интерактивное поведение, а внешний вид вынесен в отдельный объект — WidgetRenderer. Разделение сознательное. API виджета описывает поведение и состояние (SetText, SetEnabled), рендер его не касается; когда состояние меняется, вызывается Refresh, и рендерер перерисовывает элемент по новому состоянию. Из этого следует неожиданно приятное свойство: приложение можно прогонять юнит-тестами в памяти, вообще не отрисовывая его на экран — для этого в пакете test есть SoftwarePainter и безоконный canvas. Widget и WidgetRenderer — интерфейсы, и на них держится вся система кастомных виджетов: как такие «контракты» проектируются на чистом Go, подробно разбирается в уроке 10-interfejsy продвинутого курса, а свой виджет мы соберём в восьмом уроке этого курса.

Виджеты в Fyne не решают сами, где им стоять. Они сообщают минимальный размер — MinSize — а расстановкой занимаются контейнеры с компоновками. container.NewVBox из hello world складывает элементы в колонку: каждый получает ширину самого широкого соседа и высоту не меньше своей минимальной; горизонтальный HBox работает так же, но в строку и с общей высотой. Дальше по списку пакета layout: Border с зонами сверху, слева, снизу и справа, где всё остальное занимает центр; Center, ставящий каждый элемент на его минимум; Form парами «подпись — поле»; Grid и GridWrap для плиток; Padded и Stack. Отступы берутся из темы: стандартный padding равен 4, внутренний отступ виджета — 8, и это не случайные пиксели, а константы темы, которые можно переопределить. Компоновки вкладываются друг в друга: заголовок в HBox, боковая панель в VBox, содержимое в Grid — и всё это внутри Border. Полный разбор Box-контейнеров и их ловушек — четвёртый урок курса.

Кто именно рисует пиксели? На десктопе Fyne открывает окна через GLFW и рисует через OpenGL: в go.mod тулкита прописаны привязки go-gl/gl и go-gl/glfw, а в internal/painter/gl живут шейдеры, которыми прямоугольники, скругления и текст превращаются в графику видеокарты. В сборках под WebAssembly те же вызовы уходят в gl-js — то есть в браузерный WebGL. Второй путь — программная растеризация: software-пейтер из internal/painter/software рисует canvas в обычный image.Image в памяти, без участия видеокарты. Медленнее, но именно на нём построены тесты и headless-среды: пакет test подсовывает приложению SoftwarePainter, а драйвер software умеет рисовать в WindowlessCanvas — рендер без окна вообще. Третье, что полезно знать заранее: GUI живёт в главном потоке операционной системы. Драйвер закрепляет за собой главный поток через runtime.LockOSThread и проводит все операции рисования через очередь; из собственной горутины менять интерфейс напрямую небезопасно — с версии 2.6.0 для этого есть fyne.Do, который ставит вашу функцию в очередь главного потока. Обновление GUI из горутин — тема двадцатого урока.

Главный аргумент за Fyne — кроссплатформенность. Десктоп: Windows, macOS, Linux — обычные go run и go build; нужен установленный C-компилятор, а первая сборка на Windows может занять до десяти минут, дальше кеш. Мобильные: Android и iOS собираются командой fyne package -os android -appID my.domain.app или fyne package -os ios; сборка под iOS ведётся с macOS, а -os iossimulator даёт пакет для эмулятора. Готовый пакет ставится утилитой fyne install -os android или платформенными средствами. Посмотреть, как приложение будет выглядеть на телефоне, можно и без пакования: go run -tags mobile запускает мобильную симуляцию. Пятая среда — браузер: с версии 2.5.0 web-драйвер полностью поддерживается, fyne serve поднимает локальный сервер с WebAssembly-сборкой, fyne package -os web готовит файлы для хостинга; ограничения описаны честно — файловые диалоги и хранение документов пока не работают. Требования к среде разработки скромные: Go 1.22 или новее, C-компилятор, системные инструменты — всё перечислено в README.

Перебирая gui go фреймворки, вы почти наверняка наткнётесь на Walk — «Windows Application Library Kit», один из старожилов Go-ниши. Его характер противоположен Fyne: Walk — обёртка над Win32 API и стандартными элементами управления Windows. Отсюда плюс: интерфейс нативный для этой системы, кнопки и списки — настоящие контролы ОС, а не нарисованные поверх. Отсюда и жёсткий потолок: macOS, Linux, мобильные — никак; приложение, собранное с Walk, навсегда привязано к Windows и её API. Стиль кода другой: в Walk принято декларативное описание окна структурами — MainWindow, VBox, TextEdit с AssignTo — что по духу ближе к описаниям интерфейса в других экосистемах, чем к Go-идиомам. Если утилита точно всегда будет под Windows и нужен нативный вид — Walk до сих пор рабочий выбор. Но как только появляется «а теперь пусть работает на маке», начинается переписывание с нуля: Fyne собирает ту же программу на все три десктопные системы из одного кода, и в этом вся цена вопроса.

Gio — второй серьёзный сосед, и сравнивать его честнее всего по уровню абстракции. Gio — immediate mode GUI: программа на каждом кадре заново описывает интерфейс, как это делают игровые движки; нет дерева объектов, живущего между кадрами, есть операция «нарисуй состояние прямо сейчас». README определяет проект одной строкой: «Immediate mode GUI programs in Go» — для Android, iOS, macOS, Linux, FreeBSD, OpenBSD, Windows и WebAssembly, причём веб помечен как экспериментальный. Последствия: Gio даёт предсказуемость и полный контроль отрисовки — ценой ручной работы. Готовых виджетов мало, тема — ваша забота, путь от идеи до формы с полями заметно длиннее, чем в Fyne. Показательна и версия: Gio до сих пор живёт в нулевой мажорной — API ещё может меняться. Fyne — retained-подход: дерево CanvasObject живёт между кадрами, Refresh перерисовывает изменившееся, виджеты и тема идут в комплекте. Для стандартных форм и панелей управления Fyne быстрее в разработке; Gio выбирают, когда интерфейс нестандартный и нужен контроль каждого пикселя. Никто не «лучше» — они про разную цену контроля.

Fyne — правильный выбор для внутренних инструментов, настольных утилит, панелей управления, клиентов к собственному API и учебных проектов: везде, где нужна форма с полями, кнопками и списками на трёх десктопных системах, а язык команды — Go. README подчёркивает переносимость: приложения работают без предустановленных библиотек — пользователю не нужны ни рантайм, ни пакеты зависимостей, только ваш бинарник. Честный список, где Fyne не лучший вариант. Игры: тулкит не для этого, в Go для игр есть отдельные инструменты вроде Ebiten. Тяжёлая 3D-графика и нестандартные медиаплееры — возможны, но вы окажетесь на низком уровне canvas раньше, чем рассчитывали. Пиксель-в-пиксель нативный вид каждой ОС — не про Fyne: тема единая, «кнопка как в Windows 11» из коробки не получится. Кросс-компиляция с машины на машину усложняется cgo: собирать под чужую платформу удобнее утилитой fyne-cross с контейнерами — это тема двадцать третьего урока. И веб: работает, но ограничения web-драйвера заметны — для сайта берите обычный фронтенд.

Дальше по курсу так. Второй урок ставит тулкит и запускает первое окно: app.New, SetContent и run loop под микроскопом (02-pervoe-okno). Третий — базовые виджеты Label, Button, Entry, Check, Select; четвёртый — Box-контейнеры и компоновки, тизер которых был выше. Седьмой урок уходит в canvas и примитивы рисования, восьмой собирает собственный виджет на WidgetRenderer — интерфейсная модель из этого урока там окупится полностью. Дальше списки и коллекции, таблицы, вкладки, диалоги, темы, привязка данных, многопоточность и сборка под мобильные и десктоп; полная программа из 25 уроков — на странице курса Fyne. Финальный проект — менеджер задач: списки, темы, сохранение состояния. Если вы прошли базовый курс этого самоучителя, опыт цельного приложения у вас уже есть: 25-pervoe-prilozhenie собирал консольный менеджер заметок. Здесь вы соберёте такой же по смыслу, но с окном, кнопками и мышью — и он будет работать там же, где вы: на вашей системе.