forked from qt-creator/qt-creator
06898f0ae7
With clang 6.0 from Ubuntu's repositories, tst_memberoperator will fail. Change-Id: I4cbd4f13e849816e70934312d67c079a88ba89a8 Reviewed-by: Christian Stenger <christian.stenger@qt.io>
91 lines
4.5 KiB
Plaintext
91 lines
4.5 KiB
Plaintext
Prerequisites - general information
|
|
-----------------------------------
|
|
Squish tests inside this folder have several prerequisites to get them running.
|
|
|
|
First - and most important - you have to own a valid Squish license. At least Squish 6.0 is required.
|
|
|
|
Second - some of the test suites/test cases expect a build of Qt 4.8.7 to be available:
|
|
1. Download the source code from:
|
|
* Windows: https://download.qt.io/archive/qt/4.8/4.8.7/qt-everywhere-opensource-src-4.8.7.zip
|
|
* Other: https://download.qt.io/archive/qt/4.8/4.8.7/qt-everywhere-opensource-src-4.8.7.tar.gz
|
|
2. Extract the contents of the archive's directory qt-everywhere-opensource-src-4.8.7 to:
|
|
* Windows: C:\Qt\Qt4.8.7
|
|
* Other: $HOME/Qt4.8.7
|
|
3. Apply the changes from patch.txt next to this README.
|
|
4. In the directory you extracted the sources to, configure Qt:
|
|
* Windows (MSVC2013 32 bit):
|
|
.\configure.exe -opensource -developer-build -confirm-license -debug-and-release -nomake tests -nomake examples -nomake demos -no-webkit -no-phonon
|
|
* Linux (gcc < 6):
|
|
./configure -opensource -developer-build -confirm-license -debug-and-release -nomake tests -nomake examples -nomake demos -no-webkit -no-phonon
|
|
* macOS:
|
|
./configure -opensource -developer-build -confirm-license -debug-and-release -nomake tests -nomake examples -nomake demos -no-webkit -no-phonon -sdk <PATH_TO_INSTALLED_MACOSX_SDK>
|
|
5. Make:
|
|
* Windows (do not use jom):
|
|
nmake
|
|
* Other:
|
|
make -j<number of available cores>
|
|
|
|
Third - some of the test suites/test cases expect Qt versions to be installed in their default
|
|
locations. On Linux/macOS this is ~/Qt5.x.1 and on Windows this is C:\Qt\Qt5.x.1. It's easiest to
|
|
use installations of the official opensource Qt packages. Just install the Qt version for the
|
|
respective toolchain with the components (if available):
|
|
- (Desktop) <toolchain> <bitness>, e.g. Desktop gcc 64-bit
|
|
- Qt Quick Controls
|
|
- Qt Script
|
|
|
|
The exact versions and toolchains are:
|
|
|
|
Linux:
|
|
Qt 5.4.1 (gcc)
|
|
Qt 5.6.1-1 (gcc)
|
|
Qt 5.10.1 (gcc)
|
|
|
|
macOS:
|
|
Qt 5.6.1-1 (clang)
|
|
Qt 5.10.1 (clang)
|
|
|
|
Windows:
|
|
Qt 5.4.1 (gcc)
|
|
Qt 5.6.1-1 (MSVC2013, 32 bit)
|
|
Qt 5.10.1 (MSVC2015, 32 bit)
|
|
|
|
Fourth - you'll have to provide some additional repositories.
|
|
These additional repositories are located inside ~/squish-data or C:\Users\<user>\squish-data (depending on the OS you're on).
|
|
You can also just provide them inside a different folder and specify the folder with the environment variable SYSTEST_SRCPATH.
|
|
This folder must contain the following:
|
|
* a QtCreator repository (or source copy) of tag v4.7.0 named 'creator' including the submodule src/shared/qbs
|
|
* a subfolder called 'creator-test-data'
|
|
* a speedcrunch 0.11 repository (or source copy) inside 'creator-test-data' named 'speedcrunch'
|
|
|
|
Fifth - you'll have to make sure that some needed tools are available (no matter on which OS you're on).
|
|
* cmake
|
|
* wget or curl, capable of HTTPS
|
|
Normally it should be okay to just install them as usual and add their executables' path(s) to the PATH variable.
|
|
|
|
Sixth - Qt Creator must be built on a Qt without Qt WebEngine or Qt WebKit. Its ClangCodeModel
|
|
plugin should be linked to LLVM/Clang 7.0.0 or later. How to do so, see QTCREATOR_REPO/README.md.
|
|
With a lower version, the tests for the ClangCodeModel might fail. Without the plugin, the tests for
|
|
the ClangCodeModel will be skipped but will not cause failures.
|
|
|
|
On macOS make sure you are using the correct keyboard layout to avoid problems when using keyboard interaction. Tested and known to be
|
|
working would be 'U.S. International - PC', while pure 'U.S.' had problems.
|
|
Use the settings in System Preferences > Keyboard > Input Sources to install missing keyboard layouts and ensure you have set it as default.
|
|
|
|
Attention! If any of these prerequisites cannot be satisfied the tests will likely fail (or not run at all).
|
|
|
|
|
|
Prerequisites - debugging and analyzing
|
|
-----------------------------------------
|
|
In tst_simple_debug from suite_debbugger, Creator needs to read data from an application it
|
|
started. On Windows, this has the following prerequisites:
|
|
Either:
|
|
* have no firewall at all enabled (sure that's a bad idea)
|
|
Or:
|
|
* run Windows with English UI
|
|
* have the Windows Firewall enabled (no other firewalls are handled by the scripts)
|
|
* run the Squish tests with administrator privileges
|
|
* additionally the UAC should be disabled, too
|
|
|
|
Otherwise you'll have some trouble with popping up dialogs from the firewall.
|
|
If you're using a different firewall - try to figure out and add a rule for this.
|