desktop/src-tauri/installer/windows.nsi

第 1 条注释，第 1 行

desktop/src-tauri/installer/windows.nsi:1

; 参考 Tauri CLI v2.12.0，MIT 许可证见 LICENSE-MIT.upstream。

第 2 条注释，第 2 行

desktop/src-tauri/installer/windows.nsi:2

; 源码：https://raw.githubusercontent.com/tauri-apps/tauri/tauri-cli-v2.12.0/crates/tauri-bundler/src/bundle/windows/nsis/installer.nsi

第 3 条注释，第 3 行

desktop/src-tauri/installer/windows.nsi:3

; 本项目由可执行程序清理自启动项，保留其他安装或软件的值。

第 4 条注释，第 6 行

desktop/src-tauri/installer/windows.nsi:6

; Windows 10 1607+ 清单添加 dpiAwareness=PerMonitorV2；较早系统使用 ManifestDPIAware true。

第 5 条注释，第 7 行

desktop/src-tauri/installer/windows.nsi:7

; NSIS 源码 Docs 目录的相关说明见下列固定参考。

第 6 条注释，第 8 行

desktop/src-tauri/installer/windows.nsi:8

; 文档：https://github.com/kichik/nsis/blob/5fc0b87b819a9eec006df4967d08e522ddd651c9/Docs/src/attributes.but#L286-L300

第 7 条注释，第 9 行

desktop/src-tauri/installer/windows.nsi:9

; 修改说明：https://github.com/tauri-apps/tauri/pull/10106

第 8 条注释，第 15 行

desktop/src-tauri/installer/windows.nsi:15

; 设置压缩算法，默认 LZMA。

第 9 条注释，第 19 行

desktop/src-tauri/installer/windows.nsi:19

; 放在 !include 之前，早于插件命令。

第 10 条注释，第 20 行

desktop/src-tauri/installer/windows.nsi:20

; 参考：https://github.com/tauri-apps/tauri/pull/15422#discussion_r3289239624

第 11 条注释，第 87 行

desktop/src-tauri/installer/windows.nsi:87

; 此占位值不作为默认安装路径，

第 12 条注释，第 88 行

desktop/src-tauri/installer/windows.nsi:88

; 仅让 NSIS 在目录选择器中添加产品名文件夹。

第 13 条注释，第 89 行

desktop/src-tauri/installer/windows.nsi:89

; 参考：https://nsis.sourceforge.io/Reference/InstallDir

第 14 条注释，第 100 行

desktop/src-tauri/installer/windows.nsi:100

# 额外插件

第 15 条注释，第 103 行

desktop/src-tauri/installer/windows.nsi:103

; 卸载程序签名命令

第 16 条注释，第 108 行

desktop/src-tauri/installer/windows.nsi:108

; 处理 currentUser、perMachine 或 both 安装模式。

第 17 条注释，第 134 行

desktop/src-tauri/installer/windows.nsi:134

; 安装程序图标

第 18 条注释，第 139 行

desktop/src-tauri/installer/windows.nsi:139

; 安装程序侧栏图片

第 19 条注释，第 144 行

desktop/src-tauri/installer/windows.nsi:144

; 任一图片已配置时，启用安装及卸载页面的页头图片。

第 20 条注释，第 151 行

desktop/src-tauri/installer/windows.nsi:151

; 安装程序页头图片

第 21 条注释，第 156 行

desktop/src-tauri/installer/windows.nsi:156

; 卸载程序页头图片

第 22 条注释，第 161 行

desktop/src-tauri/installer/windows.nsi:161

; 卸载程序图标

第 23 条注释，第 166 行

desktop/src-tauri/installer/windows.nsi:166

; 保存安装语言的注册表键

第 24 条注释，第 171 行

desktop/src-tauri/installer/windows.nsi:171

; 安装页面按显示顺序声明。

第 25 条注释，第 172 行

desktop/src-tauri/installer/windows.nsi:172

; 第 1 页：欢迎

第 26 条注释，第 176 行

desktop/src-tauri/installer/windows.nsi:176

; 第 2 页：已配置时显示许可证

第 27 条注释，第 182 行

desktop/src-tauri/installer/windows.nsi:182

; 第 3 页：both 模式下选择安装范围

第 28 条注释，第 188 行

desktop/src-tauri/installer/windows.nsi:188

; 第 4 页：选择重新安装或卸载

第 29 条注释，第 189 行

desktop/src-tauri/installer/windows.nsi:189

; 仅在发现已有安装时显示。

第 30 条注释，第 193 行

desktop/src-tauri/installer/windows.nsi:193

; 查找符合条件的已有 WiX 安装。

第 31 条注释，第 194 行

desktop/src-tauri/installer/windows.nsi:194

;（空行）

第 32 条注释，第 195 行

desktop/src-tauri/installer/windows.nsi:195

; WiX 安装信息保存在注册表中，

第 33 条注释，第 196 行

desktop/src-tauri/installer/windows.nsi:196

; 使用 UUID 标识，因此枚举下面的所有键：

第 34 条注释，第 197 行

desktop/src-tauri/installer/windows.nsi:197

; 注册表路径 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall。

第 35 条注释，第 198 行

desktop/src-tauri/installer/windows.nsi:198

; 核对 DisplayName/Publisher 与 ${PRODUCTNAME}/${MANUFACTURER} 是否一致。

第 36 条注释，第 199 行

desktop/src-tauri/installer/windows.nsi:199

;（空行）

第 37 条注释，第 200 行

desktop/src-tauri/installer/windows.nsi:200

; 其他安装可能使用相同的产品名称和发布者，

第 38 条注释，第 201 行

desktop/src-tauri/installer/windows.nsi:201

; 即 ${PRODUCTNAME}/${MANUFACTURER}，并非本项目 WiX 包，

第 39 条注释，第 202 行

desktop/src-tauri/installer/windows.nsi:202

; 因此卸载前需要用户确认，

第 40 条注释，第 203 行

desktop/src-tauri/installer/windows.nsi:203

; 用户也可取消不符合预期的卸载。

第 41 条注释，第 207 行

desktop/src-tauri/installer/windows.nsi:207

; 没有更多注册表键时退出循环。

第 42 条注释，第 221 行

desktop/src-tauri/installer/windows.nsi:221

; 没有已有安装时跳过重新安装页面。

第 43 条注释，第 226 行

desktop/src-tauri/installer/windows.nsi:226

; 比较安装包版本与已有安装版本，

第 44 条注释，第 227 行

desktop/src-tauri/installer/windows.nsi:227

; 按结果设置提示文字。

第 45 条注释，第 239 行

desktop/src-tauri/installer/windows.nsi:239

; 重新安装相同版本

第 46 条注释，第 245 行

desktop/src-tauri/installer/windows.nsi:245

; 升级

第 47 条注释，第 251 行

desktop/src-tauri/installer/windows.nsi:251

; 降级

第 48 条注释，第 265 行

desktop/src-tauri/installer/windows.nsi:265

; passive 模式跳过此页面。

第 49 条注释，第 266 行

desktop/src-tauri/installer/windows.nsi:266

;（空行）

第 50 条注释，第 267 行

desktop/src-tauri/installer/windows.nsi:267

; 此判断放在版本读取之后，

第 51 条注释，第 268 行

desktop/src-tauri/installer/windows.nsi:268

; 让相关变量先取得

第 52 条注释，第 269 行

desktop/src-tauri/installer/windows.nsi:269

; 已安装版本信息，

第 53 条注释，第 270 行

desktop/src-tauri/installer/windows.nsi:270

; 并确定是否为降级。

第 54 条注释，第 287 行

desktop/src-tauri/installer/windows.nsi:287

; 不允许降级时，禁用降级选项对应的单选按钮。

第 55 条注释，第 293 行

desktop/src-tauri/installer/windows.nsi:293

; 初次进入此页面时选中第一个按钮；

第 56 条注释，第 294 行

desktop/src-tauri/installer/windows.nsi:294

; 之前未选择第二个按钮时，

第 57 条注释，第 295 行

desktop/src-tauri/installer/windows.nsi:295

; 再次进入也选中第一个。

第 58 条注释，第 317 行

desktop/src-tauri/installer/windows.nsi:317

; WiX 迁移总是卸载旧包。

第 59 条注释，第 322 行

desktop/src-tauri/installer/windows.nsi:322

; update 模式继续安装，不执行卸载。

第 60 条注释，第 327 行

desktop/src-tauri/installer/windows.nsi:327

; $R0：相同版本为 0，升级为 1，降级为 -1。

第 61 条注释，第 328 行

desktop/src-tauri/installer/windows.nsi:328

; $R1 保存单选按钮状态：

第 62 条注释，第 329 行

desktop/src-tauri/installer/windows.nsi:329

; 值 1 表示选择第一项。

第 63 条注释，第 330 行

desktop/src-tauri/installer/windows.nsi:330

; 值 0 表示选择第二项。

第 64 条注释，第 331 行

desktop/src-tauri/installer/windows.nsi:331

; 版本相同，继续。

第 65 条注释，第 332 行

desktop/src-tauri/installer/windows.nsi:332

; 用户选择添加或重新安装。

第 66 条注释，第 334 行

desktop/src-tauri/installer/windows.nsi:334

; 用户选择卸载。

第 67 条注释，第 337 行

desktop/src-tauri/installer/windows.nsi:337

; 升级

第 68 条注释，第 338 行

desktop/src-tauri/installer/windows.nsi:338

; 用户选择卸载。

第 69 条注释，第 341 行

desktop/src-tauri/installer/windows.nsi:341

; 用户选择保留已有安装。

第 70 条注释，第 343 行

desktop/src-tauri/installer/windows.nsi:343

; 降级

第 71 条注释，第 344 行

desktop/src-tauri/installer/windows.nsi:344

; 用户选择卸载。

第 72 条注释，第 347 行

desktop/src-tauri/installer/windows.nsi:347

; 用户选择保留已有安装。

第 73 条注释，第 361 行

desktop/src-tauri/installer/windows.nsi:361

; 添加 /UPDATE 参数。

第 74 条注释，第 362 行

desktop/src-tauri/installer/windows.nsi:362

; 添加 /P 参数。

第 75 条注释，第 363 行

desktop/src-tauri/installer/windows.nsi:363

; 添加卸载目录参数。

第 76 条注释，第 369 行

desktop/src-tauri/installer/windows.nsi:369

; ExecWait 失败时设置人工错误码。

第 77 条注释，第 373 行

desktop/src-tauri/installer/windows.nsi:373

; WiX 卸载被取消时返回维护选项页面。

第 78 条注释，第 379 行

desktop/src-tauri/installer/windows.nsi:379

; NSIS 卸载被取消时返回维护选项页面。

第 79 条注释，第 384 行

desktop/src-tauri/installer/windows.nsi:384

; 其他错误显示通用错误提示，再返回维护选项页面。

第 80 条注释，第 391 行

desktop/src-tauri/installer/windows.nsi:391

; 第 5 页：安装目录

第 81 条注释，第 395 行

desktop/src-tauri/installer/windows.nsi:395

; 第 6 页：开始菜单快捷方式

第 82 条注释，第 405 行

desktop/src-tauri/installer/windows.nsi:405

; 第 7 页：安装过程

第 83 条注释，第 408 行

desktop/src-tauri/installer/windows.nsi:408

; 第 8 页：完成

第 84 条注释，第 409 行

desktop/src-tauri/installer/windows.nsi:409

;（空行）

第 85 条注释，第 410 行

desktop/src-tauri/installer/windows.nsi:410

; 安装过程结束后不自动跳到完成页，

第 86 条注释，第 411 行

desktop/src-tauri/installer/windows.nsi:411

; 保留安装过程信息供故障排查。

第 87 条注释，第 413 行

desktop/src-tauri/installer/windows.nsi:413

; 将完成页的显示说明按钮用于创建桌面快捷方式。

第 88 条注释，第 417 行

desktop/src-tauri/installer/windows.nsi:417

; 显示安装后启动应用选项。

第 89 条注释，第 427 行

desktop/src-tauri/installer/windows.nsi:427

; 卸载页面

第 90 条注释，第 428 行

desktop/src-tauri/installer/windows.nsi:428

; 第 1 页：确认卸载

第 91 条注释，第 433 行

desktop/src-tauri/installer/windows.nsi:433

; 添加删除应用数据复选框。

第 92 条注释，第 434 行

desktop/src-tauri/installer/windows.nsi:434

; $1：内部对话框 HWND

第 93 条注释，第 435 行

desktop/src-tauri/installer/windows.nsi:435

; $2：窗口 DPI

第 94 条注释，第 436 行

desktop/src-tauri/installer/windows.nsi:436

; $3：样式

第 95 条注释，第 437 行

desktop/src-tauri/installer/windows.nsi:437

; $4：横坐标

第 96 条注释，第 438 行

desktop/src-tauri/installer/windows.nsi:438

; $5：纵坐标

第 97 条注释，第 439 行

desktop/src-tauri/installer/windows.nsi:439

; $6：宽度

第 98 条注释，第 440 行

desktop/src-tauri/installer/windows.nsi:440

; $7：高度

第 99 条注释，第 441 行

desktop/src-tauri/installer/windows.nsi:441

; 查找内部对话框。

第 100 条注释，第 469 行

desktop/src-tauri/installer/windows.nsi:469

; 第 2 页：卸载过程

第 101 条注释，第 472 行

desktop/src-tauri/installer/windows.nsi:472

; 语言配置

第 102 条注释，第 504 行

desktop/src-tauri/installer/windows.nsi:504

; 设置默认安装位置。

第 103 条注释，第 532 行

desktop/src-tauri/installer/windows.nsi:532

; 不允许降级时中止静默安装。

第 104 条注释，第 535 行

desktop/src-tauri/installer/windows.nsi:535

; 检查是否降级。

第 105 条注释，第 540 行

desktop/src-tauri/installer/windows.nsi:540

; 设置红色文字。

第 106 条注释，第 551 行

desktop/src-tauri/installer/windows.nsi:551

; 读取 WebView2 已安装版本，根据条件安装或更新。

第 107 条注释，第 562 行

desktop/src-tauri/installer/windows.nsi:562

; 安装 WebView2

第 108 条注释，第 563 行

desktop/src-tauri/installer/windows.nsi:563

;（空行）

第 109 条注释，第 564 行

desktop/src-tauri/installer/windows.nsi:564

; update 模式跳过。

第 110 条注释，第 601 行

desktop/src-tauri/installer/windows.nsi:601

; $6 保存 WebView2 安装包路径。

第 111 条注释，第 626 行

desktop/src-tauri/installer/windows.nsi:626

; Chromium 更新文档：https://source.chromium.org/chromium/chromium/src/+/main:docs/updater/user_manual.md

第 112 条注释，第 627 行

desktop/src-tauri/installer/windows.nsi:627

; 参考注册表 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\Microsoft EdgeWebView\ModifyPath。

第 113 条注释，第 651 行

desktop/src-tauri/installer/windows.nsi:651

; 复制主程序。

第 114 条注释，第 654 行

desktop/src-tauri/installer/windows.nsi:654

; 复制资源。

第 115 条注释，第 662 行

desktop/src-tauri/installer/windows.nsi:662

; 复制外部可执行文件。

第 116 条注释，第 667 行

desktop/src-tauri/installer/windows.nsi:667

; 创建文件关联。

第 117 条注释，第 674 行

desktop/src-tauri/installer/windows.nsi:674

; 注册深层链接协议。

第 118 条注释，第 682 行

desktop/src-tauri/installer/windows.nsi:682

; 创建卸载程序。

第 119 条注释，第 685 行

desktop/src-tauri/installer/windows.nsi:685

; 在注册表保存 $INSTDIR，供后续安装读取。

第 120 条注释，第 689 行

desktop/src-tauri/installer/windows.nsi:689

; 保存安装范围，供后续更新

第 121 条注释，第 690 行

desktop/src-tauri/installer/windows.nsi:690

; 或卸载时默认选用。

第 122 条注释，第 694 行

desktop/src-tauri/installer/windows.nsi:694

; 主程序名改变时删除旧主程序。

第 123 条注释，第 701 行

desktop/src-tauri/installer/windows.nsi:701

; 保存当前 MAINBINARYNAME，供后续更新读取。

第 124 条注释，第 704 行

desktop/src-tauri/installer/windows.nsi:704

; 添加或删除程序界面的注册表信息。

第 125 条注释，第 725 行

desktop/src-tauri/installer/windows.nsi:725

; 创建开始菜单快捷方式。

第 126 条注释，第 730 行

desktop/src-tauri/installer/windows.nsi:730

; 为静默及 passive 安装创建桌面快捷方式，

第 127 条注释，第 731 行

desktop/src-tauri/installer/windows.nsi:731

; 因为这些模式会跳过完成页。

第 128 条注释，第 741 行

desktop/src-tauri/installer/windows.nsi:741

; passive 模式自动关闭此页。

第 129 条注释，第 748 行

desktop/src-tauri/installer/windows.nsi:748

; 仅静默及 passive 安装检查 /R，

第 130 条注释，第 749 行

desktop/src-tauri/installer/windows.nsi:749

; GUI 安装使用复选项控制是否重新启动应用。

第 131 条注释，第 788 行

desktop/src-tauri/installer/windows.nsi:788

; 删除本安装拥有的文件，并尝试删除安装目录。

第 132 条注释，第 789 行

desktop/src-tauri/installer/windows.nsi:789

; 删除主程序。

第 133 条注释，第 792 行

desktop/src-tauri/installer/windows.nsi:792

; 删除资源。

第 134 条注释，第 797 行

desktop/src-tauri/installer/windows.nsi:797

; 删除外部可执行文件。

第 135 条注释，第 802 行

desktop/src-tauri/installer/windows.nsi:802

; 删除应用文件关联。

第 136 条注释，第 809 行

desktop/src-tauri/installer/windows.nsi:809

; 删除深层链接协议。

第 137 条注释，第 818 行

desktop/src-tauri/installer/windows.nsi:818

; 删除卸载程序。

第 138 条注释，第 826 行

desktop/src-tauri/installer/windows.nsi:826

; 非 update 模式才删除快捷方式。

第 139 条注释，第 830 行

desktop/src-tauri/installer/windows.nsi:830

; 删除开始菜单快捷方式。

第 140 条注释，第 846 行

desktop/src-tauri/installer/windows.nsi:846

; 删除桌面快捷方式。

第 141 条注释，第 855 行

desktop/src-tauri/installer/windows.nsi:855

; 删除添加或删除程序的注册表信息。

第 142 条注释，第 864 行

desktop/src-tauri/installer/windows.nsi:864

; 可执行程序的卸载前置清理负责检查 HKCU Run 中属于本安装的自启动项。

第 143 条注释，第 865 行

desktop/src-tauri/installer/windows.nsi:865

; 清理仅删除本安装拥有的值，保留其他软件或安装的值。

第 144 条注释，第 866 行

desktop/src-tauri/installer/windows.nsi:866

; 自有值不存在时，无需删除。

第 145 条注释，第 867 行

desktop/src-tauri/installer/windows.nsi:867

; update 模式保留自启动项，不执行此清理。

第 146 条注释，第 869 行

desktop/src-tauri/installer/windows.nsi:869

; --uninstall-cleanup 已删除本安装拥有的自启动项。

第 147 条注释，第 872 行

desktop/src-tauri/installer/windows.nsi:872

; 勾选删除应用数据时执行删除，

第 148 条注释，第 873 行

desktop/src-tauri/installer/windows.nsi:873

; 同时必须为非 update 模式。

第 149 条注释，第 876 行

desktop/src-tauri/installer/windows.nsi:876

; 从注册表清除安装位置 $INSTDIR。

第 150 条注释，第 880 行

desktop/src-tauri/installer/windows.nsi:880

; 从注册表清除安装语言。

第 151 条注释，第 894 行

desktop/src-tauri/installer/windows.nsi:894

; passive 或 update 模式自动关闭。

第 152 条注释，第 919 行

desktop/src-tauri/installer/windows.nsi:919

; 早期主程序名等于产品名称，

第 153 条注释，第 920 行

desktop/src-tauri/installer/windows.nsi:920

; 将旧快捷方式改为新的 MAINBINARYNAME。

第 154 条注释，第 941 行

desktop/src-tauri/installer/windows.nsi:941

; update 或 no-shortcut 模式跳过创建快捷方式，

第 155 条注释，第 942 行

desktop/src-tauri/installer/windows.nsi:942

; WiX 迁移仍创建快捷方式。

第 156 条注释，第 961 行

desktop/src-tauri/installer/windows.nsi:961

; 早期主程序名等于产品名称，

第 157 条注释，第 962 行

desktop/src-tauri/installer/windows.nsi:962

; 将旧快捷方式改为新的 MAINBINARYNAME。

第 158 条注释，第 970 行

desktop/src-tauri/installer/windows.nsi:970

; update 或 no-shortcut 模式跳过创建快捷方式，

第 159 条注释，第 971 行

desktop/src-tauri/installer/windows.nsi:971

; WiX 迁移仍创建快捷方式。