forked from CastroFidel/winehelper
Compare commits
4 Commits
Author | SHA1 | Date | |
---|---|---|---|
6f50e5e0cf | |||
a58c477e32 | |||
61c1d81192 | |||
19fdd64d1f |
163
README.md
Normal file
163
README.md
Normal file
@ -0,0 +1,163 @@
|
||||
<div align="center">
|
||||
<h1 align="center">WineHelper</h1>
|
||||
<p align="center">WineHelper - предназначен для упрощения установки windows-приложений, с помощью подготовленных скриптов, в разные префиксы и используя портативные версии wine для максимальной повторяемости на различных системах, начиная с релиза p10 Alt Linux и выше.</p>
|
||||
</div>
|
||||
|
||||
## Установка
|
||||
|
||||
```
|
||||
su -
|
||||
apt-get update && apt-get dist-upgrade
|
||||
apt-get install winehelper
|
||||
exit
|
||||
```
|
||||
|
||||
## Использование WineHelper
|
||||
### Список приложений для установки
|
||||
|
||||
Для вывода списка доступных к установке приложений:
|
||||
|
||||
```
|
||||
winehelper install list
|
||||
```
|
||||
|
||||
либо использовать сокращенную команду:
|
||||
|
||||
```
|
||||
winehelper -i
|
||||
```
|
||||
|
||||
### Запуск установки приложений
|
||||
В списках есть 2 вида установщиков:
|
||||
|
||||
**Список программ с возможностью автоматической установки** - содержит полностью автоматизированные скрипты установок программ у которых есть дистрибутивы (установщики) в свободном доступе.
|
||||
|
||||
Пример:
|
||||
|
||||
```
|
||||
winehelper install spravki-bk
|
||||
```
|
||||
|
||||
либо использовать сокращенную команду:
|
||||
|
||||
```
|
||||
winehelper -i spravki-bk
|
||||
```
|
||||
|
||||
**Список программ с возможностью установки из существующего дистрибутива** - содержит скрипты установок для программ которых нет в свободном доступе.
|
||||
|
||||
Пример:
|
||||
|
||||
```sh
|
||||
winehelper install is-record-station "/путь/до/установочного_файла"
|
||||
```
|
||||
|
||||
либо использовать сокращенную команду:
|
||||
|
||||
```sh
|
||||
winehelper -i is-record-station "/путь/до/установочного_файла"
|
||||
```
|
||||
|
||||
### Процесс установки приложений
|
||||
|
||||
1. при первом запуске winehelper произойдет проверка на дополнительные зависимости и при необходимости будет запрос ввода root пароля для установки пакетов
|
||||
2. далее будет предложено принять лицензионные соглашения использования сторонних компонентов, для продолжения нажмите любую клавишу на клавиатуре
|
||||
3. на данном этапе, в большей части скриптов, всё устанавливается автоматически с подробным выводом информации в терминале:
|
||||
- загрузка необходимой версии wine, с последующей проверкой хэш-суммы
|
||||
- загрузка базового префикса, с последующей проверкой хэш-суммы
|
||||
- первичные обновление и подготовка префикса
|
||||
- скачивание дистрибутива (установщика) программы с официального сайта
|
||||
- установка программы
|
||||
- создание desktop файла (ярлыка) на рабочем столе и в меню
|
||||
|
||||
Если устанавливаемое приложение требует дополнительных действий от пользователя, об этом будет явно написано в терминале.
|
||||
|
||||
### Процесс удаления префикса с приложением
|
||||
Выполняем команду:
|
||||
|
||||
```sh
|
||||
winehelper remove-prefix
|
||||
```
|
||||
|
||||
и видим список префиксов доступных для удаления, например:
|
||||
|
||||
```sh
|
||||
winehelper remove-prefix spravki-bk
|
||||
```
|
||||
|
||||
после подтверждения клавишей "y" полностью удалит префикс с ПО и desktop файлы (ярлыки)
|
||||
|
||||
### Процесс удаления WineHelper
|
||||
Выполняем команду:
|
||||
|
||||
```sh
|
||||
winehelper remove-all
|
||||
```
|
||||
|
||||
после подтверждения клавишей "y" данная команда удалить WineHelper и все связанные данные (префиксы, ярлыки, wine, прогаммы установленные с помощью WineHelper)
|
||||
|
||||
### Процесс создания резервной копии префикса
|
||||
Выполняем команду:
|
||||
|
||||
```sh
|
||||
winehelper backup-prefix "имя префикса"
|
||||
```
|
||||
|
||||
команда создаст резервную копию префикса на рабочем столе в виде архива backup_имя_префикса_год.месяц.цисло.whpack
|
||||
|
||||
### Процесс восстановления резервной копии префикса
|
||||
Выполняем команду:
|
||||
|
||||
```sh
|
||||
winehelper restore-prefix "/путь/к/архиву.whpack"
|
||||
```
|
||||
|
||||
команда восстановит префикс из резервной копии а также desktop файлы и фалы меню
|
||||
|
||||
|
||||
### Дополнительные команды
|
||||
|
||||
```sh
|
||||
winehelper help
|
||||
```
|
||||
|
||||
Вывод:
|
||||
<pre>
|
||||
Использование: $SCRIPT_NAME [команда]
|
||||
|
||||
Команды:
|
||||
install list список возможных установочных скриптов
|
||||
install [скрипт] запустить скрипт установки программы
|
||||
install [скрипт] --clear-pfx не использовать подготовленный префикс для установки ПО
|
||||
|
||||
installed список установленных программ
|
||||
run [программа.exe] запуск программы (отладка)
|
||||
remove-all удалить WineHelper и все связанные данные
|
||||
remove-prefix [имя_префикса] удалить префикс и все связанные данные
|
||||
backup-prefix [имя_префикса] создать резервную копию префикса
|
||||
restore-prefix [имя_префикса] восстановить префикс из резервной копии
|
||||
|
||||
Параметры:
|
||||
--help показать эту справку и выйти
|
||||
--version показать информацию о пакете и его версии
|
||||
--debug [команда] включить режим логирования работы WINE
|
||||
</pre>
|
||||
|
||||
## 🛠 Участие в разработке
|
||||
|
||||
Мы рады вашим Pull Request'ам! Вот как можно помочь:
|
||||
|
||||
1. **Сообщить о баге или предложить улучшение**
|
||||
Откройте [Задачи](https://git.linux-gaming.ru/CastroFidel/winehelper/issues), опишите проблему или идею.
|
||||
|
||||
2. **Исправить баг или добавить функционал**
|
||||
- Форкните репозиторий
|
||||
- Создайте ветку (`git checkout -b feature/ваша-фича`)
|
||||
- Закоммитьте изменения (`git commit -m 'Добавил ...'`)
|
||||
- Запушьте в форк (`git push origin feature/ваша-фича`)
|
||||
- Откройте Pull Request
|
||||
|
||||
3. **Помощь с документацией**
|
||||
Исправления в документации тоже приветствуются!
|
||||
|
||||
Перед началом работы обсудите вашу идею в [Задачи](https://git.linux-gaming.ru/CastroFidel/winehelper/issues), чтобы избежать дублирования.
|
Reference in New Issue
Block a user