Revision as of 14:29, 24 November 2010

Testability Driver (TDriver) Getting Started Guide

This page describes the installation of the Testability Driver on your host machine. We provide repositories for Fedora 13 and Ubuntu 10.04, and more will be added as soon as it's possible from OBS. For other platforms and versions you will need to compile the Qt components from source.

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

Ubuntu 10.10

Before the repository is available, you will need to compile the Qt components from see below .

To install build requirements

sudo apt-get install libxtst-dev libqtwebkit-dev qt4-qmake g++ libqt4-dev 

Requirements for Ruby components:

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

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 step 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

Fedora 14

Before the repository is available, you will need to compile the Qt components from see below .

Build requirements:

sudo yum install libxtst-devel libqtwebkit-devel qt4-qmake gcc-c++ libqt4-devel

Build requirements for Ruby components:

sudo yum install libxslt-devel libxml2-devel

Compling TDriver from source repositories

Compilation

Compile and install qttas-server

git clone http://gitorious.org/tdriver/agent_qt.git # Note that this our development master. See the list of available tags if you want to checkout a released version.
cd agent_qt 
qmake -r CONFIG+=no_mobility 
make
sudo make install

Compile and install visualizer

git clone http://gitorious.org/tdriver/visualizer.git
cd visualizer
qmake -r 
make 
sudo make install

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'" 

The command above prints out nothing, the ruby components are installed successfully.

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

Now we are ready to 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 & # If you compiled visualizer from source, it will be under /opt/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, the visualizer will highlight the object that is currently under the 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
• Running cucumber tests
• Making your application load the testability plugin
• Making your application testable

Links

• TDriver wiki
• API Documentation
• Gitorious project