配置

摘要

qbs config [--settings-dir <directory>] [--user|--system] [--list [<root> ...]]
           [--unset <key>] [--export <file>] [--import <file>]
qbs config [--settings-dir <directory>] [--user|--system] <key>
qbs config [--settings-dir <directory>] [--user|--system] <key> <value>

描述

管理 Qbs 设置，例如首选项和配置文件。您可以列出所有密钥，删除指定的密钥，以及从文件导入设置或将设置导出到文件。

此命令的第二个形式显示指定的 <key>。

此命令的第三个形式使用指定的 <value> 设置指定的 <key>。

有两种类型的设置：系统级别的设置影响所有用户，而用户级别的设置针对当前用户。默认情况下，读取操作同时考虑两个来源。如果两个设置中都存在相同的密钥，那么对于列表值，系统值将附加到用户值，而对于其他类型的值，则用户级别的值优先。默认情况下，写入操作将写入用户级别的设置。使用 --user 和 --system 选项来更改此行为。

注意：可以想象默认的系统值 preferences.qbsSearchPaths 设置可能会引入不需要的 Qbs 模块，尤其是在进行交叉构建时。在这种情况下，您可以设置 preferences.ignoreSystemSearchPaths 来排除来自系统设置的搜索路径。您通常会为此特定的配置文件执行此操作。

$ qbs config profiles.myprofile.preferences.ignoreSystemSearchPaths true

您可以使用 config-ui 命令打开 Qbs 设置工具，以分层视图管理设置。

有关更多信息，请参阅配置配置文件和首选项、管理 Qt 版本、模块、模块列表以及自定义模块和元素。

选项

`--settings-dir <directory>`

从指定的 <directory> 读取所有设置（例如配置文件信息）。如果目录不存在，则将其创建。

默认值是系统特定的。例如

Linux: $HOME/.config/QtProject/qbs
Windows: %APPDATA%\QtProject\qbs
macOS: $HOME/Library/Preferences/qbs

`--list [<root> ...]`

列出 <root> 下的密钥或如果不指定根则列出所有密钥。

可能的值包括

defaultProfile 是未指定配置文件时使用的默认配置文件
preferences 接受作为二级密钥的构建首选项
profiles 接受配置文件名称作为二级密钥

`--unset <key>`

删除指定的 <key>。

`--export <file>`

将设置导出到指定的 <file>。

`--import <file>`

从指定的 <文件> 中导入设置。

`--user`

导致只读取用户级别的设置，而忽略系统级别的设置。写入操作将针对用户级别的设置，这也是默认值。

`--system`

读取和写入操作将只考虑系统级别的设置。

`--help|-h|-?`

显示命令的帮助信息。

参数

`<key>`

通常，一个 <key> 由若干个通过点分隔的级别组成。第一级显示一个根值，如 首选项 或 配置文件。根值决定第二级键是构建首选项还是配置文件名称。较低级别的键由模块名称后跟属性名称组成。

示例

列出现有配置文件

qbs config --list profiles

显示默认配置文件

qbs config defaultProfile

注意： 如果没有显示输出，使用的默认配置文件是内置配置文件 none，它不设置任何属性。

将名称为 gcc 的配置文件设置为由名为 myqt 的 Qt 配置文件的基配置文件

qbs config profiles.myqt.baseProfile gcc

将自定义模块的位置添加到首选项中，以便在不同的项目中访问该模块

qbs config preferences.qbsSearchPaths /usr/local/share/custom-qbs-extensions