Difference between revisions of "Testtool"

From Apache OpenOffice Wiki
Jump to: navigation, search
m
Line 1: Line 1:
The testtool is the application used to automatically test OOo from the UI. Basically, it connects to the running office,  
+
The VCL TestTool is the application used to automatically test [[OOo]] from the UI. Basically, it connects to the running office,  
 
and sends artificial key and mouse event. For that to work, it normally needs a machine (or at least a display) on its own.
 
and sends artificial key and mouse event. For that to work, it normally needs a machine (or at least a display) on its own.
  
==HowTo setup testtool==
+
= How to setup the VCL TestTool =
 
+
 
Download the testtool application [http://qa.openoffice.org/qatesttool/ here] (you probably want the OOo2.0 binaries). Unpack the archive,  
 
Download the testtool application [http://qa.openoffice.org/qatesttool/ here] (you probably want the OOo2.0 binaries). Unpack the archive,  
 
start the <code>testtool</code> executable. Read up on how to setup [http://qa.openoffice.org/qatesttool/OOo_testtool.pdf here]. Please note that  
 
start the <code>testtool</code> executable. Read up on how to setup [http://qa.openoffice.org/qatesttool/OOo_testtool.pdf here]. Please note that  
Line 14: Line 13:
 
Settings edit field (enter the full path to the place where the soffice/ooffice binary is located, usually something like <path>/program).
 
Settings edit field (enter the full path to the place where the soffice/ooffice binary is located, usually something like <path>/program).
  
==HowTo run tests==
+
= How to run tests =
  
 
Open one of the test scripts in the qa/qatesttool directory, e.g. <code>qa/qatesttool/framework/first/first.bas</code> or <code>qa/qatesttool/framework/first/topten.bas</code>. Press <code>F5</code> to run the test. Eventually, the office pointed to by the Generic settings  
 
Open one of the test scripts in the qa/qatesttool directory, e.g. <code>qa/qatesttool/framework/first/first.bas</code> or <code>qa/qatesttool/framework/first/topten.bas</code>. Press <code>F5</code> to run the test. Eventually, the office pointed to by the Generic settings  
 
page will open, and the test will be run (make sure the office keeps the focus, and best leave both keyboard and mouse alone during test run).
 
page will open, and the test will be run (make sure the office keeps the focus, and best leave both keyboard and mouse alone during test run).
  
==Compare against master builds==
+
= Compare against master builds =
 
+
 
If your CWS showed errors during testtool runs, compare it against the master build [[OOoRelease1AutomationTestMatrix]].
 
If your CWS showed errors during testtool runs, compare it against the master build [[OOoRelease1AutomationTestMatrix]].
 +
 +
[[Category:Quality Assurance]]

Revision as of 08:30, 12 January 2007

The VCL TestTool is the application used to automatically test OOo from the UI. Basically, it connects to the running office, and sends artificial key and mouse event. For that to work, it normally needs a machine (or at least a display) on its own.

How to setup the VCL TestTool

Download the testtool application here (you probably want the OOo2.0 binaries). Unpack the archive, start the testtool executable. Read up on how to setup here. Please note that the base and HID directories on the profile tab page must point to a checked-out tree of the qa/qatesttool directory:

cvs -d:pserver:anoncvs@anoncvs.services.openoffice.org:/cvs co qa/qatesttool

The basedir must point exactly to that checked-out directory, e.g. <somepath>/qa/qatesttool, the HID directory to e.g. <somepath>/qa/qatesttool/global/hid. After that, change to the Generic tabpage in the Extras->Settings dialog, select OOoProgramDir as Area (if it does not exist: simply type it literally in the Area edit line), and enter the path to an installed OOo instance in the Settings edit field (enter the full path to the place where the soffice/ooffice binary is located, usually something like <path>/program).

How to run tests

Open one of the test scripts in the qa/qatesttool directory, e.g. qa/qatesttool/framework/first/first.bas or qa/qatesttool/framework/first/topten.bas. Press F5 to run the test. Eventually, the office pointed to by the Generic settings page will open, and the test will be run (make sure the office keeps the focus, and best leave both keyboard and mouse alone during test run).

Compare against master builds

If your CWS showed errors during testtool runs, compare it against the master build OOoRelease1AutomationTestMatrix.

Personal tools