Ресурсы: изображения и шрифты

Прежде чем рисовать свои значки, посмотри на шкаф с готовыми: тема приложения содержит десятки встроенных иконок, каждая под именем fyne.ThemeIconName — IconNameHome, IconNameContentAdd, IconNameDocumentSave и так далее. Получить ресурс можно хелпером theme.Icon(theme.IconNameHome) — он спросит активную тему за тебя, как theme.Padding() из пятнадцатого урока. Значки монохромные и тематические: тема раздаёт их уже перекрашенными под свою палитру, поэтому в тёмном режиме значок светлый, в светлом — тёмный, и никакой работы с твоей стороны не нужно. Применяются они везде, где тулкит ждёт fyne.Resource: в кнопке через widget.NewButtonWithIcon, в пункте меню через поле Icon у fyne.MenuItem, в тулбаре через widget.NewToolbarAction, во вкладках через NewTabItemWithIcon из двенадцатого урока. Диалоги тринадцатого урока рисуют свои заголовки этими же значками. Ниже — рабочий каталог самых ходовых имён: держи его под рукой, прежде чем рисовать свою шестерёнку.

Статический ресурс — байты, зафиксированные на момент создания. В пакете fyne.io/fyne/v2/resource живёт структура StaticResource с двумя полями: StaticName string и StaticContent []byte, плюс фабрика resource.NewStaticResource(name, content). Сокращение fyne.NewStaticResource делает то же самое — это удобная обёртка в корневом пакете, и в этом курсе мы пользуемся именно ей; длинная форма нужна в сгенерированном коде, о нём ниже. Когда статический ресурс из файла оправдан? Когда данные появляются или меняются в рантайме: пользователь выбрал аватарку, приложение скачало обновление каталога, логотип положили рядом с исполняемым файлом. Подводный камень один, но классический: относительный путь «assets/logo.png» отсчитывается от рабочей папки процесса, а не от папки с exe — запустишь ярлыком из другого каталога, и файл «исчезнет». Для данных, которые живут вместе с программой, надёжнее вшить их в бинарник — этим займёмся через пару блоков. А для фоновых проверок существования файла лучше storage-API из двадцать первого урока. Пока запомни главное: статический ресурс — это просто пара имя-плюс-байты, и создать его можно где угодно, хоть в горутине.

Любое fyne изображение в окне — это canvas.Image, примитив из седьмого урока. Источников у него три, в порядке приоритета: Resource fyne.Resource, Image image.Image — уже декодированный в памяти Go-образ — и File string с путём к файлу. Фабрики удобства просто прячут выбор: canvas.NewImageFromFile для диска, canvas.NewImageFromImage для готового image.Image, canvas.NewImageFromResource для ресурса, canvas.NewImageFromURI для URI из диалога выбора файла — она пригодится в двадцать первом уроке. За поведение в раскладке отвечает поле FillMode: canvas.ImageFillStretch растягивает под отведённый прямоугольник, возможно с искажением пропорций; canvas.ImageFillContain вписывает целиком, сохраняя пропорции и оставляя поля; canvas.ImageFillOriginal рисует в исходном пиксельном размере. Поле Translucency от 0 до 1 делает картинку полупрозрачной — водяные знаки и фоны под текстом. И не забывай правило седьмого урока: поля изображения хранят значения, а не подписки. Поменял Resource или FillMode — позови canvas.Refresh(img), иначе рендерер не узнает. Форматы: PNG, JPEG и GIF декодируются стандартной библиотекой, SVG fyne рисует собственным рендерером — и именно SVG открывает дорогу тематическим значкам, о них ниже.

Самый надёжный способ раздать ассеты — вшить их в исполняемый файл ещё на компиляции. С Go 1.16 это делается директивой //go:embed прямо над переменной: байты файла или целого каталога становятся частью пакета, и единственный exe уезжает к пользователю со всем содержимым. Три правила директивы. Первое: файлы должны лежать внутри каталога пакета — подняться выше через «..» нельзя, абсолютные пути нельзя. Второе: каталоги, начинающиеся с точки или подчёркивания, не вшиваются — если папка ассетов не видна, проверь имя. Третье: переменная может быть и одной строкой с []byte, и embed.FS — виртуальной файловой системой для целого дерева; из неё байты достают методом ReadFile по пути относительно пакета. Дальше всё знакомо: ReadFile отдал байты — fyne.NewStaticResource упаковал — виджет нарисовал. Эти embed ресурсы компилятор контролирует за тебя: файла нет — сборка падает, и битый путь невозможно заметить только на проде. Именно так стоит вшивать логотипы, значки и шрифты, которые живут вместе с приложением.

Когда файлов много, а держать рядом с кодом каталог ассетов не хочется, в дело вступает утилита fyne bundle: она принимает каталог или файл и генерирует Go-исходник с готовыми константами fyne.StaticResource. Запуск выглядит так: go run fyne.io/fyne/v2/cmd/fyne@latest bundle -o assets.go -pkg main assets/icons. Результат — файл assets.go, в котором каждый ассет стал переменной вида resourceAssetsIconsGearSvg со вшитыми байтами: импортируешь пакет — ресурсы уже там, никакой embed.FS и ReadFile не нужно. Это старший приём из тех же fyne ресурсы, и у него своя ниша: имя ресурса фиксируется при генерации, типизация — чистая переменная вместо строки, а на этапе сборки не требуются ни директивы, ни правило о каталоге пакета. Цена — перегенерация: изменил значок, запусти bundle заново, закоммить сгенерированный файл; продвинутые команды вешают это на make-цель рядом со сборкой. Выбор между embed и bundle — вопрос вкуса и размера ассет-парка: принципиально оба дают одно и то же — fyne.Resource с байтами внутри бинарника.

Вот и обещание пятнадцатого урока: значки, перекрашивающиеся со сменой палитры. Встроенные значки темы так себя ведут потому, что внутри них — обёртка theme.NewThemedResource(res): ресурс-адаптер, который при отрисовке красит содержимое цветом активной темы. По умолчанию это ColorNameForeground, но поле ColorName можно переназначить: theme.ColorNamePrimary даст фирменный акцент, ColorNameDisabled — приглушённый вид, ColorNameError — тревожный. Есть и поле ColorAdjustment для тонких подстроек прозрачности. Честная оговорка: перекраска гарантированно рассчитана на SVG — тулкит перерисовывает вектор сам; PNG-файл обёртка отдаст как есть, с исходными цветами. Отсюда простая производственная привычка: свои монохромные значки рисуй в SVG одним цветом и оборачивай в NewThemedResource — они встанут в один ряд со встроенными и будут честно реагировать и на смену светлого-тёмного режима, и на локальный ThemeOverride из пятнадцатого урока. А цветные логотипы оставай обычным ресурсом: брендовой палитре перекраска не нужна.

Последний жанр ресурсов — шрифты, и он уже частично знаком: метод Font(style fyne.TextStyle) твоей темы из пятнадцатого урока возвращает fyne.Resource, внутри которого лежит TTF-файл. Стандартная тема раздаёт семейство Noto Sans: обычный, жирный, курсив и монопространственный вариант — причём кириллица в них поддерживается из коробки, поэтому русский текст в fyne не превращается в квадраты. Подключить свой шрифт просто: вшиваешь TTF через embed, в своей теме возвращаешь ресурс из метода Font — весь интерфейс, от Label до Entry, перечитает шрифт сам, ведь виджеты спрашивают тему при каждой отрисовке. Стиль параметра решает, какой из четырёх файлов отдать: TextStyle.Bold, TextStyle.Italic, TextStyle.Monospace. Два практических предупреждения. Первое: проверяй глифы — модный узкий шрифт без кириллических букв даст красивую латиницу и пустые квадраты в русском тексте. Второе: не присваивай ресурс шрифта напрямую виджетам — шрифт живёт в теме, и это правильно: одна точка правды, как с цветами. Размер текста, напомню, шрифтовой ресурс не задаёт — это SizeNameText из пятнадцатого урока.

Ресурс — последняя «кирпичная» абстракция тулкита: теперь у тебя есть всё, из чего собирается интерфейс. Каркас приложения и первый запуск — во втором уроке; примитивы и правило «значение вместо подписки», на котором держится Refresh у canvas.Image, — в седьмом; пункты меню с полем Icon — в четырнадцатом, а тема, чьи Color, Font и Icon раздают ресурсы, — в пятнадцатом. Дальше по программе данные: семнадцатый урок посвящён привязке binding — когда данные меняются, виджеты обновляются сами, и правило ручного Refresh наконец отступает. Практические выбросы сегодняшнего материала: иконки приложения для сторов собираются при упаковке под мобильные, а полный маршрут курса — на странице Fyne. Держи в голове одну рекомендацию из этого урока как дефолт: всё, что должно жить с программой, — embed; всё, что меняется в рантайме, — статический ресурс из свежих байтов.