Обновление версий

Обновление до новой версии

Обновление заменяет только программу. Ваши настройки, кредиты, история общих файлов, незавершённые загрузки и готовые файлы хранятся в месте, которое новая версия не перезаписывает, поэтому в большинстве систем для обновления достаточно установить новую версию поверх старой. Единственное исключение — ZIP-архив для Windows: там ваши данные лежат внутри папки программы, поэтому прочитайте его раздел, прежде чем что-либо распаковывать.

Где хранятся ваши данные

Вы используете	Программа	Ваши данные
Установщик для Windows	`C:\Program Files\eMule Qt`	`%LOCALAPPDATA%\eMuleQt`, внутри папки `Incoming` и `Temp`
ZIP для Windows (портативная версия)	Распакованная папка `eMule`	Та же папка: `config`, `Incoming` и `Temp` рядом с `emuleqt.exe`
macOS	`emuleqt.app` в папке «Программы»	`~/eMuleQt/Config`, `~/eMuleQt/Incoming`, `~/eMuleQt/Temp`
Linux	Папка `eMuleQt` из архива tarball	`~/eMuleQt/Config`, `~/eMuleQt/Incoming`, `~/eMuleQt/Temp`
Docker	Образ	Тома `/config` и `/data`

Если вы перенесли Incoming, Temp или общие папки в другое место в разделе «Настройки», они останутся там, где вы их указали. Обновление их не затрагивает.

Перед каждым обновлением

Закройте eMule Qt и его ядро. Окно и ядро (emulecored) — это две разные программы. Если значок цепи в строке состояния разорван, ядро отсоединено и продолжает работать после закрытия окна. Убедитесь, что в диспетчере задач, «Мониторинге системы» или через pgrep emulecored не осталось процесса emulecored.
Сделайте резервную копию папки config. Она небольшая, а копия ничего не стоит. Незавершённые загрузки в Temp при обычном обновлении копировать не нужно.

Установщик для Windows

Скачайте новый установщик (eMuleQt-vX.Y.Z-win64-setup.exe) на странице загрузки.
Запустите его. Он найдёт прежнюю установку и поместит новую версию в ту же папку. Запущенные eMule Qt и его ядро будут закрыты автоматически.
Не отмечайте «Импортировать настройки из eMule». При обновлении флажок снят по умолчанию, так как профиль eMule Qt уже используется.
Запустите eMule Qt.

Предварительно удалять старую версию не нужно. Даже если вы это сделаете, деинсталлятор не тронет %LOCALAPPDATA%\eMuleQt.

ZIP для Windows (портативная версия)

В портативной версии папка config находится внутри папки программы, а в ZIP-архиве есть своя папка config. Вот что в ней лежит:

Файлы программы, которые нужно заменить: eMule.tmpl, папка webserver, nodes.ed3knod и GeoLite2-Country.mmdb.
Стартовые файлы, свою копию которых нужно сохранить: server.met, nodes.dat, webservices.dat и FakeFileFilter.dat. Если ZIP их перезапишет, список серверов и контакты Kad вернутся к исходным. Ничего не сломается, но вы потеряете накопленные списки.

Ваших личных файлов в ZIP нет: preferences.yml, preferences.dat, cryptkey.dat, clients.met, known.met, файлы .part в Temp и готовые загрузки. Распаковка их не затронет.

Как обновить

Закройте eMule Qt и его ядро (см. выше).
Распакуйте новую версию во временную папку, а не поверх установленной.
Во временной папке eMule\config удалите server.met, nodes.dat, webservices.dat и FakeFileFilter.dat.
Скопируйте всё содержимое временной папки eMule поверх существующей папки eMule и подтвердите замену файлов.
Запустите eMule Qt, затем удалите временную папку.

.:Обновляйте на месте, не переносите

Соблазн распаковать архив в новую папку и перенести туда только config велик. Не делайте так. Незавершённые загрузки лежат в Temp, готовые файлы — в Incoming, и обе папки находятся в старой папке программы, а preferences.yml хранит их полные пути. В новой папке список загрузок окажется пустым, либо программа продолжит использовать старую папку, а вы этого не заметите. Если вам действительно нужно перенести установку, переносите всю папку целиком, а затем проверьте каталоги в разделе «Настройки».

Если вы изменяли файлы веб-интерфейса в config\webserver, сначала сохраните их копию: при обновлении они заменяются.

macOS

Закройте eMule Qt и его ядро (см. выше).
Откройте новый образ диска: eMuleQt-vX.Y.Z-macOS-arm64.dmg для Apple silicon или eMuleQt-vX.Y.Z-macOS-x86_64.dmg для Intel.
Перетащите eMule Qt в папку «Программы» и выберите «Заменить».
Запустите eMule Qt.

Ваши данные в ~/eMuleQt находятся вне приложения и остаются без изменений.

Linux

Закройте eMule Qt и его ядро (см. выше).
Распакуйте новый архив tarball в то же место, где лежал прежний, чтобы он перезаписал старую папку eMuleQt: tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz
Запустите eMule Qt. Пункт меню и типы файлов продолжат работать, так как путь не изменился.

.:Не удаляйте сначала старую папку

Если вы распаковали архив в домашнюю папку, программа и ваши данные находятся в одной папке: программа — это ~/eMuleQt, а данные — ~/eMuleQt/Config, Incoming и Temp. Если удалить старую папку программы перед обновлением, всё это тоже будет удалено. Распаковка поверх всегда безопасна, потому что в архиве нет папок Config, Incoming и Temp. Его папка config в нижнем регистре содержит поставляемые значения по умолчанию, и eMule Qt никогда не копирует их поверх изменённых вами файлов.

Если вы всё же распакуете новую версию в другое место, один раз запустите её оттуда, и eMule Qt обновит пункт меню на новый путь.

Docker

Загрузите новый образ и пересоздайте контейнер. Ваши данные хранятся в томах:

Docker Compose: docker compose pull && docker compose up -d
Обычный Docker: docker pull ghcr.io/moddermule/emuleqt:latest, затем удалите старый контейнер и запустите новый с теми же параметрами -v.

Как вы узнаете о новой версии

eMule Qt сам проверяет наличие новых версий и показывает окно со списком изменений и ссылкой на страницу загрузки. Чтобы проверить сразу, выберите Инструменты → Ссылки → Проверка версии. Если в окне сказано, что обновление обязательно, в вашей версии есть известные серьёзные ошибки, и eMule Qt закроется, пока вы не обновитесь.

Ядро, работающее без окна на сервере или NAS, может устанавливать обновления самостоятельно: запустите его как emulecored --autoupdate. Оно скачает каждый новый релиз, проверит его, установит так, как описано на этой странице (в том числе сохранит ваши файлы конфигурации в портативной установке), и перезапустится с теми же параметрами. Контейнеры Docker сами не обновляются: загрузите новый образ.

Назад к справке