WingetUI项目命令行参数与深度链接使用指南
一、命令行参数概述
WingetUI作为一款现代化的软件包管理工具,提供了丰富的命令行参数来控制程序行为。这些参数可以帮助用户实现自动化操作、故障排查以及个性化配置等功能。本文将详细介绍各版本支持的命令行参数及其使用场景。
二、核心命令行参数详解
2.1 基础控制参数
-
后台运行模式
- 参数:
--daemon
- 功能:以系统托盘模式启动程序,不显示主窗口
- 注意:需在设置中启用"开机自启"功能才能生效
- 适用版本:1.0+
- 参数:
-
设置向导
- 参数:
--welcome
- 功能:显示初始设置向导界面
- 适用版本:2.2.0及之前版本
- 参数:
2.2 更新管理参数
- 强制启用自动更新
- 参数:
--updateapps
- 功能:绕过用户设置,强制启用可用更新的自动安装
- 适用版本:1.6.0+
- 参数:
2.3 错误报告参数
-
完整错误报告
- 参数:
--report-all-errors
- 功能:程序加载时遇到任何错误都显示详细错误报告页面
- 适用版本:3.0.0+
- 参数:
-
简化错误对话框
- 参数:
--no-corrupt-dialog
- 功能:用详细错误报告替代简化的错误对话框
- 适用版本:3.2.1+
- 参数:
2.4 程序管理参数
-
卸载相关
- 参数:
--uninstall-unigetui
- 功能:从通知面板注销程序并静默退出
- 适用版本:3.1.0-3.1.8
- 参数:
-
数据迁移
- 参数:
--migrate-wingetui-to-unigetui
- 功能:迁移旧版数据文件夹和快捷方式
- 适用版本:3.1.0+
- 参数:
2.5 设置管理参数(3.2.0+)
-
设置导入导出
- 导入:
--import-settings file
- 导出:
--export-settings file
- 注意:需重启程序使更改生效
- 导入:
-
设置项操作
- 启用布尔设置:
--enable-setting key
- 禁用布尔设置:
--disable-setting key
- 设置非布尔值:
--set-setting-value key value
- 启用布尔设置:
2.6 文件处理参数
- 包捆绑文件加载
- 用法:
UniGetUI.exe 文件路径
- 支持格式:.ubundle、.json、.yaml、.xml
- 功能:在包捆绑页面加载指定文件
- 适用版本:3.1.2+
- 用法:
三、深度链接协议
WingetUI 3.1.2+版本支持通过unigetui://
协议进行深度链接交互:
-
包详情展示
- 格式:
unigetui://showPackage?id={}&managerName={}&sourceName={}
- 必填参数:包ID、管理器名称、源名称
- 格式:
-
页面导航
- 显示主界面:
unigetui://showUniGetUI
- 发现页面:
unigetui://showDiscoverPage
- 更新页面:
unigetui://showUpdatesPage
- 已安装页面:
unigetui://showInstalledPage
- 显示主界面:
四、安装程序参数
基于Inno Setup的安装程序支持以下特有参数:
-
运行控制
- 不自动启动:
/NoAutoStart
- 不注册开机启动:
/NoRunOnStartup
(3.1.6+)
- 不自动启动:
-
组件选择
- 跳过VC++运行库:
/NoVCRedist
(3.1.2+) - 跳过Edge WebView:
/NoEdgeWebView
(3.1.2+) - 不安装Chocolatey:
/NoChocolatey
- 不安装WinGet:
/NoWinGet
(不推荐)
- 跳过VC++运行库:
-
安装模式
- 所有用户:
/ALLUSERS
(需管理员权限) - 当前用户:
/CURRENTUSER
- 所有用户:
五、最佳实践建议
- 对于自动化部署,建议组合使用
--daemon
和--updateapps
参数实现静默后台更新 - 配置迁移时,先使用
--export-settings
备份,再在新环境使用--import-settings
恢复 - 生产环境中谨慎使用
/NoWinGet
参数,可能导致部分功能不可用 - 深度链接非常适合与其他管理工具集成,实现一键跳转到特定包详情
通过合理运用这些命令行参数,用户可以更高效地管理WingetUI的各项功能,实现自动化运维和个性化配置。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考