Главная · Все классы · Основные классы · Классы по группам · Модули · Функции

Руководство по использованию QTestLib

Инструментарий QTestLib, предоставленая компанией Trolltech, является средством для тестирования Qt приложений и библиотек. QTestLib предоставляет полный базовый функционал для тестирования графического пользовательского интерфейса.

Содержание:

• Возможности QTestLib
• QTestLib API
• Использование QTestLib
• Создание теста
• Сборка теста
• Аргументы командной строки QTestLib
• Синтаксис
• Параметры

Возможности QTestLib

QTestLib создан для облегчения написания тестов для приложений и библиотек Qt:

Примечание: для высокоуровневых пользовательских графических интерфейсов и приложений, которым необходимо тестирование, читайте Тестирование продуктов Qt посредством партнёров Trolltech.

QTestLib API

Все публичные методы определены в пространстве имён QTest. Дополнительно, класс QSignalSpy пригоден для легкого наблюдения посредством сигналов и слотов Qt.

Использование QTestLib

Создание теста

Для создания теста переопределите QObject и добавьте один или несколько закрытых слотов в нем. Каждый закрытый слот является функцией вашего теста. QTest::qExec() используется для выполнения всех функций тестов в объекте тесте.

Дополнительно, нужно добавить четыре закрытых слота, которые не будут выполнять роль функций тестов. Они запускаются структурой тестирования и могут быть использованы для инициализации и очистки любого из тестов или текущей функции теста.

• initTestCase() выполняется перед запуском первой функции теста.
• cleanupTestCase() выполняется после выполнения последней функции теста.
• init() выполняется перед запуском каждой функции теста.
• cleanup() выполняется после каждой функции теста.

Если initTestCase() вернул ошибку, значит нет функций тестов, которые могут быть запущены. Если init() вернул ошибку, значит функция тест не была запущена, после чего тест перейдет к следующей функции тесту.

Пример:

 class MyFirstTest: public QObject
 {
     Q_OBJECT
 private slots:
     void initTestCase()
     { qDebug("called before everything else"); }
     void myFirstTest()
     { QVERIFY(1 == 1); }
     void mySecondTest()
     { QVERIFY(1 != 2); }
     void cleanupTestCase()
     { qDebug("called after myFirstTest and mySecondTest"); }
 };

Другие примеры приведены в Учебном пособии по QTestLib.

Сборка теста

Если вы используете qmake в качестве инструмента сборки, добавьте следующую строку в ваш файл проекта:

 CONFIG += qtestlib

Если вы используете другой инструмент сборки, убедитесь, что вы добавили путь к заголовочным файлам QTestLib (обычно include/QtTest в папке установки Qt). Если вы используете релиз-сборку Qt, свяжите ваш тест с библиотекой QtTest. Для отладочных сборок используйте QtTest_debug.

Смотрите Написание юнит-тестов для получения пояснения, как это делается шаг за шагом.

Аргументы командной строки QTestLib

Синтаксис

Синтаксис выполнения автотеста имеет такую форму:

 testname [options] [testfunctions[:testdata]]...

Замените testname реальным именем исполняемого файла. testfunctions может содержать имена функций тестов, которые должны выполняться. Если testfunctions не задана, то будут выполнены все тесты. Если к имени функции теста будут добавлены тестовые данные (test data), то функция тест будет выполнена только с ними.

Например:

     /myTestDirectory$ testQString toUpper

Запуск функции теста, выполняющей toUpper, со всеми доступными тестовыми данными.

     /myTestDirectory$ testQString toUpper toInt:zero

Запускает функцию теста toUpper со всеми доступными тестовыми данными и тестовую функцию toInt с тестовыми данными с именем zero (если тестовые данные не существуют, ассоциированный с ними тест закончится ошибкой).

     /myTestDirectory$ testMyWidget -vs -eventdelay 500

Запускает функцию теста testMyWidget, которая выводит информацию о возникновении любого сигнала и ждет 500 миллисекунд после каждой симуляции событий мыши/клавиатуры.

Параметры

Общеприняты следующие аргументы командной строки:

• -help
  вывод доступных аргументов командной строки и получение помощи.
• -functions
  вывод всех доступных функций теста.
• -o filename
  запись выводимых данных в файл
• -silent
  вывод показывает только предупреждения, ошибки и минимальное статус-сообщения
• -v1
  выводит информацию от введенных и существующих функций тестов.
• -v2
  расширяет вывод; также выводит QCOMPARE() и QVERIFY()
• -vs
  выводит информацию о возникновении любого сигнала.
• -xml
  вывод в XML-формате вместо обычного текста
• -lightxml
  выводит результаты как XML поток
• -eventdelay ms
  если не определена задержка для симуляции клавиатуры или мыши (QTest::keyClick(), QTest::mouseClick() и т.д.), будет использовано значение этого параметра (в миллисекундах).
• -keydelay ms
  похоже на -eventdelay, но включает только симуляцию клавиатуры, без мыши.
• -mousedelay ms
  похоже на -eventdelay, но включает только симуляцию мыши, без клавиатуры.
• -keyevent-verbose
  более подробный вывод при симуляции клавиатуры
• -maxwarnings numberBR устанавливает максимальное число предупреждений, записываемых в вывод. 0 - не ограничивать, по умолчанию установлено в 2000.