C

Building for Host Platform

From Qt Safe Renderer 2.0 onwards, Qt Safe Renderer binaries built with Qt 5.15.6 are included to the installation. However, if you like to build Qt Safe Renderer yourself, follow instructions in this topic.

Qt Safe Renderer and its examples are built via the following projects:

ProjectDescription.pro file namePath
Qt Safe RendererWhen you build Qt Safe Renderer, the Qt Safe Renderer plugins and Qt Safe Tools are built and installed under the current kit in Qt Creator (that is, the Qt version that you use for building the projects).qtsaferenderer.pro<Qt installation directory>/Src/QtSafeRenderer-<version>
The Telltales exampleWhen you build Telltales for a host platform, the desktop part of the project is built. Telltales uses layout files from the Qt Cluster example.examples.pro<Qt installation directory>/Examples/QtSafeRenderer-<version>/saferenderer
The Indicators exampleIndicators demonstrates the Qt Quick Designer related functionality.indicators.pro<Qt installation directory>/Examples/QtSafeRenderer-<version>/saferenderer/indicators/indicators.pro

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

To build Qt Safe Renderer and its examples for a host platform, execute the steps in Building Projects with Qt Creator for qtsaferenderer.pro and examples.pro. Qt Safe Renderer Binaries lists the binaries that are generated in the Qt Safe Renderer build.

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 .pro 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 > Make.
  4. In Make arguments, add 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 build, you have the following binaries under your Qt installation:

FileLocationDescription
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.
libqtsaferendererplugin.so (on Linux) / qtsaferendererplugin.dll (on Windows)<Qt installation directory>/<Qt version>/<compiler>/qml/Qt/SafeRendererA plugin that enables Qt Quick Designer related Qt Safe Renderer functionality.

Available under certain Qt licenses.
Find out more.