Installing Qt Safe Renderer

Qt License

Qt Safe Renderer installation is available only via Qt online installer. In order to install Qt Safe Renderer, you must purchase the required commercial license separately for your Qt account. So, Qt Safe Renderer is not included in Qt's Application Development or Device Creation licenses. For more information, contact us.

Installing Qt Safe Renderer

Download the online installer. On Linux, see General Installation Issues for Linux.

Launch the online installer and follow the instructions in the installation wizard. In the Select Components page, you see a list of all Qt components that are available for your Qt account. Select Qt Safe Renderer and finish the installation as instructed in the wizard.

The installed Qt Safe Renderer content is found under the Qt installation directory that you set in the installation wizard. In this Safety Manual, the installation directory is referred as <Qt installation directory>.

In the Qt Safe Renderer release, only the source code of Qt Safe Renderer is provided via the online installer. Before developing UI with Qt Safe Renderer, you must build Qt Safe Renderer from the sources. See Building for QNX and Building for Host Platform.

General Installation Issues for Linux

On Linux, remember to allow the execution of the installer binary. You can do this by using one of the following methods:

  • On the command line enter the chmod +x <filename> command.
  • Right-click the file, and select Properties > Permissions > Allow executing file as program.

Note: Do not execute the installer as a root user or with sudo.

Qt Safe Renderer Installation Content

The Qt Safe Renderer installation contains:

  • Qt Safe Renderer sources under <Qt installation directory>/Src/QtSafeRenderer-<version>/src
  • Qt Safe Renderer examples under <Qt installation directory>/Examples
  • Qt Safe Renderer documentation under <Qt installation directory>/Docs
    • Qt Safe Renderer architecture and design documentation
    • Unit test case documentation
    • Code Coverage test reports
    • Qt Safe Renderer Safety Manual
    • Qt Safe Renderer Verification specification
    • Qt Safe Renderer Verification report
  • Qt Safe Renderer unit tests under <Qt installation directory>/Src/QtSafeRenderer-<version>/tests
  • Qt Safe Renderer unit test documentation in <Qt installation directory>Docs/QtSafeRenderer-<version>/tests/qtsr-unit-tests.html

The sources of the Qt Safe Renderer core part are under <Qt installation directory>/Src/QtSafeRenderer-<version>/src/saferenderer. The Qt Safe Renderer core part covers the content inside the SafeRenderer namespace (see Qt Safe Renderer C++ Classes).

Uninstalling Qt Safe Renderer

To uninstall Qt Safe Renderer, you need to launch the maintenance tool under the Qt Safe Renderer installation directory.

Uninstalling All Qt Components

You can uninstall all installed Qt components (including Qt Safe Renderer) as follows:

  • Launch the maintenance tool.
  • In Welcome to Qt Maintenance Tool, select Next.
  • In Maintain Qt, enable the Uninstall only checkbox.
  • Follow the instructions in the wizard.

After exiting the maintenance tool, all installed Qt components under your installation folder are removed.

Uninstalling Only Qt Safe Renderer Components

You can uninstall only the installed Qt Safe Renderer files as follows:

  • Launch the maintenance tool.
  • In Welcome to Qt Maintenance Tool, select Next.
  • In Qt Account - Your unified login to everything Qt, select Next.
  • In Setup - Qt, enable Add or remove components and select Next.
  • In Select Components, deselect Qt Safe Renderer in the list of installed components and select Next.
  • Follow the instructions in the wizard.

After exiting the maintenance tool, all installed Qt Safe Renderer components under your installation folder are removed. If you have built Qt Safe Renderer or its examples, the compiled binaries are not removed during the Qt Safe Renderer uninstallation. Instead, you need to delete them manually to remove all the Qt Safe Renderer related files.

When you manually delete the Qt Safe Renderer files, you need to check if the following paths contain some Qt Safe Renderer files:

PathFile or directory
<Qt Safe Renderer installation directory>/<Qt version>/<compiler>/binThe qtsafelayouttool binary file
<Qt Safe Renderer installation directory>/<Qt version>/<compiler>/qml/QtThe SafeRenderer directory
<Qt Safe Renderer installation directory>/ExamplesBuild directories of Qt Safe Renderer examples
<Qt Safe Renderer installation directory>/SrcThe build directory of Qt Safe Renderer

Available under certain Qt licenses.
Find out more.