C

MCU.Config.fileSelector

一个字符串列表,指定在 qmlproject 文件中对节点应使用默认的变体。

描述

当项目有很多同名但内容根据选中设备特性(屏幕大小、平台、语言等)变化的文件时,可以使用 fileSelector 属性,而且项目会针对一组特性使用每个文件。

qmlprojectexporter 会用它来保持所有变体对文件的引用相等。

qmlproject 中,您可以在以下列出的不同级别设置此属性,qmlprojectexporter 会按照相同顺序获取选择器的值。

  • 在文件节点(QmlFilesImageFilesFontFilesModuleFilesTranslationFiles)中通过 "fileSelector" 属性设置。
  • MCU.Config 节点中,使用 "fileSelector" 属性,这将对所有未定义 "fileSelector" 的文件节点应用。
  • 使用 qmlprojectexporter--selector 选项,您可以使用它来配置整个项目,并且 qmlprojectexporter 会将选择器应用于项目中使用的所有 .qmlproject 文件(主文件和导入的模块)。
  • 最后,qmlprojectexporter 可以使用项目中默认的 QFileSelector 选择器。

注意:可能的选择器值仅取决于项目中的文件夹名称(QFileSelector 将以 + 开头的文件夹视为可选择的变体)

注意:可以链接选择器 "project/+selector_one/+selector_two/resource.png"。

警告:应该将选择器放在资源路径的末尾。 QFileSelector 会忽略中间的任何选择器,并且只会将它们视为普通文件夹。例如 "project/+wrong_selector/normal_folder/+correct_selector1/+correct_selector2/resource.png"。

用法

该属性接受在主应用程序 .qmlproject 文件或模块 .qmlproject 文件中。它接受非空的字符串列表。

代码示例:

// Project files:
//      data/images/+big/logo.png
//      data/images/+small/logo.png
//      src/headers/+ram_optimized/myoperation.h
//      src/headers/+cpu_oprimased/myoperation.h

// Picks src/headers/+ram_optimized/myoperation.h
//      data/images/+small/logo.png

MCU.Config {
    fileSelector: ["ram_optimized", "small"]
}

InterfaceFiles {
    files: ["src/headers/myoperation.h"]
}

ImageFiles {
    files: ["data/images/logo.png"]
}

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

在特定的 Qt 许可下可用。
了解更多信息。