PortProtonQt предоставляет встроенный инструмент миграции, который позволяет обновить ранее созданные ярлыки и скрипты запуска без необходимости пересоздавать их вручную.
Функция доступна в разделе:
Настройки PPQT → Перенести старые ярлыки
Важно: перенос выполняется только по нажатию кнопки «Перенести старые ярлыки». Процедура не запускается автоматически при старте PortProtonQt.
Что обновляется
Во время миграции PortProtonQt проверяет:
- ярлыки рабочего стола (
*.desktop). - ярлыки меню приложений пользователя.
- внутренние ярлыки PortProtonQt.
- Steam-скрипты запуска (
steam_scripts/*.sh).
Если обнаружены устаревшие команды запуска или пути, они автоматически заменяются на актуальные. Файлы, в которых изменений не требуется, не затрагиваются.
Помимо команды запуска, миграция также выполняет следующие правки в .desktop файлах:
- удаляет строку
Path=— она более не используется. - заменяет пути вида
~/PortProton/на~/PortProtonQt/. - обновляет пути к каталогу данных, если они изменились.
Перенос ярлыков после перемещения AppImage
Если вы используете AppImage и переместили файл PortProtonQt в другое место, старые ярлыки продолжат ссылаться на прежний путь.
Например, раньше приложение находилось здесь:
/home/user/Downloads/PortProtonQt.AppImage
После перемещения:
/home/user/Applications/PortProtonQt.AppImage
существующие ярлыки могут перестать запускаться.
Нажмите «Перенести старые ярлыки», и PortProtonQt автоматически обновит найденные ярлыки и Steam-скрипты на новое расположение AppImage.
Переход между способами установки
Миграция умеет обновлять команды запуска независимо от способа установки.
Все параметры запуска игр сохраняются автоматически — только команда лаунчера заменяется на актуальную, аргументы игры остаются без изменений.
Старый Flatpak
Exec=flatpak run ru.linux_gaming.PortProton /home/user/PortProton/data/myapp.exe
Старый AppImage (прежнее расположение)
Exec=/home/user/Downloads/PortProtonQt.AppImage --silent /home/user/PortProtonQt/data/myapp.exe
Старый скрипт через env + start.sh
Exec=env /home/user/PortProton/data/scripts/start.sh /home/user/PortProtonQt/data/myapp.exe
После миграции (AppImage, новое расположение)
Exec=/home/user/Applications/PortProtonQt.AppImage --silent /home/user/PortProtonQt/data/myapp.exe
После миграции (установленная версия)
Exec=portprotonqt --silent /home/user/PortProtonQt/data/myapp.exe
Миграция Steam-скриптов
Также проверяются скрипты из каталога:
steam_scripts/
Если внутри обнаружены устаревшие команды запуска PortProton или старые пути к AppImage, они автоматически заменяются на актуальные. Аргументы запуска, включая "$@", сохраняются.
Пересоздавать ярлыки Steam вручную не требуется.
Ограничения миграции
Функция обновляет только ссылки и команды запуска — ярлыки рабочего стола, ярлыки меню приложений, Steam-скрипты и пути внутри них. Файлы, в которых устаревших данных не обнаружено, не затрагиваются.
Сами данные игр и настройки PortProtonQt миграция не переносит. Если каталог данных нужно переместить в другое место, это делается вручную.
Итог
Функция миграции позволяет быстро восстановить работоспособность ярлыков после:
- перехода с PortProton на PortProtonQt.
- переноса AppImage в другую папку.
- переустановки приложения.
- смены способа установки.
- изменения путей хранения данных.
Для переноса пользовательских данных между различными установками PortProtonQt необходимо дополнительно выполнить ручное копирование каталога данных.
