Building for Host Platform

The Qt Safe Renderer binaries built with Qt 6.5.5 are included in the installation.

You need to build Qt Safe Renderer yourself from sources if you like to use Qt Safe Renderer with some other Qt version than Qt 6.5.5.

Note: From Qt Safe Renderer 2.1 onwards, you must build the Qt Safe Renderer Runtime component before the Tooling component.

Building Qt Safe Renderer Runtime

You must build Qt Safe Renderer Runtime before building Qt Safe Renderer Tooling.

The Runtime sources are found under <Qt installation directory>/Src/QtSafeRenderer-runtime-<version>.

Build Qt Safe Renderer Runtime as instructed in Building Projects with Qt Creator.

Building Qt Safe Renderer Tooling

After you have built QSR Runtime, build Qt Safe Renderer Tooling.

The Tooling sources are found under <Qt installation directory>/Src/QtSafeRenderer-<version>.

Build Qt Safe Renderer Tooling as instructed in Building Projects with Qt Creator.

Qt Safe Renderer Binaries lists the binaries that are generated in the Qt Safe Renderer Tooling build.

Building Qt Safe Renderer Examples

Qt Safe Renderer Examples lists the examples included into the Qt Safe Renderer installation.

For building, you must use a Qt version that is compiled for your host platform.

To build Qt Safe Renderer examples for a host platform, execute the steps in Building Projects with Qt Creator.

Building Projects with Qt Creator

When you build a project in Qt Creator, execute the following steps:

Opening Project to Edit Mode

Open the project to Qt Creator's Edit mode:

  1. Start Qt Creator.
  2. Select File > Open File or Project and browse to a CMakeLists.txt file.
  3. Select Open.
  4. In the Configure Project page, choose a kit for building the project and select Configure Project.

The project is now open in Qt Creator's Edit mode.

Adding a Custom Build Step <make install>

Note: If you are building some of the examples in Qt Safe Renderer, you can skip this step.

Before building Qt Safe Renderer, add a custom build step that installs the binary file under <Qt installation directory>/<Qt version/<compiler>/bin in the Qt version that is used for building the project:

  1. Select a Projects mode.
  2. In the kit, select Build.
  3. Select Build Settings > Build Steps > Add Build Step > Cmake Build.
  4. In Targets, select install.
  5. Select the Edit mode. Your custom build step is automatically saved.

Building the Project

Build the project in the Edit mode by selecting Build > Build Project "<project name>".

Qt Safe Renderer Binaries

After a successful Qt Safe Renderer Tooling build, you have the following binaries under your Qt installation:

qtsafelayouttool<Qt installation directory>/<Qt version>/<compiler>/binQt Safe Layout Tool that is used for generating the safe layout data for Qt Safe Renderer.
qtsafercctool<Qt installation directory>/<Qt version>/<compiler>/binQt Safe Resource Compiler Tool that is used for generating the safe resource files for Qt Safe Renderer.

Available under certain Qt licenses.
Find out more.