命令行界面

使用 Qt 安装器框架创建的安装程序具有以下命令行界面语法

installer.exe [options] command <args> <key=value>

在此 [选项] 是一个或多个支持的选项，可以是简短或长形式。此外，某些选项可能需要通过赋值运算符或空格传递的强制值。

命令 是支持的头模式文本模式下运行的命令行安装操作之一。某些命令可能提供了通过空格分隔的可选 <args>。使用 <key=value> 列表通过框架设置内部键值对。

安装程序在执行后将返回一个退出码。退出码可以用来确定安装是否成功，如果安装有强制更新等。请参阅 PackagemanagerCore::Status。

选项摘要

标有 CLI 的选项仅在无头模式下运行时可用，其余选项也可以在图形模式下使用。对于特定版本 Qt 安装器框架的可用选项的最完整列表，请参阅 installerbase 的 --help 选项输出。

选项	用法
-?, -h, –help	显示帮助。
-v, –version	显示版本信息。
-d, –verbose	详细模式。打印更多信息。
-g, –logging-rules <rules>	根据传递的规则启用日志记录。以逗号分隔的日志规则具有以下语法：`loggingCategory=true/false`。通过传递空日志规则启用所有日志类别。以下规则启用了单个类别：`ifw.*=false, ifw.category=true`。可通过 –help 选项引用可用的日志类别。
–ar, –add-repository <URI,...>	将本地或远程仓库添加到用户定义仓库列表中。
–at, –add-temp-repository <URI,...>	将本地或远程仓库添加到临时可用仓库列表中。
–st, –set-temp-repository <URI,...>	将本地或远程仓库设置为临时仓库，它是获取过程中唯一使用的仓库。注意：URI 必须以协议前缀开头，例如 file:///、https://、http:// 或 ftp://。
–sp, –system-proxy	在 Windows 和 Linux 上使用系统代理。此选项对 macOS 无效。（默认值）
–np, –no-proxy	不使用系统代理。
–su, –start-updater	以更新模式启动应用程序。这将覆盖内部标记，用于区分当前运行的二进制文件类型。
–sm, –start-package-manager	以包管理器模式启动应用程序。这将覆盖用于区分当前运行的二进制文件类型的内部标记。
–sr, –start-uninstaller	以卸载程序模式启动应用程序。这将覆盖用于区分当前运行的二进制文件类型的内部标记。
-t, –root <directory>	[CLI] 设置安装根目录。
–oi, –offline-installer-name <filename>	[CLI] 设置生成的离线安装程序的名称。如果没有此选项，则使用原始文件名，并附加 "_offline-yyyy-MM-dd" 后缀。
-p, –platform <plugin>	使用指定的平台插件。
–nf, –no-force-installations	允许取消选择被标记为强制性的组件。
–nd, –no-default-installations	取消选择被标记为默认的组件。
–ns, –no-size-checking	禁用检查安装目标的空间。
–sv, –show-virtual-components	在安装程序和软件包管理器中显示虚拟组件。
-i, –install-compressed-repository <文件,...>	安装QBSP或7z文件。QBSP（板级支持包）文件必须是一个包含有效存储库的.7z文件。
-c, –create-local-repository	在安装目录内创建本地存储库。此选项对在线安装程序没有影响。
–fp, –filter-packages <element=regex,...>	[命令行界面] 以逗号分隔的附加关键字值对列表，用于通过搜索命令查询软件包。键可以是任何可能的软件包信息元素，如`DisplayName`和`Description`。
–cp, –cache-path <路径>	设置用于本地元数据缓存的路径。路径必须可由当前用户写入。
–type package\|alias	[命令行界面] 为支持多种参数类型的命令（如搜索）设置给定参数的类型。默认为别名。
–am, –accept-messages	[命令行界面] 接受所有消息查询，无需用户输入。
–rm, –reject-messages	[命令行界面] 拒绝所有消息查询，无需用户输入。
–aa, –auto-answer <标识符=值>	[命令行界面] 使用消息标识符和按钮值自动回答消息查询。可以给出多个`标识符=值`对，用逗号分隔，例如`--auto-answer message.id=确定,message.id2=取消`。
–da, –default-answer	[命令行界面] 自动以默认值回答消息查询。
–al, –accept-licenses	[命令行界面] 无用户输入地接受所有许可协议。
–file-query <标识符=值>	[命令行界面] 自动设置安装脚本请求的QFileDialog值getExistingDirectory()或getOpenFileName()。可以给出多个`标识符=值`对，用逗号分隔，例如`--file-query filedialog.id=C:Temp,filedialog.id2=C:Temp2`。
-c, –confirm-command	[命令行界面] 无用户输入地确认安装、更新或删除组件的开始。
-s, –script <文件>	执行作为参数给出的脚本。
–ss, –start-server <模式, 套接字名, 密钥>	以无头进程启动应用程序，等待执行命令。模式可以是DEBUG或PRODUCTION。在DEBUG模式中，可以省略选项值。注意：服务器不会自行关闭，需要手动退出进程。
–sc, –start-client <套接字名, 密钥>	启动应用程序以调试客户端-服务器通信。如果省略了值，客户端将使用默认值。注意：在这种情况下，客户端应用程序不会启动服务器进程，需要您自行启动。
-q, –squish-port <端口号>	给出Squish可以连接到的端口号。如果没有给出端口号，则使用默认端口11233。注意：为了启用Squish支持，您首先需要使用SQUISH_PATH参数构建IFW，其中SQUISH_PATH指向您的Squish安装文件夹：`<path_to_qt>/bin/qmake -r SQUISH_PATH=<pat_to_squish>`。
–mco, –max-concurrent-operations <线程数>	指定在组件解包阶段执行并发操作时使用的最大线程数。设置为正数，或0（默认）以让应用程序从系统的逻辑处理器核心数中确定理想的线程数。

命令摘要

命令	用法
in, install <pkg\|别名 ...>	安装作为参数给出的软件包和别名。如果没有给出参数，则安装默认软件包集。
ch, check-updates	显示维护工具中可用更新的信息。
up, 更新 <.pkg ...>	更新作为参数提供的软件包。如果没有提供软件包，则安装所有可用更新。
rm, 删除 <.pkg ...>	卸载选定的软件包及其子组件。
li, 列出 <.pack软件包正则表达式>	列出当前安装的软件包的信息。
se, 搜索 <.pack软件包正则表达式\|别名>	搜索可用的别名或软件包。如果没有给出搜索模式，则显示所有可用的软件包。注意：可以使用 `--filter-packages` 选项来指定搜索操作要应用的其他筛选器。请参阅选项摘要。注意：可以使用 `--type` 选项来指定要搜索的内容类型。请参阅选项摘要。
co, 创建安装包 <.pkg ...>	从选定的软件包创建离线安装器。
cc, 清除缓存	清除本地元数据缓存的内容。
pr, 清理	卸载所有软件包并删除程序目录。

参考配置文件