Project Chimera
Меню

Исходники

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, сохранения).
41set -eu
42
43VERSION="@@VERSION@@"
44# Смещение полезной нагрузки в байтах. Подставляется сборщиком
45# (`packaging/build-installer.sh`) с фиксированной шириной, чтобы
46# подстановка не меняла длину самого заголовка.
47OFFSET=@@OFFSET@@
48# Ведущие нули снимаются до первой же арифметики: `$((0000010192 + 1))`
49# — это не десять тысяч, а синтаксическая ошибка, потому что число с
50# ведущим нулём шелл считает восьмеричным, а цифр 8 и 9 в восьмеричной
51# записи не бывает. Ширина у OFFSET фиксированная не просто так (иначе
52# подстановка сместила бы сам заголовок), так что нули там будут почти
53# всегда. Своим циклом, а не `$((10#$OFFSET))`: последнего нет в POSIX
54# sh, а на Debian и Ubuntu /bin/sh — это dash.
55while [ "${OFFSET#0}" != "$OFFSET" ]; do OFFSET=${OFFSET#0}; done
56
57say() { printf '%s\n' "$*"; }
58die() { printf '%s\n' "$*" >&2; exit 1; }
59
60usage() {
61 cat <<EOF
62Chimera-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Права администратора не нужны ни в одном из режимов.
74EOF
75}
76
77mode=gui
78extract_to=""
79tmp_base=""
80# Остаток аргументов уезжает в «chl setup» как есть.
81cli_args=""
82while [ $# -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
90done
91
92# --- чем распаковывать -------------------------------------------------
93# Единственное, что установщику нужно от системы, — распаковать себя.
94# xz выбран не за сжатие, а за наличие: он есть в базовой системе
95# Debian, Ubuntu, Fedora, Arch и SteamOS (без него не работают их
96# пакетные менеджеры). zstd сжал бы лучше и распаковал быстрее, но на
97# минимальной установке Debian его нет, а обещание «никаких
98# зависимостей» не должно спотыкаться на первом же шаге.
99command -v tar >/dev/null 2>&1 || die "не найден tar — распаковать установщик нечем"
100if tar --help 2>&1 | grep -q -- '-J'; then
101 untar() { tar -xJf - -C "$1"; }
102elif command -v xz >/dev/null 2>&1; then
103 untar() { xz -dc | tar -xf - -C "$1"; }
104else
105 die "не найден ни tar с поддержкой xz, ни отдельный xz — распаковать нечем"
106fi
107
108# --- куда распаковываться ----------------------------------------------
109# Каталог должен быть не только доступен на запись, но и смонтирован
110# БЕЗ noexec: из него сразу запускается мастер. /tmp с noexec —
111# классическая причина, по которой не запускаются AppImage, и молча
112# наступать на неё не стоит. Поэтому каждый кандидат проверяется делом:
113# создаётся файл, ему ставится бит x, он запускается.
114exec_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
125if [ -n "$tmp_base" ]; then
126 candidates="$tmp_base"
127else
128 # ~/.cache первым: он на том же разделе, что и цель установки, то
129 # есть места там ровно столько же, и распаковка не упрётся в мелкий
130 # tmpfs. /run/user — второй: он exec, но это оперативная память.
131 candidates="${XDG_CACHE_HOME:-$HOME/.cache}/chimera-launcher ${XDG_RUNTIME_DIR:-} ${TMPDIR:-/tmp}"
132fi
133work=""
134for c in $candidates; do
135 [ -n "$c" ] || continue
136 if exec_ok "$c"; then work="$c"; break; fi
137done
138[ -n "$work" ] || die "не нашлось каталога, где можно и записать, и запустить файл.
139Попробуй указать свой: --tmpdir ~/куда-нибудь"
140
141if [ "$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
148fi
149
150# Каталоги распаковки, оставшиеся от прошлых запусков. Их быть не должно,
151# но пока в установщике стоял `exec` (см. ниже), каждая установка без
152# графики оставляла по 500 МиБ в кэше, и на машине владельца их накопилось
153# девять — 4,5 ГиБ. Уборка при старте нужна и после исправления: установщик
154# могут убить по -9 или выключением питания, и тогда trap не сработает.
155for 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"
165done
166
167tmp="$work/setup.$$"
168mkdir -p "$tmp"
169# Временный каталог убирается в любом случае: и после установки, и если
170# человек закрыл мастер крестиком, и если что-то упало.
171trap 'rm -rf "$tmp"' EXIT INT TERM
172
173say ""
174say " Chimera-Launcher $VERSION"
175say " Запуск игр Windows на Linux"
176say ""
177say " Распаковываю... (около 400 МиБ, это несколько секунд)"
178tail -c "+$((OFFSET + 1))" "$0" | untar "$tmp"
179p="$tmp/payload"
180[ -x "$p/bin/chimera-launcher" ] || die "архив распаковался не полностью — попробуй скачать файл заново"
181
182say " Готовлю программу к запуску..."
183sh "$p/relocate.sh" "$p" >/dev/null
184
185if [ "$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 $?
193fi
194
195say " Открываю мастер установки."
196say ""
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"
208exit 0
209@@PAYLOAD@@
210