CMake 构建工具 简化了跨不同平台的项目构建过程。它自动生成构建系统，如 Makefiles 和 Visual Studio 项目文件。

CMake 是一个第三方工具，它有它自己的 文档。本主题描述了如何使用 CMake 与 Qt Quick Ultralite 一起使用。

目录

• 开始使用 CMake
• CMake 参考
  • CMake 变量参考

    QUL_ALLOW_DEPRECATED_CMAKE_API	当使用由 QmlProject 替换的 CMake 函数和标志时，忽略弃用警告
    QUL_BINARY_ASSET_OPTIONS	让您控制如何包含图像资源所需的二进制资产数据
    QUL_BOARD_SDK_DIR	目标平台软件开发套件 (SDK) 的路径
    QUL_COLOR_DEPTH	为构建的显示色深的位数
    QUL_FREERTOS_HEAP_POLICY	为 app_target_setup_os 选择 FreeRTOS 堆策略
    QUL_OS	为 app_* 便利函数选择 OS
    QUL_PLATFORM	要构建的平台名称
    QUL_PLATFORM_DEFAULT_LAYER_RENDERING_HINTS	平台层引擎的默认渲染提示
    QUL_PLATFORM_DEFAULT_NUM_FRAMES_TO_PRESERVE_ASSETS	保留文本缓存中资产所需的默认帧数
    QUL_PLATFORM_DEFAULT_TEXT_CACHE_ENABLED	给定平台的文本缓存的默认状态
    QUL_PLATFORM_DEFAULT_TEXT_CACHE_SIZE	字节字节的默认文本缓存大小
    QUL_PLATFORM_DEVICELINK_ENABLED	启用设备链接组件
    QUL_PLATFORM_PARTIAL_FRAMEBUFFER	如果启用，平台将采用部分帧缓冲区策略。
    QUL_PLATFORM_RENDER_BATCH_HEIGHT	给定平台的渲染批次高度
    QUL_SOFTWARE_RASTERIZER_FREETYPE	矢量图形的软件支持
    QUL_TARGET_TOOLCHAIN_DIR	目标工具链的路径

    已弃用的 CMake 变量列表

    QUL_DEBUG_BYTECODE	将 JavaScript 字节码作为注释添加到生成的源代码中。
    QUL_DEBUG_LINE_DIRECTIVES	将 #line 指令添加到生成的源代码中。
    QUL_PLATFORM_DEFAULT_RESOURCE_COMPRESSED_LOSSLESS_PIXEL_FORMAT_ALPHA	透明图像资产无损压缩的默认像素格式
    QUL_PLATFORM_DEFAULT_RESOURCE_COMPRESSED_LOSSLESS_PIXEL_FORMAT_OPAQUE	不透明图像资产无损压缩的默认像素格式
    QUL_PLATFORM_DEFAULT_RESOURCE_PIXEL_FORMAT_ALPHA	透明图像资产的默认像素格式
    QUL_PLATFORM_DEFAULT_RESOURCE_PIXEL_FORMAT_OPAQUE	不透明图像资产的默认像素格式
    QUL_PLATFORM_REQUIRED_IMAGE_ALIGNMENT	给定平台图像数据的最低对齐要求
    QUL_PLATFORM_REQUIRED_PIXEL_WIDTH_ALIGNMENT	新平台上的图像宽度将是该值的倍数。

  • CMake 目标属性参考（已弃用）

    QUL_AUTO_GENERATE_GLYPHS	此选项用于控制静态字体引擎的自动字形生成。
    QUL_COMPLEX_TEXT_RENDERING	启用复杂脚本渲染。
    QUL_CONTROLS_STYLE	覆盖控件样式。
    QUL_DEFAULT_FONT_FAMILY	文本元素的默认字体家族。
    QUL_DEFAULT_FONT_QUALITY	文本元素的默认字体质量。
    QUL_FONT_CACHE_PREALLOC	控制字体缓存缓冲区的预分配。
    QUL_FONT_CACHE_PRIMING	启用字体缓存初始化。
    QUL_FONT_CACHE_SIZE	设置字体引擎使用的最大缓存大小。
    QUL_FONT_ENGINE	启用提供的字体引擎。
    QUL_FONT_FILES	字体文件路径列表。
    QUL_FONT_FILES_RESOURCE_CACHE_POLICY	配置应用程序字体文件的复制到RAM以提高访问速度。
    QUL_FONT_FILES_RESOURCE_RUNTIME_ALLOCATION_TYPE	当复制应用程序时配置运行时分配类型。
    QUL_FONT_FILES_RESOURCE_STORAGE_SECTION	配置应用程序使用的资源存储部分。
    QUL_FONT_HEAP_PREALLOC	控制字体引擎使用的堆缓冲区的预分配。
    QUL_FONT_HEAP_SIZE	为字体引擎设置最大堆大小。
    QUL_FONT_VECTOR_OUTLINES_DRAWING	使用矢量轮廓进行文本渲染。
    QUL_GLYPHS_RESOURCE_CACHE_POLICY	配置将预光栅化字形数据复制到RAM以加快访问速度。
    QUL_GLYPHS_RESOURCE_RUNTIME_ALLOCATION_TYPE	配置复制预光栅化字形数据到RAM时使用的运行时分配类型。
    QUL_GLYPHS_RESOURCE_STORAGE_SECTION	配置用于预光栅化字形数据的资源存储部分。
    QUL_MAX_PARAGRAPH_SIZE	设置最大段落大小。

  • CMake 源文件属性

    已弃用的源文件属性列表

    QUL_RESOURCE_ALIGNMENT	纹理数据的字节数据对齐
    QUL_RESOURCE_CACHE_POLICY	定义图像缓存策略。
    QUL_RESOURCE_COMPRESSION	使用压缩格式存储图像。
    QUL_RESOURCE_IMAGE_PIXEL_FORMAT	设置图像的首选像素格式。
    QUL_RESOURCE_OPTIMIZE_FOR_ROTATION	启用对在运行时旋转图像的优化。
    QUL_RESOURCE_OPTIMIZE_FOR_SCALE	启用对在运行时缩放图像的优化。
    QUL_RESOURCE_RUNTIME_ALLOCATION_TYPE	定义资产运行时分配类型。
    QUL_RESOURCE_SPLIT_IMAGE_OPTIMIZATION	启用将图像分割为不透明段落的优化。
    QUL_RESOURCE_STORAGE_SECTION	定义资产存储部分。

  • CMake 命令参考

    app_target_default_entrypoint	为目标添加一个最小的入口点函数
    app_target_setup_os	设置平台操作系统为目标
    qul_add_target	创建一个 Qt Quick Ultralite 应用程序目标
    qul_generate_flash_target	为应用程序生成闪存目标
    qul_get_module_target	获取 Qt Quick Ultralite 模块目标名称
    qul_override_freertos_heap_size	覆盖freeRTOS总堆大小配置

    已弃用CMake命令列表

    qul_add_qml_module	为QML模块创建一个目标
    qul_add_resource	将图像资源添加到目标
    qul_set_maximum_resource_cache_size	为给定的运行时分配类型设置最大资源缓存大小
    qul_target_embed_translations	嵌入.ts文件中的翻译
    qul_target_generate_interfaces	公开导出的C
    qul_target_qml_sources	将QML源文件添加到目标