Installation

Dependencies

  • Windows, Linux or macOS
  • Qt5.4 or higher

Building for desktop

$ qmake
$ make

QmlLive Bench can be started directly from build directory by executing ./bin/qmllivebench. Optionally it can be installed with

$ make install

Building for device

Note: Only needed when you want to have live reloading enabled on the target.

# using qmake from cross compiler toolchain
$ qmake "CONFIG+=skip-bench skip-examples static-link-runtime"
$ make

You need to cross-compile QmlLive and copy the ./bin/qmlliveruntime binary onto the target.

Optionally it can be packaged with the help of

$ make install INSTALL_ROOT=...

Building documentation

$ qmake CONFIG+=force_independent
$ make docs

The documentation will be available at doc/qmllive/index.html.

Build options reference

The following values can be added to qmake CONFIG variable:

OptionDescription
skip-benchDo not build QmlLive Bench
skip-examplesDo not build examples
skip-runtimeDo not build QmlLive Runtime
skip-testsDo not build tests
static-link-runtimeProduce a single-binary QmlLive Runtime executable. Without this option enabled QmlLive Runtime executable requires the libqmllive dynamic library to be copied to the target.

The following custom qmake variables are recognized:

VariableDescription
PREFIXInstallation prefix. Defaults to $$[QT_INSTALL_PREFIX].
EXAMPLES_PREFIXInstallation prefix for examples. Defaults to $$[QT_INSTALL_EXAMPLES]/qmllive.
QMLLIVE_VERSION_EXTRADistribution specific version description (spaces allowed).
QMLLIVE_REVISIONThe VCS revision number.
QMLLIVE_SETTINGS_VARIANTOverrides QCoreApplication::organizationName which is used to determine application specific QSettings storage.

© 2019 Luxoft Sweden AB. 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.