
Автоматизация тестирования десктопных приложений на VB6 и WinForms: FlaUI, WinAppDriver и регресс в CI
Юнит-тесты на старый VB.NET или VB6 написать можно, но они не ловят главное: кнопка перестала открывать окно, поле не принимает дату, отчёт печатается пустым. Разбираем, как автоматизировать проверку интерфейса десктопной программы: какой инструмент выбрать в 2026 году, как искать контролы VB6 и WinForms, как писать стабильные тесты на FlaUI и как запускать их в CI.
Старое десктопное приложение обычно живёт без автотестов вообще. Каждый релиз проверяет один и тот же человек, по памяти, за полдня. Пока изменений мало, это работает. Когда начинается миграция на новый .NET, замена компонентов или просто активная доработка, ручной регресс перестаёт успевать, и ошибки уезжают к пользователям. Автоматизация тестирования интерфейса закрывает именно эту дыру: десяток сценариев, которые за 15 минут проходят главные экраны так, как их проходит бухгалтер или кладовщик.
Эта работа требует отдельных рук: кто-то должен написать сценарии, подготовить тестовые данные и поддерживать агент сборки. Если в команде сопровождения один-два человека, тестирование десктопных приложений вместе с доработкой самой программы часто отдают внешней команде, которая занимается desktop-разработкой. Но и в этом случае полезно понимать, как устроены такие тесты, чтобы принимать работу и не платить за хрупкий набор, который никто не запускает.
Если тестов в проекте нет совсем, начните с логики: как зафиксировать поведение расчётов, рассказано в статье «Как покрыть тестами legacy VB.NET». Здесь речь о следующем уровне, проверке через интерфейс.
Зачем legacy-десктопу UI-тесты, если есть юнит-тесты?
UI-тесты нужны, потому что в старых программах на VB6 и WinForms логика живёт прямо в обработчиках событий форм, и юнит-тестом до неё не дотянуться без рефакторинга. Расчёт суммы в Command1_Click, проверка полей в Form_Unload, запрос к базе в Timer1_Timer: всё это проверяется только запуском формы.
Второй довод: UI-тест проверяет то, что видит пользователь. Сломанная привязка данных, перепутанный порядок табуляции, модальное окно, которое открылось за главным, не видны ни в одном юнит-тесте. А при обновлении OCX, переходе на новый Windows или переносе WinForms-проекта на .NET 8 и новее ломается именно это.
Третий довод экономический, и тут важно не обманываться. Набор из 20 сквозных сценариев пишется за 2-4 недели, а экономия ручного регресса при ежемесячных релизах составляет полдня в месяц, то есть сама по себе окупается годами. Набор окупают другие вещи: частые релизы во время миграции или активной доработки и ошибки, которые не дошли до пользователей. Если одна сорванная отгрузка или неверно проведённый документ стоит дороже недели работы, считать стоит именно их.
Как инструмент «видит» окно программы?
Инструмент видит окно одним из трёх способов: через дерево доступности (UI Automation или MSAA), по координатам или по распознаванию картинок. Для legacy-десктопа рабочий только первый, остальные оставляют на крайний случай.
- UI Automation (UIA). Система доступности Windows, через которую экранные дикторы читают интерфейс. Каждое окно и контрол становятся элементом дерева со свойствами Name, AutomationId, ClassName, ControlType и паттернами вроде Invoke, Value, Selection. Подробное описание модели есть в обзоре UI Automation на Microsoft Learn.
- MSAA. Предшественник UIA, который до сих пор отвечает за многие старые контролы. UIA умеет отдавать MSAA-элементы через мост, поэтому отдельный инструмент обычно не нужен.
- Координаты. «Кликнуть в точку 312, 145». Ломается при смене разрешения, масштаба, шрифта или темы. Годится только для одного-двух мест, куда иначе не добраться.
- Картинки. SikuliX, pyautogui и похожие ищут на экране фрагмент изображения. Медленно и чувствительно к сглаживанию шрифтов, но иногда это единственный способ кликнуть в нарисованный вручную контрол.
Перед тем как писать тесты, откройте программу и посмотрите на её дерево в инспекторе: Inspect.exe из Windows SDK, FlaUInspect или Accessibility Insights for Windows. За 10 минут станет понятно, какие экраны видны полностью, а где инструмент упирается в «чёрный ящик».
Какой инструмент выбрать в 2026 году?
Для команды на .NET основной выбор FlaUI, для Python pywinauto, для тех, у кого уже есть инфраструктура Appium, драйвер NovaWindows. Коммерческие пакеты оправданы, когда тесты пишут тестировщики без программирования.
| Инструмент | Язык | Как находит контролы | Состояние | Когда подходит |
|---|---|---|---|---|
| FlaUI | VB.NET, C# | UIA2 и UIA3, условия по AutomationId, Name, ClassName | Открытый, версия 5.0 вышла в феврале 2025 года | Команда сопровождения на .NET, тесты рядом с кодом |
| pywinauto | Python | Бэкенды win32 и uia | Открытый, активное сообщество | Отдельная QA-команда на Python, смешанный парк программ |
| Appium + NovaWindows | Любой с клиентом WebDriver | UIA, локаторы в стиле WebDriver | Открытый, развивается сообществом | Уже есть Appium для мобильных и веб-тестов |
| WinAppDriver | Любой с клиентом WebDriver | UIA | Последний стабильный релиз 1.2.1 в ноябре 2020 года, превью 1.2.99 в 2021-м | Только поддержка уже написанных тестов |
| TestComplete, Ranorex | Запись и скрипты | UIA, MSAA, свои плагины | Коммерческие, платная лицензия | Тестировщики без опыта программирования, нужна запись сценариев |
| SikuliX, pyautogui | Java, Python | Картинки и координаты | Открытые | Только как запасной путь для отдельных контролов |
Про WinAppDriver стоит сказать отдельно. Его до сих пор советуют в старых статьях и ответах на форумах, а драйвер Windows для Appium исторически работает поверх него. Если у вас уже есть набор тестов на WinAppDriver, переписывать его срочно не нужно. Начинать на нём новый проект в 2026 году нет смысла: исправлений для новых сборок Windows не будет.
Дальше в примерах FlaUI: это библиотека для .NET, тесты на ней пишутся на том же VB.NET, что и приложение, и запускаются обычным MSTest, NUnit или xUnit.
Чем VB6 отличается от WinForms для автотестов?
Главное отличие в том, есть ли у контрола стабильный идентификатор. В WinForms он есть почти бесплатно, в VB6 его обычно нет, и локаторы приходится строить из класса окна, подписи и положения в дереве.
| Что | VB6 | WinForms (.NET Framework и .NET 8+) |
|---|---|---|
| Идентификатор контрола | Стабильного AutomationId обычно нет | Свойство Name контрола становится AutomationId |
| Класс окна | ThunderRT6CommandButton, ThunderRT6TextBox и т. п. в скомпилированном EXE, Thunder* без RT6 при запуске из IDE | WindowsForms10.* с суффиксом, который меняется между запусками |
| Подпись | Caption и Text доступны как Name | Text или AccessibleName доступны как Name |
| Сетки и списки | MSFlexGrid, сторонние OCX часто не отдают ячейки | DataGridView отдаёт строки и ячейки |
| Как улучшить | Тестовый режим программы, проверка результата через базу или файл | Осмысленные имена контролов вместо Button1, AccessibleName для нарисованных контролов |
WinForms: имена контролов как AutomationId
Для WinForms первым делом пройдитесь по формам, которые попадут в тесты, и переименуйте контролы с дизайнерскими именами: Button1 и TextBox3 работают как AutomationId, но через год никто не вспомнит, что это. Переименование меняет только код формы и обработчики, на пользователей не влияет.
VB6: локаторы без AutomationId
Для VB6 работает другой набор приёмов:
- ищите контрол по связке ClassName плюс Name (подпись кнопки, текст метки рядом с полем), а не по индексу;
- помните, что в IDE и в скомпилированном EXE классы окон разные, тесты гоняйте только на собранном EXE;
- если сетка не отдаёт ячейки, проверяйте результат не на экране, а в базе или в выгруженном файле: тест нажимает «Провести», а затем читает строку документа запросом;
- добавьте в программу ключ запуска для тестов, который подключает тестовую базу и отключает заставки, автообновление и сетевые запросы.
Как написать первый UI-тест на FlaUI?
Первый тест пишут на самый частый сценарий, который при поломке бьёт по деньгам: создание счёта, проведение накладной, печать акта. Порядок такой:
- Создайте в решении отдельный тестовый проект (MSTest, NUnit или xUnit) и подключите NuGet-пакеты FlaUI.Core и FlaUI.UIA3.
- Подготовьте копию программы в отдельном каталоге и тестовую базу, которую можно пересоздать скриптом.
- В инспекторе выпишите идентификаторы контролов сценария.
- Напишите тест: запуск, действия, ожидание окна, проверка результата, закрытие.
- Запустите тест пять раз подряд. Если он хоть раз упал без причины, ищите гонку до того, как писать второй.
Imports System.Linq
Imports FlaUI.Core
Imports FlaUI.Core.Tools
Imports FlaUI.UIA3
Imports Microsoft.VisualStudio.TestTools.UnitTesting
<TestClass>
Public Class InvoiceFormTests
Private _app As Application
Private _automation As UIA3Automation
<TestInitialize>
Public Sub StartApp()
' копия программы и тестовая база готовятся до запуска
_app = Application.Launch("C:\uitest\Billing.exe", "/db=uitest")
_automation = New UIA3Automation()
End Sub
<TestMethod>
Public Sub NewInvoice_TotalIsQuantityTimesPrice()
Dim main = _app.GetMainWindow(_automation, TimeSpan.FromSeconds(15))
main.FindFirstDescendant(Function(cf) cf.ByAutomationId("btnNewInvoice")).AsButton().Invoke()
' ждём модальное окно, а не спим фиксированное время
Dim dlg = Retry.WhileNull(Function() main.ModalWindows.FirstOrDefault(),
TimeSpan.FromSeconds(5)).Result
Assert.IsNotNull(dlg, "Окно счёта не открылось")
dlg.FindFirstDescendant(Function(cf) cf.ByAutomationId("txtQty")).AsTextBox().Text = "3"
dlg.FindFirstDescendant(Function(cf) cf.ByAutomationId("txtPrice")).AsTextBox().Text = "400"
dlg.FindFirstDescendant(Function(cf) cf.ByAutomationId("btnCalc")).AsButton().Invoke()
Dim total = dlg.FindFirstDescendant(Function(cf) cf.ByAutomationId("lblTotal")).Name
Assert.AreEqual("1 200,00", total)
End Sub
<TestCleanup>
Public Sub CloseApp()
_app.Close()
_automation.Dispose()
End Sub
End ClassОбратите внимание на две вещи. Ожидание окна сделано через Retry.WhileNull: тест ждёт ровно столько, сколько нужно, и падает с понятным сообщением. И проверка идёт по результату, видимому пользователю, а не по внутреннему состоянию. Для VB6-программы код такой же, только вместо ByAutomationId используются ByClassName и ByName.
Когда тестов станет больше пяти, вынесите поиск контролов в классы экранов (InvoiceScreen, MainScreen): сценарий читается как «открыть счёт, ввести позицию, провести», а при изменении формы правится один класс.
Как сделать UI-тесты стабильными?
Стабильность UI-тестов в основном определяется данными и ожиданиями, а не инструментом. Типичные причины «мигающих» тестов и что с ними делать:
- Фиксированные паузы. Thread.Sleep(2000) то слишком короткий, то слишком длинный. Ждите условия: появления окна, активности кнопки, смены текста.
- Общие данные. Тест, который рассчитывает на «счёт №15 в базе», падает после соседнего теста. Каждый тест сам готовит свои данные или база пересоздаётся перед прогоном.
- Зависимость от порядка. Тесты должны проходить в любом порядке и по одному. Проверьте, запустив их в обратном порядке.
- Неожиданные окна. «Доступна новая версия», «Совет дня», окно активации. Отключите их ключом тестового режима, а не кликами в тесте.
- Даты и региональные настройки. Формат даты и разделитель дробной части зависят от настроек Windows. Зафиксируйте их на тестовой машине и в ожидаемых значениях.
- Фокус и фон. Тесты с вводом через клавиатуру ломаются, если окно потеряло фокус. Используйте паттерны Value и Invoke вместо эмуляции нажатий, где это возможно.
Добавьте в TestCleanup снимок экрана и дерева элементов при падении: в FlaUI для этого есть класс Capture. Без снимка разбор упавшего ночного прогона превращается в гадание.
Для отчётов и печатных форм удобна проверка по эталону: тест формирует документ на фиксированных данных, выгружает его в PDF или текст и сравнивает с сохранённым эталоном. Это ловит съехавшие колонки и пропавшие поля, которые сложно проверить через UIA.
Как запускать UI-тесты в CI?
UI-тестам нужен настоящий рабочий стол, поэтому агент CI для них запускают не службой, а интерактивным процессом под отдельной учётной записью. Служба Windows работает в сеансе без рабочего стола, окна там не отрисовываются, и тест падает на поиске главного окна. Как настроить интерактивный режим агента, описано в документации Azure Pipelines по Windows-агентам; для GitLab Runner и Jenkins принцип тот же.
- отдельная виртуальная машина с автовходом под тестовой учётной записью и отключённой блокировкой экрана;
- фиксированное разрешение и масштаб 100 %: при отключении RDP-сессии разрешение может смениться, поэтому для подключения используйте консоль гипервизора или tscon;
- те же региональные настройки, шрифты и версии OCX, что у пользователей;
- одна задача на агент за раз: два UI-теста на одном рабочем столе мешают друг другу;
- артефакты прогона: отчёт тестов, снимки экрана упавших шагов, логи программы.
Сборку и юнит-тесты держите в основном конвейере, а UI-тесты запускайте отдельной стадией после сборки или ночью. Как устроить сам конвейер для старого проекта на .NET Framework и VB6, мы разбирали в статье «CI/CD для legacy-проекта на .NET Framework и VB.NET».
С чего начать: план на первые две недели
Начинать стоит с короткого списка сценариев и одной стабильной машины, а не с выбора «идеального» фреймворка.
- День 1-2. Выпишите 10-15 операций, поломка которых стоит денег или остановки работы. Это и есть список сценариев.
- День 3. Пройдите экраны этих сценариев инспектором, отметьте, где контролы не видны.
- День 4-5. Добавьте в программу тестовый режим, скрипт пересоздания тестовой базы, переименуйте контролы WinForms.
- День 6-8. Напишите 3-5 первых тестов и добейтесь, чтобы они проходили 10 раз подряд.
- День 9-10. Поднимите агент с интерактивной сессией, подключите ночной прогон и отчёт.
Дальше набор растёт по одному-два сценария за релиз, и в первую очередь там, где только что нашли ошибку руками.
Как принять набор UI-тестов у подрядчика?
Принимать набор UI-тестов нужно по тому, как он работает без автора, а не по числу тестов в отчёте. Сто тестов, которые падают через раз и запускаются только с ноутбука исполнителя, стоят меньше десяти стабильных в ночном прогоне.
Минимальный список проверок при приёмке:
- весь набор проходит 10 прогонов подряд на агенте CI без ручного вмешательства;
- тестовая база пересоздаётся скриптом из репозитория, а не копией файла с чьего-то диска;
- каждый тест проверяет результат для пользователя: сумму, статус документа, строку в базе, а не только то, что окно открылось;
- при падении сохраняются снимок экрана, дерево элементов и лог программы;
- поиск контролов вынесен в классы экранов, в тестах нет координат и фиксированных пауз;
- в репозитории есть короткая инструкция: как поднять агент, как запустить набор локально, как добавить сценарий.
Попросите исполнителя на приёмке сломать что-нибудь в программе намеренно, например поменять формулу итога. Если ни один тест не упал, набор проверяет не то.
По срокам ориентир тот же, что и при работе своими силами: 2-4 недели на первые 15-20 сценариев, включая тестовый режим программы и агент. Если исполнитель называет срок заметно меньше, уточните, входят ли в него данные, CI и доработки самой программы для тестируемости.
Как это делают сегодня
Частые вопросы про UI-автотесты для VB6 и WinForms
Можно ли автоматизировать UI-тесты для программы на VB6?
Да. Стандартные контролы VB6 видны через UI Automation как обычные окна Win32, поэтому FlaUI, pywinauto и Appium находят кнопки, поля и списки. Сложнее со сторонними OCX и сетками вроде MSFlexGrid: их содержимое часто не видно, и результат проверяют через базу или выгружаемый файл.
Стоит ли в 2026 году начинать с WinAppDriver?
Для нового проекта лучше нет. Последний стабильный релиз WinAppDriver 1.2.1 вышел в ноябре 2020 года, превью 1.2.99 в 2021-м, дальше развития не было. Для .NET-команды проще FlaUI, для тех, кто уже живёт в Appium, есть драйвер NovaWindows, которому WinAppDriver не нужен.
Почему UI-тесты проходят локально, а в CI падают?
Чаще всего агент CI запущен как служба Windows и работает без рабочего стола, поэтому окна не отрисовываются. Агент для UI-тестов запускают интерактивно под отдельной учётной записью с автовходом, с фиксированным разрешением экрана и масштабом 100 %.
Сколько UI-тестов нужно legacy-приложению?
Немного: 10-30 сквозных сценариев по главным бизнес-операциям. Остальное дешевле покрывать характеризационными тестами логики и проверками данных. UI-тесты медленные и хрупкие, ими страхуют только то, что нельзя проверить ниже.
Пригодятся ли UI-тесты при переписывании на .NET или веб?
Сценарии и тестовые данные пригодятся полностью: это готовая спецификация поведения старой системы. Сам код тестов придётся переписать под новый интерфейс, но если он разделён на шаги сценария и объекты экранов, переписывается только слой экранов.