Views
Quality/QA-tools/TDriver/Getting Started
Contents |
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
Skip to #Installing TDriver.
Ubuntu 10.10
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
You will need to compile the Qt components. Skip to compilation .
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
Skip to #Installing TDriver.
Fedora 14
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
You will need to compile the Qt components. Skip to compilation .
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