====== Инструкция по установке 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**).