38be0d1383
This is the beginning of revision history for this module. If you want to look at revision history older than this, please refer to the Qt Git wiki for how to use Git history grafting. At the time of writing, this wiki is located here: http://qt.gitorious.org/qt/pages/GitIntroductionWithQt If you have already performed the grafting and you don't see any history beyond this commit, try running "git log" with the "--follow" argument. Branched from the monolithic repo, Qt master branch, at commit 896db169ea224deb96c59ce8af800d019de63f12
94 lines
3.2 KiB
Plaintext
94 lines
3.2 KiB
Plaintext
-------------------------------------------------------------------------
|
|
TESTING WIDGETS DEFINED IN *.UI FILES (SCREENSHOT COMPARISON)
|
|
-------------------------------------------------------------------------
|
|
This test is based on dev/qt/tests/auto/atwrapper/
|
|
|
|
|
|
HOW TO RUN THE TESTS
|
|
|
|
Compile the necessary programs:
|
|
qmake
|
|
make
|
|
|
|
Now there should be an executable 'uiloader'.
|
|
Run the tests:
|
|
./uiloader
|
|
|
|
|
|
|
|
CONFIGURATION
|
|
|
|
The tests can be executed on different machines. For every machine there
|
|
is a config file <hostname>.ini.
|
|
|
|
If this file is not available the tests won't be run on the machine.
|
|
|
|
Example kayak.ini:
|
|
|
|
[General]
|
|
ftpBaseDir=/arthurtest
|
|
ftpHost=wartburg
|
|
ftpPass=anonymouspass
|
|
ftpUser=anonymous
|
|
output=testresults
|
|
|
|
[engines]
|
|
1\engine=uic
|
|
size=1
|
|
|
|
Don't modify the [engines] section. Later it will be used for styles. The
|
|
only thing you might want to modify is the ftpHost value. At the moment
|
|
wartburg is just a server on which we test the tests.
|
|
|
|
The actual test server is: kramer.troll.no
|
|
|
|
|
|
|
|
HOW IT WORKS
|
|
|
|
There are 3 important folders:
|
|
|
|
tst_uiloader/ Actual program executing the tests.
|
|
tst_screenshot/ Program to generate one *.png file out of *.ui
|
|
baseline/ This is a dir with *.ui files.
|
|
|
|
./uiloader (compiled from tst_uiloader) will use the tst_screenshot program
|
|
and the files in baseline/.
|
|
|
|
In order to generate screenshots the *.ui files in baseline/ will be used.
|
|
Therefore a folder testresults/ (specified in the config) will be
|
|
created/used.
|
|
|
|
Structure of testresults/:
|
|
|
|
|-- testresults
|
|
| `-- i686 Linux g++-4 full-config That's buildKey().
|
|
| `-- 4.5.0 Used Qt version.
|
|
| |-- uic Here are the generated images.
|
|
| |-- uic.baseline Baseline downloaded from server.
|
|
| |-- uic.diff Diff Images of failed tests.
|
|
| `-- uic.failed Generated images of failed tests.
|
|
|
|
If there is no baseline at the server the results in uic/ will be uploaded
|
|
as a new baseline (first run for your machine). So to create a new baseline
|
|
on the server you just need to remove your folders there.
|
|
|
|
On the server side there is a dir /arthurtest with following structure
|
|
(it will be created if it's not there):
|
|
|
|
|-- arthurtest
|
|
| `-- <your machines hostname>
|
|
| `-- <buildKey()>
|
|
| `-- <qt version>
|
|
| |-- uic.baseline Baseline.
|
|
| |-- uic.diff Here the local diffs will be uploaded.
|
|
| `-- uic.failed Here the local failed files will be uploaded.
|
|
|
|
After a test run the files in local uic.diff/ and uic.failed/ will be
|
|
uploaded to the server.
|
|
|
|
For every run the uic.diff/ and uic.failed/ on the local and remote machine
|
|
will be cleared in order to place new files there. On the local side uic/
|
|
gets cleared, too.
|
|
|