Upgrade Uninstall

升级与卸载

默认安装位置

开发机	私有数据目录	命令入口
macOS Apple Silicon	~/Library/Application Support/webman-aot-builder	~/.local/bin/webman-aot
Windows x64	%LOCALAPPDATA%\webman-aot-builder	%LOCALAPPDATA%\webman-aot-builder\bin\webman-aot.cmd

入口会显示安装位置和 PATH 影响；自定义安装应沿用自己的根目录与 bin 参数。私有目录包含 current、versions、toolchains、cache、logs 等，不是业务项目目录。

升级

更换工具包前先查看开发状态和所选发布记录中的修复范围；公开包不等于已正常可用，不能把升级当作未经验证的解决办法。需要测试另一个包时，从下载与发布记录取得同平台 setup，按安装入口确认安装，完成后重新打开终端运行 webman-aot version 核对所选包身份。项目产物不会因为工具升级自动重新构建；按需要重新构建并验收。

签名更新命令见命令参考。它需要实际可信 HTTPS 更新清单和可信密钥，缺少配置会报 update manifest URL is not configured。回滚只激活已有前代次；没有前代次时不能保证回滚可用。

清理旧版本后使用 Composer（0.3.5）

先安装轻量 Composer 入口。它无需准备完整运行时即可列出和卸载旧版本；旧原生 0.3.2 与 Composer 0.3.3 不包含此功能。新入口仍使用固定的 0.3.2 完整运行时，本次没有重发完整原生安装包。

Windows PowerShell 中依次运行：

本清理流程使用 --no-scripts 跳过自动项目菜单，先逐项清理旧安装。

composer global require supdger/webman-aot-builder:^0.3.7 --no-scripts
if ($LASTEXITCODE -ne 0) { throw 'Composer 安装失败，未开始卸载。' }
$aotBin = (composer global config bin-dir --absolute).Trim()
& (Join-Path $aotBin 'webman-aot.bat') uninstall --list
& (Join-Path $aotBin 'webman-aot.bat') uninstall
& (Join-Path $aotBin 'webman-aot.bat') uninstall --list
& (Join-Path $aotBin 'webman-aot.bat') --version

从 Composer 代理的完整路径启动，避免 PATH 中旧同名命令抢先执行。卸载时对核对过的旧原生版本、旧命令或备份输入 y，对 “Composer 全局包（supdger/webman-aot-builder）”输入 n，保留新入口。每项回车或 n 保留，q 结束并保留余项；EOF 或非交互环境不会默认删除，不支持免确认全删。

macOS 终端的相同流程：

composer global require supdger/webman-aot-builder:^0.3.7 --no-scripts || exit "$?"
aot_bin="$(composer global config bin-dir --absolute)"
"$aot_bin/webman-aot" uninstall --list
"$aot_bin/webman-aot" uninstall
"$aot_bin/webman-aot" uninstall --list
"$aot_bin/webman-aot" --version

最后一次列表会说明哪些版本和入口还保留，版本应显示 Composer 入口 0.3.7、目标构建器 0.3.2。如选择了卸载 Composer 全局包，重新执行 composer global require，再取得 bin 目录。想重新准备私有运行时时可选择卸载有所有权标记的 Composer 状态项；安装锁、额外文件及共享工具链仍保留。之后进入自己的项目目录，按构建 Webman或SaiAdmin运行完整代理路径下的 build。

列表会显示安装方式、从文件读取的版本、绝对路径与归属判断；不运行旧命令探版本。已知位置包括两代原生标准数据目录、current、升级/回滚代次、历史安装备份、PATH 固定入口以及 Composer 私有状态和全局包。重复路径会去重；不搜索整块磁盘，放在自定义位置的安装需明确指定目录。

自定义原生数据根、入口目录或 Composer 状态目录可明确指定；参数输入的是安装时使用的实际目录：

macOS 可在上述代理命令后加 --home="原生数据目录" --bin-dir="命令目录"；PowerShell 在 uninstall 后加相同参数。指定 Composer 状态目录使用 --state-dir="Composer状态目录"。

卸载完成会列出删除/失败计数及重新发现的剩余路径；失败返回非零，可检查提示路径后重试。

无法证明归属的旧文件显示“未知”并保留，须先核对其来源再处理精确路径；不运行它探版本。Composer 全局包只移除本次明确确认的项目，禁用 scripts/plugins，其他全局工具保留。状态目录只删除所有权白名单，安装锁 setup.lock、状态根与额外用户文件保留，避免并发安装换用另一把锁。项目 dist-aot/、源码、共享工具链、日志与 PATH 始终保留，已空的 PATH 目录可在核对后自行整理。

原生 0.3.2 历史卸载脚本

已有原生 0.3.2 安装包中的卸载器只处理该安装根，且可能恢复旧入口；需要清理多个版本时优先使用上面的 Composer 0.3.5 入口。单独运行历史卸载器时，先取得与安装平台相同、对应实际安装工具的安装包（轻量或完整），解压至临时目录。进入直接包含卸载脚本的解压目录；setup 本身不是卸载脚本。

macOS 终端：

sh ./uninstall.sh

Windows PowerShell：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\uninstall.ps1

默认移除工具程序与所属命令入口，保留缓存、组件等用户数据；不会删除 Webman 项目或 dist-aot/。确实要清除该工具用户数据时，macOS 加 --purge，Windows 加 -Purge。自定义位置需分别提供 --home / --bin-dir 或 -InstallRoot / -BinDir；不要指向共享目录。

看到 Webman AOT Builder uninstalled. 表示脚本完成。重新打开终端检查命令查找结果；若工具安装前已有同名命令，卸载会尝试恢复原入口，不能仅以同名命令仍存在判断卸载失败。