Chapter 3. How to Install Squish

Table of Contents

3.1. Installing the Command Line Tools, Server, and IDEs
3.1.1. Installing from Binary Packages
3.1.2. Installing Squish for Qt from Desktop Source Packages
3.1.3. Installing Squish for Qt from Embedded Source Packages
3.1.4. Distributing and Sharing an Installation
3.1.5. Installing Squish for Mac
3.1.6. Installation for Web Testing using browsers on mobile devices
3.1.7. Installation for Web Testing using Opera® up to version 12
3.1.8. Installation for Flex applets in web pages
3.1.9. Installing Squish for Android
3.2. Standalone Installation of the IDE
3.2.1. Installing the IDE on Windows
3.2.2. Installing the IDE on Linux
3.2.3. Installing the IDE on Mac OS X
3.3. Using Squish

This chapter explains how to install Squish on Windows, and on Unix-like systems such as Linux, Mac OS X, and Embedded Linux.

Squish 4.1 and later is supplied as a single easy to install and set up binary package that contains the Tools and the IDE. Squish 4.1 and later is also available in separate packages for when this is preferred or necessary—a Tools package in source form, and a separate binary for the new Eclipse-based Squish IDE. (It is also possible to use Eclipse as your IDE by integrating the Squish IDE plugins into it. See Eclipse IDE Integration (Section 21.6).)

In many cases Squish's command line tools can be successfully installed using binary packages, but there are some situations where it is necessary to build them from source, either using a standard build or—in particular cases—a non-standard build.

The cases where it is not possible to do a standard build are when you want to test applications built with a non-standard Qt library or running on a non-standard system. If any of these applies, the following sections describe how to do a non-standard build of Squish from source in the relevant circumstances:

If none of the cases above applies—for example, you are testing Java or Web applications or native Mac OS X or Windows applications, or Qt 4 applications using a standard (multi-threaded and shared) library, then using a binary package is the quickest and easiest way to get Squish up and running. The process is explained in Installing from Binary Packages (Section 3.1.1).

[Note]Using Squish with Qt debug libraries

The prebuilt binary packages are built against release versions of the Qt libraries—not against the debug versions. If you want to use Squish with Qt debug libraries inquire with technical support about the availability of a debug version for your configuration. If not available you will need to build Squish from source. (See Installation for Testing Pure Qt 4 Applications (Section

However, if for some reason—perhaps you are using an unusual Unix system or setup, or if you want to use Qt debug libraries—a binary package is not suitable, you can always do a standard build from source. This is explained in the section Installing Squish for Qt from Desktop Source Packages (Section 3.1.2), although it is also worth reading Configure Switches (Section first, so that you know what options are available to you when you run configure.

And if you want to use a Squish installation on more than one machine, you will find it helpful to read Distributing and Sharing an Installation (Section 3.1.4).

One the binary package is unpacked you can immediately start up the Squish IDE—its executable is SQUISHDIR\bin\squishide.exe on Windows, SQUISHDIR/bin/squishide on Unix, and SQUISHDIR/bin/ on Mac OS X. (The first time you run the Squish IDE you will be presented with the setup application which you can use to configure Squish—this only happens once.)

[Warning]iOS (e.g., iPhone and iPad) Testing

Note that iPhone and iPad applications can only be tested on Apple hardware—either on the devices themselves or on simulators that run under Mac OS X.


When you unpack a Squish package it is put into the directory you specify. The Squish installation and setup do not not touch the Windows registry or interfere with any system files or directories—for example, Squish doesn't put any files in C:\Windows or /usr/bin.

The only files that Squish creates outside of its own directory are configuration files that are stored in your home directory in the %APPDATA%\froglogic\Squish or $HOME/.squish subdirectory, plus the Squish license file which is normally stored as %HOMEPATH%\.squish-3-license (or %USERPROFILE%\.squish-3-license if %HOMEPATH% isn't defined ) or $HOME/.squish-3-license. And on Windows, Squish also creates the %HOMEPATH%\My Documents\Squish Test Results (or %HOMEPATH%\My Documents\Squish Test Results) directory—on other platforms this directory is $HOME/.squish/Test Results.

If you want to uninstall Squish, simply delete the directory it was installed into.

It is best to keep the license file and to leave the configuration files alone so that if you install a new version it will already have all your settings in place. However, if you want to do a complete uninstallation simply delete the configuration directory (and on Windows the test results directory), and the license file, in addition to the Squish directory.