379 строк · 32 КиБ
packaging/README.md
| 1 | # Как Chimera-Launcher попадает на машину |
| 2 | |
| 3 | Два способа, и они для разных людей. |
| 4 | |
| 5 | | | для кого | что делает | |
| 6 | |---|---|---| |
| 7 | | `packaging/install.sh` | разработчик | собирает из исходников `cargo build --release` и раскладывает в `~/.local`. Берёт системные GTK, WebKitGTK, glibc. Быстро, но работает только там, где эти версии достаточно свежие. | |
| 8 | | `packaging/build-installer.sh` | всем остальным | собирает **один файл** `chimera-launcher-<версия>.run` (~130 МиБ). Человек скачивает его, запускает, видит графический мастер установки. Ничего доустанавливать не надо. | |
| 9 | |
| 10 | `install.sh` никуда не денется: разработчику незачем гонять контейнер на |
| 11 | каждую правку. |
| 12 | |
| 13 | --- |
| 14 | |
| 15 | ## 1. Что программе на самом деле нужно от системы |
| 16 | |
| 17 | Обещание «скачал и всё работает, никаких зависимостей» имеет смысл |
| 18 | только если известно, где у него граница. Вот она — по факту, а не по |
| 19 | предположению. |
| 20 | |
| 21 | ### 1.1. Обязано быть на хосте, привезти нельзя |
| 22 | |
| 23 | | Что | Почему нельзя привезти | Проверено | |
| 24 | |---|---|---| |
| 25 | | Ядро Linux | оно одно на машину | — | |
| 26 | | **Драйверы видеокарты**: `libGL.so.1`, `libGLX.so.0`, `libOpenGL.so.0`, `libEGL.so.1`, `libGLESv2.so.2`, `libgbm.so.1`, `libdrm.so.2` | драйвер должен совпадать с ядром и железом. Своя копия не нашла бы ни DRI-драйвера, ни прошивки | Debian 12/13, Ubuntu 24.04, Fedora 41/43 — контейнер без них не запускает окно | |
| 27 | | **Загрузчик Vulkan**: `libvulkan.so.1` + ICD-описания в `/usr/share/vulkan/icd.d` | то же, и вдвойне: DXVK и VKD3D **в процессе игры** обязаны видеть ICD хоста. Своя libvulkan в комплекте сломала бы не лаунчер, а все игры | `ldd` в контейнере: `libvulkan.so.1 => /lib/x86_64-linux-gnu/libvulkan.so.1` | |
| 28 | | **Библиотеки протокола Wayland**: `libwayland-client.so.0` (**не старше 1.22**), `-cursor`, `-egl`, `-server` | их подгружает Mesa хоста; своя копия рядом с чужой Mesa даёт `eglGetDisplay → EGL_BAD_PARAMETER` и падение веб-процесса (tauri-apps/tauri#15665 — тот же GTK4 + WebKitGTK, тот же способ упаковки) | контейнер без них: `error while loading shared libraries: libwayland-egl.so.1`. Минимум версии проверен опытом: см. 1.1а | |
| 29 | | `libva.so.2`, `libva-drm`, `libva-x11` | аппаратное декодирование видео — часть драйвера | — | |
| 30 | | `tar` и `xz` | ими установщик распаковывает себя | есть в базовой системе Debian, Ubuntu, Fedora, Arch, SteamOS | |
| 31 | | `cp` | мгновенные снимки префиксов через reflink (`chl_wine::snapshot`) | `chl doctor` помечает как обязательный | |
| 32 | | `/run/user/<uid>` (создаёт logind) | через короткую ссылку в нём WebKitGTK находит свои процессы (см. ниже) | `chl doctor`, раздел «Как поставлена программа» | |
| 33 | | Хоть один шрифт с кириллицей | не обязано: DejaVu едет в комплекте как подстраховка | | |
| 34 | |
| 35 | ### 1.1а. Единственная версия, которую комплект действительно требует: libwayland-client ≥ 1.22 |
| 36 | |
| 37 | Найдено прогоном по дистрибутивам 2026-09-07 и доказано подменой одной |
| 38 | библиотеки. На Debian 12 (libwayland 1.21) окно не появляется вовсе: |
| 39 | GTK получает от композитора протокольную ошибку и печатает |
| 40 | `Error 0 (Success) dispatching to Wayland display` — больше ничего, ни |
| 41 | имени библиотеки, ни намёка. Ни драйверы, ни Vulkan, ни GL тут не при |
| 42 | чём: с `GSK_RENDERER=cairo GDK_DISABLE=vulkan,gl`, то есть вообще без |
| 43 | GPU, поведение то же. |
| 44 | |
| 45 | Доказательство: в том же контейнере Debian 12 хостовая |
| 46 | `libwayland-client.so.0.26.0` подставлена через `LD_PRELOAD`, остальное |
| 47 | не менялось — окно нарисовалось и сняло себя скриншотом. Механизм: |
| 48 | метаданные интерфейсов Wayland (`wl_surface` версии 6 и остальные) |
| 49 | лежат внутри самой `libwayland-client`, GTK 4.22 просит версии, которых |
| 50 | в 1.21 нет. |
| 51 | |
| 52 | Привезти свою копию нельзя по той же причине, что и всю строку про |
| 53 | Wayland в таблице выше: её грузит Mesa хоста, и две копии в одном |
| 54 | процессе ломают EGL. |
| 55 | |
| 56 | Версии по дистрибутивам (проверено в образах): Debian 12 — 1.21 (**не |
| 57 | пойдёт**), Ubuntu 24.04 — 1.22, Debian 13 — 1.23, Fedora 41 — 1.24, |
| 58 | Fedora 43 — 1.25. Под сеансом X11 (`GDK_BACKEND=x11`) эта библиотека не |
| 59 | нужна вовсе. |
| 60 | |
| 61 | Молча это больше не сломается: `relocate.sh` предупреждает при |
| 62 | установке, `chl doctor` показывает отдельной проверкой в разделе «Как |
| 63 | поставлена программа». |
| 64 | |
| 65 | ### 1.2. Обязано быть на хосте, но только для отдельных возможностей |
| 66 | |
| 67 | Всё это `chl doctor` показывает предупреждением, а не проблемой, и |
| 68 | называет команду установки под конкретный дистрибутив. |
| 69 | |
| 70 | | Что | Без чего останешься | |
| 71 | |---|---| |
| 72 | | `bwrap` + `xdg-dbus-proxy` | песочница веб-процесса встроенного браузера. **Не мелочь**: в этом браузере вводят пароль от Epic и GOG. WebKitGTK 6.0 не даёт отключить песочницу из кода (`webkit_web_context_set_sandbox_enabled` убрали из API) и запускает **вкомпилированные** `/usr/bin/bwrap` и `/usr/bin/xdg-dbus-proxy`. Подменить эти пути в комплекте нечем: строка в библиотеке 14 и 23 байта, каталог установки в них не влезет, а вести системный путь запуска песочницы через `/tmp` нельзя — подменив там ссылку, чужой процесс подсунул бы свой веб-процесс. Поэтому: есть на хосте — песочница работает; нет — лаунчер выставляет `WEBKIT_DISABLE_SANDBOX_THIS_IS_DANGEROUS` и **говорит об этом** в диагностике | |
| 73 | | `secret-tool` (libsecret) | токены Epic и GOG не сохранятся между запусками | |
| 74 | | `unzip` | распаковка нативных Linux-установщиков GOG | |
| 75 | | `gamemoderun` | повышение приоритета игры | |
| 76 | | `mangohud`, `vkbasalt` | оверлей и постобработка. Привезти нельзя: это слои Vulkan, а не программы, и vkBasalt вообще не публикует собранных бинарников (проверено по релизам `DadSchoorse/vkBasalt`) | |
| 77 | | `winetricks` | `chl tool winetricks` | |
| 78 | | `xdg-open` или `steam` | открытие ссылок `steam://` | |
| 79 | | 32-битный GStreamer (`/usr/lib32/gstreamer-1.0`) | видеовставки в 32-битных играх. Комплект 64-битный целиком; привезти 32-битную половину стека — отдельная работа | |
| 80 | | Модуль ядра `ntsync` | быстрейшая синхронизация Wine. Есть `fsync` (`futex_waitv`) как замена | |
| 81 | |
| 82 | ### 1.3. Что везёт с собой комплект |
| 83 | |
| 84 | 278 библиотек, 494 МиБ до сжатия. Всё, что ниже, на машине человека |
| 85 | **не нужно** — и не проверяется, и не ставится: |
| 86 | |
| 87 | - **glibc 2.44 и её загрузчик** `ld-linux-x86-64.so.2`; |
| 88 | - **GTK 4.22**, **libadwaita 1.9**; |
| 89 | - **WebKitGTK 6.0** (2.52) — библиотека, три вспомогательных процесса |
| 90 | (`WebKitWebProcess`, `WebKitNetworkProcess`, `WebKitGPUProcess`), |
| 91 | `injected-bundle`, JavaScriptCore, **libsoup 3** (версия libsoup обязана |
| 92 | совпадать с версией WebKit — на расхождении получается пустое окно без |
| 93 | ошибок, см. gitbutlerapp/gitbutler#12885); |
| 94 | - **GStreamer 1.28** с плагинами (base/good/libav) и процессом-сканером; |
| 95 | - gdk-pixbuf, **glycin** и четыре его процесса-загрузчика картинок; |
| 96 | - pango, cairo, harfbuzz, freetype, **fontconfig** со своим конфигом, |
| 97 | ICU, libxml2, sqlite, OpenSSL, GnuTLS; |
| 98 | - libmanette, libevdev, libhidapi, libudev — геймпады; |
| 99 | - X11/XCB; |
| 100 | - **данные**: схемы GSettings, тема значков Adwaita, `xkeyboard-config`, |
| 101 | модули iconv (gconv), локали `ru_RU.UTF-8` и `en_US.UTF-8`, переводы |
| 102 | GTK и libadwaita на русский, `shared-mime-info`, шрифты DejaVu и |
| 103 | Cantarell; |
| 104 | - `patchelf`, `gdk-pixbuf-query-loaders`, `gio-querymodules` — они нужны |
| 105 | **в момент установки** на машине человека, см. `relocate.sh`. |
| 106 | |
| 107 | TLS-сертификаты хоста тоже не нужны: `ureq` собран с встроенными |
| 108 | `webpki-roots`. Единственное исключение — `chl-compat`, который ходит в |
| 109 | личный кластер владельца и читает системное хранилище доверия. |
| 110 | |
| 111 | ### 1.4. Что лаунчер скачивает сам (это не зависимости системы) |
| 112 | |
| 113 | | Что | Откуда | Целостность | Когда | |
| 114 | |---|---|---|---| |
| 115 | | `legendary` (Epic) | GitHub `legendary-gl/legendary` | SHA-256 из поля `digest` самого GitHub | по кнопке / `chl epic ensure-legendary` | |
| 116 | | `innoextract` (GOG) | GitHub `dscharrer/innoextract` | отсоединённая подпись OpenPGP автора | по кнопке / `chl gog ensure-innoextract` | |
| 117 | | Сборки Wine и Proton | ссылки из локального `wine_version.json` StartWine (Kron4ek, GloriousEggroll) | **обычно никакой** — см. дыру в 1.5 | `chl wine install` | |
| 118 | | `SteamSetup.exe` | зеркала Valve | никакой | `chl steam windows` | |
| 119 | | Манифест ludusavi, обложки, база знаний | GitHub raw, Steam CDN, GOG, Википедия, Fandom | никакой (только TLS) | автоматически | |
| 120 | |
| 121 | ### 1.5. Что мы до сих пор **предполагаем**, а предполагать не должны |
| 122 | |
| 123 | Это самое важное в этом разделе, и это не про установщик, а про то, чего |
| 124 | установщику не хватает, чтобы обещание выполнялось целиком. |
| 125 | |
| 126 | 1. **Каталог данных StartWine.** Сборки Wine, DXVK, VKD3D, шаблоны |
| 127 | префиксов и сам список доступных сборок (`wine_version.json`) лаунчер |
| 128 | берёт из `~/Games/Chimera/data` (ADR-001). На чистой машине этого |
| 129 | каталога нет — и `chl doctor` честно говорит: **«Установка StartWine |
| 130 | не найдена — запускать игры пока нечем»**. То есть из чистой системы |
| 131 | ставится и запускается сам лаунчер, работают библиотека, магазины, |
| 132 | база знаний, диагностика и внешний вид, а **запуск игры — нет**. |
| 133 | Мастер установки на последнем экране говорит это прямым текстом, а не |
| 134 | «программа готова к работе». |
| 135 | Чтобы закрыть дыру, нужен свой каталог сборок и своё скачивание |
| 136 | DXVK/VKD3D — это фаза 2 плана, отдельная работа. |
| 137 | 2. **`chl-wine/keys/wine-manifest.pub` — пустой файл (0 байт).** Значит, |
| 138 | проверка подписанного манифеста сборок Wine не может пройти никогда, и |
| 139 | каждая установка сборки идёт непроверенной (кроме двух с зашитыми |
| 140 | SHA-256). Ключ надо сгенерировать и положить. |
| 141 | 3. **glibc комплекта не должна быть старше системной.** Направление |
| 142 | совместимости работает только в одну сторону: наша новая glibc умеет |
| 143 | всё, что умела старая, поэтому библиотеки хоста (Mesa) внутри нашего |
| 144 | процесса работают. Наоборот — нет. Комплект собирается на Arch, то |
| 145 | есть с самой свежей glibc, и `relocate.sh` сверяет версии и |
| 146 | предупреждает, если хост оказался новее; `chl doctor` показывает это |
| 147 | отдельной проверкой. Но гарантии тут нет — есть проверка. |
| 148 | |
| 149 | --- |
| 150 | |
| 151 | ## 2. Почему установщик — самораспаковывающийся `.run`, а не AppImage и не Flatpak |
| 152 | |
| 153 | Взвешивались четыре варианта. |
| 154 | |
| 155 | **AppImage** архитектурно — то же самое, что здесь: полезная нагрузка |
| 156 | плюс скрипт-запускала. Отброшен по двум причинам. Первая: AppImage — это |
| 157 | «программа, которую не ставят», а просьба была ровно про установщик, |
| 158 | который спрашивает, куда поставить, и делает ярлыки; подделывать одно |
| 159 | другим значило бы всё равно писать мастер, но ещё и объяснять человеку, |
| 160 | почему установленная программа — это тот файл, который он скачал. |
| 161 | Вторая: AppImage второго типа монтирует себя через FUSE. Статически |
| 162 | собранный runtime избавил от библиотеки `libfuse2`, но не от |
| 163 | setuid-помощника `fusermount`, а в SteamOS лежит открытая заявка Valve на |
| 164 | выпиливание fuse2 целиком (ValveSoftware/SteamOS#2391, ответа нет). |
| 165 | Штатный обходной путь `--appimage-extract-and-run` — это в точности то, |
| 166 | что делает наш заголовок, только без зависимости от FUSE вообще. |
| 167 | |
| 168 | **Flatpak** решил бы самую трудную часть этой работы: готовые GTK 4 и |
| 169 | WebKitGTK 6.0 с рабочей песочницей, совпадающий libsoup3, схемы, локали. |
| 170 | И сломал бы главную. Лаунчер обязан запускать произвольные |
| 171 | Windows-программы из произвольных каталогов, видеть `/dev/input`, слои |
| 172 | Vulkan хоста (MangoHud, vkBasalt) и `~/.local/share/Steam`, чтобы |
| 173 | дописать туда `shortcuts.vdf`. Конец этого пути известен по |
| 174 | Flatpak-версиям Lutris и Bottles: `--filesystem=host --device=all` плюс |
| 175 | дыра `org.freedesktop.Flatpak` для запуска чего-либо на хосте — то есть |
| 176 | песочница без стен, зато с обязательным Flatseal для каждой новой папки с |
| 177 | играми. Плюс это не «один файл, который ты запускаешь». |
| 178 | |
| 179 | **Сборка пакетов под каждый дистрибутив** — не рассматривалась серьёзно: |
| 180 | это пять сборочных конвейеров и репозиторий вместо одного файла. |
| 181 | |
| 182 | **Самораспаковывающийся `.run`** — то, что осталось, и оно подходит по |
| 183 | всем пунктам: один файл, никакого FUSE, никакого root, распаковка в |
| 184 | каталог, который выбрал человек, и мастер на том же GTK4, что и сам |
| 185 | лаунчер, так что первое окно программы выглядит как программа. Приём |
| 186 | живой: так устроены `.run`-установщики драйверов NVIDIA (собраны |
| 187 | makeself), и makeself поддерживается GoReleaser'ом. |
| 188 | |
| 189 | Оговорка, которую надо знать: **готового решения «GTK4 + WebKitGTK 6.0 в |
| 190 | переносимом комплекте» не существует**. `linuxdeploy-plugin-gtk` — только |
| 191 | для GTK3, Tauri работает с webkit2gtk-4.1 (это GTK3), а поддержка |
| 192 | GTK4/WebKitGTK 6.0 в Wails появилась в 2026 году и про упаковку там не |
| 193 | сказано ничего. Всё, что описано ниже, собрано здесь впервые, и именно |
| 194 | поэтому проверок в сборке столько. |
| 195 | |
| 196 | --- |
| 197 | |
| 198 | ## 3. Как это устроено |
| 199 | |
| 200 | ``` |
| 201 | chimera-launcher-0.1.0.run |
| 202 | ├── заголовок (bundle/header.sh) обычный /bin/sh |
| 203 | └── payload.tar.xz дописан к нему байтами |
| 204 | ``` |
| 205 | |
| 206 | Заголовок: находит каталог, где можно и записать, и **запустить** файл |
| 207 | (проверяется делом: создать, `chmod +x`, запустить — `/tmp` с `noexec` |
| 208 | это классическая причина, по которой не запускаются AppImage), распаковывает |
| 209 | туда комплект, зовёт `relocate.sh`, запускает |
| 210 | `bin/chimera-launcher --setup-payload <каталог>` и после выхода мастера |
| 211 | всё за собой убирает. |
| 212 | |
| 213 | Режимы: без аргументов — мастер; `--cli <аргументы chl setup>` — |
| 214 | установка без графики (ssh, консоль, игровой режим Steam Deck); |
| 215 | `--extract <каталог>` — только распаковать; `--tmpdir` — где |
| 216 | распаковываться; `--help`. |
| 217 | |
| 218 | ### Комплект |
| 219 | |
| 220 | ``` |
| 221 | <каталог установки>/ |
| 222 | ├── .chimera-bundle метка: по ней chl_core::portable понимает, что мы в комплекте |
| 223 | ├── bin/ chimera-launcher, chl, patchelf, *-query-* |
| 224 | ├── lib/ 278 библиотек плоско + gconv/ locale/ gio/ gstreamer-1.0/ gdk-pixbuf-2.0/ |
| 225 | ├── libexec/ процессы WebKitGTK, загрузчики glycin, сканер GStreamer |
| 226 | ├── share/ схемы GSettings, значки, шрифты, xkb, mime, переводы |
| 227 | └── relocate.sh привязка к каталогу |
| 228 | ``` |
| 229 | |
| 230 | **Пути к библиотекам — в RUNPATH через `$ORIGIN`, а не в |
| 231 | `LD_LIBRARY_PATH`.** Это не стилистика: |
| 232 | `chl_wine::prefix::PASS_THROUGH` намеренно пропускает `LD_LIBRARY_PATH` в |
| 233 | окружение Wine (там она нужна драйверам), и наш `lib/` в этой переменной |
| 234 | означал бы, что игра и Wine грузят библиотеки лаунчера вместо системных. |
| 235 | RUNPATH виден только нашим файлам и никуда не наследуется. |
| 236 | |
| 237 | **Переменные для данных** (схемы GSettings, кэш загрузчиков, модули GIO, |
| 238 | плагины GStreamer, iconv, локали, xkb, fontconfig) выставляются в самом |
| 239 | начале `main` — `chl_core::portable::activate`, там у каждой написано, |
| 240 | что сломается без неё. В окружение игры они не попадают: `Prefix::command` |
| 241 | собирает его белым списком через `env_clear()`. |
| 242 | |
| 243 | ### Что делает `relocate.sh` и почему без него нельзя |
| 244 | |
| 245 | Три вещи в комплекте знают абсолютные пути, и узнать их при сборке |
| 246 | нельзя — каталог выбирает человек: |
| 247 | |
| 248 | 1. **PT_INTERP исполняемых файлов.** Комплект везёт свою glibc, а поле |
| 249 | «каким загрузчиком меня запускать» в ELF обязано быть абсолютным |
| 250 | путём: ни `$ORIGIN`, ни относительных путей формат тут не допускает. |
| 251 | Библиотекам это не нужно, а вот вспомогательные процессы |
| 252 | (WebKitWebProcess и компания, загрузчики glycin) запускает библиотека, |
| 253 | по абсолютному пути и без всякого окружения. С PT_INTERP хоста |
| 254 | получилось бы: загрузчик Debian 12 (glibc 2.36) грузит нашу |
| 255 | `libc.so.6` (2.44) и падает на `version GLIBC_PRIVATE not defined`. |
| 256 | 2. **Каталог вспомогательных процессов WebKitGTK.** Он вкомпилирован |
| 257 | строкой `/usr/lib/webkitgtk-6.0`, переменной окружения для него не |
| 258 | существует (в библиотеке есть `WEBKIT_INJECTED_BUNDLE_PATH` и |
| 259 | `WEBKIT_DISABLE_SANDBOX_…`, а `WEBKIT_EXEC_PATH` убрали вместе с |
| 260 | переходом на API 6.0), а писать в `/usr` мы не можем. Строка правится |
| 261 | на месте — тем же приёмом, что у Tauri (tauri-apps/tauri#2940). |
| 262 | Править можно только на **не более длинную**: 22 байта. Каталог |
| 263 | установки в них не влезет, короткая ссылка в `/run/user/<uid>` — |
| 264 | влезает, и там ей и место (logind делает этот каталог с правами 0700 |
| 265 | на владельца, подменить ссылку чужой процесс не может — в отличие от |
| 266 | `/tmp`). Саму ссылку создаёт лаунчер при каждом запуске: `/run/user` |
| 267 | — это tmpfs, её вытирает выход из сеанса. |
| 268 | 3. **Кэш загрузчиков gdk-pixbuf и конфиги glycin** — в них абсолютные |
| 269 | пути, пересобираются на месте. |
| 270 | |
| 271 | --- |
| 272 | |
| 273 | ## 4. Сборка |
| 274 | |
| 275 | ```sh |
| 276 | packaging/build-installer.sh # всё целиком, ~5 минут |
| 277 | SKIP_CONTAINER=1 packaging/build-installer.sh # правился только relocate.sh |
| 278 | REPACK=1 packaging/build-installer.sh # правился только header.sh |
| 279 | ``` |
| 280 | |
| 281 | **Сборка идёт в контейнере Arch, и это необходимость, а не удобство.** |
| 282 | На CachyOS системные пакеты собраны под znver4: `pacman -Qi gtk4` |
| 283 | показывает `Architecture: x86_64_v4`, а в `libglib-2.0.so.0` лежат |
| 284 | инструкции AVX-512. Комплект из таких библиотек упал бы с SIGILL на |
| 285 | Steam Deck (Zen 2) и на любом процессоре без AVX-512. Официальные |
| 286 | репозитории Arch собраны под базовый x86-64. |
| 287 | |
| 288 | Свои бинарники переносимы и так: `.cargo/config.toml` не задаёт |
| 289 | `target-cpu`. |
| 290 | |
| 291 | Сборка сама себя проверяет (шаг 7): у каждого ELF-файла RUNPATH обязан |
| 292 | идти через `$ORIGIN` **и вести туда, где правда лежит `libc.so.6`**, и ни |
| 293 | один файл не должен зависеть от библиотеки, которой в комплекте нет |
| 294 | (кроме намеренно исключённых). Обе проверки появились не из |
| 295 | аккуратности: первая версия сборки ошибалась в RUNPATH на один уровень — |
| 296 | на CachyOS всё запускалось, потому что загрузчик молча брал системные |
| 297 | библиотеки той же версии, а на Debian 12 сразу вылезло |
| 298 | `version GLIBC_2.39 not found`, на Debian 13 — segfault. |
| 299 | |
| 300 | ## 5. Проверка на других дистрибутивах |
| 301 | |
| 302 | ```sh |
| 303 | packaging/bundle/test-distros.sh packaging/out/chimera-launcher-0.1.0.run |
| 304 | ``` |
| 305 | |
| 306 | Ставит комплект в контейнерах Debian 12/13, Ubuntu 24.04, Fedora 41/43 — |
| 307 | от лица обычного пользователя, без root. В контейнер доустанавливается |
| 308 | **только** стек графических драйверов и библиотеки протокола Wayland, |
| 309 | то есть ровно то, что комплект намеренно не везёт. Ставить туда gtk4 или |
| 310 | webkitgtk запрещено: это сделало бы проверку бессмысленной. Окно |
| 311 | рисуется в настоящий Wayland-сеанс хоста (сокет и `/dev/dri` |
| 312 | прокидываются внутрь), снимок делает сам лаунчер своим `--screenshot` — |
| 313 | проверяется отрисованное окно, а не «процесс не упал». |
| 314 | |
| 315 | `ONLY=debian:12 packaging/bundle/test-distros.sh …` — прогнать один |
| 316 | образ. Логи и снимки — в `packaging/out/distro-tests/`. |
| 317 | |
| 318 | ### Что получилось 2026-09-14 |
| 319 | |
| 320 | | Дистрибутив | glibc | libwayland | установка без root | окно | |
| 321 | |---|---|---|---|---| |
| 322 | | Arch (`archlinux:base`) | 2.42 | 1.25 | да | да, на драйверах образа | |
| 323 | | openSUSE Tumbleweed | 2.42 | 1.25 | да | да, на драйверах образа | |
| 324 | | Debian 13 (trixie) | 2.41 | 1.23 | да | да, на драйверах образа | |
| 325 | | Ubuntu 24.04 LTS | 2.39 | 1.22 | да | да, на драйверах образа | |
| 326 | | Fedora 41 | 2.40 | 1.24 | да | да, на драйверах образа | |
| 327 | | Fedora 43 | 2.42 | 1.25 | да | да, на драйверах образа | |
| 328 | | Debian 12 (bookworm) | 2.36 | **1.21** | да | **нет** | |
| 329 | |
| 330 | Прогон 14 сентября на 0.1.35 нашёл две настоящие поломки — обе в |
| 331 | `relocate.sh`, обе про `awk`, которого в базовом образе openSUSE нет: |
| 332 | |
| 333 | - **Проверка версии glibc убивала установку.** Она необязательная — |
| 334 | сравнивает нашу glibc с системной и печатает предупреждение, — но звала |
| 335 | `awk '{print $2}'`, а при `set -e` отсутствие `awk` обрывало всю |
| 336 | раскладку. Заменено подстановкой оболочки. |
| 337 | - **Правка вкомпилированного в WebKitGTK пути** генерировала хвост нулей |
| 338 | через `awk`. Заменено на `dd if=/dev/zero`, который там и так рядом |
| 339 | вторым вызовом. |
| 340 | |
| 341 | После этого `awk` в `relocate.sh` не остался нигде, и openSUSE проходит. |
| 342 | Заодно чинился сам харнесс: имя образа `opensuse/tumbleweed` содержит косую |
| 343 | черту, а имя файла лога собиралось заменой только `:` и `.` — путь уезжал в |
| 344 | несуществующий подкаталог. |
| 345 | |
| 346 | Ни в одном из образов нет ни GTK 4, ни libadwaita, ни WebKitGTK — то |
| 347 | есть сборка из исходников там бы не заработала, а комплект работает. |
| 348 | Девять предупреждений в контейнерах — про то, чего в голом образе |
| 349 | действительно нет (32-битные библиотеки, `bwrap`, `secret-tool`, |
| 350 | `ntsync`, reflink на overlayfs); на настоящей машине их столько не |
| 351 | бывает: на CachyOS владельца из чистого домашнего каталога вышло 29 |
| 352 | проверок, 0 проблем и 1 предупреждение. |
| 353 | |
| 354 | Debian 12 — единственный отказ, и причина у него названа: libwayland |
| 355 | 1.21, см. 1.1а. Установка там проходит, `chl doctor` из терминала |
| 356 | работает и теперь сам говорит про libwayland; графика не поднимается. |
| 357 | |
| 358 | Чего этот прогон **не** проверяет и что честно остаётся непроверенным: |
| 359 | |
| 360 | - **SteamOS (Steam Deck)** — образа нет, машины нет. По документам |
| 361 | подходит (glibc 2.37, libwayland 1.22, Mesa свежая, `/home` |
| 362 | переживает обновление), и установщик написан под её ограничения |
| 363 | (никакого root, ничего в `/usr`), но **не проверено**. |
| 364 | - **Другие видеокарты** — всё снималось на RX 9070 XT. NVIDIA с |
| 365 | проприетарным драйвером и Intel не проверялись. |
| 366 | - **X11-сеанс** — все прогоны шли по Wayland. |
| 367 | - **Процессоры без AVX-512** — сборка ведётся в контейнере Arch именно |
| 368 | из-за этого (см. раздел 4), но запуска на Zen 2 не было. |
| 369 | |
| 370 | ## 6. Удаление |
| 371 | |
| 372 | ```sh |
| 373 | chl uninstall # из установленной копии |
| 374 | packaging/uninstall.sh # для сборки из исходников |
| 375 | ``` |
| 376 | |
| 377 | Данные не трогаются ни в одном из вариантов: библиотека, конфиги игр, |
| 378 | префиксы и сохранения остаются на месте, и об этом говорится вслух. |
| 379 |