diff options
Diffstat (limited to 'old/README')
-rw-r--r-- | old/README | 109 |
1 files changed, 109 insertions, 0 deletions
diff --git a/old/README b/old/README new file mode 100644 index 0000000..7bb0d63 --- /dev/null +++ b/old/README @@ -0,0 +1,109 @@ +==== INTRO =================================================================== + +QtUiTest is an experimental tool for automated testing of Qt user interfaces. +Do NOT use this tool for any serious development work, instead use the tools +provided by our partners. + +==== BUILDING ================================================================ + +* Qt + + QtUiTest requires Qt 4.5 or higher. Please ensure Qt has been built or + installed before continuing. + +* Default TCP/IP port for communication + By default the TCP/IP port used is 5656, this can be changed by + 1) running qmake with the port specified, eg: + qmake DEFINES+="DEFAULT_AUT_PORT=5156" ~/depot/qtuitest/qtuitest.pro + and 'touching' qtuitest_config.h eg: + touch ~/depot/qtuitest/qtuitest_config.h + OR + 2) changing the value of DEFAULT_AUT_PORT macro in qtuitest_config.h + + Hint: If QtUitest is reporting problem connecting try a different TCP/IP port for autport. + *nix users can try seeing what TCP/IP ports are being used by running : netstat -n + See below for setting autport via QTUITEST_DEFAULT_OPTIONS environment variable + + +* Enabling building support for Orbit or QML + + To enable Orbit suport run qmake with the addition of CONFIG+=hbwidgets + + To enable QML suport run qmake with addition of CONFIG+=qmlwidget + +* Disable building tests or examples + To disable tests run qmake with addition of CONFIG+=no_tests + + To disable example run qmake with addition of CONFIG+=no_examples + +* Enabling debug code + By default no debuging code is printed. To enable print of debuging to console + 1) set QTUITEST_DEBUG environment variable to greater than zero value eg: + export QTUITEST_DEBUG=1 + OR + 2) run qmake with DEFINES+=QTUITEST_DEBUG eg : + qmake DEFINES+=QTUITEST_DEBUG ~/depot/qtuitest/qtuitest.pro + +* Linux and Mac OS X + + Assuming source is in ~/depot/qtuitest, build in ~/build/qtuitest : + + mkdir -p ~/build/qtuitest + cd ~/build/qtuitest + qmake ~/depot/qtuitest/qtuitest.pro + make + make install + +* Windows + + Assuming source is in c:\depot\qtuitest : + + mkdir \build\qtuitest + cd \build\qtuitest + qmake c:\depot\qtuitest\qtuitest.pro + nmake + nmake install + + If using MinGW, use mingw32-make instead of nmake. + +* Symbian + + Shadow building is not supported for Symbian, you need to build in the + same directory as the source. The build procedure is essentially the same + as for other platforms : + + qmake + make debug-winscw (to build for emulator) + make release-armv5 (to build for device) + + Note that by default qtuitestrunner is not built for Symbian, as you + would normally run qtuitestrunner on a local machine and connect to a + device to run tests. + + Once built, an installable .SIS package must be created and installed + on the phone. For example : + + cd symbian + qmake qtuitest.pro + createpackage.bat QtUiTest_template.pkg release-armv5 rd.cer rd-key.pem + +* Orbit + + QtUiTest includes experimental support for Orbit. To build, ensure that the + environment variables HB_SOURCE_DIR and HB_INSTALL_DIR are set to the + appropriate locations, and use qtuitest-orbit.pro instead of qtuitest.pro. + + The sys_orbit tests require the Orbit test applications to be built, and + HB_INSTALL_DIR set correctly. + +==== USING =================================================================== + +There are some tests included which can be run like this (Linux): + + cd ~/build/qtuitest/tests/qtuitest/sys_input + make test + + To set a different autport to eg 5121 run: + export QTUITEST_DEFAULT_OPTIONS="-autport 5121" + before starting the test. + |