210 строк · 13 КиБ
packaging/bundle/header.sh
| 1 | #!/bin/sh |
| 2 | # Chimera-Launcher — установщик одним файлом. |
| 3 | # |
| 4 | # Этот файл — шелл-скрипт, к которому дописан архив: сначала идёт то, |
| 5 | # что ты сейчас читаешь, потом байты `tar.xz` с программой. Скрипт |
| 6 | # распаковывает архив во временный каталог и запускает оттуда |
| 7 | # графический мастер установки. Приём старый и живой: так устроены |
| 8 | # `.run`-установщики драйверов NVIDIA (они собраны makeself). |
| 9 | # |
| 10 | # Почему не AppImage — при том, что архитектурно это одно и то же |
| 11 | # (полезная нагрузка плюс скрипт-запускала): |
| 12 | # |
| 13 | # * AppImage — это «программа, которую не ставят»: скачал файл, он и |
| 14 | # есть программа. А просьба была другая — установщик, который |
| 15 | # спрашивает, куда поставить, и делает ярлыки. Мастер пришлось бы |
| 16 | # писать всё равно, и вдобавок объяснять человеку, почему |
| 17 | # «установленная программа» — это тот же файл, который он скачал. |
| 18 | # * AppImage второго типа монтирует себя через FUSE. Статически |
| 19 | # собранный runtime избавил от библиотеки libfuse2, но не от |
| 20 | # setuid-помощника `fusermount`, и в SteamOS есть открытая заявка |
| 21 | # Valve на выпиливание fuse2 целиком (ValveSoftware/SteamOS#2391). |
| 22 | # Обходной путь `--appimage-extract-and-run` — это ровно то, что |
| 23 | # делает этот скрипт, только без зависимости от FUSE вообще. |
| 24 | # * Flatpak решил бы за нас самую трудную часть (свои GTK 4 и |
| 25 | # WebKitGTK готовыми, с рабочей песочницей) — и сломал бы главную: |
| 26 | # лаунчер обязан запускать произвольные Windows-программы из |
| 27 | # произвольных каталогов, видеть `/dev/input`, слои Vulkan хоста |
| 28 | # (MangoHud, vkBasalt) и `~/.local/share/Steam`. Кончилось бы это |
| 29 | # `--filesystem=host --device=all` плюс дырой `org.freedesktop.Flatpak` |
| 30 | # для запуска чего-либо на хосте, то есть песочницей без стен — |
| 31 | # ровно то, на что жалуются пользователи Flatpak-версий Lutris и |
| 32 | # Bottles, которым каждую папку с играми приходится открывать |
| 33 | # руками через Flatseal. |
| 34 | # |
| 35 | # Что делает установщик и чего он НЕ делает: |
| 36 | # * ставит всё в домашний каталог, без root и без пакетного менеджера; |
| 37 | # * ничего не пишет в системные каталоги — на SteamOS они и так |
| 38 | # только на чтение; |
| 39 | # * не трогает уже существующие данные лаунчера (библиотеку, конфиги |
| 40 | # игр, префиксы Wine, сохранения). |
| 41 | set -eu |
| 42 | |
| 43 | VERSION="@@VERSION@@" |
| 44 | # Смещение полезной нагрузки в байтах. Подставляется сборщиком |
| 45 | # (`packaging/build-installer.sh`) с фиксированной шириной, чтобы |
| 46 | # подстановка не меняла длину самого заголовка. |
| 47 | OFFSET=@@OFFSET@@ |
| 48 | # Ведущие нули снимаются до первой же арифметики: `$((0000010192 + 1))` |
| 49 | # — это не десять тысяч, а синтаксическая ошибка, потому что число с |
| 50 | # ведущим нулём шелл считает восьмеричным, а цифр 8 и 9 в восьмеричной |
| 51 | # записи не бывает. Ширина у OFFSET фиксированная не просто так (иначе |
| 52 | # подстановка сместила бы сам заголовок), так что нули там будут почти |
| 53 | # всегда. Своим циклом, а не `$((10#$OFFSET))`: последнего нет в POSIX |
| 54 | # sh, а на Debian и Ubuntu /bin/sh — это dash. |
| 55 | while [ "${OFFSET#0}" != "$OFFSET" ]; do OFFSET=${OFFSET#0}; done |
| 56 | |
| 57 | say() { printf '%s\n' "$*"; } |
| 58 | die() { printf '%s\n' "$*" >&2; exit 1; } |
| 59 | |
| 60 | usage() { |
| 61 | cat <<EOF |
| 62 | Chimera-Launcher $VERSION — установщик. |
| 63 | |
| 64 | ./$(basename "$0") графический мастер установки |
| 65 | ./$(basename "$0") --cli [аргументы] установка без графики; аргументы |
| 66 | те же, что у «chl setup» |
| 67 | (--prefix, --autostart, --steam-entry…) |
| 68 | ./$(basename "$0") --extract <каталог> только распаковать, ничего не ставить |
| 69 | ./$(basename "$0") --tmpdir <каталог> где распаковываться (по умолчанию |
| 70 | ~/.cache/chimera-launcher) |
| 71 | ./$(basename "$0") --help это сообщение |
| 72 | |
| 73 | Права администратора не нужны ни в одном из режимов. |
| 74 | EOF |
| 75 | } |
| 76 | |
| 77 | mode=gui |
| 78 | extract_to="" |
| 79 | tmp_base="" |
| 80 | # Остаток аргументов уезжает в «chl setup» как есть. |
| 81 | cli_args="" |
| 82 | while [ $# -gt 0 ]; do |
| 83 | case "$1" in |
| 84 | --help | -h) usage; exit 0 ;; |
| 85 | --extract) mode=extract; extract_to=${2:?--extract требует каталог}; shift 2 ;; |
| 86 | --tmpdir) tmp_base=${2:?--tmpdir требует каталог}; shift 2 ;; |
| 87 | --cli) mode=cli; shift; cli_args="$*"; break ;; |
| 88 | *) die "непонятный аргумент: $1 (см. --help)" ;; |
| 89 | esac |
| 90 | done |
| 91 | |
| 92 | # --- чем распаковывать ------------------------------------------------- |
| 93 | # Единственное, что установщику нужно от системы, — распаковать себя. |
| 94 | # xz выбран не за сжатие, а за наличие: он есть в базовой системе |
| 95 | # Debian, Ubuntu, Fedora, Arch и SteamOS (без него не работают их |
| 96 | # пакетные менеджеры). zstd сжал бы лучше и распаковал быстрее, но на |
| 97 | # минимальной установке Debian его нет, а обещание «никаких |
| 98 | # зависимостей» не должно спотыкаться на первом же шаге. |
| 99 | command -v tar >/dev/null 2>&1 || die "не найден tar — распаковать установщик нечем" |
| 100 | if tar --help 2>&1 | grep -q -- '-J'; then |
| 101 | untar() { tar -xJf - -C "$1"; } |
| 102 | elif command -v xz >/dev/null 2>&1; then |
| 103 | untar() { xz -dc | tar -xf - -C "$1"; } |
| 104 | else |
| 105 | die "не найден ни tar с поддержкой xz, ни отдельный xz — распаковать нечем" |
| 106 | fi |
| 107 | |
| 108 | # --- куда распаковываться ---------------------------------------------- |
| 109 | # Каталог должен быть не только доступен на запись, но и смонтирован |
| 110 | # БЕЗ noexec: из него сразу запускается мастер. /tmp с noexec — |
| 111 | # классическая причина, по которой не запускаются AppImage, и молча |
| 112 | # наступать на неё не стоит. Поэтому каждый кандидат проверяется делом: |
| 113 | # создаётся файл, ему ставится бит x, он запускается. |
| 114 | exec_ok() { |
| 115 | d=$1 |
| 116 | mkdir -p "$d" 2>/dev/null || return 1 |
| 117 | p="$d/.chl-exec-test.$$" |
| 118 | printf '#!/bin/sh\nexit 0\n' > "$p" 2>/dev/null || return 1 |
| 119 | chmod +x "$p" 2>/dev/null || { rm -f "$p"; return 1; } |
| 120 | if "$p" 2>/dev/null; then rm -f "$p"; return 0; fi |
| 121 | rm -f "$p" |
| 122 | return 1 |
| 123 | } |
| 124 | |
| 125 | if [ -n "$tmp_base" ]; then |
| 126 | candidates="$tmp_base" |
| 127 | else |
| 128 | # ~/.cache первым: он на том же разделе, что и цель установки, то |
| 129 | # есть места там ровно столько же, и распаковка не упрётся в мелкий |
| 130 | # tmpfs. /run/user — второй: он exec, но это оперативная память. |
| 131 | candidates="${XDG_CACHE_HOME:-$HOME/.cache}/chimera-launcher ${XDG_RUNTIME_DIR:-} ${TMPDIR:-/tmp}" |
| 132 | fi |
| 133 | work="" |
| 134 | for c in $candidates; do |
| 135 | [ -n "$c" ] || continue |
| 136 | if exec_ok "$c"; then work="$c"; break; fi |
| 137 | done |
| 138 | [ -n "$work" ] || die "не нашлось каталога, где можно и записать, и запустить файл. |
| 139 | Попробуй указать свой: --tmpdir ~/куда-нибудь" |
| 140 | |
| 141 | if [ "$mode" = extract ]; then |
| 142 | mkdir -p "$extract_to" |
| 143 | say "Распаковываю в $extract_to" |
| 144 | tail -c "+$((OFFSET + 1))" "$0" | untar "$extract_to" |
| 145 | say "Готово: $extract_to/payload" |
| 146 | say "Привязать к каталогу: sh $extract_to/payload/relocate.sh <каталог>" |
| 147 | exit 0 |
| 148 | fi |
| 149 | |
| 150 | # Каталоги распаковки, оставшиеся от прошлых запусков. Их быть не должно, |
| 151 | # но пока в установщике стоял `exec` (см. ниже), каждая установка без |
| 152 | # графики оставляла по 500 МиБ в кэше, и на машине владельца их накопилось |
| 153 | # девять — 4,5 ГиБ. Уборка при старте нужна и после исправления: установщик |
| 154 | # могут убить по -9 или выключением питания, и тогда trap не сработает. |
| 155 | for stale in "$work"/setup.*; do |
| 156 | [ -d "$stale" ] || continue |
| 157 | pid=${stale##*/setup.} |
| 158 | # Чужой живой процесс с тем же номером не трогаем: маловероятно, но |
| 159 | # удалить каталог из-под работающей установки хуже, чем оставить мусор. |
| 160 | case "$pid" in |
| 161 | ''|*[!0-9]*) continue ;; |
| 162 | esac |
| 163 | kill -0 "$pid" 2>/dev/null && continue |
| 164 | rm -rf "$stale" |
| 165 | done |
| 166 | |
| 167 | tmp="$work/setup.$$" |
| 168 | mkdir -p "$tmp" |
| 169 | # Временный каталог убирается в любом случае: и после установки, и если |
| 170 | # человек закрыл мастер крестиком, и если что-то упало. |
| 171 | trap 'rm -rf "$tmp"' EXIT INT TERM |
| 172 | |
| 173 | say "" |
| 174 | say " Chimera-Launcher $VERSION" |
| 175 | say " Запуск игр Windows на Linux" |
| 176 | say "" |
| 177 | say " Распаковываю... (около 400 МиБ, это несколько секунд)" |
| 178 | tail -c "+$((OFFSET + 1))" "$0" | untar "$tmp" |
| 179 | p="$tmp/payload" |
| 180 | [ -x "$p/bin/chimera-launcher" ] || die "архив распаковался не полностью — попробуй скачать файл заново" |
| 181 | |
| 182 | say " Готовлю программу к запуску..." |
| 183 | sh "$p/relocate.sh" "$p" >/dev/null |
| 184 | |
| 185 | if [ "$mode" = cli ]; then |
| 186 | # Без `exec`. Он заменял оболочку процессом `chl`, и trap на EXIT не |
| 187 | # срабатывал никогда: каждая установка без графики оставляла в кэше |
| 188 | # каталог распаковки на 500 МиБ. Нашлось при измерении, сколько места |
| 189 | # занимает лаунчер после установки с нуля. |
| 190 | # shellcheck disable=SC2086 |
| 191 | "$p/bin/chl" setup $cli_args |
| 192 | exit $? |
| 193 | fi |
| 194 | |
| 195 | say " Открываю мастер установки." |
| 196 | say "" |
| 197 | "$p/bin/chimera-launcher" --setup-payload "$p" || die " |
| 198 | Мастер установки не запустился. |
| 199 | |
| 200 | Так бывает, если графического сеанса нет вовсе (запуск по ssh, консоль). |
| 201 | Тогда поставить можно без графики, тем же файлом: |
| 202 | |
| 203 | ./$(basename "$0") --cli --prefix ~/.local/share/chimera-launcher/app |
| 204 | |
| 205 | Полный список вопросов, которые задаёт мастер, там же: |
| 206 | |
| 207 | ./$(basename "$0") --cli --help" |
| 208 | exit 0 |
| 209 | @@PAYLOAD@@ |
| 210 |