VCLTesttool

Руководство по автоматическому тестированию OpenOffice.org

Apendix

[[{{{PrevPart}}}|← Предыдущая часть - {{{PrevPartName}}}]]

[[{{{NextPart}}}| Следующая часть: - {{{NextPartName}}} →]]

• VCLTesttool
• Введение для начинающих пользователей
• Введение для разработчиков тестов
• Введение для тестеров локализаций
• Приложение А: Справочник по командам

[[{{{PrevPage}}}|← Предыдущая страница ]]

Следующая страница →

О VCLTesttool

VCLTesttool - это отдельная программа, которая используется для тестирования OpenOffice.org. VCLTesttool взаимодействует с TCP/IP-интерфейсом пакета OpenOffice.org и может проверить каждую установку OpenOffice.org на компьютере или в локальной сети (LAN). Текущая версия VCLTesttool может быть использована на OpenOffice.org 1.1beta и выше. Однако, в будущих версиях OpenOffice.org могут быть несовместимые изменения, поэтому может понадобиться обновлённая версия VCLTesttool.

Текущая версия VCLTesttool всегда доступна.

Быстрый старт

Если вы хотите помочь в автоматизированном тестировании и начать немедленно, то данное руководство является вашим правильным выбором. Здесь представлено пошаговое руководство для начала тестирования OpenOffice.org-версий 3.x. Однако, это руководство будет полезно также и для начинающих, и для опытных тестеров.

Предпосылки

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

CVS/SVN

Вы должны иметь рабочую CVS или SVN (мигрировать на SubVersion для запуска милстоуна DEV300_m32) в своей системе. Прочтите про клиента CVS [en] и его настройку для использования с OpenOffice.org. Прочтите про использование SubVersion [en] с OpenOffice.org.

По окончании автоматического тестирования необходимо извлечь его результаты и заархивировать их [en].

OpenOffice.org

У вас должен быть установлен OpenOffice.org, при этом чрезвычайно знать его точную версию перед началом тестирования.

Если вы не уверены, какая версия установлена в вашей системе, то это можно проверить.

Для этого нужно открыть файл

.versionrc (UNIX-Systems)

или

version.ini (Windows-Systems)

в каталоге установки
(смотрите в <INSTALLDIR>/OpenOffice.org 3/program)

Откройте этот файл и просмотрите раздел [Version]:

Например:

ProductMajor=300
ProductMinor=29
ProductSource=DEV300

Система VCLTesttool (автоматизированное тестирование

Рамках VCLTesttool имеются все сценарии для тестирования милстоуна на основе текущих ответвлений и находящихся в CVS/SVN модулей автоматических тестов. Вы можете найти все эти файлы в OpenOffice.org CVS/SVN и легко загрузить их на вашей локальной файловой системе с помощью отладчика CVS/SVN.

Допустим, вы собираетесь протестировать версию на основе 'DEV300' c милстоуна 'm29'.

Помните, все DEV300 до милстоуна m32 находятся в CVS и все милстоуны от m32 на находятся в SVN.

Используйте следующую команду, чтобы получить исходники:

cvs checkout -r DEV300_m29 -d testautomation_m29 testautomation

(опциональный параметр -d используется для проверки в указанном каталоге, чтобы иметь возможность провести несколько версий параллельно.)

Проверка через SubVersion:

svn checkout svn://svn.services.openoffice.org/ooo/tags/DEV300_m32/testautomation testautomation_m32

Если вы не хотите использовать CVS или SVN, то вы можете скачать архив автоматических тестов, созданный Наката Махо из Good Day server. Просто архив для прохождения тестирования вашей версии OpenOffice.org.

VCLTestTool

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

testtool.bin

testtool.exe

После запуска VCLTesttool перейдите в меню Tools → Options.

(Все надписи на скриншотах приведены только как примеры. Адаптируйте их под свою ситуацию.)

• Вкладка "Profile"

Необходимо создать профиль для автоматических тестов. Для этого введите:

1. Profile: DEV300m29
2. Log base directory: (Все результитующие файлы выполненных тестов будут сохраняться здесь.)
3. Base directory: Каталог извлечённых скриптов автоматического тестирования.
4. Default HID directory устанавливается автоматически и, в большинстве случаев, не должен изменяться.

• Вкладка "Crashreport"

Щёлкните "Allow contact" для установки флажка "Разрешить контакт" и введите действующий адрес электропочты OpenOffice.org в поле "EMail". Этот адрес будет использоваться VCLTesttool для отсылки креш-репортов. Позже, когда вы ознакомитесь с автоматическими тестами, вы сможете добавлять результаты в QUASTe (Quality Assurance Statuspage), для чего действующий адрес электропочты имеет важное значение.

• Вкладка "Misc"

На этой вкладке вы можете установить параметры связи VCLTesttool с OpenOffice.org. В большинстве случаев эти параметры оставляются по умолчанию. Если VCLTesttool не может запустить установленный OpenOffice.org, значит, что "Testtool Port" или "Remote UNO Port" заблокированы или защищены в вашей системе. "OOo Program Dir" может быть указан каталог установки вашего OpenOffice.org. В большинстве случаев это поле должно оставаться пустым, так как VCLTesttool должен быть в состоянии найти установленный OpenOffice.org. Если нет, то вы можете указать здесь путь установки. Например:

<INSTALLDIR>/OpenOffice.org 3/program

Все ваши настройки VCLTestTool сохраняет в:

${HOME}/.testtoolrc (UNIX-Systems)

или

%APPDATA%\testtool.ini (Windows-Systems)

или

$HOME/Library/Application Support/.testtoolrc (Mac OS X)

Щёлкните кнопку [OK] для сохранения настроек и выхода из VCLTestTool.

Теперь вся подготовка завершена.

Run a single autotest

Running a single autotest is quite easy once you managed to download the scripts to your machine's space and made all necessary settings described in 'Quick start' section. If you want more information on how to know what autotests should be finished please visit QUASTe#Category_model.

• Start VCLTesttool and choose File->Open
• change file type to *.bas
• choose directory holding the testscripts
• choose *.bas-file to be run next
• Select 'OK' in file dialog
• Press 'F5' or select 'Program->start' to run the autotest

Now you only have to wait until test has finished and analyzed the test results written to *.res-file.

To feed QUASTe with the results

To feed QUASTe with the results you have to add two rows to the ~/.testtoolrc (under linux)

[Others]

PCname=<Name of the maschine>

Issues regarding auto tests

All issues regarding auto tests should have the following options set to assure it will be recognized by automation team:

• Component: qa
• Subcomponent: testscripts
• assigned to: automat@openoffice.org
• Summary should start with text [Automation] and follow by the test script name in square brackets (f.e. [w_updt.bas] )

Additionally if you know the owner of the auto tests one can directly assign it to the owner. For a list of automated tests and his owner see: Autotests overview on QUASTe

Additional links

1. Run_OOo_versions_parallel

---