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), чтобы избежать дублирования.
|
||||
235
winehelper
235
winehelper
@ -361,13 +361,7 @@ create_desktop () {
|
||||
local name_desktop="$1"
|
||||
local exe_file="$2"
|
||||
local desktop_filename="$(basename "$exe_file" .exe | sed "s| |_|")"
|
||||
local icon_file
|
||||
if [[ "$RESTORE_FROM_BACKUP" == "1" ]] && [[ -f "$3" ]]
|
||||
then icon_file="$3"
|
||||
elif [[ -f "$WH_IMAGE_PATH/$3.png" ]]
|
||||
then icon_file="$WH_IMAGE_PATH/$3.png"
|
||||
else icon_file="wine"
|
||||
fi
|
||||
local icon_file="$WH_IMAGE_PATH/$3.png"
|
||||
|
||||
if [[ -z "$name_desktop" ]] || [[ -z "$exe_file" ]] ; then
|
||||
fatal "Used: $SCRIPT_NAME --desktop \"desktop_name\" \"path_to_exe\" \"name_png_from_image\""
|
||||
@ -391,6 +385,7 @@ create_desktop () {
|
||||
|
||||
# создаем .desktop файл
|
||||
create_new_dir "$WH_MENU_DIR"
|
||||
[[ ! -f "$icon_file" ]] && icon_file=wine
|
||||
{
|
||||
echo "[Desktop Entry]"
|
||||
echo "Name=$name_desktop"
|
||||
@ -405,19 +400,14 @@ create_desktop () {
|
||||
|
||||
cp -f "$USER_WORK_PATH/$desktop_filename.desktop" "$WH_MENU_DIR/"
|
||||
|
||||
if [[ "$RESTORE_FROM_BACKUP" == "1" ]] ; then
|
||||
print_info "Пропускаем обновление desktop.list (режим восстановления из бэкапа)"
|
||||
else
|
||||
# добавляем информацию о приложении в "$WINEPREFIX/desktop.list"
|
||||
if [[ -f "$WINEPREFIX/desktop.list" ]] \
|
||||
&& grep -qe "^${name_desktop}=" "$WINEPREFIX/desktop.list"
|
||||
then sed -i "/^$name_desktop=/d" "$WINEPREFIX/desktop.list"
|
||||
fi
|
||||
create_new_dir "$WINEPREFIX/icons"
|
||||
try_copy_file "$icon_file" "$WINEPREFIX/icons/"
|
||||
echo "$name_desktop=${exe_file//$WINEPREFIX/}=$(basename "$icon_file")" >> "$WINEPREFIX/desktop.list"
|
||||
# добавляем информацию о приложении в "$WINEPREFIX/desktop.list"
|
||||
if [[ -f "$WINEPREFIX/desktop.list" ]] \
|
||||
&& grep -qe "^${name_desktop}=" "$WINEPREFIX/desktop.list"
|
||||
then sed -i "/^$name_desktop=/d" "$WINEPREFIX/desktop.list"
|
||||
fi
|
||||
|
||||
create_new_dir "$WINEPREFIX/icons"
|
||||
try_copy_file "$icon_file" "$WINEPREFIX/icons/"
|
||||
echo "$name_desktop=${exe_file//$WINEPREFIX/}=$(basename "$icon_file")" >> "$WINEPREFIX/desktop.list"
|
||||
|
||||
# создаем файл категории для меню
|
||||
create_new_dir "$HOME/.local/share/desktop-directories"
|
||||
@ -847,7 +837,7 @@ check_prefix_var () {
|
||||
local prefixes=()
|
||||
local count=1
|
||||
print_info "Доступные префиксы WineHelper:"
|
||||
for prefix in "$WH_PREFIXES_DIR"/* ; do
|
||||
for prefix in "$WH_PREFIXES_DIR"/*; do
|
||||
if [[ -d "$prefix" ]]; then
|
||||
prefixes+=("$prefix")
|
||||
echo "$count. $(basename "$prefix")"
|
||||
@ -855,12 +845,14 @@ check_prefix_var () {
|
||||
fi
|
||||
done
|
||||
|
||||
[[ ${#prefixes[@]} -eq 0 ]] && fatal "Не найдено ни одного префикса!"
|
||||
if [[ ${#prefixes[@]} -eq 0 ]]; then
|
||||
fatal "Не найдено ни одного префикса!"
|
||||
fi
|
||||
|
||||
local max_choice=${#prefixes[@]}
|
||||
read -p "Выберите префикс (1-$max_choice): " choice
|
||||
|
||||
if [[ "$choice" -ge 1 && "$choice" -le "$max_choice" ]] ; then
|
||||
if [[ "$choice" -ge 1 && "$choice" -le "$max_choice" ]]; then
|
||||
export WINEPREFIX="${prefixes[$choice-1]}"
|
||||
else
|
||||
fatal "Неверный выбор."
|
||||
@ -872,7 +864,6 @@ check_prefix_var () {
|
||||
if echo "$WINEPREFIX" | grep -qv '/' ; then
|
||||
export WINEPREFIX="$WH_PREFIXES_DIR/$WINEPREFIX"
|
||||
fi
|
||||
export PREFIX_NAME="$(basename "$WINEPREFIX")"
|
||||
|
||||
return 0
|
||||
}
|
||||
@ -1322,166 +1313,23 @@ remove_winehelper () {
|
||||
fi
|
||||
}
|
||||
|
||||
backup_prefix() {
|
||||
export WINEPREFIX="$1"
|
||||
check_prefix_var
|
||||
|
||||
local backup_base_dir="$(xdg-user-dir DESKTOP)"
|
||||
local backup_archive_name="backup_${PREFIX_NAME}_$(date +%Y.%m.%d).whpack"
|
||||
local backup_dest_path="$backup_base_dir/$backup_archive_name"
|
||||
local temp_backup_dir="$WH_TMP_DIR/backup_${PREFIX_NAME}_$(date +%Y.%m.%d)"
|
||||
|
||||
print_info "Начало резервного копирования префикса: $PREFIX_NAME"
|
||||
create_new_dir "$temp_backup_dir"
|
||||
create_new_dir "$temp_backup_dir/prefixes/"
|
||||
create_new_dir "$temp_backup_dir/dist/"
|
||||
|
||||
print_info "Подготовка префикса к упаковке..."
|
||||
if cp -a "$WINEPREFIX" "$temp_backup_dir/prefixes/$PREFIX_NAME" ; then
|
||||
print_ok "Директория префикса подготовлена."
|
||||
else
|
||||
print_error "Не удалось подготовить директорию префикса."
|
||||
try_remove_dir "$temp_backup_dir"
|
||||
return 1
|
||||
fi
|
||||
|
||||
if [[ -f "$WINEPREFIX/last.conf" ]]; then
|
||||
source "$WINEPREFIX/last.conf"
|
||||
|
||||
if [[ -n "$WH_WINE_USE" ]] \
|
||||
&& [[ $WH_WINE_USE != system* ]] \
|
||||
&& [[ -d "$WH_DIST_DIR/$WH_WINE_USE" ]]
|
||||
then
|
||||
print_info "Копирование используемой версии WINE: $WH_WINE_USE"
|
||||
|
||||
if cp -a "$WH_DIST_DIR/$WH_WINE_USE" "$temp_backup_dir/dist/"
|
||||
then print_ok "WINE скопирован."
|
||||
else fatal "Не удалось скопировать WINE."
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
print_info "Создание squashfs архива..."
|
||||
if mksquashfs "$temp_backup_dir" "$backup_dest_path" -comp zstd ; then
|
||||
print_ok "Архив префикса $PREFIX_NAME успешно создан по пути:\n$backup_dest_path"
|
||||
else
|
||||
print_error "Не удалось создать архив префикса $PREFIX_NAME."
|
||||
try_remove_dir "$temp_backup_dir"
|
||||
return 1
|
||||
fi
|
||||
|
||||
try_remove_dir "$temp_backup_dir"
|
||||
print_info "Создание резервной копии префикса завершено."
|
||||
return 0
|
||||
}
|
||||
|
||||
restore_prefix() {
|
||||
local backup_archive_path="$1"
|
||||
local temp_extract_dir
|
||||
|
||||
if [[ -z "$backup_archive_path" ]] ; then
|
||||
read -e -p "Укажите путь к архиву резервной копии (/путь/к/архиву.whpack): " backup_archive_path
|
||||
if [[ -z "$backup_archive_path" ]] ; then
|
||||
fatal "Путь к архиву не указан. Восстановление отменено."
|
||||
fi
|
||||
fi
|
||||
|
||||
backup_archive_path=$(echo "$backup_archive_path" | sed "s/'//g; s/\"//g")
|
||||
if [[ ! -f "$backup_archive_path" ]]
|
||||
then fatal "Файл архива не найден: $backup_archive_path"
|
||||
fi
|
||||
|
||||
print_info "Восстановление из резервной копии: $backup_archive_path"
|
||||
|
||||
temp_extract_dir="$WH_TMP_DIR/restore_$(basename "$backup_archive_path" .whpack)"
|
||||
create_new_dir "$temp_extract_dir"
|
||||
|
||||
print_info "Распаковка архива..."
|
||||
if unsquashfs -f -d "$temp_extract_dir" "$backup_archive_path" ; then
|
||||
print_ok "Архив успешно распакован."
|
||||
else
|
||||
try_remove_dir "$temp_extract_dir"
|
||||
fatal "Не удалось распаковать архив."
|
||||
fi
|
||||
|
||||
if [[ -d "$temp_extract_dir/prefixes" ]] ; then
|
||||
local prefix_name prefix_dir
|
||||
prefix_name="$(ls -1 "$temp_extract_dir/prefixes")"
|
||||
prefix_dir="$temp_extract_dir/prefixes/$prefix_name"
|
||||
|
||||
print_info "Восстановление префикса: $prefix_name"
|
||||
|
||||
if [[ -d "$WH_PREFIXES_DIR/$prefix_name" ]] ; then
|
||||
try_remove_dir "$temp_extract_dir"
|
||||
fatal "Префикс $prefix_name уже существует!
|
||||
Удалите его если действительно желаете востановить префикс заново.
|
||||
Команда для удаления: $SCRIPT_NAME remove-prefix $prefix_name"
|
||||
fi
|
||||
|
||||
if [[ -d "$temp_extract_dir/dist" ]] ; then
|
||||
print_info "Восстановление версий WINE"
|
||||
if cp -fr "$temp_extract_dir/dist"/* "$WH_DIST_DIR/"
|
||||
then print_ok "Версии WINE восстановлены."
|
||||
else print_warning "Не удалось восстановить версии WINE."
|
||||
fi
|
||||
try_remove_dir "$temp_extract_dir/dist"
|
||||
fi
|
||||
|
||||
if ! mv "$prefix_dir" "$WH_PREFIXES_DIR/" ; then
|
||||
try_remove_dir "$temp_extract_dir"
|
||||
fatal "Не удалось восстановить префикс $prefix_name."
|
||||
else
|
||||
print_ok "Префикс $prefix_name восстановлен."
|
||||
|
||||
print_info "Восстановление ярлыков для префикса $prefix_name..."
|
||||
export RESTORE_FROM_BACKUP="1" # Устанавливаем флаг восстановления
|
||||
while IFS='=' read -r line; do
|
||||
local name_desktop=$(echo "$line" | cut -d'=' -f1)
|
||||
local exe_path=$(echo "$line" | cut -d'=' -f2)
|
||||
local icon_name=$(echo "$line" | cut -d'=' -f3)
|
||||
|
||||
local full_exe_path="$WH_PREFIXES_DIR/$prefix_name${exe_path}"
|
||||
local full_icon_path="$WH_PREFIXES_DIR/$prefix_name/icons/$icon_name"
|
||||
|
||||
if [[ -f "$full_exe_path" ]]; then
|
||||
print_info "Создание ярлыка для $name_desktop"
|
||||
create_desktop "$name_desktop" "$full_exe_path" "$full_icon_path"
|
||||
else
|
||||
print_warning "Исполняемый файл для ярлыка '$name_desktop' не найден: $full_exe_path"
|
||||
fi
|
||||
done < "$WH_PREFIXES_DIR/$prefix_name/desktop.list"
|
||||
unset RESTORE_FROM_BACKUP # Снимаем флаг после завершения
|
||||
print_ok "Ярлыки для префикса $prefix_name восстановлены."
|
||||
fi
|
||||
else
|
||||
try_remove_dir "$temp_extract_dir"
|
||||
fatal "Директория prefixes не найдена в архиве."
|
||||
fi
|
||||
|
||||
try_remove_dir "$temp_extract_dir"
|
||||
print_ok "Полное восстановление префикса $prefix_name завершено."
|
||||
return 0
|
||||
}
|
||||
|
||||
wh_info () {
|
||||
echo "Использование: $SCRIPT_NAME [команда]
|
||||
|
||||
Команды:
|
||||
install list список возможных установочных скриптов
|
||||
install [скрипт] запустить скрипт установки программы
|
||||
install [скрипт] --clear-pfx не использовать готовый префикс для установки ПО
|
||||
install list список возможных установочных скриптов
|
||||
install [скрипт] запустить скрипт установки программы
|
||||
install [скрипт] --clear-pfx не использовать подготовленный префикс для установки ПО
|
||||
|
||||
installed список установленных программ
|
||||
run [программа.exe] запуск программы (отладка)
|
||||
remove-all удалить WineHelper и все связанные данные
|
||||
remove-prefix [имя_префикса] удалить префикс и все связанные данные
|
||||
backup-prefix [имя_префикса] создать резерную копию префикса
|
||||
restore-prefix \"путь/до/whpack\" восстановить префикс из резервной копии
|
||||
installed список установленных программ
|
||||
run [программа.exe] запуск программы (отладка)
|
||||
remove-all удалить WineHelper и все связанные данные
|
||||
remove-prefix [имя_префикса] удалить префикс и все связанные данные
|
||||
|
||||
Параметры:
|
||||
--help показать эту справку и выйти
|
||||
--version показать информацию о пакете и его версии
|
||||
--debug [команда] включить режим логирования работы WINE
|
||||
--help показать эту справку и выйти
|
||||
--version показать информацию о пакете и его версии
|
||||
--debug [команда] включить режим логирования работы WINE
|
||||
|
||||
"
|
||||
}
|
||||
@ -1497,14 +1345,7 @@ if [[ -d "$HOME/.local/share/$SCRIPT_NAME" ]] \
|
||||
then try_force_link_dir "$HOME/.local/share/$SCRIPT_NAME" "$HOME/.winehelper"
|
||||
fi
|
||||
|
||||
if [[ -n "$1" ]] ; then
|
||||
arg1="$1"
|
||||
shift
|
||||
else
|
||||
arg1="--help"
|
||||
fi
|
||||
|
||||
case "$arg1" in
|
||||
case "${1,,}" in
|
||||
--version) rpm -qi "$SCRIPT_NAME" ; exit 0 ;;
|
||||
--help) wh_info ; exit 0 ;;
|
||||
killall) kill_wine ;;
|
||||
@ -1512,19 +1353,18 @@ case "$arg1" in
|
||||
winereg|regedit) prepair_wine ; wine_run "regedit" ;;
|
||||
winefile|explorer) prepair_wine ; wine_run "winefile" ;;
|
||||
wineconsole|cmd) prepair_wine ; wine_run "wineconsole" ;;
|
||||
winetricks) prepair_wine ; "$WINETRICKS" -q "$@" ;;
|
||||
desktop) create_desktop "$@" ; exit 0 ;;
|
||||
install|-i) run_autoinstall "$@" ;;
|
||||
installed) check_installed_programs "$1" ;;
|
||||
run|-r) run_installed_programs "$1" ;;
|
||||
backup-prefix) backup_prefix "$@" ;;
|
||||
restore-prefix) restore_prefix "$@" ;;
|
||||
remove-all) remove_winehelper "$@" ;;
|
||||
remove-prefix) remove_prefix "$@" ;;
|
||||
winetricks) shift ; prepair_wine ; "$WINETRICKS" -q "$@" ;;
|
||||
desktop) shift ; create_desktop "$@" ; exit 0 ;;
|
||||
install|-i) shift ; run_autoinstall "$@" ;;
|
||||
installed) shift ; check_installed_programs "$1" ;;
|
||||
run|-r) shift ; run_installed_programs "$1" ;;
|
||||
remove-all) shift ; remove_winehelper "$@" ;;
|
||||
remove-prefix) shift ; remove_prefix "$@" ;;
|
||||
*)
|
||||
if [[ -f "$arg1" ]] ; then
|
||||
WIN_FILE_EXEC="$(readlink -f "$arg1")"
|
||||
WIN_FILE_NAME="$(basename "$arg1")"
|
||||
if [[ -f "$1" ]] ; then
|
||||
WIN_FILE_EXEC="$(readlink -f "$1")"
|
||||
WIN_FILE_NAME="$(basename "$WIN_FILE_EXEC")"
|
||||
shift
|
||||
case "${WIN_FILE_NAME,,}" in
|
||||
*.exe) prepair_wine ; wine_run $WINE_WIN_START "$WIN_FILE_EXEC" "$@" ;;
|
||||
*.msi) prepair_wine ; wine_run msiexec /i "$WIN_FILE_EXEC" "$@" ;;
|
||||
@ -1532,9 +1372,8 @@ case "$arg1" in
|
||||
*) fatal "Тип файла не поддерживается." ;;
|
||||
esac
|
||||
else
|
||||
print_error "Команды $arg1 не существует."
|
||||
wh_info
|
||||
exit 1
|
||||
fi
|
||||
;;
|
||||
;;
|
||||
esac
|
||||
|
||||
Reference in New Issue
Block a user