Installation

Since the QtIvi module uses the same Configure System as the rest of Qt, you can do build-time configuration and enable only the features that you need.

Features Available

The following table describes the featureas available in the module. Similar to other modules, the available features are auto-detected and displayed after the configuration step in the "Configure summary".

FeatureDependencyDescription
IVI Generator python3 python3-virtualenvThe IVI Generator provides tooling to generate source code from IDL files. The IVI Generator comes with a set of templates for specific code generation use cases.
QtRemoteObjects Support QtRemoteObjects moduleThe QtRemoteObjects Support is needed to generate qtivi backends, using QtRemoteObjects for its Inter-Process Communicationm (IPC). This feature also provides templates to generate the server part of this IPC.

The following are additional command-line options to tailor the build system according to your needs:

Command-line OptionDescription
--host-tools-onlyOnly compiles the tools needed on the host to cross-compile for another target. For example, the IVI Generator.
--ivigenerator <no|qt|system>
ConstantDescription
noDisables the IVI Generator feature completely.
qtEnables the IVI Generator feature; builds and packages the necessary files.
systemEnables the IVI Generator feature, but uses the IVI Generator-related files that are already available on the system. For example, from the native-qtivi package when you cross-compile inside Yocto.

These command-line options can be passed to qmake using the QMAKE_EXTRA_ARGS environment variable:

QMAKE_EXTRA_ARGS="--host-tools-only" qmake <qtivi-src>/qtivi.pro

Build the Required Features Only

By default, all QtIvi modules are configured to be built, depending on whether all the required dependencies are available for the respective module or not. Similar to other Qt Features, you can request for every module to be built or skip it explicitly using the --[no-]feature-<modulename> argument, when you invoke qmake.

For example, to disable building QtIvi Media:

QMAKE_EXTRA_ARGS="--no-feature-ivimedia" qmake <qtivi-src>/qtivi.pro

Selecting the required module explicitly has the advantage that you can see any errors, at configuration time, if not all dependencies are met.

General Build Process

To build QtIvi modules, run the following commands:

qmake
make
make install

© 2020 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.