Сборка: десктоп, мобильные, WASM

Десктоп — самый короткий маршрут: команда go build собирает исполняемый файл текущей платформы, и игре больше ничего не нужно. Кросс-сборка задаётся переменными GOOS и GOARCH: с Linux-машины собирается exe для Windows, с Mac — бинарник для Linux, и C-тулчейн для этого не нужен, потому что на Windows и macOS движку не требуются C-зависимости. Исключение по окружению — Linux: перед первой сборкой понадобятся dev-пакеты OpenGL и X11, вроде libgl1-mesa-dev и libx11-dev, — это заголовки для компиляции, а не то, что должен ставить игрок: раздавать можно уже собранный файл. Под капотом Ebitengine сама выбирает графическую библиотеку: DirectX на Windows, Metal на macOS и iOS, OpenGL или WebGL в остальных случаях; выбор можно форсировать переменной EBITENGINE_GRAPHICS_LIBRARY, если конкретный драйвер ведёт себя странно. Проверка десктопного маршрута честная: собранный файл стоит запустить на чистой машине или у друга — ничего, кроме бинарника, с собой тащить не нужно. Подводный камень macOS — архитектура: Intel и Apple Silicon это разные значения GOARCH, и релиз собирается в двух экземплярах. WASM игры Go собираются той же парой переменных, о ней ниже.

Мобильные цели собираются через gomobile — официальный инструмент Go для Android и iOS. Установка короткая: go install golang.org/x/mobile/cmd/gomobile@latest, затем gomobile init. Дальше два маршрута. gomobile build упаковывает игру целиком: APK для Android или бандл для iOS — быстрый путь для теста на телефоне и раздачи вне магазинов. gomobile bind собирает библиотеку — aar для Android или xcframework для iOS, — которую встраивают в нативный проект; это путь для релиза в магазинах, где нативный код ведёт рекламу, покупки и экраны публикации. Инфраструктура тяжёлая, но ставится один раз: JDK и Android SDK, Xcode для iOS. Обе утилиты работают поверх обычного кода: пакеты, тесты и структура из прошлого урока не меняются ни на строчку. Особенность исполнения: RunGame обязан стартовать на главном потоке интерфейса, и на мобильных цикл ведёт обвязка пакета ebiten/v2/mobile — ваши Update и Draw вызываются как обычно, просто их запуск устроен хитрее. Проверяйте управление на телефоне заранее: тач-ввод — единственный ввод платформы, и клавиатурные схемы на нём мертвы. Отдельно держите в уме запуск с телефона: подключите устройство, соберите пакет и посмотрите на реальную частоту кадров — жесты и размеры экрана сбивают предположения, сделанные за десктопом.

Браузерная версия собирается компилятором Go в WebAssembly: GOOS=js GOARCH=wasm go build — и на выходе файл game.wasm. Открыть его двойным щелчком нельзя: модулю нужна HTML-страница и обвязка wasm_exec.js из каталога GOROOT/lib/wasm, которая соединяет код с браузерным API. Страница тривиальная: канвас, тег script с обвязкой и десяток строк вызова — она пишется один раз и живёт во всех проектах курса без изменений. Дальше — веб-сервер, и здесь главный подводный камень маршрута: game.wasm обязан отдаваться с Content-Type application/wasm. С текстовым MIME браузер откажется инстанцировать модуль, и игра не запустится, хотя файлы лежат правильно и пути не битые. Браузеру нужен WebGL 2, а WASM-бинарник весит несколько мегабайт: рантайм Go и движок едут вместе с игрой. Это лечится сжатием на сервере — gzip или brotli ужимает модуль в разы, и после распаковки игрок ждёт секунды, а не минуты. Размер проверяется локально одним взглядом на файл: если модуль растёт с каждым релизом, посмотрите, что нового появилось в вшитых ассетах. Зато обновление игры — перезагрузка страницы: никакой установки, согласований и подписей, поэтому браузерная версия становится витриной проекта раньше всех остальных сборок.

Ассеты — тихая причина сломанной сборки. Пока разработка идёт в папке проекта, чтение файлов с диска работает; но собранный бинарник запускают не из исходников, и папка sprites может остаться дома. Решение — директива //go:embed: компилятор вшивает файлы в бинарник, и они доступны через embed.FS в любом месте кода. Ассетам отводится пакет internal/assets из прошлого урока: там объявляется переменная FS с перечислением папок, и весь остальной код берёт ресурсы только через неё. Выигрыш не только в удобстве: эмбед работает одинаково на десктопе, в мобильном бандле и в WASM-модуле, потому что байты лежат внутри исполняемого файла, а не рядом с ним. Спрайты из урока про спрайты и звуки из урока про звук читаются из FS без изменений игрового кода. Важно правило одного источника: чтение с диска в пакете с эмбедом смешивать нельзя — иначе половина ассетов поедет в бинарнике, а половина останется дома, и упадёт только собранная версия. Ограничение одно: паттерн не может выходить за каталог пакета — папки обязаны лежать внутри internal/assets, что естественно совпадает со скелетом проекта. Плата — размер: вшитые ресурсы увеличивают бинарник на своих мегабайт, и для WASM это надо помнить при выборе набора файлов.

У каждой цели есть потолок, о котором лучше узнать до релиза, а не после. WASM: мегабайтный бинарник, требование WebGL 2 и медленный первый запуск без сжатия на сервере. Android и iOS: тяжёлая инфраструктура SDK, подписи, и маленькая ловушка звука — на iOS аудио оживает после первого касания, политика автовоспроизведения запрещает играть звук без жеста пользователя, поэтому стартовый экран, где игрок тапает «начать», полезен и для запуска аудиоконтекста. Десктоп: раздача без установщика требует, чтобы бинарнику ничего не понадобилось рядом, — ещё один аргумент за эмбед. Всё это собирает CI-матрица: джоба перебирает пары GOOS и GOARCH, для мобильных гоняет gomobile, для браузера — сборку с обвязкой, и каждая сборка хотя бы запускается на смоук-тест. Достаточный минимум для игр курса — три джобы: десктоп текущей платформы, веб и один мобильный билд; остальное подключается по мере роста проекта. Кэш модулей делает матрицу быстрой, артефакты складываются в релиз одной кнопкой. Полезное правило матрицы: каждая джоба воспроизводима локально — любая строка CI должна запускаться с вашей машины той же командой, иначе отладка красной сборки превращается в угадывание. Итоговый проект курса публикуется именно так — одним пушем, четырьмя артефактами, без ручных повторов. Отдельный плюс матрицы — история: артефакт прошлой сборки остаётся доступным, и regression можно отличить от поломки окружения.