Changes between Initial Version and Version 1 of WebKitGtkLayoutTests


Ignore:
Timestamp:
Jul 28, 2010 1:41:28 PM (12 years ago)
Author:
Martin Robinson
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WebKitGtkLayoutTests

    v1 v1  
     1== Dependencies ==
     2
     3You will need to install the following Debian packages to run the layout tests. For other distributions, you must install the equivalent packages.
     4{{{
     5sudo aptitude install curl ruby apache2 libapache2-mod-php5
     6}}}
     7
     8== Xvfb ==
     9
     10WebKit functional tests for WebKitGTK+ should be run inside a virtual framebuffer environment. The most common choice for WebKItGTK developers is Xvfb. To start Xvfb simply run:
     11{{{
     12Xvfb :23 -ac -screen 0 1024x768x16 &
     13}}}
     14`-screen 0 1024x768x16` ensures that Xvfb has a deep enough color depth to produce accurate pixel test results. Some older versions of Ubuntu may have bugs which cause Xvfb to segfault while running tests. A workaround for this is to run Xvfb with the GLX extension disabled:
     15{{{
     16Xvfb :23 -ac -screen 0 1024x768x16 -extension GLX &
     17}}}
     18
     19== Fonts ==
     20
     21The tests require you to use the testfonts package shared between the QtWebKit and WebKitGTK+ ports. To get this package via git run:
     22{{{
     23git clone git://gitorious.org/qtwebkit/testfonts.git
     24}}}
     25
     26The tests require the WEBKIT_TESTFONTS environment variable to point to the location of this repository on your local machine.
     27
     28== Running the Tests ==
     29
     30Simply run the run-webkit-tests script from the WebKitTools directory:
     31{{{
     32env -i DISPLAY=:23 WEBKIT_TESTFONTS=/home/developer/work/testfonts ./WebKitTools/Scripts/run-webkit-tests --gtk
     33}}}
     34If you wish to run a single test you can do:
     35{{{
     36env -i DISPLAY=:23 WEBKIT_TESTFONTS=/home/developer/work/testfonts \
     37    ./WebKitTools/Scripts/run-webkit-tests --gtk fast/forms/plaintext-mode-1.html
     38}}}
     39For debugging a test it may be useful to run it directly in DumpRenderTree (with gdb):
     40{{{
     41WebKitBuild/Debug/Programs/DumpRenderTree -v LayoutTests/fast/forms/plaintext-mode-1.html
     42}}}