Быстрый старт
SUS — набор Unity-пакетов. Начните с бесплатных Core + Router, затем добавьте Kit / Game, когда понадобится библиотека компонентов.
Требования
- Unity 6000.3+ (UI Toolkit)
- Git (для UPM git-зависимостей)
Установка бесплатных пакетов (git UPM)
В Packages/manifest.json вашего Unity-проекта:
json
{
"dependencies": {
"com.sharq-it.sus.core": "https://github.com/antaresdk/sus-core.git#v1.0.29",
"com.sharq-it.sus.router": "https://github.com/antaresdk/sus-router.git#v1.0.16"
}
}Для воспроизводимых установок лучше тег релиза;
#mainследит за tip.
Первый экран
- Предпочтительно
Window → SUS → Setup Project— создаётsus.config.jsonи копирует готовый starter (HomeScreen.sharq+ уже сгенерированныйGenerated/HomeScreen.g.cs+ entrySusApp). Первая генерация не нужна — компилируется сразу (без chicken-and-egg). - Или полный гайд по интеграции (точка входа, overlay vs world-space, порядок генерации).
- Без сгенерированных
.g.csкод, который делаетMountэкрана, не скомпилируется — а сломанный domain может помешать Sharq перегенерировать себя. Подробности в секции Critical того гайда.
Минимальный .sharq (App.sharq — тип, на который ссылается Mount<App>() ниже):
xml
<!-- App.sharq -->
<template>
<ui:Label $MainElement :text="Message" class="greeting" />
</template>
<script>
public string Message = "Hello SUS!";
</script>
<style>
.greeting {
font-size: 24px;
color: white;
-unity-text-align: middle-center;
}
</style>Вёрстка и внешний вид — в
<style>(USS). Предпочитайте классы вместо C#element.style.*. Подробнее: формат .sharq · полный гайд.
csharp
public class AppEntry : MonoBehaviour
{
public UIDocument uiDocument;
void Start() =>
Sharq.Core.SusApp.Create(uiDocument)
.UseTheme(SusTheme.Dark)
.Mount<App>(); // creates OverlayHost + world panel
}Дальше
| Тема | Ссылка |
|---|---|
| Что такое SUS? | Обзор |
Подсветка .sharq в VS Code | Настройка редактора |
| Полный гайд core | Guide |
.sharq + <style> | Формат · CSS scoping |
| Реактивность | Prop / Computed / Watch |
| Router | Документация Router |
| Компоненты | Каталог |
| Цены | Kit & Game |