====== Инструкция по установке Wine в ОС Astra Linux ======
===== 1. Общие сведения =====
Документ описывает порядок установки и первичной настройки Wine в ОС Astra Linux для запуска Windows-приложений (например, ПО «Хромос»). Предполагается, что ОС Astra Linux уже установлена и обновлена (см. документ ''%%astrainstall.md%%'').
Wine не является эмулятором: он реализует слой совместимости, транслирующий вызовы Windows API в вызовы Linux. Состояние каждого Windows-окружения хранится в отдельном каталоге — **Wine-префиксе** (''%%WINEPREFIX%%''), который содержит виртуальный диск ''%%C:%%'', реестр и сопоставление устройств.
^Параметр ^Значение ^
|Операционная система |Astra Linux (с установленными обновлениями) |
|Архитектура префикса |win32 (32-бит) либо win64 (64-бит) |
|Каталог префикса (пример)|''%%~/.local/share/wineprefixes/win32%%'' |
|Дополнительно |''%%winetricks%%'', ''%%wine-gecko%%'', ''%%wine-mono%%''|
===== 2. Общая последовательность установки =====
**Рисунок 1 — Последовательность установки и настройки Wine**
{{:doc:wineinstallflow.png?200| Последовательность установки Wine}}
===== 3. Подготовка системы =====
Включить поддержку 32-битной архитектуры (необходима для win32-приложений и многих библиотек):
sudo dpkg --add-architecture i386
Обновить список доступных пакетов:
sudo apt update
===== 4. Установка Wine и зависимостей =====
Установить Wine и вспомогательную утилиту ''%%winetricks%%'':
sudo apt install wine winetricks
При необходимости 32-битных библиотек дополнительно устанавливается ''%%ia32-libs%%'' (если доступен в репозитории).
Установить компоненты Gecko (движок отображения HTML) и Mono (среда .NET), требуемые многими приложениями для корректной работы интерфейса:
sudo apt install wine-gecko wine-mono
Проверить версию установленного Wine:
wine --version
===== 5. Создание и инициализация Wine-префикса =====
Префикс — это изолированное Windows-окружение. Для разных приложений можно создавать отдельные префиксы, что исключает их взаимное влияние.
Задать архитектуру и путь префикса и инициализировать его:
export WINEARCH=win32
export WINEPREFIX=$HOME/.local/share/wineprefixes/win32
wineboot --init
**Замечание.** Архитектура префикса (''%%WINEARCH%%'') задаётся только при его создании и не может быть изменена впоследствии. Для 32-битных приложений используется ''%%win32%%''.
Структура созданного префикса:
**Рисунок 2 — Структура Wine-префикса**
{{:doc:wineprefix.png?400| Структура Wine-префикса}}
''%%drive_c%%'' — виртуальный системный диск ''%%C:%%'' (каталоги ''%%Program Files%%'', ''%%windows%%'');
''%%dosdevices%%'' — сопоставление дисков и устройств (в т. ч. проброс COM-портов, см. документ ''%%serialport.md%%'');
''%%system.reg%%'', ''%%user.reg%%'' — файлы реестра Windows.
===== 6. Настройка параметров через winecfg =====
Запустить конфигуратор для нужного префикса:
WINEPREFIX=$HOME/.local/share/wineprefixes/win32 winecfg
Основные параметры:
^Вкладка ^Назначение ^
|Приложения|Версия эмулируемой Windows (например, Windows 7/10) |
|Библиотеки|Переопределение DLL (native/builtin) |
|Диски |Подключение дополнительных дисков и проверка устройств|
|Графика |Разрешение, режим виртуального рабочего стола, DPI |
|Аудио |Выбор звуковой подсистемы |
При необходимости установить дополнительные компоненты через ''%%winetricks%%'' (шрифты, библиотеки Visual C++ и пр.):
WINEPREFIX=$HOME/.local/share/wineprefixes/win32 winetricks
===== 7. Установка и запуск Windows-приложения =====
Запустить установщик приложения в нужном префиксе:
WINEPREFIX=$HOME/.local/share/wineprefixes/win32 wine setup.exe
После установки запустить приложение:
WINEPREFIX=$HOME/.local/share/wineprefixes/win32 wine "C:\\Program Files\\App\\app.exe"
Проверить корректность запуска и работу интерфейса.
===== 8. Типовые неисправности и их устранение =====
^Признак ^Возможная причина ^Действие ^
|Не запускается установщик 32-бит|Не включена архитектура i386 |Выполнить п. 3 (''%%dpkg --add-architecture i386%%'') |
|Не отображается HTML/интерфейс |Не установлены Gecko/Mono |Установить ''%%wine-gecko%%'', ''%%wine-mono%%'' (п. 4)|
|Приложение не видит COM-порт |Порт не проброшен в префикс |См. документ ''%%serialport.md%%'' |
|Ошибки с .NET-компонентами |Отсутствуют библиотеки |Доустановить через ''%%winetricks%%'' (п. 6) |
|Конфликт настроек приложений |Общий префикс на разные программы|Создать отдельный ''%%WINEPREFIX%%'' (п. 5) |
===== 9. Настройка ассоциаций файлов =====
Ассоциация связывает тип файла (по расширению/MIME) с приложением, чтобы файл
открывался в нужной программе Wine по двойному щелчку в файловом менеджере.
==== 9.1 Автоматические ассоциации (winemenubuilder) ====
При установке приложений Wine автоматически создаёт ярлыки **.desktop** и
MIME-ассоциации через компонент **winemenubuilder**. Данные размещаются в:
* **~/.local/share/applications/wine/** — ярлыки приложений;
* **~/.local/share/mime/** — описания типов файлов;
* **~/.config/mimeapps.list** — сопоставление «тип файла → приложение».
Автосоздание можно отключить (например, чтобы не засорять меню) переопределением
DLL **winemenubuilder** в **winecfg** (вкладка «Библиотеки») либо переменной:
WINEDLLOVERRIDES="winemenubuilder.exe=d" wine setup.exe
==== 9.2 Ручная ассоциация ====
1. Создать скрипт-обёртку, преобразующий путь Linux → Windows и запускающий приложение (пример **~/.local/bin/chromos-open**):
#!/bin/sh
export WINEPREFIX=$HOME/.wine
winfile="$(winepath -w "$1")"
exec wine "C:\\Program Files\\Chromos\\chromos.exe" "$winfile"
chmod +x ~/.local/bin/chromos-open
2. Создать ярлык **~/.local/share/applications/chromos.desktop**:
[Desktop Entry]
Type=Application
Name=Chromos
Exec=/home/user/.local/bin/chromos-open %f
MimeType=application/x-chromos;
3. Зарегистрировать тип файла и назначить приложение по умолчанию:
xdg-mime default chromos.desktop application/x-chromos
update-desktop-database ~/.local/share/applications
==== 9.3 Пример скрипта автоматизации ====
Приведённый ниже скрипт настраивает обратную ассоциацию — открытие файлов
заданных типов из Windows-приложений Wine внешними **Linux**-программами
(по умолчанию системы). Логика работы:
* задаётся префикс **WINEPRFX** и список расширений **NEED_EXT**;
* создаётся резервная копия файлов реестра префикса (**system.reg**, **user.reg**, **userdef.reg**);
* формируется скрипт **~/bin/run_linux_app**, который преобразует путь Windows в путь Linux (**winepath --unix**) и открывает файл через **xdg-open**;
* строится **.reg**-файл, регистрирующий для каждого расширения универсальный обработчик **UniversalHandlerW2L**, вызывающий этот скрипт;
* сформированный **.reg** импортируется в реестр префикса командой **wine regedit**.
Перед применением проверьте путь префикса (**WINEPRFX**) и при необходимости
скорректируйте список расширений **NEED_EXT**.
#!/bin/bash
# version 0.3
# variables
WINEPRFX="${HOME}/.wine"
NEED_EXT="bmp gif png jpg jpeg svg pdf tif tiff rtf doc docx xls xlsx odt ods vsd zip rar 7z eml"
output="REGEDIT4"$'\n'$'\n'
# end variables
# check
if [ ! -d "${WINEPRFX}" ]; then
echo "Не существует такого WINE префикса ${WINEPRFX}"
exit
fi
# end check
# create backup reg
cp -f "${WINEPRFX}/system.reg" "${WINEPRFX}/system.reg.bak"
cp -f "${WINEPRFX}/user.reg" "${WINEPRFX}/user.reg.bak"
cp -f "${WINEPRFX}/userdef.reg" "${WINEPRFX}/userdef.reg.bak"
# end backup
# create script
mkdir -p ${HOME}/bin/
cat > "${HOME}/bin/run_linux_app" <<-'_RUN_LINUX_APP_SCRIPT'
#!/bin/bash
xdg-open "$(winepath --unix "$1")"
_RUN_LINUX_APP_SCRIPT
chmod a+x "${HOME}/bin/run_linux_app"
winpath2script=$(winepath --windows "${HOME}/bin/run_linux_app")
#echo ${winpath2script}
command="${winpath2script//\\/\\\\} \\\"%1\\\""
#echo ${command}
# end create script
# create reg file
for ext in ${NEED_EXT}; do
#echo ${ext}
output+="[HKEY_CLASSES_ROOT\\.${ext}]"$'\n'
output+="@=\"UniversalHandlerW2L\""$'\n\n'
done
output+="[HKEY_CLASSES_ROOT\\UniversalHandlerW2L\\shell\\open\\command]"$'\n'
output+="@=\"${command}\""$'\n'
output+=$'\n'
printf '%s' "$output" > "${HOME}/bin/dump.reg"
env WINEPREFIX="${WINEPRFX}" wine regedit "${HOME}/bin/dump.reg"
rm -f "${HOME}/bin/dump.reg"
# end reg file
exit 0
===== 10. Типовые неисправности и их устранение =====
^Признак ^Возможная причина ^Действие ^
| Не запускается установщик 32-бит | Не включена архитектура i386 | Выполнить п. 3 (**dpkg --add-architecture i386**) |
| Не отображается HTML/интерфейс | Не установлены Gecko/Mono | Установить **wine-gecko**, **wine-mono** (п. 4) |
| Приложение не видит COM-порт | Порт не проброшен в префикс | См. документ **serialport.md** |
| Ошибки с XML/.NET-компонентами | Отсутствуют библиотеки | Доустановить через **winetricks** (раздел 7), напр. **msxml6** |
| Конфликт настроек приложений | Общий префикс на разные программы | Создать отдельный **WINEPREFIX** (п. 5) |
===== 11. Краткий чек-лист =====
- Включить архитектуру i386 и обновить пакеты (раздел 3).
- Установить **wine**, **winetricks**, **wine-gecko**, **wine-mono** (раздел 4).
- Создать и инициализировать Wine-префикс (раздел 5).
- Настроить параметры через **winecfg** (раздел 6).
- Установить дополнительные компоненты через **winetricks**, напр. **env WINEARCH=win32 winetricks msxml6** (раздел 7).
- Установить и запустить целевое приложение (раздел 8).
- При необходимости настроить ассоциации файлов (раздел 9).
- При работе с оборудованием — настроить проброс портов (**serialport.md**).