forked from CastroFidel/winehelper
390 lines
23 KiB
Markdown
390 lines
23 KiB
Markdown
<div align="center">
|
||
<img src="image/gui/winehelper.svg" width="64">
|
||
<h1 align="center">WineHelper</h1>
|
||
<p align="center">Инструмент для упрощения установки Windows-приложений на Linux. Он использует подготовленные скрипты, портативные версии Wine и изолированные префиксы, обеспечивая максимальную идентичность на различных операционных системах основанных на Alt Linux, начиная с релиза p10 и выше.</p>
|
||
</div>
|
||
|
||
<p align="center">
|
||
<img src="image/handbook/auto_install.png" alt="WineHelper GUI" width="80%">
|
||
</p>
|
||
|
||
<h2>Основные возможности</h2>
|
||
|
||
<ul>
|
||
<li><b>Простая установка</b>: Устанавливайте Windows-приложения с помощью готовых скриптов, как в автоматическом, так и в ручном режиме.</li>
|
||
<li><b>Изолированные окружения</b>: Каждое приложение устанавливается в свой собственный, изолированный префикс, что предотвращает конфликты.</li>
|
||
<li><b>Управление версиями Wine</b>: Легко переключайтесь между различными версиями Wine и Proton для достижения наилучшей совместимости.</li>
|
||
<li><b>Графический и консольный интерфейсы</b>: Используйте удобный GUI для повседневных задач или мощный CLI для автоматизации.</li>
|
||
<li><b>Резервное копирование</b>: Создавайте и восстанавливайте полные резервные копии ваших префиксов.</li>
|
||
<li><b>Встроенные утилиты</b>: Быстрый доступ к <code>winecfg</code>, <code>regedit</code>, <code>Winetricks</code> и другим инструментам для каждого префикса.</li>
|
||
</ul>
|
||
|
||
<hr>
|
||
|
||
<!-- Описание установки WineHelper-->
|
||
<details>
|
||
<summary style="font-size: 35px; font-weight: bold;">Установка</summary>
|
||
|
||
<pre><code> $ su -
|
||
# apt-get update && apt-get dist-upgrade
|
||
# apt-get install winehelper
|
||
# exit
|
||
</code></pre>
|
||
</details>
|
||
|
||
|
||
<!-- Описание использования CLI -->
|
||
<details>
|
||
<summary style="font-size: 35px; font-weight: bold;">Использование WineHelper (CLI)</summary>
|
||
|
||
<h3>Список приложений для установки</h3>
|
||
|
||
<p>Вывод списка приложений, доступных к установке:</p>
|
||
<pre><code> $ winehelper install list
|
||
</code></pre>
|
||
<p>или сокращенная команда:</p>
|
||
<pre><code> $ winehelper -i
|
||
</code></pre>
|
||
|
||
<h3>Запуск установки приложений</h3>
|
||
|
||
<p>Скрипты установки разделены на два типа:</p>
|
||
|
||
<ol>
|
||
<li><b>Список программ с возможностью автоматической установки</b> — содержит полностью автоматизированные скрипты установок программ у которыx есть дистрибутивы (установщики) в свободном доступе.
|
||
Процесс полностью автоматизирован.
|
||
Пример:
|
||
<pre><code> $ winehelper install spravki-bk
|
||
</code></pre>
|
||
или сокращенная команда:
|
||
<pre><code> $ winehelper -i spravki-bk
|
||
</code></pre>
|
||
</li>
|
||
<li><b>Список программ с возможностью установки из существующего дистрибутива</b> — содержит скрипты установок для программ, которых нет в свободном доступе.
|
||
Пример:
|
||
<pre><code> $ winehelper install is-record-station "/путь/до/установочного_файла"
|
||
</code></pre>
|
||
или сокращенная команда:
|
||
<pre><code> $ winehelper -i is-record-station "/путь/до/установочного_файла"
|
||
</code></pre>
|
||
</li>
|
||
</ol>
|
||
|
||
<h3>Процесс установки приложений</h3>
|
||
|
||
<p>При первом запуске <b>WineHelper</b> проверяются и при необходимости устанавливаются дополнительные зависимости (запрашиваются права root).</p>
|
||
|
||
<p>Процесс установки приложений:</p>
|
||
<ol>
|
||
<li>Отображаются лицензионные соглашения на сторонние компоненты. Для продолжения введите <b>y</b> и нажмите <b>Enter</b>.</li>
|
||
<li>Далее процесс проходит автоматически с подробным выводом в терминал:
|
||
<ul>
|
||
<li>Загрузка и проверка хэш-суммы нужной версии Wine.</li>
|
||
<li>Загрузка и проверка хэш-суммы базового префикса.</li>
|
||
<li>Инициализация и подготовка префикса.</li>
|
||
<li>Скачивание дистрибутива (установщика) программы с официального сайта (если применимо).</li>
|
||
<li>Установка приложения.</li>
|
||
<li>Создание .desktop-файла (ярлыка) на рабочем столе и в меню приложений.</li>
|
||
</ul>
|
||
</li>
|
||
</ol>
|
||
|
||
<p>Если устанавливаемое приложение требует дополнительных действий от пользователя (ввод лицензии, настройка), это будет явно указано в терминале.</p>
|
||
|
||
<h3>Удаление префикса с приложением</h3>
|
||
|
||
<p>Для удаления префикса выполните команду:</p>
|
||
<pre><code> $ winehelper remove-prefix [имя_префикса]
|
||
</code></pre>
|
||
<p>Если имя префикса не указано, будет выведен список существующих префиксов:</p>
|
||
<pre><code> 0 - Отмена
|
||
1 - Префикс1
|
||
2 - Префикс2
|
||
Выберите префикс (0-2):
|
||
</code></pre>
|
||
<p>Необходимо указать номер удаляемого префикса и нажать клавишу <b>Enter</b>.Далее потребуется подтвердить удаление префикса вводом <b>y</b>.</p>
|
||
|
||
<p>В результате будут удалены:</p>
|
||
<ul>
|
||
<li>сам префикс;</li>
|
||
<li>установленное ПО;</li>
|
||
<li>desktop-файлы (ярлыки для установленного ПО в префиксе).</li>
|
||
</ul>
|
||
|
||
<h3>Резервное копирование префикса</h3>
|
||
|
||
<p>Команда создания резервной копии префикса:</p>
|
||
<pre><code> $ winehelper backup-prefix [имя_префикса]
|
||
</code></pre>
|
||
<p>Если имя префикса не указано, будет выведен список существующих префиксов:</p>
|
||
<pre><code> 0 - Отмена
|
||
1 - Префикс1
|
||
2 - Префикс2
|
||
Выберите префикс (0-2):
|
||
</code></pre>
|
||
<p>Необходимо указать номер удаляемого префикса и нажать клавишу <b>Enter</b>.<br>
|
||
После выбора префикса автоматически:</p>
|
||
<ul>
|
||
<li>Создаётся копия префикса.</li>
|
||
<li>Внутри префикса сохраняется используемая версия WINE.</li>
|
||
<li>Копируются иконки для ярлыков (.desktop-файлов).</li>
|
||
<li>Сохраняется информация о ярлыках (.desktop-файлах) для будущей распаковки/восстановления префикса.</li>
|
||
<li>Резервная копия сохраняется на рабочем столе с именем: <code>backup_имя_префикса_дата_создания.whpack</code></li>
|
||
</ul>
|
||
|
||
<h3>Восстановление префикса из резервной копии</h3>
|
||
|
||
<p>Команда восстановления префикса из резервной копии:</p>
|
||
<pre><code> $ winehelper restore-prefix "путь/до/файла.whpack"
|
||
</code></pre>
|
||
<p>Восстановление префикса не требует подключение к интернету и происходит в автоматическом режиме:</p>
|
||
<ul>
|
||
<li>Распаковка префикса.</li>
|
||
<li>Восстановление версии WINE.</li>
|
||
<li>Восстановление ярлыков (.desktop-файdлов).</li>
|
||
</ul>
|
||
|
||
<p>После завершения восстановления приложение будет доступно для запуска через меню или рабочий стол.</p>
|
||
|
||
<h3>Использование команд WINE в WineHelper</h3>
|
||
|
||
<p>WineHelper предоставляет доступ к основным инструментам WINE:</p>
|
||
<pre><code> winehelper winefile # запуск файлового менеджера wine
|
||
winehelper winecfg # запуск wine конфигуратора для префикса
|
||
winehelper winereg # запуск редактора реестра для префикса
|
||
winehelper wineconsole # запуск терминала wine (cmd.exe)
|
||
winehelper winetricks # запуск графического интерфейса winetricks
|
||
winehelper winetricks [компонент] # автоматическая установка дополнительного компонента в префикс
|
||
</code></pre>
|
||
<p>После выполнения любой из вышеперечисленных команд отображается список существующих префиксов:</p>
|
||
<pre><code>0 - Отмена
|
||
1 - Префикс1
|
||
2 - Префикс2
|
||
Выберите префикс (0-2):
|
||
</code></pre>
|
||
<p>Команда выполняется в выбранном вами префиксе.</p>
|
||
|
||
<h3>Запуск стороннего *.exe файла в WineHelper</h3>
|
||
|
||
<p>Есть два варианта:</p>
|
||
<ol>
|
||
<li>В командной строке выполнить команду:
|
||
<pre><code> $ winehelper "путь/до/файла.exe"
|
||
0 - Отмена
|
||
1 - Префикс1
|
||
2 - Префикс2
|
||
Выберите префикс (0-2):
|
||
</code></pre>
|
||
<p>Файл будет запущен в выбранном префиксе.</p>
|
||
</li>
|
||
<li>С помощью файлового менеджера WINE:
|
||
<pre><code> $ winehelper winefile
|
||
0 - Отмена
|
||
1 - Префикс1
|
||
2 - Префикс2
|
||
Выберите префикс (0-2):
|
||
</code></pre>
|
||
<p>В файловом менеджере найти и запустить нужный exe-файл.</p>
|
||
</li>
|
||
</ol>
|
||
|
||
<h3>Дополнительные команды</h3>
|
||
|
||
<pre><code> $ winehelper help
|
||
</code></pre>
|
||
<p>Вывод:</p>
|
||
<pre>
|
||
Использование: winehelper [команда]
|
||
|
||
Команды:
|
||
install list список возможных установочных скриптов
|
||
install [скрипт] запустить скрипт установки программы
|
||
install [скрипт] --clear-pfx не использовать готовый префикс для установки ПО
|
||
|
||
install-dxvk [версия|none|list] установить, удалить или показать версии DXVK
|
||
install-vkd3d [версия|none|list] установить, удалить или показать версии VKD3D
|
||
change-wine [версия] изменить версию Wine/Proton для текущего префикса
|
||
|
||
installed список установленных программ
|
||
run [программа] запуск программы (отладка)
|
||
remove-all удалить WineHelper и все связанные данные
|
||
create-prefix создать префикс
|
||
remove-prefix [имя_префикса] удалить префикс и все связанные данные
|
||
backup-prefix [имя_префикса] создать резервную копию префикса
|
||
restore-prefix \"путь/до/whpack\" восстановить префикс из резервной копии
|
||
|
||
Параметры:
|
||
--help показать эту справку и выйти
|
||
--version показать информацию о пакете и его версии
|
||
--changelog показать историю изменений
|
||
--debug [команда] включить режим логирования работы WINE
|
||
</pre>
|
||
|
||
</details>
|
||
|
||
|
||
<!-- Описание использования GUI -->
|
||
<details>
|
||
<summary style="font-size: 35px; font-weight: bold;">Использование WineHelper (GUI)</summary>
|
||
|
||
<h3>Вкладки «Автоматическая установка» и «Ручная установка»</h3>
|
||
|
||
<p>При использовании графического интерфейса списки приложений расположены во вкладках <b>Автоматическая установка</b> и <b>Ручная установка</b>.</p>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/auto_install.png">
|
||
<p><em>Вкладка "Автоматическая установка"</em></p>
|
||
</div>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/manual_install.png">
|
||
<p><em>Вкладка "Ручная установка"</em></p>
|
||
</div>
|
||
|
||
<p>Для поиска нужной программы введите название в поле поиска.</p>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/search.png">
|
||
<p><em>Поле поиска</em></p>
|
||
</div>
|
||
|
||
<p>При выборе программы из списка слева, в правой части окна отображается подробная информация о ней: описание, иконка и ссылка на официальный сайт.</p>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/info.png">
|
||
<p><em>Информация о выбранной программе</em></p>
|
||
</div>
|
||
|
||
<p>Для установки программы нажмите кнопку <b>Установить</b>.</p>
|
||
|
||
<p>Для <b>ручной установки</b> дополнительно потребуется указать путь к установочному файлу (<code>.exe</code> или <code>.msi</code>), который вы скачали самостоятельно.</p>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/manual_install_1.png">
|
||
<p><em>Вкладка "Ручная установка" с указанием пути к дистрибутиву</em></p>
|
||
</div>
|
||
|
||
<p>После нажатия кнопки <b>Установить</b> появится окно с лицензионным соглашением. После его принятия начнется процесс установки, который будет подробно логироваться в отдельном окне.</p>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/license_agreement.png">
|
||
<p><em>Окно с лицензионным соглашением</em></p>
|
||
</div>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/log.png">
|
||
<p><em>Окно установки с логом</em></p>
|
||
</div>
|
||
|
||
<p>После установки приложения и нажатия кнопки <b>Закрыть</b> в окне установки приложения, ярлык приложения появится в списке установленных приложений во вкладке <b>Установленные</b> а также в меню приложений и на рабочем столе если это разрешено в рабочем окружении.</p>
|
||
|
||
<h3>Вкладка «Установленные»</h3>
|
||
|
||
<p>На этой вкладке отображаются все приложения, которые были установлены с помощью WineHelper.</p>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/installed.png">
|
||
<p><em>Вкладка "Установленные"</em></p>
|
||
</div>
|
||
|
||
<p>При выборе приложения в правой панели становятся доступны следующие действия:</p>
|
||
<ul>
|
||
<li><b>Запустить/Остановить</b>: Запускает или останавливает/закрывает выбранное приложение.</li>
|
||
<li><b>Создать лог запуска программы</b>: Запускает приложение в режиме отладки. После закрытия приложения в вашем домашнем каталоге будет создан файл <code>winehelper.log</code>.</li>
|
||
<li><b>Создать резервную копию префикса</b>: Создает полный бэкап префикса приложения (включая версию Wine) в формате <code>.whpack</code> на вашем рабочем столе если это разрешено в рабочем окружении.</li>
|
||
<li><b>Удалить префикс</b>: Полностью удаляет приложение вместе с его префиксом и всеми связанными ярлыками.</li>
|
||
</ul>
|
||
|
||
<p>Также на этой вкладке доступна кнопка <b>«Восстановить префикс из резервной копии»</b>, которая позволяет восстановить любое приложение из ранее созданного <code>.whpack</code> файла.</p>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/election_installed.png">
|
||
<p><em>Выбранное приложение во вкладке "Установленные"</em></p>
|
||
</div>
|
||
|
||
<p>Расположения лога запуска программы а также резервной копии префикса можно просмотреть с помощью кнопки <b>«Открыть папку с логом/резервной копией префикса»</b> которая появляется автоматически после создания лога или резервной копии.</p>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/folder_log_backup.png">
|
||
<p><em>Кнопка "Открыть папку с логом/резервной копией префикса"</em></p>
|
||
</div>
|
||
|
||
<h3>Вкладка «Менеджер префиксов»</h3>
|
||
|
||
<p>Эта вкладка предоставляет мощные инструменты для управления префиксами Wine.</p>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/prefix_manager.png">
|
||
<p><em>Вкладка "Менеджер префиксов"</em></p>
|
||
</div>
|
||
|
||
<h4>Создание нового префикса</h4>
|
||
|
||
<p>Нажав кнопку <b>«Создать новый префикс»</b>, вы откроете диалог, где можно задать:</p>
|
||
<ul>
|
||
<li><b>Имя префикса</b>.</li>
|
||
<li><b>Разрядность</b> (32-bit или 64-bit).</li>
|
||
<li><b>Наполнение</b> (чистый префикс или с рекомендуемыми библиотеками).</li>
|
||
<li><b>Версию Wine/Proton</b> из доступного списка.</li>
|
||
</ul>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/create_prefix.png">
|
||
<p><em>Диалог создания нового префикса</em></p>
|
||
</div>
|
||
|
||
<h4>Управление существующим префиксом</h4>
|
||
|
||
<p>Выбрав префикс из выпадающего списка, вы получаете доступ к панели управления, которая позволяет:</p>
|
||
|
||
<ul>
|
||
<li><b>Запускать стандартные утилиты Wine</b>:
|
||
<ul>
|
||
<li><code>Редактор настроек (winecfg)</code></li>
|
||
<li><code>Редактор реестра (regedit)</code></li>
|
||
<li><code>Удаление программ (uninstaller)</code></li>
|
||
<li><code>Командная строка (cmd)</code></li>
|
||
<li><code>Файловый менеджер (winefile)</code></li>
|
||
</ul>
|
||
</li>
|
||
<li><b>Управлять компонентами</b>:
|
||
<ul>
|
||
<li><b>Менеджер компонентов (Winetricks)</b>: Удобный интерфейс для установки и переустановки библиотек, шрифтов и настроек.</li>
|
||
<li><b>Управление Wine/Proton</b>: Смена версии Wine или Proton для выбранного префикса.</li>
|
||
<li><b>Управление DXVK/VKD3D</b>: Установка или удаление конкретных версий DXVK и VKD3D.</li>
|
||
<li><b>Ассоциации файлов</b>: Настройка открытия определенных типов файлов (например, <code>.pdf</code>, <code>.docx</code>) нативными приложениями Linux.</li>
|
||
</ul>
|
||
</li>
|
||
<li><b>Включать/выключать ESync и FSync</b>.</li>
|
||
<li><b>Устанавливать приложения</b>: Установить любой <code>.exe</code> или <code>.msi</code> файл напрямую в выбранный префикс.</li>
|
||
<li><b>Создавать ярлыки</b>: Создать ярлык для любого исполняемого файла внутри префикса.</li>
|
||
<li><b>Удалять префикс</b> или <b>создавать из него шаблон</b>.</li>
|
||
</ul>
|
||
|
||
<p>Справа отображается подробная информация о конфигурации выбранного префикса.</p>
|
||
|
||
<h3>Вкладка «Справка»</h3>
|
||
|
||
<p>Содержит полезную информацию о проекте:</p>
|
||
<ul>
|
||
<li><b>Руководство</b>: Ссылка на официальную документацию.</li>
|
||
<li><b>Авторы</b>: Список разработчиков и участников проекта.</li>
|
||
<li><b>Лицензия</b>: Текст лицензии WineHelper и информация о сторонних компонентах.</li>
|
||
<li><b>История изменений</b>: Changelog пакета.</li>
|
||
</ul>
|
||
|
||
<div align="center">
|
||
<img src="image/handbook/help.png">
|
||
<p><em>Вкладка "Справка"</em></p>
|
||
</div>
|
||
|
||
</details>
|
||
|
||
|
||
<h3>Примечание</h3>
|
||
|
||
<blockquote>
|
||
<p><b>[WARNING]</b><br>
|
||
Проект находится на стадии WIP (work in progress)</p>
|
||
</blockquote>
|