Table of Contents

Установка

Требования

  • .NET 10 SDK. IcyUI нацелена на net10.0, поэтому проект игры тоже должен нацеливаться на net10.0 (или net10.0-windows).
  • Windows, x64 или ARM64.
  • Движок: Stride 4.4 или новее либо MonoGame 3.8.5.1 или новее.
Важно

Новые проекты из шаблонов MonoGame нацелены на более старую версию .NET. Прежде чем добавлять IcyUI, измените <TargetFramework> на net10.0 в файле проекта игры, иначе NuGet откажется ставить пакет (ошибка NU1202); где именно — показано на странице MonoGame. Проекты Stride 4.4 уже нацелены на .NET 10.

Пакеты

Пакет Что это Когда нужен
IcyUI.Stride Интеграция со Stride: отрисовка, ввод, ресурсы. Игра на Stride.
IcyUI.MonoGame Интеграция с MonoGame: отрисовка, ввод, ресурсы. Игра на MonoGame.
IcyUI Независимое от движка ядро: элементы управления, компоновка, разметка, привязка. Ставится автоматически вместе с пакетом движка.
IcyUI.Design Документ разметки, горячая перезагрузка и внутриигровой редактор. Только для инструментов разработки; выпущенной игре не нужен.

Пока IcyUI в альфа-версии, все пакеты — предварительные выпуски, поэтому добавляйте --prerelease:

dotnet add package IcyUI.Stride --prerelease

MonoGame: бэкенд выбираете вы

IcyUI.MonoGame не зависит от конкретного бэкенда MonoGame. Игра сама ссылается на один из них — так и происходит, если проект создан из шаблона MonoGame:

  • MonoGame.Framework.DesktopGL (OpenGL),
  • MonoGame.Framework.WindowsDX (Direct3D 11).

Используйте версию 3.8.5.1 или новее. Со старым MonoGame игра запустится, но при первом обращении к IcyUI упадёт с FileLoadException.

Далее