forked from CastroFidel/winehelper
Compare commits
9 Commits
dd2901c85e
...
799185a132
| Author | SHA1 | Date | |
|---|---|---|---|
|
799185a132 | ||
|
|
ad775e4644 | ||
|
|
36f5c306c5 | ||
|
|
173a7ae41f | ||
|
|
32e56879f7 | ||
|
|
b88ea9f478 | ||
|
|
dd82cee5ea | ||
|
|
a35efc347d | ||
|
|
95a8d370ab |
363
README.md
363
README.md
@@ -8,28 +8,28 @@
|
||||
<img src="image/handbook/auto_install.png" alt="WineHelper GUI" width="80%">
|
||||
</p>
|
||||
|
||||
## Основные возможности
|
||||
<h2>Основные возможности</h2>
|
||||
|
||||
* **Простая установка**: Устанавливайте Windows-приложения с помощью готовых скриптов, как в автоматическом, так и в ручном режиме.
|
||||
* **Изолированные окружения**: Каждое приложение устанавливается в свой собственный, изолированный префикс, что предотвращает конфликты.
|
||||
* **Управление версиями Wine**: Легко переключайтесь между различными версиями Wine и Proton для достижения наилучшей совместимости.
|
||||
* **Графический и консольный интерфейсы**: Используйте удобный GUI для повседневных задач или мощный CLI для автоматизации.
|
||||
* **Резервное копирование**: Создавайте и восстанавливайте полные резервные копии ваших префиксов.
|
||||
* **Встроенные утилиты**: Быстрый доступ к `winecfg`, `regedit`, `Winetricks` и другим инструментам для каждого префикса.
|
||||
|
||||
---
|
||||
<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>
|
||||
|
||||
```
|
||||
$ su -
|
||||
<pre><code> $ su -
|
||||
# apt-get update && apt-get dist-upgrade
|
||||
# apt-get install winehelper
|
||||
# exit
|
||||
```
|
||||
</code></pre>
|
||||
</details>
|
||||
|
||||
|
||||
@@ -37,160 +37,162 @@
|
||||
<details>
|
||||
<summary style="font-size: 35px; font-weight: bold;">Использование WineHelper (CLI)</summary>
|
||||
|
||||
### Список приложений для установки
|
||||
<h3>Список приложений для установки</h3>
|
||||
|
||||
Вывод списка приложений, доступных к установке:
|
||||
```
|
||||
$ winehelper install list
|
||||
```
|
||||
или сокращенная команда:
|
||||
```
|
||||
$ winehelper -i
|
||||
```
|
||||
<p>Вывод списка приложений, доступных к установке:</p>
|
||||
<pre><code> $ winehelper install list
|
||||
</code></pre>
|
||||
<p>или сокращенная команда:</p>
|
||||
<pre><code> $ winehelper -i
|
||||
</code></pre>
|
||||
|
||||
### Запуск установки приложений
|
||||
<h3>Запуск установки приложений</h3>
|
||||
|
||||
Скрипты установки разделены на два типа:
|
||||
<p>Скрипты установки разделены на два типа:</p>
|
||||
|
||||
1. **Список программ с возможностью автоматической установки** — содержит полностью автоматизированные скрипты установок программ у которыx есть дистрибутивы (установщики) в свободном доступе.
|
||||
<ol>
|
||||
<li><b>Список программ с возможностью автоматической установки</b> — содержит полностью автоматизированные скрипты установок программ у которыx есть дистрибутивы (установщики) в свободном доступе.
|
||||
Процесс полностью автоматизирован.
|
||||
Пример:
|
||||
```
|
||||
$ winehelper install spravki-bk
|
||||
```
|
||||
<pre><code> $ winehelper install spravki-bk
|
||||
</code></pre>
|
||||
или сокращенная команда:
|
||||
```
|
||||
$ winehelper -i spravki-bk
|
||||
```
|
||||
2. **Список программ с возможностью установки из существующего дистрибутива** — содержит скрипты установок для программ, которых нет в свободном доступе.
|
||||
<pre><code> $ winehelper -i spravki-bk
|
||||
</code></pre>
|
||||
</li>
|
||||
<li><b>Список программ с возможностью установки из существующего дистрибутива</b> — содержит скрипты установок для программ, которых нет в свободном доступе.
|
||||
Пример:
|
||||
```
|
||||
$ winehelper install is-record-station "/путь/до/установочного_файла"
|
||||
```
|
||||
<pre><code> $ winehelper install is-record-station "/путь/до/установочного_файла"
|
||||
</code></pre>
|
||||
или сокращенная команда:
|
||||
```
|
||||
$ winehelper -i is-record-station "/путь/до/установочного_файла"
|
||||
```
|
||||
<pre><code> $ winehelper -i is-record-station "/путь/до/установочного_файла"
|
||||
</code></pre>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
### Процесс установки приложений
|
||||
<h3>Процесс установки приложений</h3>
|
||||
|
||||
При первом запуске **WineHelper** проверяются и при необходимости устанавливаются дополнительные зависимости (запрашиваются права root).
|
||||
<p>При первом запуске <b>WineHelper</b> проверяются и при необходимости устанавливаются дополнительные зависимости (запрашиваются права root).</p>
|
||||
|
||||
Процесс установки приложений:
|
||||
1. Отображаются лицензионные соглашения на сторонние компоненты. Для продолжения введите **y** и нажмите **Enter**.
|
||||
2. Далее процесс проходит автоматически с подробным выводом в терминал:
|
||||
- Загрузка и проверка хэш-суммы нужной версии Wine.
|
||||
- Загрузка и проверка хэш-суммы базового префикса.
|
||||
- Инициализация и подготовка префикса.
|
||||
- Скачивание дистрибутива (установщика) программы с официального сайта (если применимо).
|
||||
- Установка приложения.
|
||||
- Создание .desktop-файла (ярлыка) на рабочем столе и в меню приложений.
|
||||
<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>
|
||||
|
||||
Для удаления префикса выполните команду:
|
||||
```
|
||||
$ winehelper remove-prefix [имя_префикса]
|
||||
```
|
||||
Если имя префикса не указано, будет выведен список существующих префиксов:
|
||||
```
|
||||
0 - Отмена
|
||||
<p>Для удаления префикса выполните команду:</p>
|
||||
<pre><code> $ winehelper remove-prefix [имя_префикса]
|
||||
</code></pre>
|
||||
<p>Если имя префикса не указано, будет выведен список существующих префиксов:</p>
|
||||
<pre><code> 0 - Отмена
|
||||
1 - Префикс1
|
||||
2 - Префикс2
|
||||
Выберите префикс (0-2):
|
||||
```
|
||||
Необходимо указать номер удаляемого префикса и нажать клавишу **Enter**.Далее потребуется подтвердить удаление префикса вводом **y**.
|
||||
</code></pre>
|
||||
<p>Необходимо указать номер удаляемого префикса и нажать клавишу <b>Enter</b>.Далее потребуется подтвердить удаление префикса вводом <b>y</b>.</p>
|
||||
|
||||
В результате будут удалены:
|
||||
- сам префикс;
|
||||
- установленное ПО;
|
||||
- desktop-файлы (ярлыки для установленного ПО в префиксе).
|
||||
<p>В результате будут удалены:</p>
|
||||
<ul>
|
||||
<li>сам префикс;</li>
|
||||
<li>установленное ПО;</li>
|
||||
<li>desktop-файлы (ярлыки для установленного ПО в префиксе).</li>
|
||||
</ul>
|
||||
|
||||
###
|
||||
<h3>Резервное копирование префикса</h3>
|
||||
|
||||
Команда создания резервной копии префикса:
|
||||
```
|
||||
$ winehelper backup-prefix [имя_префикса]
|
||||
```
|
||||
Если имя префикса не указано, будет выведен список существующих префиксов:
|
||||
```
|
||||
0 - Отмена
|
||||
<p>Команда создания резервной копии префикса:</p>
|
||||
<pre><code> $ winehelper backup-prefix [имя_префикса]
|
||||
</code></pre>
|
||||
<p>Если имя префикса не указано, будет выведен список существующих префиксов:</p>
|
||||
<pre><code> 0 - Отмена
|
||||
1 - Префикс1
|
||||
2 - Префикс2
|
||||
Выберите префикс (0-2):
|
||||
```
|
||||
Необходимо указать номер удаляемого префикса и нажать клавишу **Enter**.
|
||||
После выбора префикса автоматически:
|
||||
- Создаётся копия префикса.
|
||||
- Внутри префикса сохраняется используемая версия WINE.
|
||||
- Копируются иконки для ярлыков (.desktop-файлов).
|
||||
- Сохраняется информация о ярлыках (.desktop-файлах) для будущей распаковки/восстановления префикса.
|
||||
- Резервная копия сохраняется на рабочем столе с именем: {{path|backup_имя_префикса_дата_создания.whpack}}
|
||||
</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>
|
||||
|
||||
Команда восстановления префикса из резервной копии:
|
||||
```
|
||||
$ winehelper restore-prefix "путь/до/файла.whpack"
|
||||
```
|
||||
Восстановление префикса не требует подключение к интернету и происходит в автоматическом режиме:
|
||||
- Распаковка префикса.
|
||||
- Восстановление версии WINE.
|
||||
- Восстановление ярлыков (.desktop-файdлов).
|
||||
<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>
|
||||
|
||||
### Использование команд WINE в WineHelper
|
||||
<h3>Использование команд WINE в WineHelper</h3>
|
||||
|
||||
WineHelper предоставляет доступ к основным инструментам WINE:
|
||||
```
|
||||
winehelper winefile # запуск файлового менеджера wine
|
||||
<p>WineHelper предоставляет доступ к основным инструментам WINE:</p>
|
||||
<pre><code> winehelper winefile # запуск файлового менеджера wine
|
||||
winehelper winecfg # запуск wine конфигуратора для префикса
|
||||
winehelper winereg # запуск редактора реестра для префикса
|
||||
winehelper wineconsole # запуск терминала wine (cmd.exe)
|
||||
winehelper winetricks # запуск графического интерфейса winetricks
|
||||
winehelper winetricks [компонент] # автоматическая установка дополнительного компонента в префикс
|
||||
```
|
||||
После выполнения любой из вышеперечисленных команд отображается список существующих префиксов:
|
||||
```
|
||||
0 - Отмена
|
||||
</code></pre>
|
||||
<p>После выполнения любой из вышеперечисленных команд отображается список существующих префиксов:</p>
|
||||
<pre><code>0 - Отмена
|
||||
1 - Префикс1
|
||||
2 - Префикс2
|
||||
Выберите префикс (0-2):
|
||||
```
|
||||
Команда выполняется в выбранном вами префиксе.
|
||||
</code></pre>
|
||||
<p>Команда выполняется в выбранном вами префиксе.</p>
|
||||
|
||||
### Запуск стороннего *.exe файла в WineHelper
|
||||
<h3>Запуск стороннего *.exe файла в WineHelper</h3>
|
||||
|
||||
Есть два варианта:
|
||||
1. В командной строке выполнить команду:
|
||||
```
|
||||
$ winehelper "путь/до/файла.exe"
|
||||
<p>Есть два варианта:</p>
|
||||
<ol>
|
||||
<li>В командной строке выполнить команду:
|
||||
<pre><code> $ winehelper "путь/до/файла.exe"
|
||||
0 - Отмена
|
||||
1 - Префикс1
|
||||
2 - Префикс2
|
||||
Выберите префикс (0-2):
|
||||
```
|
||||
Файл будет запущен в выбранном префиксе.
|
||||
|
||||
2. С помощью файлового менеджера WINE:'''
|
||||
```
|
||||
$ winehelper winefile
|
||||
</code></pre>
|
||||
<p>Файл будет запущен в выбранном префиксе.</p>
|
||||
</li>
|
||||
<li>С помощью файлового менеджера WINE:
|
||||
<pre><code> $ winehelper winefile
|
||||
0 - Отмена
|
||||
1 - Префикс1
|
||||
2 - Префикс2
|
||||
Выберите префикс (0-2):
|
||||
```
|
||||
В файловом менеджере найти и запустить нужный exe-файл.
|
||||
</code></pre>
|
||||
<p>В файловом менеджере найти и запустить нужный exe-файл.</p>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
### Дополнительные команды
|
||||
<h3>Дополнительные команды</h3>
|
||||
|
||||
```
|
||||
$ winehelper help
|
||||
```
|
||||
Вывод:
|
||||
<pre><code> $ winehelper help
|
||||
</code></pre>
|
||||
<p>Вывод:</p>
|
||||
<pre>
|
||||
Использование: winehelper [команда]
|
||||
|
||||
@@ -225,9 +227,9 @@ WineHelper предоставляет доступ к основным инст
|
||||
<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">
|
||||
@@ -239,30 +241,30 @@ WineHelper предоставляет доступ к основным инст
|
||||
<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>
|
||||
|
||||
Для **ручной установки** дополнительно потребуется указать путь к установочному файлу (`.exe` или `.msi`), который вы скачали самостоятельно.
|
||||
<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">
|
||||
@@ -271,84 +273,105 @@ WineHelper предоставляет доступ к основным инст
|
||||
|
||||
<div align="center">
|
||||
<img src="image/handbook/log.png">
|
||||
<p><em>Окно установки с логом</em></м</em></p>
|
||||
<p><em>Окно установки с логом</em></p>
|
||||
</div>
|
||||
|
||||
После установки приложения и нажатия кнопки **Закрыть** в окне установки приложения, ярлык приложения появится в списке установленных приложений во вкладке **Установленные** а также в меню приложений и на рабочем столе если это разрешено в рабочем окружении.
|
||||
<p>После установки приложения и нажатия кнопки <b>Закрыть</b> в окне установки приложения, ярлык приложения появится в списке установленных приложений во вкладке <b>Установленные</b> а также в меню приложений и на рабочем столе если это разрешено в рабочем окружении.</p>
|
||||
|
||||
### Вкладка «Установленные»
|
||||
<h3>Вкладка «Установленные»</h3>
|
||||
|
||||
На этой вкладке отображаются все приложения, которые были установлены с помощью WineHelper.
|
||||
<p>На этой вкладке отображаются все приложения, которые были установлены с помощью WineHelper.</p>
|
||||
|
||||
<div align="center">
|
||||
<img src="image/handbook/installed.png">
|
||||
<p><em>Вкладка "Установленные"</em></p>
|
||||
</div>
|
||||
|
||||
При выборе приложения в правой панели становятся доступны следующие действия:
|
||||
* **Запустить/Остановить**: Запускает или останавливает/закрывает выбранное приложение.
|
||||
* **Создать лог запуска программы**: Запускает приложение в режиме отладки. После закрытия приложения в вашем домашнем каталоге будет создан файл `winehelper.log`.
|
||||
* **Создать резервную копию префикса**: Создает полный бэкап префикса приложения (включая версию Wine) в формате `.whpack` на вашем рабочем столе если это разрешено в рабочем окружении.
|
||||
* **Удалить префикс**: Полностью удаляет приложение вместе с его префиксом и всеми связанными ярлыками.
|
||||
<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>
|
||||
|
||||
Также на этой вкладке доступна кнопка **«Восстановить префикс из резервной копии»**, которая позволяет восстановить любое приложение из ранее созданного `.whpack` файла.
|
||||
<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>
|
||||
|
||||
Эта вкладка предоставляет мощные инструменты для управления префиксами Wine.
|
||||
<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>
|
||||
|
||||
Нажав кнопку **«Создать новый префикс»**, вы откроете диалог, где можно задать:
|
||||
* **Имя префикса**.
|
||||
* **Разрядность** (32-bit или 64-bit).
|
||||
* **Наполнение** (чистый префикс или с рекомендуемыми библиотеками).
|
||||
* **Версию Wine/Proton** из доступного списка.
|
||||
<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>
|
||||
|
||||
* **Запускать стандартные утилиты Wine**:
|
||||
* `Редактор настроек (winecfg)`
|
||||
* `Редактор реестра (regedit)`
|
||||
* `Удаление программ (uninstaller)`
|
||||
* `Командная строка (cmd)`
|
||||
* `Файловый менеджер (winefile)`
|
||||
* **Управлять компонентами**:
|
||||
* **Менеджер компонентов (Winetricks)**: Удобный интерфейс для установки и переустановки библиотек, шрифтов и настроек.
|
||||
* **Управление Wine/Proton**: Смена версии Wine или Proton для выбранного префикса.
|
||||
* **Управление DXVK/VKD3D**: Установка или удаление конкретных версий DXVK и VKD3D.
|
||||
* **Ассоциации файлов**: Настройка открытия определенных типов файлов (например, `.pdf`, `.docx`) нативными приложениями Linux.
|
||||
* **Включать/выключать ESync и FSync**.
|
||||
* **Устанавливать приложения**: Установить любой `.exe` или `.msi` файл напрямую в выбранный префикс.
|
||||
* **Создавать ярлыки**: Создать ярлык для любого исполняемого файла внутри префикса.
|
||||
* **Удалять префикс** или **создавать из него шаблон**.
|
||||
<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>
|
||||
|
||||
Содержит полезную информацию о проекте:
|
||||
* **Руководство**: Ссылка на официальную документацию.
|
||||
* **Авторы**: Список разработчиков и участников проекта.
|
||||
* **Лицензия**: Текст лицензии WineHelper и информация о сторонних компонентах.
|
||||
* **История изменений**: Changelog пакета.
|
||||
<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">
|
||||
@@ -358,7 +381,9 @@ WineHelper предоставляет доступ к основным инст
|
||||
</details>
|
||||
|
||||
|
||||
### Примечание
|
||||
<h3>Примечание</h3>
|
||||
|
||||
> [!WARNING]
|
||||
> Проект находится на стадии WIP (work in progress)
|
||||
<blockquote>
|
||||
<p><b>[WARNING]</b><br>
|
||||
Проект находится на стадии WIP (work in progress)</p>
|
||||
</blockquote>
|
||||
|
||||
BIN
image/handbook/folder_log_backup.png
Normal file
BIN
image/handbook/folder_log_backup.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 111 KiB |
@@ -102,7 +102,9 @@ else
|
||||
fi
|
||||
|
||||
if [[ $WINEDEBUG != "-all" ]] ; then
|
||||
export LOG_FILE="$HOME/winehelper.log"
|
||||
log_dir="$HOME/winehelper_backup_log"
|
||||
mkdir -p "$log_dir"
|
||||
export LOG_FILE="$log_dir/winehelper.log"
|
||||
date > "$LOG_FILE"
|
||||
print_warning "Включен режим логирования работы WINE."
|
||||
print_warning "Лог будет сохранен по пути: $LOG_FILE"
|
||||
@@ -1773,6 +1775,7 @@ remove_winehelper () {
|
||||
echo " - Все настройки WineHelper"
|
||||
echo " - Все приложения/программы, установленные через WineHelper"
|
||||
echo " - Все ярлыки из меню и с рабочего стола, созданные с помощью WineHelper"
|
||||
echo " - Все резервные копии и логи, созданные WineHelper"
|
||||
echo "======================================================"
|
||||
if print_confirmation "Продолжить?" ; then
|
||||
echo "----------------------------------------------"
|
||||
@@ -1788,6 +1791,7 @@ remove_winehelper () {
|
||||
|
||||
# Удаление рабочих каталогов
|
||||
try_remove_dir "$USER_WORK_PATH"
|
||||
try_remove_dir "$HOME/winehelper_backup_log"
|
||||
|
||||
# Удаление файлов меню
|
||||
try_remove_dir "$WH_MENU_DIR"
|
||||
@@ -1866,7 +1870,8 @@ backup_prefix() {
|
||||
check_prefix_var
|
||||
|
||||
local backup_base_dir backup_archive_name backup_dest_path temp_backup_dir temp_prefix_dir temp_users_dir
|
||||
backup_base_dir="$(xdg-user-dir DESKTOP)"
|
||||
backup_base_dir="$HOME/winehelper_backup_log"
|
||||
create_new_dir "$backup_base_dir"
|
||||
backup_archive_name="backup_${PREFIX_NAME}_$(date +%d.%m.%Y-%H.%M.%S).whpack"
|
||||
backup_dest_path="$backup_base_dir/$backup_archive_name"
|
||||
temp_backup_dir="$WH_TMP_DIR/backup_${PREFIX_NAME}_$(date +%d.%m.%Y-%H.%M.%S)"
|
||||
|
||||
@@ -1762,6 +1762,7 @@ class WineHelperGUI(QMainWindow):
|
||||
if show_global:
|
||||
self.backup_button.setVisible(False)
|
||||
self.create_log_button.setVisible(False)
|
||||
self.open_log_dir_button.setVisible(False)
|
||||
self.uninstall_button.setVisible(False)
|
||||
self.current_selected_app = None
|
||||
|
||||
@@ -1877,6 +1878,12 @@ class WineHelperGUI(QMainWindow):
|
||||
self.backup_button.clicked.connect(self.backup_prefix_for_app)
|
||||
installed_global_layout.addWidget(self.backup_button)
|
||||
|
||||
self.open_log_dir_button = QPushButton("Открыть папку с логом/резервной копией префикса")
|
||||
self.open_log_dir_button.setIcon(QIcon.fromTheme("folder-open"))
|
||||
self.open_log_dir_button.clicked.connect(self.open_log_directory)
|
||||
self.open_log_dir_button.setVisible(False) # Скрыта по умолчанию
|
||||
installed_global_layout.addWidget(self.open_log_dir_button)
|
||||
|
||||
self.uninstall_button = QPushButton("Удалить префикс")
|
||||
self.uninstall_button.setIcon(QIcon.fromTheme("user-trash"))
|
||||
self.uninstall_button.clicked.connect(self.uninstall_app)
|
||||
@@ -2316,6 +2323,24 @@ class WineHelperGUI(QMainWindow):
|
||||
management_layout.setColumnStretch(2, 2)
|
||||
|
||||
container_layout.addWidget(self.prefix_management_groupbox)
|
||||
|
||||
# --- Кнопка полного удаления ---
|
||||
# Добавляем разделитель и кнопку в основной контейнер управления
|
||||
container_layout.addSpacing(15)
|
||||
self.remove_all_button = QPushButton("Удалить все данные WineHelper")
|
||||
self.remove_all_button.setStyleSheet("""
|
||||
QPushButton:!disabled {
|
||||
background-color: #d32f2f;
|
||||
color: white;
|
||||
padding: 5px;
|
||||
}
|
||||
""")
|
||||
self.remove_all_button.setMinimumHeight(32)
|
||||
self.remove_all_button.setFont(QFont('Arial', 10, QFont.Bold))
|
||||
self.remove_all_button.setToolTip("ВНИМАНИЕ: Удаляет ВСЕ данные WineHelper, включая все префиксы, настройки и ярлыки.")
|
||||
self.remove_all_button.clicked.connect(self.remove_all_data)
|
||||
container_layout.addWidget(self.remove_all_button)
|
||||
|
||||
layout.addWidget(self.management_container_groupbox)
|
||||
layout.addStretch()
|
||||
self.add_tab(self.prefix_tab, "Менеджер префиксов")
|
||||
@@ -2357,6 +2382,7 @@ class WineHelperGUI(QMainWindow):
|
||||
prefix_names = []
|
||||
|
||||
self.created_prefix_selector.blockSignals(True)
|
||||
self.remove_all_button.setEnabled(bool(prefix_names))
|
||||
self.created_prefix_selector.clear()
|
||||
if prefix_names:
|
||||
self.created_prefix_selector.addItems(prefix_names)
|
||||
@@ -2372,6 +2398,7 @@ class WineHelperGUI(QMainWindow):
|
||||
self.current_managed_prefix_name = None
|
||||
self._setup_prefix_management_panel(None)
|
||||
self.delete_prefix_button.setEnabled(False)
|
||||
self.remove_all_button.setEnabled(False)
|
||||
self.create_base_pfx_button.setEnabled(False)
|
||||
else:
|
||||
# Прокручиваем к выбранному элементу, чтобы он был виден в списке
|
||||
@@ -2382,6 +2409,7 @@ class WineHelperGUI(QMainWindow):
|
||||
self.current_managed_prefix_name = prefix_name
|
||||
self._setup_prefix_management_panel(prefix_name)
|
||||
self.delete_prefix_button.setEnabled(True)
|
||||
self.remove_all_button.setEnabled(True)
|
||||
self.create_base_pfx_button.setEnabled(True)
|
||||
|
||||
def delete_selected_prefix(self):
|
||||
@@ -3378,6 +3406,7 @@ class WineHelperGUI(QMainWindow):
|
||||
self.installed_global_action_widget.setVisible(True)
|
||||
self.backup_button.setVisible(True)
|
||||
self.create_log_button.setVisible(True)
|
||||
self.update_open_log_dir_button_visibility()
|
||||
self.uninstall_button.setVisible(True)
|
||||
self.manual_install_path_widget.setVisible(False)
|
||||
|
||||
@@ -3386,6 +3415,27 @@ class WineHelperGUI(QMainWindow):
|
||||
self.current_selected_app = None
|
||||
self.info_panel.setVisible(False)
|
||||
|
||||
def update_open_log_dir_button_visibility(self):
|
||||
"""Проверяет наличие лог-файла или бэкапов и обновляет видимость кнопки."""
|
||||
log_dir_path = os.path.join(os.path.expanduser("~"), "winehelper_backup_log")
|
||||
is_visible = False
|
||||
if os.path.isdir(log_dir_path):
|
||||
# Кнопка должна быть видна, если директория не пуста.
|
||||
if os.listdir(log_dir_path):
|
||||
is_visible = True
|
||||
self.open_log_dir_button.setVisible(is_visible)
|
||||
|
||||
def open_log_directory(self):
|
||||
"""Открывает директорию с лог-файлами."""
|
||||
log_dir_path = os.path.join(os.path.expanduser("~"), "winehelper_backup_log")
|
||||
if os.path.isdir(log_dir_path):
|
||||
try:
|
||||
subprocess.Popen(['xdg-open', log_dir_path])
|
||||
except Exception as e:
|
||||
QMessageBox.warning(self, "Ошибка", f"Не удалось открыть директорию:\n{log_dir_path}\n\nОшибка: {e}")
|
||||
else:
|
||||
QMessageBox.information(self, "Информация", f"Директория с логами не найдена:\n{log_dir_path}")
|
||||
|
||||
def _get_prefix_name_for_selected_app(self):
|
||||
"""Извлекает имя префикса для выбранного приложения."""
|
||||
if not self.current_selected_app or 'desktop_path' not in self.current_selected_app:
|
||||
@@ -3426,8 +3476,8 @@ class WineHelperGUI(QMainWindow):
|
||||
msg_box = QMessageBox(self)
|
||||
msg_box.setWindowTitle("Создание резервной копии")
|
||||
msg_box.setText(
|
||||
f"Будет создана резервная копия префикса '{prefix_name}'.\n"
|
||||
f"Файл будет сохранен на вашем Рабочем столе в формате .whpack.\n\nПродолжить?"
|
||||
f"Будет создана резервная копия префикса '{prefix_name}'.\n\n"
|
||||
f"Файл будет сохранен в домашней директории в папке winehelper_backup_log/ в формате .whpack.\n\nПродолжить?"
|
||||
)
|
||||
msg_box.addButton(yes_button, QMessageBox.YesRole)
|
||||
msg_box.addButton(no_button, QMessageBox.NoRole)
|
||||
@@ -3460,6 +3510,7 @@ class WineHelperGUI(QMainWindow):
|
||||
self.command_process.setProcessChannelMode(QProcess.MergedChannels)
|
||||
self.command_process.readyReadStandardOutput.connect(self._handle_command_output)
|
||||
self.command_process.finished.connect(self._handle_command_finished)
|
||||
self.command_process.finished.connect(self.update_open_log_dir_button_visibility)
|
||||
|
||||
winehelper_path = self.winehelper_path
|
||||
args = ["backup-prefix", prefix_name]
|
||||
@@ -3525,9 +3576,9 @@ class WineHelperGUI(QMainWindow):
|
||||
msg_box = QMessageBox(self)
|
||||
msg_box.setWindowTitle("Создание лога")
|
||||
msg_box.setText(
|
||||
"Приложение будет запущено в режиме отладки.\n"
|
||||
"После закрытия приложения лог будет сохранен в вашем домашнем каталоге "
|
||||
"под именем 'winehelper.log'."
|
||||
"Приложение будет запущено в режиме отладки.\n\n"
|
||||
"После закрытия приложения лог будет сохранен в папке 'winehelper_backup_log' "
|
||||
"в вашем домашнем каталоге под именем 'winehelper.log'."
|
||||
)
|
||||
msg_box.addButton(yes_button, QMessageBox.YesRole)
|
||||
msg_box.addButton(no_button, QMessageBox.NoRole)
|
||||
@@ -3793,6 +3844,7 @@ class WineHelperGUI(QMainWindow):
|
||||
# и избегания проблем с замыканием в lambda.
|
||||
process.finished.connect(partial(self._on_app_process_finished, desktop_path))
|
||||
|
||||
process.finished.connect(self.update_open_log_dir_button_visibility)
|
||||
|
||||
try:
|
||||
process.start(program, arguments)
|
||||
@@ -3811,6 +3863,55 @@ class WineHelperGUI(QMainWindow):
|
||||
QMessageBox.critical(self, "Ошибка",
|
||||
f"Не удалось обработать команду запуска:\n{command_str}\n\nОшибка: {str(e)}")
|
||||
|
||||
def remove_all_data(self):
|
||||
"""Запускает процесс полного удаления всех данных WineHelper."""
|
||||
# Первое подтверждение
|
||||
msg_box1 = QMessageBox(self)
|
||||
msg_box1.setIcon(QMessageBox.Critical)
|
||||
msg_box1.setWindowTitle('Подтверждение полного удаления')
|
||||
msg_box1.setText(
|
||||
"<h2>ВНИМАНИЕ!</h2>"
|
||||
"<p>Это действие полностью и безвозвратно удалит <b>ВСЕ</b> данные, связанные с WineHelper, включая:</p>"
|
||||
"<ul>"
|
||||
"<li>Все созданные префиксы и установленные в них программы.</li>"
|
||||
"<li>Все ярлыки в меню и на рабочем столе.</li>"
|
||||
"<li>Все настройки, кэш и резервные копии.</li>"
|
||||
"</ul>"
|
||||
"<p>Продолжить?</p>"
|
||||
)
|
||||
msg_box1.setTextFormat(Qt.RichText)
|
||||
yes_button1 = msg_box1.addButton("Да, я понимаю", QMessageBox.YesRole)
|
||||
no_button1 = msg_box1.addButton("Отмена", QMessageBox.NoRole)
|
||||
msg_box1.setDefaultButton(no_button1)
|
||||
msg_box1.exec_()
|
||||
|
||||
if msg_box1.clickedButton() != yes_button1:
|
||||
return
|
||||
|
||||
# Второе, финальное подтверждение
|
||||
msg_box2 = QMessageBox(self)
|
||||
msg_box2.setIcon(QMessageBox.Critical)
|
||||
msg_box2.setWindowTitle('Последнее предупреждение')
|
||||
msg_box2.setText("<h3>Вы уверены, что хотите удалить ВСЁ?</h3><p>Это действие необратимо.</p>")
|
||||
msg_box2.setTextFormat(Qt.RichText)
|
||||
yes_button2 = msg_box2.addButton("Да, удалить всё", QMessageBox.DestructiveRole)
|
||||
no_button2 = msg_box2.addButton("Нет, я передумал", QMessageBox.RejectRole)
|
||||
msg_box2.setDefaultButton(no_button2)
|
||||
msg_box2.exec_()
|
||||
|
||||
if msg_box2.clickedButton() != yes_button2:
|
||||
return
|
||||
|
||||
# Запускаем команду и выходим из приложения
|
||||
try:
|
||||
# Запускаем команду в фоне и не ждем ее завершения
|
||||
subprocess.Popen([self.winehelper_path, "remove-all", "--force"])
|
||||
# Сообщаем пользователю и закрываем GUI
|
||||
QMessageBox.information(self, "Удаление", "Запущена процедура удаления WineHelper. Приложение будет закрыто.")
|
||||
self.quit_application()
|
||||
except Exception as e:
|
||||
QMessageBox.critical(self, "Ошибка", f"Не удалось запустить команду удаления: {e}")
|
||||
|
||||
def quit_application(self):
|
||||
"""Инициирует процесс выхода из приложения."""
|
||||
self.is_quitting = True
|
||||
|
||||
Reference in New Issue
Block a user