Составление отчёта об ошибках по работе программ в Wine.

Основы по использованию Wine: https://noostyche.ru/blog/2020/04/30/ispolzovanie-wine-dlya-zapuska-windows-programm-v-linux/

Не смотря на то, что Wine развивается стремительно, с работой программ всё ещё могут возникать различные проблемы. Они решатся тем быстрее, чем раньше и качественнее о них сообщит пользователь.

Описание проблемы оформляется в специальный отчёт, который размещается в системе контроля ошибок (Bugzilla): https://bugs.winehq.org/

Разработчики Wine регулярно ознакамливаются с отчётами, размещёнными в системе, и по мере возможности решают описанные проблемы.

Требования.

Базовые:

• Создать аккаунт в системе контроля ошибок: https://bugs.winehq.org/createaccount.cgi
• Отчёт должен составляться на английском языке. Это связано с тем, что команда разработчиков Wine международная. Если отчёт оформлен на русском языке, то для его разбора разработчику придётся перевести его с русского языка на английский, при этом далеко не факт, что онлайн-переводчик сможет перевести адекватно, что довольно сильно снижает энтузиазм разбираться с описанной в отчёте проблеме.
• Убедиться в отсутствии ранее сделанных отчётов об аналогичной проблеме: https://bugs.winehq.org/query.cgi Необходимо использовать поиск. Если отчёт существует, то в комментариях описать, что проблема всё ещё актуальна.
• Одна проблема — один отчёт. В одном отчёте не следует описывать все проблемы, связанные с программой. К примеру, сделать отчёт о проблеме с отрисовкой элементов интерфейса и отдельно о нестабильной работе в тот или иной момент.

Технические требования:

• Должна использоваться актуальная версия Wine из ветки разработки, то есть крайняя из регулярно выпускаемых версий, а не стабильная или просто устаревшая.
• Использование версий со сторонними патчами недопустимо.
• Должен использоваться чистый стандартный префикс, в который установлена только тестируемая программа.
• Запуск с NTFS-разделов Windows неприемлем.
• Для описания проблем с работоспособностью запуск необходимо осуществлять без использования каких-либо сторонних Windows-библиотек, а только с теми, которые встроены в Wine-префикс. Но, если работоспособность программы восстанавливается при использовании сторонних библиотек, это стоит указать.

Подготовка и отправка отчёта.

Предварительная подготовка.

После создания аккаунта перейти по ссылке в пункте Submit a new bug:

https://bugs.winehq.org/enter_bug.cgi

Выбрать Wine, открыв страницу:

https://bugs.winehq.org/enter_bug.cgi?product=Wine

Заполнение отчёта.

Вид страницы с формой отчёта:

Далее описан разбор пунктов, которые требуется заполнить для публикации отчёта. Пример отчёта после описания пунктов.

Product. Зависит от выбора «продукта» на предыдущей странице. В данном случае выбран Wine.

Component. Если точно известно, из-за какого компонента (библиотеки) возникает проблема с программой, то его следует указать. Если нет, то указать -unknown-.

Version. Версия Wine, на которой была выявлена проблема. В примере Wine 7.22.

Severity. Уровень критичности проблемы. Для обычного случая стоит выбирать normal. Мелкие проблемы, такие как не совсем правильная отрисовка UI, не влияющая на работоспособность программы, стоит отмечать minor или trivial. Если на предыдущей версии Wine программа работала, а на новой — нет, то это регрессия. Регрессии стоит отмечать более высоким приоритетом: major.

Hardware. Архитектура ОС и оборудования, на которой производился запуск. Для процессоров Intel и AMD это x86 (32-бит) или x86-64 (64-бит).

OS. В этом пункте выбор очевиден.

Summary. Именование отчёта. Должно включать в себя:

• Название и версию программы.
• Ключевое следствие проявления проблемы (к чему приводит проблема). Пример: «аварийное завершение работы при запуске»; «некорректная отрисовка интерфейса» и т.п.

Пример Summary:

Quixel Mixer 2022.1.0 Beta installer cannot find the specified path

Пример неправильного Summary:

Оформлено на русском языке и никак не раскрывает суть проблемы. По итогу отчёт был никем не разобран и закрыт, как «заброшенный».

Description. Детальное описание. Писать на английском языке. Стоит начать с детализации информации о системе:

• Название дистрибутива и его версия.
• Версия ядра.
• Модель процессора.
• Модель видеокарты.
• Версия видеодрайвера.

Далее основное описание:

• Шаги для воспроизведения проблемы.
• К чему приводит проблема.
• Как должно быть в нормальном случае.

Если программу можно свободно загрузить, включая демо-версии, указать ссылку на загрузку.

Описать дополнительные шаги, к примеру, если программа становится работоспособной после установки сторонних Windows-библиотек или прочих манипуляций.

Attachment. Раздел для прикрепления файлов. Как правило, прикрепляют текстовый файл с выводом из терминала.

• Убедиться, что в файл не попали конфиденциальные данные пользователя.
• Проконтролировать, чтобы файл не был слишком большим (до 10 Мб).
• Имеет смысл почистить дублирующие строки, из всего полотна оставив только несколько, чтобы было понятно, что они повторялись множество раз.

В процессе работы программы вывод из терминала можно сразу перенаправить в файл. Пример:

WINEPREFIX='/home/igor/.wine64quixel' wine 'C:/Quixel_Mixer_2022.1.0_Beta.exe' &> ~/quixel_mixer_cannot_install.log

Прикрепить файл, нажав кнопку Add an attachment и выбрав файл. Прикрепить можно только один файл, но после публикации отчёта можно прикрепить дополнительные файлы, если в этом есть необходимость. К примеру, прикрепить снимки.

В поле Description описать содержимое файла. Пример: Output as the program runs.

---

На этом заполнение отчёта завершено. Необходимо подтвердить отправку, нажатием кнопки Submit Bug.

Пример заполненного отчёта.

Product.

Wine

Component.

-unknown-

Version.

Wine 7.22

Severity.

normal

Hardware.

x86-64

OS.

Linux

Summary.

Quixel Mixer 2022.1.0 Beta installer cannot find the specified path

Description.

• Distro: Ubuntu 20.04 x64
• Kernel: Linux 6.0.8
• CPU: Ryzen 7 1700
• GPU: Radeon RX 580 8 Gb
• Driver: Mesa 22.2.4 (Kisak PPA)

Steps to reproduce:

• Running the installation file.
• In the installation dialog, after confirming the selection of the directory to install, an error is displayed: «The path you entered is invalid». Changing the path to different directories does not solve the problem.
• The program cannot be installed.

Download link:https://quixel.com/products/mixer

Attachment.

Прикреплён файл, с выводом из терминала: quixel_mixer_cannot_install.log

Description: Output as the program runs.

---

Отчёт успешно опубликован:

Примечание:Затем после подтверждения отправки отчёта был прикреплён ещё один файл — снимок с выводом предупреждения из программы-установщика:

Опубликованный отчёт окажется в общем списке отчётов:

Потенциально, каждая решённая проблема устраняет не только проблему для конкретной программы, но и для многих других. Таким нехитрым образом можно внести свой скромный вклад в развитие Wine и ликвидацию использования Windows для чего-либо, что само по себе избавление от унижения и огромного множества проблем.