Revision as of 13:37, 24 November 2010

Testability Driver (TDriver) setup tutorial

This page describes the installation of the Testability Driver on your host machine. Currently supported hosts are Fedora 13 and Ubuntu 10.04. Repositories for newer versions will be available as soon as they are available in obs.

Installing required packages from repositories

First wee need to enable the Testing:Tools repository. See the How to set up repositories for QA-tools guide.

Ubuntu 10.04

Note - you cannot use the Ubuntu 10.04 repository in 10.10. The version is compiled agains Qt 4.6, which is not compatible

TDriver requires Rubygems and xml libraries:

sudo apt-get install rubygems ruby1.8-dev libxslt-dev libxml2-dev visualizer

Fedora 13

Unfortunately Fedora 13 does not have the required Ruby 1.8.7, so we need to compile and install it first. (If you do not want to compile it yourself, you can download the packages from here).

Compiling ruby (skip this if you downloaded the packages)

sudo yum install rpmdevtools # 
rpmdev-setuptree
sudo yum install yum-utils fedora-release-rawhide gcc
yumdownloader --enablerepo=rawhide --source ruby rubygems
sudo yum install $( rpm -qRp ruby-*src.rpm | grep -v rpmlib) gcc-g++
rpmbuild --rebuild ruby-*src.rpm # Compilation will take a few minutes

Install the ruby packges that were created:

cd ~
sudo yum localinstall --nogpgcheck   \
                    rpmbuild/*/*/ruby-1.8.7.*.rpm         \
                    rpmbuild/*/*/ruby-libs-1.8.7.302*.rpm    \
                    rpmbuild/*/*/ruby-devel-1.8.7.302*.rpm   \
                    rpmbuild/*/*/ruby-irb-1.8.7.302*.noarch.rpm \
                    rpmbuild/*/*/ruby-rdoc-1.8.7.302*.noarch.rpm

Next we need rubygems:

rpmbuild --rebuild rubygems-*src.rpm
sudo yum localinstall --nogpgcheck rpmbuild/*/*/rubygems-1.3.7*.noarch.rpm

Install other requirements, required to build native dependencies for ruby gems:

sudo yum install libxslt-devel libxml2-devel

Installing TDriver

Install the Testabiity Driver qt plugin. This will install everything required.

sudo gem install testability-driver-qt-sut-plugin # This will take a few minutes

Try that it works

export RUBYOPT="rubygems" # This should go to your login file e.g. .bashrc
ruby -e "require 'tdriver'" # Should print nothing

Ubuntu 10.04

To install visualizer:

sudo apt-get install visualizer qttas-server 

Fedora 13

sudo yum install --nogpgcheck testability-driver-visualizer qttas-server

Testing the installation

Everything should be now installed.

We need an application to test it with, so download one. Let's a classic calculator application.

Compilation:

sudo yum install git qt4-qmake gcc-c++
git clone http://git.gitorious.org/tdriver/tests.git
cd tests/calculator
qmake # in Fedora qmake-qt4
make

Start the qttas-server and the calculator

qttas-server &
./calculator &

You should see a simple calculator application. Next, let's start the visualizer.

tdriver_visualizer &

In the visualizer, select File->Refresh. You should see a picture of the calculator application. If you hover your mouse above the picture, it the visualizer will highlight the object tree will display the object under cursor.

Right click on an element, for example one button, and select "send tap to SUT". The calculator should receive a click to the "1" button. If so, congratulations you have a working TDriver environment!

What's next

TODO - Contacting to MeeGo device - Tutorial for test creation - ??

Links

• TDriver wiki
• API Documentation
• Gitorious project