Десктопные особенности

Fyne пишет один код для пяти платформ, но десктоп — старший брат: у него есть окна с рамками, системный трей, буфер обмена, перетаскивание файлов и меню в строке ОС. Всё, что существует только на настольных системах, Fyne выносит в отдельный пакет fyne.io/fyne/v2/driver/desktop, а точка входа в эти возможности — приведение типа приложения: myApp.(desktop.App) даёт расширенный интерфейс поверх обычного fyne.App. Приведение честное: на мобильных платформах из двадцать второго урока проверка ok вернёт false, и ветка просто не выполнится — это штатный способ писать код, который включается только там, где есть смысл. Запрос «fyne десктоп» почти всегда приводит к этому пакету. Вторая особенность — окна: на мобильном приложение живёт в одном экране, заданном системой, а на столе ты сам создаёшь окна через NewWindow, задаёшь размеры и решаешь, какое из них главное. Третья — рендер и масштаб: на десктопе встречаются экраны с разной плотностью пикселей, и Fyne прячет разницу за логическими координатами, о которых ниже отдельный раздел. Наконец, поведение: десктопный пользователь ожидает, что крестик спросит про несохранённые данные, что свернутое приложение найдётся в трее и что файл можно бросить прямо в окно. Всё это — обычные вызовы API, без единой платформенной ветки по операционной системе в твоём коде: различия Fyne берёт на себя. Сначала разберём самый драматичный момент жизни окна — его закрытие.

Окно создаётся вызовом myApp.NewWindow(title) — первое созданное окно становится мастер-окном: его закрытие завершает приложение, если не сказано иное. Размер задаётся window.Resize(fyne.NewSize(w, h)) в логических пикселях, позиция — window.CenterOnScreen(), который ставит окно в центр того монитора, на котором оно сейчас. Дальше три переключателя поведения: SetFixedSize(true) запрещает пользователю тянуть рамку — режим для палитр и маленьких утилит с жёсткой сеткой; SetFullScreen(true) разворачивает окно без рамок на весь экран — просмотрщики и киоски; SetPadded(false) убирает внутренний отступ между содержимым и краями окна, что полезно для графики из седьмого урока, прижатой к границам. Важно понимать, что Resize — это запрос: оконный менеджер вправе скорректировать размер по своим минимумам, поэтому не строй логику на точном равенстве, а фактический размер содержимого читай из window.Canvas().Size(). Ещё два полезных жеста: window.RequestFocus() поднимает окно и передаёт ему фокус — вызывай его, когда приложение нашло что-то по поиску или получило внешнее событие, но помни, что без причины крадущий фокус раздражает. И window.SetIcon(fyne.Resource) — иконка окна и панели задач, ресурсом из шестнадцатого урока. Все эти вызовы — hints, подсказки системе, а не приказы: десктоп уважает волю пользователя сильнее желания программы.

Трей — маленькая иконка в системной панели рядом с часами, по клику показывающая меню. Для свернутых в фон утилит это второй дом: окно можно закрыть, а приложение продолжит жить и примет команду из трея. В Fyne трей включается через расширенный интерфейс приложения: приведение myApp.(desktop.App) даёт два метода — SetSystemTrayMenu(menu *fyne.Menu) и SetSystemTrayIcon(icon fyne.Resource). Меню строится знакомым по четырнадцатому уроку конструктором: fyne.NewMenu(«имя», элементы...) и fyne.NewMenuItem(«подпись», функция). Типичный состав — «Показать окно» с window.Show() и RequestFocus, переключатель действия и «Выход» с myApp.Quit(). Есть тонкость жизненного цикла: если окно закрыто, но назначено меню трея, приложение не завершится при закрытии последнего окна — выйти из него можно через Quit из меню трея; без трея закрытие единственного окна означает конец. Иконка трея назначается ресурсом из шестнадцатого урока: если её не ставить, платформа покажет значок приложения по умолчанию. Два правила гигиены: держи в трей-меню три-пять пунктов, не превращай его в второе главное меню, и всегда оставляй путь к выходу — пользователь должен иметь возможность завершить процесс, не открывая диспетчер задач. Для случаев, когда трей нужен глубже — всплывающие уведомления из иконки, динамическая иконка-индикатор, — есть отдельный пакет github.com/fyne-io/systray, но в девяти случаях из десяти хватает встроенных двух методов.

На десктопе экраны бывают 96 точек на дюйм, а бывают и 200 с лишним, и Fyne прячет эту разницу за двумя системами координат. Логические пиксели — то, чем ты оперируешь везде: в Resize, в NewSize, в координатах canvas из седьмого урока. Физические пиксели — то, что реально светится на матрице. Связывает их коэффициент window.Canvas().Scale(): при Scale 2.0 логическое окно 300 на 200 занимает 600 на 400 физических точек. Шрифты и виджеты, построенные на темах из пятнадцатого урока, масштабируются сами — тебе же коэффициент нужен, когда дело доходит до растровых картинок: изображение, нарисованное в один логический пиксель, на плотном экране замылится, так что бери исходники в двойном размере и храни в ресурсах. Практические правила: не хардкодь предположений о размере монитора — окно 1200 на 800 не влезет на маленький ноутбук, поэтому стартуй со скромного Resize и дай пользователю растянуть; фактический размер контента читай из Canvas().Size(), а не из того, что просил; геометрию при выходе запоминай в preferences из девятнадцатого урока и восстанавливай при старте — это один из самых ценимых мелких сервисов. Позицию и размер каждого монитора сам тулкит не раскрывает: если нужны перечисления дисплеев, это территория внешних пакетов, но для 95 процентов приложений достаточно центрирования и сохранённой геометрии. Помни и про минимальные размеры: слишком узкое окно ломает раскладки из четвёртого урока — задай нижнюю границу в SetFixedSize либо проверяй при Resize.

Три механизма делают приложение своим для операционной системы. Буфер обмена: с версии 2.6 он живёт на приложении — myApp.Clipboard() возвращает объект с Content() для чтения и SetContent(string) для записи; одноимённый метод окна объявлен устаревшим, так что новый код пиши через приложение. Вставка картинки в редактор, копирование ссылки, обмен задачами между окнами — всё это одна строка, без внешних пакетов. Drag-and-drop: window.SetOnDropped(func(pos fyne.Position, uris []fyne.URI)) — пользователь бросает файлы из проводника прямо в окно, колбэк получает позицию падения и срез URI; имя файла достаётся uris[i].Name(), а читается содержимое хранилищем из двадцать первого урока. Это самый короткий путь «открыть документ»: поддержка перетаскивания экономит пользователю обход диалога выбора. Нативные меню: SetMainMenu из четырнадцатого урока на разных столах рендерится по-разному — на Windows и Linux это строка внутри окна, на macOS пункты уходят в системную строку сверху экрана, как у родных приложений; твой код при этом не меняется ни на символ. Отдельная десктопная вежливость — горячие клавиши: пользователь стола ждёт Ctrl+C и Ctrl+V везде, где есть текст, и Ctrl+S в редакторе; базовые привязки Fyne делает сам, а свои добавляются через AddShortcut из шестого урока с desktop.CustomShortcut. Собирая всё вместе, ты получаешь приложение, которое ОС считает своим: оно в трее, в буфере обмена, в строке меню и в системе перетаскивания.

Соберём чек-лист десктопного приличия из уже пройденного. Геометрия: при закрытии — в перехватчике или SetOnClosed — пишешь ширину, высоту и позицию в preferences девятнадцатого урока; при старте читаешь с WithFallback и применяешь до ShowAndRun, чтобы первый кадр уже был правильным, без прыжка «сначала центр, потом куда-то влево». Выход: если в данных есть несохранённое — флаг dirty, который ставят обработчики из шестого урока, — перехватчик показывает диалог из тринадцатого урока с тремя исходами: сохранить и выйти, выйти без сохранения, остаться. Трей: сворачиваемая в панель утилита получает меню из двух-трёх пунктов и иконку-упрощение; окно при этом можно закрыть совсем — агент живёт в трее. Файлы: SetOnDropped открывает документ броском, а буфер обмена через myApp.Clipboard() даёт обмен текстом с другими программами. Горячие клавиши: Ctrl+S на сохранение и Ctrl+Q на выход через AddShortcut — десктопный пользователь проверит их в первую минуту. Каждая строка этого чек-листа — два-пятнадцать строк кода, но именно они отличают инструмент, которым пользуются год, от поделки, которую закрывают в первый день. Прогони свой проект из двадцать пятого урока по списку — и он будет выглядеть родным на любом столе.

Теперь приложение ведёт себя как нативное для стола: спрашивает перед выходом, помнит геометрию, живёт в трее, принимает файлы перетаскиванием и разговаривает с буфером обмена. Опора урока — второй урок с каркасом запуска, тринадцатый с диалогом подтверждения, четырнадцатый с меню и тулбаром, девятнадцатый с хранением геометрии и шестнадцатый с иконками. Следующая тема — тестирование: как проверить, что кнопка действительно меняет состояние и что виджет рендерится так, как задуман, не открывая ни одного окна, и почему после этого урока регрессии в интерфейсе перестанут быть сюрпризом. Полный маршрут — на странице курса Fyne.