Advanced Installer 22.5 实战：从建工程到静默安装的完整避坑指南

简介Advanced Installer 22.5 打包 Windows 安装包资源面向需要制作专业安装程序的软件开发者与运维人员帮助将应用程序、依赖文件及安装配置整合为可安装、可卸载、易管理的 Windows 安装包。压缩包共约 2000 个文件整体约 229.56MB以 png、jpg、ico 等界面与图标素材aip、aitemplate 工程模板xsd、xml、json 配置定义以及 rtf、html、txt 说明文档为主另含 msi、msm、exe 等安装产物与脚本文件覆盖从界面资源到打包配置的完整结构。已有 1435 人学习下载适合希望掌握图形化打包流程、静默安装与命令行模式、安装条件设置及测试验证的读者参考。资源包含多语言界面文件与模板便于对照定制安装向导、快捷方式、注册表项及先决条件检查为构建稳定一致的安装体验提供完整素材。1. 从一次翻车说起Advanced Installer 22.5 到底解决什么问题上个月帮朋友公司做一个内部工具的交付需求很朴素把一套 .NET 桌面程序打成 exe 安装包双击就能装装完桌面有快捷方式开始菜单能卸载。我一开始图省事直接拿 Visual Studio 自带的 Installer 项目凑合结果在 Win11 上装到一半弹「Windows Installer 服务不可用请重启系统」重启了三次照样翻车。后来换成 Advanced Installer 22.5从建工程到出包不到四十分钟连注册表写入、服务安装、前置依赖检测都一次过。Advanced Installer 是一款 Windows 平台上的安装包制作工具22.5 是它较新的一个版本。它的核心价值在于把 MSI 和 EXE 两种安装格式的复杂度封装成可视化工程你不用手写 WiX 的 XML也不用去啃 InstallShield 那套脚本就能做出带界面、带依赖检测、带升级逻辑的安装包。它适合谁一是需要给客户交付桌面软件的开发者二是做企业内部工具分发、需要静默安装和批量部署的运维三是被 VS Installer 和 Inno Setup 的边界卡住、想找一个中间档方案的人。这篇笔记就按「建工程 → 配参数 → 出包 → 排错」的顺序把我踩过的坑和能直接抄的配置写清楚。2. 工程建立与安装类型选型MSI 还是 EXE先想清楚再动手2.1 为什么默认推荐 EXE 而不是裸 MSIAdvanced Installer 新建工程时会让你选安装类型常见的有 Professional、Enterprise、Architect 等版本对应的模板但真正影响你后续工作量的是「Package Type」这一项MSI、EXE、MSI 加 EXE 引导程序。很多人第一反应是选 MSI觉得原生、干净、方便组策略推送。但实际交付给普通用户时裸 MSI 有个硬伤它不能自带前置依赖的安装逻辑。比如你的程序依赖 .NET 6 运行时用户机器上没有MSI 只会弹一句「缺少依赖」然后退出用户一脸懵。EXE 引导程序Bootstrapper的本质是外面套一层可执行壳先按你定义的顺序检查并安装前置条件全部满足后再调用内嵌的 MSI 执行真正的安装。常见做法是选「EXE setup with resources next to it」或者「Single EXE setup」前者把 MSI 和依赖文件放在同目录后者全部塞进一个 exe。我一般交付给外部客户用 Single EXE内部批量部署用 MSI因为内部机器镜像里依赖早就打好了。选型判断可以按这张表走场景推荐类型理由交付外部客户、依赖不确定Single EXE自带依赖检测双击即装企业内部组策略推送纯 MSI便于 GPO 和 SCCM 静默分发需要自定义安装界面EXE 内嵌 MSI引导程序可做界面MSI 做实际写入需要支持静默安装两者皆可加/qn或/exenoui参数2.2 建工程时的四个关键填写项打开 Advanced Installer 22.5新建工程后左侧是导航树右侧是属性面板。第一遍做的时候别急着点下一步先把这几项填对Product Name会写进注册表卸载项和开始菜单别用中文加特殊符号空格可以有但、%这类字符会在某些系统上导致卸载项显示异常。Product Version格式必须是x.y.z22.5 对版本号校验比老版本严写成1.0它会自动补成1.0.0但如果你写1.0.0.0四段某些升级场景会匹配不上。Manufacturer公司名会出现在「应用和功能」列表里建议和代码签名证书的 Subject 保持一致。Installation Type按上一节的结论选。填完之后在「Install Parameters」页里确认安装路径变量。默认是[ProgramFilesFolder][Manufacturer][ProductName]如果你想让用户能改路径勾上「Allow user to change installation path」如果做静默部署这个勾要去掉否则静默模式下路径变量可能取不到值。2.3 用命令行建工程的思路适合批量场景Advanced Installer 支持用命令行调它的工程文件常见做法是先用 GUI 建一个模板.aip然后用AdvancedInstaller.com这个 CLI 工具做批量替换。比如你有十个内部工具要打包只有版本号和源目录不同就可以写脚本:: 假设 Advanced Installer 装在默认路径 set AI_CLIC:\Program Files (x86)\Caphyon\Advanced Installer 22.5\bin\x86\AdvancedInstaller.com :: 用模板工程替换版本号和源路径重新构建 %AI_CLI% /edit D:\pack\Template.aip ^ /SetVersion 2.3.1 ^ /SetProperty SOURCEDIRD:\build\ToolA ^ /SetProperty PRODUCTNAMEToolA :: 构建 MSI %AI_CLI% /build D:\pack\Template.aip这段脚本的逻辑是/edit打开工程并修改属性/SetVersion改版本号/SetProperty改自定义属性前提是模板里已经把源目录和产品名做成了属性引用/build触发构建。参数说明^是 Windows 批处理的换行符路径里有空格必须加引号。注意/SetProperty只能改已经在工程里定义过的属性临时造一个属性名是无效的这是新手最容易翻车的地方——以为随便写个名字就能注入结果构建出来还是模板的旧值。3. 文件、注册表与依赖配置把「装什么」落到具体条目3.1 添加文件和文件夹的正确姿势左侧导航树里「Files and Folders」页是核心。很多人直接把整个bin\Release拖进去结果发现配置文件、日志目录、临时文件全被打进去了。正确做法是分三层第一层应用程序文件放[ProgramFilesFolder][Manufacturer][ProductName]这些是只读的 exe 和 dll。第二层用户配置模板放[CommonAppDataFolder][Manufacturer][ProductName]首次启动时程序从这里拷贝到用户目录。第三层快捷方式在「Shortcuts」页单独建指向第一层的 exe。添加文件时注意「File Properties」里的几个选项Read-only勾上后安装完文件是只读的防止用户误改但如果你程序运行时要写同目录的日志别勾。Permanent勾上后卸载时不会删除该文件用于保留用户数据慎用容易留下垃圾。Never overwrite升级安装时如果目标文件已存在就跳过适合配置文件。3.2 注册表写入的两种方式Advanced Installer 写注册表有两条路一是在「Registry」页手动建键值二是在「Custom Actions」里用脚本写。手动建适合静态键值比如文件关联、协议注册。举个例子注册一个自定义协议myapp://HKEY_CLASSES_ROOT\myapp (Default) URL:myapp Protocol URL Protocol HKEY_CLASSES_ROOT\myapp\shell\open\command (Default) [APPDIR]MyApp.exe %1在 Registry 页里逐级新建注意[APPDIR]是 Advanced Installer 的路径变量构建时会替换成实际安装目录。%1是传入的 URL 参数必须带引号否则路径里有空格时协议调用会失败。动态键值就用 Custom Action比如安装时把当前时间写进注册表// Custom Action: JScript在 InstallFiles 之后执行 var shell new ActiveXObject(WScript.Shell); var key HKLM\\SOFTWARE\\MyCompany\\MyApp\\InstallTime; var now new Date().toLocaleString(); shell.RegWrite(key, now, REG_SZ);逻辑说明这段脚本在安装文件写完后运行往 HKLM 写一个安装时间戳。参数说明RegWrite第三个参数是类型REG_SZ是字符串如果要写 DWORD 用REG_DWORD并传整数。注意 Custom Action 的执行时机Execution Time要选对选「Commit」阶段写注册表最稳选「InstallFiles」之前可能路径还没建好。3.3 前置依赖检测.NET 运行时和 VC 库这是 Advanced Installer 比 VS Installer 强的地方。在「Prerequisites」页你可以勾选常见的依赖项比如 .NET Desktop Runtime 6.0、Visual C 2015-2022 Redistributable。勾上之后构建时它会把这些依赖的安装包一起打进去安装时先检测缺了就先装。关键参数在「Prerequisite Properties」里Install Condition检测条件比如(VersionNT 603)表示 Win8 以上才装。Run as admin装运行时需要管理员权限必须勾。Continue with main install if prerequisite fails这个千万别勾依赖装不上主程序装了也跑不起来。我一般会额外加一个「Launch Condition」在「Launch Conditions」页里写如果检测到系统是 Win7 且没装 .NET 6直接弹提示并终止安装而不是让用户装到一半失败。条件表达式类似(VersionNT 1000) OR (NETFRAMEWORK6INSTALLED)具体变量名在 Advanced Installer 的文档里有22.5 版本对 .NET 6 的检测变量支持是完整的。4. 界面定制与静默安装让安装包能看也能藏4.1 安装界面的主题和对话框顺序Advanced Installer 自带几套主题在「Themes」页选。默认主题够用但如果你要改对话框顺序得去「Dialogs」页。常见需求是把「安装路径选择」对话框去掉强制装到默认目录。操作是找到FolderDlg把它的「Display」属性改成False或者在「Sequence」里把它拖出流程。改对话框有个血泪经验别在「First Time Install」和「Maintenance」两个序列里用同一套对话框配置。升级安装时如果还弹「欢迎使用安装向导」用户会以为装了个新软件。正确做法是在「Dialogs」页里针对「Maintenance」模式单独配一套精简对话框只保留「修复」和「卸载」两个选项。4.2 静默安装参数与日志开关做批量部署时静默安装是刚需。Advanced Installer 生成的 EXE 和 MSI 都支持标准参数:: EXE 引导程序静默安装并输出日志 MyAppSetup.exe /exenoui /qn /L*v C:\temp\install.log :: 纯 MSI 静默安装 msiexec /i MyApp.msi /qn /L*v C:\temp\install.log :: 静默卸载 msiexec /x MyApp.msi /qn参数说明/exenoui告诉引导程序不显示自己的界面/qn是 MSI 的完全静默/L*v输出详细日志*表示所有日志类型v是详细级别。日志路径建议用绝对路径相对路径在 SYSTEM 账户下执行时会写到C:\Windows\System32里找起来很麻烦。静默安装最容易翻车的是权限。如果通过 SCCM 或计划任务以 SYSTEM 账户运行安装路径变量[ProgramFilesFolder]能正常解析但如果你在脚本里用了%USERPROFILE%这类用户变量SYSTEM 账户下会解析成C:\Windows\System32\config\systemprofile导致文件装错地方。解决办法是静默安装时不要依赖用户级变量全部用机器级路径。4.3 用响应文件做可复现的静默配置如果静默安装的参数很多每次敲命令行容易漏可以用响应文件。Advanced Installer 支持/i配合一个.ini文件[Install] ProductNameMyApp Version2.3.1 InstallDirC:\Program Files\MyCompany\MyApp CreateDesktopShortcut1 LaunchAfterInstall0然后在命令行里引用MyAppSetup.exe /exenoui /qn /i D:\deploy\config.ini逻辑说明响应文件把安装选项固化下来适合多台机器重复部署。参数说明/i后面跟 ini 路径ini 里的键名要和工程里定义的属性名一致否则会被忽略。注意 ini 文件编码要用 ANSI 或 UTF-8 无 BOM带 BOM 的 UTF-8 在某些版本上会解析出乱码导致中文路径失败。5. 避坑与排查五个真实翻车记录5.1 现象安装到一半弹「Windows Installer 服务不可用请重启系统」原因这个报错和 Advanced Installer 本身关系不大通常是目标机器上 Windows Installer 服务被禁用或者C:\Windows\Installer目录权限异常。还有一种情况是之前装过同 ProductCode 的旧版本注册表残留导致新安装无法接管。解决先services.msc确认 Windows Installer 服务是「手动」或「自动」且能启动。如果服务正常用msiexec /unregister再msiexec /regserver重新注册。最后检查C:\Windows\Installer目录如果权限被改过恢复 SYSTEM 和 Administrators 的完全控制权限。预防办法是在 Advanced Installer 里给每次构建生成新的 ProductCode别复用。5.2 现象升级安装后旧版本的文件还在新旧混用原因Advanced Installer 默认的升级逻辑依赖「Upgrades」页里的配置。如果你只改了版本号没在「Upgrades」页添加升级规则安装包会当成全新安装装到另一个目录或者覆盖不彻底。解决在「Upgrades」页勾选「Customize upgrade rules」添加一条规则检测到任意旧版本就执行「Uninstall old version」再「Install new version」。注意卸载旧版本时如果旧版的卸载程序损坏会卡住这时候要在规则里加「Force uninstall」选项。我一般还会在「Launch Conditions」里加一条如果检测到比当前版本更高的版本已安装直接终止防止降级安装。5.3 现象快捷方式图标是白板或者指向错误原因快捷方式图标路径用了相对路径或者图标文件没被打进安装包。Advanced Installer 里快捷方式的 Icon 属性如果填的是app.ico构建时它会在工程目录找但安装后快捷方式引用的是安装目录下的图标如果图标没被添加到「Files and Folders」里就会白板。解决把图标文件加到「Files and Folders」的应用程序目录然后在快捷方式属性里用[APPDIR]app.ico引用。另外注意图标文件必须是.ico格式.png改后缀不行Windows 不认。5.4 现象静默安装返回 0 但程序没装上原因/qn静默模式下如果安装过程中弹了任何需要交互的对话框比如「是否覆盖文件」安装会直接失败但返回码可能还是 0。另外如果前置依赖安装失败但主安装继续执行也会出现「返回成功但没装全」。解决静默安装一定要加/L*v日志装完检查日志里有没有Return value 3或Installation success or error status: 1603。1603 是 MSI 的通用失败码具体原因看日志里最后几行。预防办法是在「Prerequisites」里把「Continue with main install if prerequisite fails」取消勾选依赖失败就整体失败。5.5 现象安装包在 Win11 上被 SmartScreen 拦截原因没有代码签名。Advanced Installer 生成的 exe 即使内容合法没有签名证书也会触发 SmartScreen 警告。这不是 Advanced Installer 的问题是 Windows 的安全机制。解决买一张代码签名证书OV 或 EV在 Advanced Installer 的「Digital Signature」页配置签名。EV 证书能立即获得 SmartScreen 信任OV 证书需要积累下载量。如果只是内部使用可以在目标机器上把安装包加入白名单或者用组策略关闭 SmartScreen 对特定路径的检查。注意签名要在构建的最后一步做先签名再打包会导致签名失效。6. 进阶技巧用 PowerShell 做安装后验证与回滚安装包做完不是终点交付之后怎么确认装对了、装错了怎么回滚才是区分熟练工和新手的地方。我现在的习惯是每个安装包配一个 PowerShell 验证脚本装完自动跑一遍检查文件、注册表、服务、快捷方式四项。# Verify-Install.ps1 $ErrorActionPreference Stop $result () # 1. 检查主程序文件 $exePath C:\Program Files\MyCompany\MyApp\MyApp.exe if (Test-Path $exePath) { $result OK: 主程序存在 } else { $result FAIL: 主程序缺失 $exePath } # 2. 检查注册表卸载项 $regPath HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{你的ProductCode} if (Test-Path $regPath) { $ver (Get-ItemProperty $regPath).DisplayVersion $result OK: 注册表版本 $ver } else { $result FAIL: 注册表卸载项缺失 } # 3. 检查服务状态如果装了服务 $svc Get-Service -Name MyAppService -ErrorAction SilentlyContinue if ($svc -and $svc.Status -eq Running) { $result OK: 服务运行中 } elseif ($svc) { $result WARN: 服务存在但状态为 $($svc.Status) } else { $result FAIL: 服务未安装 } # 4. 检查桌面快捷方式 $lnk $env:PUBLIC\Desktop\MyApp.lnk if (Test-Path $lnk) { $result OK: 桌面快捷方式存在 } else { $result FAIL: 桌面快捷方式缺失 } $result | ForEach-Object { Write-Host $_ } if ($result -match FAIL) { exit 1 } else { exit 0 }这段脚本的逻辑是逐项检查安装结果任何一项 FAIL 就返回非零退出码方便在 CI 或部署脚本里判断。参数说明$env:PUBLIC是公共桌面路径对应所有用户可见的快捷方式{你的ProductCode}要替换成 Advanced Installer 工程里实际的 ProductCode在「Product Details」页能看到。注意 ProductCode 每次构建如果重新生成脚本里的硬编码就会失效所以要么固定 ProductCode要么在构建时把 ProductCode 写进一个配置文件让脚本读取。回滚方面Advanced Installer 本身支持在安装失败时自动回滚MSI 的标准行为但前提是失败发生在 MSI 执行阶段。如果失败发生在 EXE 引导程序的前置依赖安装阶段MSI 还没开始就没有回滚可言。我的做法是在部署脚本里加一层先跑安装再跑验证脚本验证失败就调msiexec /x卸载然后重新装旧版本。旧版本的安装包要提前放在部署目录里别等出问题了再去下载。还有一个容易被忽略的点安装日志的归档。每次静默安装都把/L*v日志按机器名和时间戳存一份出问题时直接翻日志比远程连过去复现快得多。我一般用\\fileserver\logs\MyApp\%COMPUTERNAME%_%DATE%.log这种路径注意%DATE%里有斜杠要先替换成短横线。从那以后我每次做完安装包都强制走一遍「静默装 → 验证脚本 → 静默卸 → 再装」的循环确认升级和卸载路径都干净才敢交付。希望帮到你。本文还有配套的精品资源点击获取