The CMake build tool simplifies the build process for development projects across different platforms. It automatically generates build systems, such as Makefiles and Visual Studio project files.

CMake is a third-party tool with its own documentation. This topic describes how to use CMake with Qt Quick Ultralite.

Table of contents

• Getting Started with CMake
• CMake Reference
  • CMake Variable Reference

    FREERTOS_HEAP_POLICY	Select FreeRTOS heap policy for app_target_setup_os.
    OS	Choose OS for app_* convenience functions.
    QUL_COLOR_DEPTH	Bits of display color depth to build for.
    QUL_DEBUG_BYTECODE	Adds JavaScript bytecode as comments into generated sources.
    QUL_DEBUG_LINE_DIRECTIVES	Adds #line directives into the generated sources.
    QUL_PLATFORM	Name of the platform to build for.
    QUL_TEXTURE_CACHE	Set texture/image cache size.

  • CMake Target Properties Reference

    QUL_CONTROLS_STYLE	Overrides the Controls style.
    QUL_DEFAULT_FONT_FAMILY	Default font family for Text elements.
    QUL_FONTS_DIR	Search path for fonts.
    QUL_FONT_FILES_COPY_TO_RAM	Copy the application's font files to RAM for faster access.
    QUL_GLYPHS_COPY_TO_RAM	Copy the pre-rasterized glyph data to RAM for faster access.
    QUL_MONOTYPE_SPARK_CACHE_PRIMING	Enable cache priming for the Monotype Spark font engine
    QUL_MONOTYPE_SPARK_CACHE_SIZE	Set maximum cache size for the Monotype Spark font engine
    QUL_MONOTYPE_SPARK_FONT_FILE	Enable the Monotype Spark font engine and set the font file path
    QUL_MONOTYPE_SPARK_HEAP_SIZE	Set maximum heap size for the Monotype Spark font engine

  • CMake Source File Properties

    QUL_COMPRESSION	Store image in compressed format.
    QUL_COPY_TO_RAM	Copy image data to RAM for faster access.
    QUL_IMAGE_COLOR_DEPTH	Set the preferred color depth for the image.
    QUL_OPTIMIZE_FOR_ROTATION	Enable optimizations for rotating the image at runtime.
    QUL_OPTIMIZE_FOR_SCALE	Enable optimizations for scaling the image at runtime.

  • CMake Command Reference

    app_target_default_entrypoint	Adds a minimal entry point function to target
    app_target_setup_os	Set up target for platform OS.
    qul_add_qml_module	Creates a target for a QML module.
    qul_add_resource	Adds image resources to the target.
    qul_add_target	Creates a Qt Quick Ultralite application target.
    qul_target_embed_translations	Embeds translations from .ts files.
    qul_target_generate_interfaces	Exposes the exported C++ classes to the QML context.
    qul_target_qml_sources	Adds QML source files to a target.

  • CMake Toolchains

    GHS toolchain	Green Hills Compiler Toolchain
    IAR toolchain	IAR Build Tools for Arm V8.50
    armgcc toolchain	GNU Arm Embedded Toolchain