Difference between revisions of "RU/development/qa/vcltesttool"

From Wiki
Jump to navigationJump to search
(переводим...)
 
(33 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RU/documentation/beingedited|[[User:Sancho|Санчо]] 10:34, 10 April 2010 (UTC)}}  
+
<section begin=title /><noinclude>{{DISPLAYTITLE:Контроль качества: </noinclude>VCLTesttool<noinclude>}}</noinclude><section end=title />{{BreadCrumbL10n}}
{{RU/documentation/helpneeded|Перевод на русский язык}}
 
{{DISPLAYTITLE:VCLTesttool}}
 
[[en:VCLTesttool]]
 
[[ko:KO/VCLTesttool]]
 
[[sl:SL/VCLTestTool]]
 
  
 
{{RU/vcltesttool/vcltesttooltoc
 
{{RU/vcltesttool/vcltesttooltoc
 
|ShowPrevNext=none
 
|ShowPrevNext=none
 
|ShowPrevPage=none
 
|ShowPrevPage=none
|ShowNextPage=VCLTesttool/Introduction
+
|ShowNextPage=RU/development/qa/vcltesttool/introduction
 
|ShowNextPart=none
 
|ShowNextPart=none
 
|ShowPrevPart=none
 
|ShowPrevPart=none
|NextPage=VCLTesttool/Introduction
+
|NextPage=RU/development/qa/vcltesttool/introduction
 
|parttitle=[[Apendix]]
 
|parttitle=[[Apendix]]
 
}}  
 
}}  
 
== О VCLTesttool ==
 
== О VCLTesttool ==
  
VCLTesttool - это отдельная программа, которая используется для тестирования OpenOffice.org. VCLTesttool взаимодействует с TCP/IP-интерфейсом пакета OpenOffice.org и может проверить каждую установку OpenOffice.org на компьютере или в локальной сети (LAN). Текущая версия VCLTesttool может быть использована на OpenOffice.org 1.1beta и выше. Однако, в будущих версиях OpenOffice.org могут быть несовместимые изменения, поэтому может понадобиться обновлённая версия VCLTesttool.
+
VCLTesttool - это отдельная программа, которая используется для тестирования {{OOo}}. VCLTesttool взаимодействует с {{OOo}} через TCP/IP сокеты и может проверить каждую установку {{OOo}} на ПК. На текущий момент доступны версии [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html VCLTesttool для нескольких версий], от {{OOo}} 1.1beta и выше. Крайне желательно следить за выходом новых версий VCLTestTool, чтобы исключить ошибки из-за несовместимости утилиты и {{OOo}}
 
 
 
 
Текущая версия VCLTesttool [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html всегда доступна].
 
  
 
== Быстрый старт ==
 
== Быстрый старт ==
Line 26: Line 18:
 
Если вы хотите помочь в автоматизированном тестировании и начать немедленно, то данное руководство является вашим правильным выбором. Здесь представлено пошаговое руководство для начала тестирования OpenOffice.org-версий 3.x. Однако, это руководство будет полезно также и для начинающих, и для опытных тестеров.
 
Если вы хотите помочь в автоматизированном тестировании и начать немедленно, то данное руководство является вашим правильным выбором. Здесь представлено пошаговое руководство для начала тестирования OpenOffice.org-версий 3.x. Однако, это руководство будет полезно также и для начинающих, и для опытных тестеров.
  
==== Предпосылки ====
+
==== Подготовка ====
 
Если все изложенные далее условия выполняются, то вы можете приступить к тестированию.
 
Если все изложенные далее условия выполняются, то вы можете приступить к тестированию.
  
Line 41: Line 33:
 
Для этого нужно открыть файл
 
Для этого нужно открыть файл
  
{{Documentation/Linux| '''.versionrc''' <br>(UNIX-Systems)}}  
+
{{DocLinux| '''.versionrc''' <br>(UNIX-Systems)}}  
 
или
 
или
{{Documentation/Windows| '''version.ini''' <br>(Windows-Systems)}}  
+
{{DocWindows| '''version.ini''' <br>(Windows-Systems)}}  
  
 
в каталоге установки<br>
 
в каталоге установки<br>
Line 76: Line 68:
  
 
===== VCLTestTool =====
 
===== VCLTestTool =====
Для того, чтобы начать автоматическое тестирование OpenOffice.org вы должны иметь локальную копию VCLTesttool, установленную в вашей системе.[http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать текущую версию VCLTesttool] соответствующую вашей ОС на ваш локальный компьютер, и распакуйте архив в вашей локальной системе. После извлечения файлов запустите в первый раз файл
+
Для того, чтобы начать автоматическое тестирование OpenOffice.org вы должны иметь локальную копию VCLTesttool, установленную в вашей системе. [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать текущую версию VCLTesttool] соответствующую вашей ОС на ваш локальный компьютер, и распакуйте архив в вашей локальной системе. После извлечения файлов запустите в первый раз файл
  
{{Documentation/Linux| '''testtool.bin'''}}
+
{{DocLinux| '''testtool.bin'''}}
{{Documentation/Windows| '''testtool.exe'''}}
+
{{DocWindows| '''testtool.exe'''}}
  
После запуска VCLTesttool перейдите в меню '''Tools Options'''.
+
После запуска VCLTesttool перейдите в меню {{Menu|Tools|Options}}.
  
 
'''(Все надписи на скриншотах приведены только как примеры. Адаптируйте их под свою ситуацию.)'''
 
'''(Все надписи на скриншотах приведены только как примеры. Адаптируйте их под свою ситуацию.)'''
Line 87: Line 79:
  
  
* Вкладка 'Profile'
+
* Вкладка '''"Profile"'''
  
 
[[Image: Testtool-option-profile.jpg]]
 
[[Image: Testtool-option-profile.jpg]]
Line 100: Line 92:
  
  
* Вкладка 'Crashreport'
+
* Вкладка '''"Crashreport"'''
  
 
[[Image: Testtool-option-crashreport.jpg]]
 
[[Image: Testtool-option-crashreport.jpg]]
  
Check 'Allow contact' checkbox and enter your valid OpenOffice.org-mail-address in 'EMail' field. This mail address will be used when VCLTesttool sends a crashreport. Later on when you are familiar with automated testing you can add your results to [[QUASTe]] (Quality Assurance Statuspage) Therefor a valid mail-address is important.
+
Щёлкните '''"Allow contact"''' для установки флажка '''"Разрешить контакт"''' и введите действующий адрес электропочты OpenOffice.org в поле '''"EMail"'''. Этот адрес будет использоваться VCLTesttool для отсылки креш-репортов. Позже, когда вы ознакомитесь с автоматическими тестами, вы сможете добавлять результаты в [[QUASTe]] (Quality Assurance Statuspage), для чего действующий адрес электропочты имеет важное значение.
  
  
  
* Tabpage 'Misc'
+
* Вкладка '''"Misc"'''
  
 
[[Image: Testtool-option-misc.jpg]]
 
[[Image: Testtool-option-misc.jpg]]
  
On this tabpage you can set the options to be used by VCLTesttool to communicate with OpenOffice.org. In most cases this values can stay default. If VCLTesttool is unable to start your OpenOffice.org installation 'Testtool Port' or 'Remote UNO Port' may be blocked or reserved by your system.
+
На этой вкладке вы можете установить параметры связи VCLTesttool с OpenOffice.org. В большинстве случаев эти параметры оставляются по умолчанию. Если VCLTesttool не может запустить установленный OpenOffice.org, значит, что '''"Testtool Port"''' или '''"Remote UNO Port"''' заблокированы или защищены в вашей системе.
'OOo Program Dir' can be set to the program dir of your OpenOffice.org-Installation to be tested with VCLTestTool. In most cases this field can be left empty as VCLTesttool should be able to find your OpenOffice.org Installation. If not you can try adding the path to your installation here. For example: <INSTALLDIR>/OpenOffice.org 3/program
+
'''"OOo Program Dir"''' может быть указан каталог установки вашего OpenOffice.org. В большинстве случаев это поле должно оставаться пустым, так как VCLTesttool должен быть в состоянии найти установленный OpenOffice.org. Если нет, то вы можете указать здесь путь установки. Например:
 +
<INSTALLDIR>/OpenOffice.org 3/program
 +
 
 +
Все ваши настройки VCLTestTool сохраняет в:
 +
 
 +
{{DocLinux| '''${HOME}/.testtoolrc'''<br>(UNIX-Systems)}}
 +
или
 +
{{DocWindows| '''%APPDATA%\testtool.ini'''<br>(Windows-Systems)}}
 +
или
 +
{{DocOSX | '''$HOME/Library/Application Support/.testtoolrc'''<br>(Mac OS X)}}
  
All your changes to VCLTestTool-options are saved in
+
Щёлкните кнопку '''[OK]''' для сохранения настроек и выхода из VCLTestTool.
  
** ${HOME}/.testtoolrc (UNIX-Systems) or
 
** "$HOME/Library/Application Support/.testtoolrc" (Mac OS X) or
 
** %APPDATA%\testtool.ini (Windows-Systems).
 
  
Click on 'OK' button in Options to save your changes and exit VCLTestTool for this time.
+
Теперь вся подготовка завершена.
  
 +
== Запуск отдельного автоматического теста ==
  
Now all prerequisites are done!
+
Запустить отдельный автоматический тест легко после того, как загружен сценарий на локальную машину и все необходимые настройки из раздела "Быстрый старт" выполнены.
  
== Run a single autotest ==
+
Вся необходимая дополнительная информация о том, как должны завершаться автоматические тесты, находится в [[QUASTe#Category_model|QUASTe]].
  
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]].
+
* Запустите VCLTesttool и выбирете из меню '''File → Open''';
 +
* выберите файл с расширением '''*.bas''';
 +
* выберите каталог со скриптами тестов;
 +
* выберите '''*.bas-файл''' для запуска следующего;
 +
* нажмите '''[OK]''' в диалоге выбора файлов;
 +
* нажмите '''[F5]''' или выберите из меню 'Program → start' для запуска автоматического теста.
  
* Start VCLTesttool and choose File->Open
+
Теперь остаётся только ждать завершения теста, и по его окончании проанализировать '''*.res-файл'''.
* 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.
+
== Как скормить QUASTу результаты тестов ==
  
== To feed QUASTe with the results ==
+
Чтобы скормить [[QUASTe|QUASTу]] результаты, вы должны добавить две строки в файл
 +
{{DocLinux| '''~/.testtoolrc'''}}
  
To feed [[QUASTe]] with the results you have to add two rows to the ~/.testtoolrc (under linux)
+
[Others]
 +
PCname=<Name of the maschine>
  
[Others]
+
== Вопросы, касающихся автоматических тестов ==
  
PCname=<Name of the maschine>
+
Во всех вопросах по автоматическим тестам, чтобы их могла обработать Группа Автоматического тестирования, необходимо указывать:
  
== Issues regarding auto tests ==
+
* '''Component''': qa
 +
* '''Subcomponent''': testscripts
 +
* '''assigned to''': automat@openoffice.org
 +
* Резюме должно начинаться со слова '''[Automation]''' в квадратных скобках, и следом, так же в квадратных скобках, имя скрипта теста (например '''[w_updt.bas]''')
  
All issues regarding auto tests should have the following options set to assure it will be recognized by automation team:
 
  
* Component: qa
+
Кроме того, если вы знаете ответственного за автоматический тест (автора), то адресоваться можно напрямую к нему. [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview Список автоматических тестов и их ответственных] в [http://quaste.services.openoffice.org QUASTe].
* 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: [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview Autotests overview] on [http://quaste.services.openoffice.org QUASTe]
+
* Переключение документа для редактирования в режиме (слот: "EditDoc", StandardBar кнопка "Bearbeiten"): Когда документ загружается только для чтения у нас нет возможности для определения, активирована ли кнопка "Редактировать документ" и работает, или она в режиме "не используется". Некоторые странности обхода в реализации '''t_doc2.inc::sMakeReadOnlyDocumentEditable()''', которые не всегда работают. В графических модулей другие методы реализованы, но они не являются общими и не всегда обрабатывают возможные окна сообщений (messagebox).
  
== Additional links ==
+
== Дополнительные ссылки ==
  
1. [[Run_OOo_versions_parallel]]
+
# [[Run_OOo_versions_parallel]]
 +
# [[RU/development/qa/automatic_testing]]
  
  
[[Category:Quality_Assurance]]
 
 
[[Category:TestAutomation]]
 
[[Category:TestAutomation]]
----
 
{{RU/documentation/signyear|Sancho|Переводчик:<br>А. Е. Харламенков|2010}}
 
  
{{qaВottom}}
+
 
 +
{{SignTransYear|RU|Sancho|А. Е. Харламенков|2010}}
 +
 
 +
{{RUqaBottom}}

Latest revision as of 19:56, 18 September 2011



О VCLTesttool

VCLTesttool - это отдельная программа, которая используется для тестирования OpenOffice.org. VCLTesttool взаимодействует с OpenOffice.org через TCP/IP сокеты и может проверить каждую установку OpenOffice.org на ПК. На текущий момент доступны версии VCLTesttool для нескольких версий, от OpenOffice.org 1.1beta и выше. Крайне желательно следить за выходом новых версий VCLTestTool, чтобы исключить ошибки из-за несовместимости утилиты и OpenOffice.org

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

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

Подготовка

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

CVS/SVN

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

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

OpenOffice.org

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

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

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

Documentation linux.png .versionrc
(UNIX-Systems)

или

Documentation windows.png 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 соответствующую вашей ОС на ваш локальный компьютер, и распакуйте архив в вашей локальной системе. После извлечения файлов запустите в первый раз файл

Documentation linux.png testtool.bin
Documentation windows.png testtool.exe

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

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


  • Вкладка "Profile"

Testtool-option-profile.jpg

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

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


  • Вкладка "Crashreport"

Testtool-option-crashreport.jpg

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


  • Вкладка "Misc"

Testtool-option-misc.jpg

На этой вкладке вы можете установить параметры связи 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 сохраняет в:

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

или

Documentation windows.png %APPDATA%\testtool.ini
(Windows-Systems)

или

Documentation Mac Logo 40.png $HOME/Library/Application Support/.testtoolrc
(Mac OS X)

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


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

Запуск отдельного автоматического теста

Запустить отдельный автоматический тест легко после того, как загружен сценарий на локальную машину и все необходимые настройки из раздела "Быстрый старт" выполнены.

Вся необходимая дополнительная информация о том, как должны завершаться автоматические тесты, находится в QUASTe.
  • Запустите VCLTesttool и выбирете из меню File → Open;
  • выберите файл с расширением *.bas;
  • выберите каталог со скриптами тестов;
  • выберите *.bas-файл для запуска следующего;
  • нажмите [OK] в диалоге выбора файлов;
  • нажмите [F5] или выберите из меню 'Program → start' для запуска автоматического теста.

Теперь остаётся только ждать завершения теста, и по его окончании проанализировать *.res-файл.

Как скормить QUASTу результаты тестов

Чтобы скормить QUASTу результаты, вы должны добавить две строки в файл

Documentation linux.png ~/.testtoolrc
[Others]
PCname=<Name of the maschine>

Вопросы, касающихся автоматических тестов

Во всех вопросах по автоматическим тестам, чтобы их могла обработать Группа Автоматического тестирования, необходимо указывать:

  • Component: qa
  • Subcomponent: testscripts
  • assigned to: automat@openoffice.org
  • Резюме должно начинаться со слова [Automation] в квадратных скобках, и следом, так же в квадратных скобках, имя скрипта теста (например [w_updt.bas])


Кроме того, если вы знаете ответственного за автоматический тест (автора), то адресоваться можно напрямую к нему. Список автоматических тестов и их ответственных в QUASTe.

Известные проблемы, связанные со сценариями автоматизированных тестов

  • Переключение документа для редактирования в режиме (слот: "EditDoc", StandardBar кнопка "Bearbeiten"): Когда документ загружается только для чтения у нас нет возможности для определения, активирована ли кнопка "Редактировать документ" и работает, или она в режиме "не используется". Некоторые странности обхода в реализации t_doc2.inc::sMakeReadOnlyDocumentEditable(), которые не всегда работают. В графических модулей другие методы реализованы, но они не являются общими и не всегда обрабатывают возможные окна сообщений (messagebox).

Дополнительные ссылки

  1. Run_OOo_versions_parallel
  2. RU/development/qa/automatic_testing





Переводчик:
А. Е. Харламенков

2010










К началу страницы