Squish Manual i Squish Manual Squish Manual ii COLLABORATORS TITLE : Squish Manual ACTION NAME DATE SIGNATURE WRITTEN BY April 10, 2009 REVISION HISTORY NUMBER DATE DESCRIPTION NAME Squish Manual iii Contents 1 Welcome 1 2 Release Notes 2 2.1 Version 3.4.4.....................................................2 2.1.1 General....................................................2 2.1.2 IDE......................................................2 2.1.3 Qt-specific..................................................3 2.1.4 Java-specific.................................................3 2.1.5 Web-specific.................................................3 2.1.6 Tk-specific..................................................3 2.1.7 Source Builds.................................................3 2.2 Version 3.4.3.....................................................4 2.2.1 General....................................................4 2.2.2 IDE......................................................4 2.2.3 Qt-specific..................................................5 2.2.4 Java-specific.................................................5 2.2.5 Web-specific.................................................5 2.2.6 Tk-specific..................................................5 2.2.7 Mac-specific (Cocoa/Carbon edition)....................................6 2.2.8 Source Builds.................................................6 2.3 Version 3.4.2.....................................................6 2.3.1 General....................................................6 2.3.2 Qt-specific..................................................7 2.3.3 Java-specific.................................................7 2.3.4 Web-specific.................................................8 2.3.5 Tk-specific..................................................8 2.4 Version 3.4.1.....................................................8 2.4.1 General....................................................8 2.4.2 Qt-specific..................................................9 2.4.3 Java-specific.................................................9 Squish Manual iv 2.4.4 Web-specific.................................................9 2.4.5 Tk-specific..................................................9 2.4.6 Native Win32 Support............................................9 2.4.7 Native X11 Support.............................................9 2.5 Version 3.4.0..................................................... 10 2.5.1 General.................................................... 10 2.5.2 Qt-specific.................................................. 11 2.5.3 Java-specific................................................. 11 2.5.4 Web-specific................................................. 12 2.5.5 Tk-specific.................................................. 12 2.5.6 Source Builds................................................. 12 2.6 Version 3.3.1..................................................... 12 2.6.1 General.................................................... 12 2.6.2 Qt-specific.................................................. 13 2.6.3 Java-specific................................................. 13 2.6.4 Web-specific................................................. 13 2.6.5 Source Builds................................................. 14 2.7 Version 3.3.0..................................................... 14 2.7.1 General.................................................... 14 2.7.2 Qt-specific.................................................. 14 2.7.3 Java-specific................................................. 15 2.7.4 Web-specific................................................. 15 2.7.5 Mac-specific................................................. 15 2.7.6 Source Builds................................................. 15 2.8 Version 3.3.0 Beta 1.................................................. 15 2.8.1 General.................................................... 15 2.8.2 Qt-specific.................................................. 16 2.8.3 Java-specific................................................. 16 2.8.4 Web-specific................................................. 16 2.8.5 Mac-specific................................................. 16 2.8.6 Source Builds................................................. 16 2.9 Version 3.2.3..................................................... 17 2.9.1 General.................................................... 17 2.9.2 Qt-specific.................................................. 17 2.9.3 Web-specific................................................. 17 2.9.4 XView-specific................................................ 17 2.9.5 Source Builds................................................. 18 2.10 Version 3.2.2..................................................... 18 2.10.1 General.................................................... 18 Squish Manual v 2.10.2 Qt-specific.................................................. 18 2.10.3 Web-specific................................................. 18 2.11 Version 3.2...................................................... 18 2.11.1 General.................................................... 19 2.11.2 Qt....................................................... 19 2.11.3 Web...................................................... 19 2.11.4 Java...................................................... 19 2.11.5 Tk....................................................... 19 2.12 Version 3.1.2..................................................... 20 2.12.1 General.................................................... 20 2.12.2 Qt....................................................... 20 2.12.3 Java...................................................... 20 2.12.4 Web...................................................... 21 2.12.5 Tk....................................................... 21 2.13 Version 3.1.1..................................................... 21 2.13.1 General.................................................... 21 2.13.2 Qt....................................................... 21 2.13.3 Java...................................................... 22 2.13.4 Web...................................................... 22 2.14 Version 3.1.0..................................................... 22 2.14.1 General.................................................... 22 3 Installation 23 3.1 Installing from Binary Packages........................................... 23 3.1.1 Getting the Correct Package......................................... 23 3.1.2 Configuring the Package........................................... 24 3.1.2.1 Entering the License Key..................................... 26 3.1.2.2 Acknowledging the Terms of Use................................. 27 3.1.2.3 Paths for Java™ Settings..................................... 28 3.1.2.4 Preferred Scripting Language................................... 29 3.1.2.5 Preferred Web Browser...................................... 30 3.1.2.6 Configuration Review....................................... 31 3.1.2.7 Concluding the Configuration................................... 32 3.1.3 Using the Binary Package.......................................... 32 3.2 Installing from Source Packages........................................... 32 3.2.1 Quick Install................................................. 32 3.2.2 Configure Switches.............................................. 35 3.2.3 Installation for Testing Pure Qt 4 Applications............................... 37 3.2.4 Installation for Testing Qt 3.0 Applications................................. 39 Squish Manual vi 3.2.5 Installation for testing Qt/Embedded 2.3 applications............................ 40 3.2.6 Installation for testing of Qt/Embedded, QtopiaCore and Qtopia 4.x applications............. 42 3.2.6.1 Build instructions......................................... 42 3.2.6.2 Cross-compilation......................................... 42 3.2.6.3 Installation on the target device.................................. 43 3.2.7 Installation for testing with a single-threaded Qt library........................... 44 3.2.8 Installation for testing with a static Qt library................................ 44 3.2.9 Installation for testing with a renamed Qt library.............................. 45 3.3 Distributing and Sharing an Installation....................................... 45 4 Concepts and Making an Application Testable 48 4.1 Squish Concepts.................................................... 48 4.2 Making an application testable............................................ 49 5 Tutorial: Creating the First Test with Squish/Java™ 50 5.1 Creating a Test Suite................................................. 50 5.1.1 Choosing a Name............................................... 51 5.1.2 Selecting a Toolkit.............................................. 52 5.1.3 Choosing a Scripting Language....................................... 53 5.1.4 Selecting the AUT.............................................. 53 5.2 Recording a Test................................................... 55 5.2.1 Creating a Test Case............................................. 55 5.2.2 Recording User Input............................................. 55 5.2.3 A Generated Script.............................................. 56 5.3 Introducing Verification Points............................................ 57 5.3.1 Verifying the Outcome using Verification Points............................... 57 5.3.2 Selecting Properties to Check........................................ 58 5.3.3 Injecting