Squish: Add some hints for the setup on macOS

Change-Id: I7aaaee9f32b22f632bdd80c2bcfb1f0cc19f1c8d
Reviewed-by: Robert Loehning <robert.loehning@qt.io>

1 files changed, 25 insertions, 0 deletions

diff --git a/tests/system/README b/tests/system/README
index bcb808caf0..6a62bb8d05 100644
--- a/tests/system/README
+++ b/tests/system/README
@@ -29,6 +29,27 @@ Third - some of the test suites/test cases expect Qt 5.3.1 (default toolchain),
 installed in their default locations. On Linux/Mac this is ~/Qt5.x.1 and on Windows this is C:\Qt\Qt5.x.1. The default toolchains are gcc on Linux,
 clang on Mac and MSVC2010 (Qt <= 5.5) or MSVC2013 (Qt > 5.5) on Windows. It's easiest to use default installations of the official opensource Qt packages.
 
+On macOS it might be necessary to tweak some files of the Qt installation - depending on the installed Xcode and its installed SDKs.
+If Xcode 8+ is installed you will need to update the file
+~/Qt5.3.1/5.3/clang_64/mkspecs/features/mac/default_pre.prf
+Change the line
+
+ isEmpty($$list($$system("/usr/bin/xcrun -find xcrun 2>/dev/null")))
+
+to
+
+ isEmpty($$list($$system("/usr/bin/xcrun -find xcodebuild 2>/dev/null")))
+
+Furthermore - depending on the installed SDK it might be necessary to update the file
+~/Qt5.3.1/5.3/clang_64/mkspecs/qdevice.pri
+Search for the following line
+
+ !host_build:QMAKE_MAC_SDK = macosx10.8
+
+Newer Xcode might miss the 10.8 SDK. Check
+/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs
+which SDKs are installed and update the version number accordingly.
+
 Fourth - you'll have to provide some additional repositories (and for the hooking into subprocesses even some more Squish bundles, see below).
 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.
@@ -46,6 +67,10 @@ Normally it should be okay to just install them as usual and add their executabl
 Sixth - Qt Creator should be built with ClangCodeModel plugin. How to do so, see QTCREATOR_REPO/src/plugins/clangcodemodel/README. Without the
 plugin, the tests for 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).