定义如何包含图像资源二进制资产数据。

描述

此 QmlProject 属性控制如何将图像资源的二进制资产数据包含到应用程序的二进制文件中。

可用的选项包括

• COMPILE - qulrcc 将二进制资产数据作为 uint64_t 值数组在生成的 C++ 文件中发出 (qulrcc_assets.cpp)。此选项可能会导致编译时间更长，并且如果 C++ 文件太大，编译器可能会耗尽内存。
• SYMBOLS - 使用自定义链接器选项为每个存储部分提供所需的符号，直接来自生成的资产数据二进制文件。此选项仅支持 IAR 和 GreenHills 编译器工具链。另外，在使用 GreenHills 编译器工具链时，需要修改链接脚本。
• INCBIN - qulrcc 生成一个汇编源文件 (qulrcc_assets_s.S)，并使用 incbin 指令来加载资产二进制文件。此选项仅支持 GCC 编译器工具链。

与 GreenHills 使用变量

SYMBOLS 选项与 rawimport 链接器选项一起使用以包含资产二进制文件。此外，链接脚本必须将资产二进制数据放在相应的部分中，并提供相应的符号。

以下是默认 "QulResourceData" 资源存储部分的示例

QulResourceData ALIGN(128) :{qul_resources_QulResourceData.bin(.raw)} >.
qul_resources_QulResourceData_instance = addr(QulResourceData);

支持 GreenHills 工具链的参考平台的链接脚本中包含了必要的更改。

用法

此属性接受在主应用程序 .qmlproject 文件中，或针对目标平台的 BoardDefaults.qmlprojectconfig。它接受一个字符串，默认值为 "Automatic"。

可用的选项包括

• "Automatic"
• "incbin"
• "symbols"
• "winresource"
• "compile"

代码示例：

MCU.Config {
    binaryAssetOptions: "symbols"
}

自从

此属性是在 QmlProject API 1.3 中引入的。