Skip to content

Latest commit

 

History

History
82 lines (64 loc) · 2.25 KB

static-compile.md

File metadata and controls

82 lines (64 loc) · 2.25 KB

Compile a static desktop remote-ui app

A static remote-ui app allows to run the application on other systems without having to install the Qt runtime environment.

This is not required for local development.

macOS

Tested on macOS 13 with Xcode SDK 13.

Install Qt 5.15.2 & Qt Creator

  1. Download Qt for Open Source development: https://www.qt.io/download
  2. Register, if you don't have an account yet.
  3. Install:
    • Use default installation folder: ~/Qt
    • Select:
      • Qt 5.15.2
      • Sources
      • Qt Virtual Keyboard
      • Qt Network Authorization

Compile static Qt framework

⚠️ Xcode 15 with SDK 14 breaks qmake and the build! This requires the following Qt patches:

See comment in issue #1 for more information on how to patch it.

  1. Make sure that Xcode and command line tools are installed
  2. Patch Qt source file ~/Qt/5.15.2/Src/qtbase/src/plugins/platforms/cocoa/qiosurfacegraphicsbuffer.h
    Add the following include just before QT_BEGIN_NAMESPACE:
#include <CoreGraphics/CGColorSpace.h>
  1. Create a shallow build directory (don't compile inside source directory):
mkdir -p ~/projects/qt-static-5.15.2
cd ~/projects/qt-static-5.15.2
  1. Configure
~/Qt/5.15.2/Src/configure --prefix=~/Qt/5.15.2/clang_64-static -static -debug-and-release \
    -nomake examples -nomake tests \
    -qt-libpng -qt-zlib -qt-libjpeg \
    -opensource -confirm-license \
    -opengl -qt-freetype -qt-pcre -qt-harfbuzz -platform macx-clang
  1. Make
    Adjust 8 to the available number of cores in your machine:
make -j 8
  1. Install
make -j 8 install
  1. Configure a new Qt Kit in Qt Creator
    • Preferences, Kits, Qt Versions: Add...
      • Select ~/Qt/5.15.2/clang_64-static/bin/qmake
    • Preferences, Kits: Add
      • Name: Desktop Qt 5.15.2 static
      • Qt version: previously defined Qt version Qt 5.15.2 (clang_64-static)
  2. Change Kit in project, compile, finished!

Linux

Contributions welcomed 😊

Windows

Contributions welcomed 😊