Руководство по обновлению
Это руководство описывает способы обновления XMCL на Windows, macOS и Linux, а также объясняет, как гарантировать полную сохранность игровых инстансов, сохранений миров и аккаунтов.
Гарантия безопасности данных
Обновление XMCL никогда не удаляет ваши инстансы, моды, миры или учетные записи. Все данные пользователя хранятся отдельно от исполняемых файлов лаунчера в системных каталогах.
Windows
1. Встроенное автоматическое обновление (Стандартный способ)
- При выходе нового релиза в верхней панели заголовка окна появляется значок обновления.
- Нажмите на уведомление, чтобы просмотреть список изменений и начать фоновую загрузку.
- По завершении нажмите Перезапустить и обновить. Лаунчер перезапустится в новой версии.
2. Пакеты AppInstaller и APPX
- Если XMCL был установлен через пакет
xmcl.appinstaller, операционная система Windows автоматически проверяет и загружает обновления при запуске через службу Windows Delivery Optimization. - Скачиваются только измененные бинарные блоки (инкрементные обновления), что существенно экономит трафик.
- Если автообновление завершилось сбоем, скачайте свежий файл
xmcl.appinstallerс официального сайта и запустите его вручную для восстановления.
3. Портативный архив (Portable ZIP) и DeskGap
- Portable ZIP: Скачайте свежий архив
xmcl-*-win32-x64.zipсо страницы релизов, распакуйте его и замените старые файлы. Все ваши миры и настройки сохранятся, так как они находятся в%AppData%\xmcl. - DeskGap (v0.72.0+): Распакуйте новый архив
xmcl-*-deskgap-win32-x64.zipповерх текущей папки.
macOS
1. Автоматическое обновление в приложении
- Лаунчер самостоятельно проверяет официальный канал релизов для macOS.
- При появлении новой версии загрузка и перезапуск выполняются в один клик.
2. Обновление через файл DMG
- Скачайте свежий
.dmgдля процессора вашего Mac:- Apple Silicon (M1 / M2 / M3 / M4):
arm64.dmg - Процессоры Intel:
x64.dmg
- Apple Silicon (M1 / M2 / M3 / M4):
- Откройте файл
.dmg. - Перетащите XMCL.app в папку Программы (Applications) и выберите Заменить (Replace).
Снятие карантина Gatekeeper
Если macOS блокирует обновленную программу предупреждением о поврежденном файле или неизвестном разработчике, выполните следующую команду в Terminal:
sudo xattr -cr /Applications/XMCL.appLinux и Steam Deck
1. AppImage
- Прямая замена файла: Скачайте свежий
xmcl-*.AppImage, дайте ему права на исполнение и запустите:shchmod +x xmcl-*.AppImage ./xmcl-*.AppImage - AppImageUpdate: Если вы используете утилиты автоматизации, лаунчер поддерживает бинарное дельта-обновление через
appimageupdatetool. - Steam Deck: В режиме рабочего стола SteamOS Desktop Mode просто замените существующий файл
xmcl.AppImageв вашей папкеApplicationsилиGames.
2. Flatpak (Flathub) — Рекомендуется
Flatpak является официально поддерживаемым основным форматом для Linux (включая Arch Linux, Fedora, Ubuntu и SteamOS). Обновите его через системный центр приложений или командой в консоли:
flatpak update app.xmcl.XMCL3. Автономные архивы и бинарные пакеты
Для пакетов .tar.xz, .deb или .rpm скачайте последнюю версию со страницы релизов и установите поверх текущей.
Резервное копирование и пути к данным
Если перед обновлением вы хотите сделать резервную копию вручную, ваши данные хранятся в следующих каталогах:
%AppData%\xmcl~/Library/Application Support/xmcl~/.config/xmclДостаточно скопировать эту папку на внешний диск или в облако, чтобы получить полный бекап всех инстансов, аккаунтов и настроек.