简介Advanced Installer 22.5 打包 Windows 安装包资源面向需要制作专业安装程序的软件开发者与运维人员帮助将应用程序、依赖文件及安装配置整合为可安装、可卸载、易管理的 Windows 安装包。压缩包共 2000 个文件约 229.56MB以 png、jpg、ico 等界面与图标素材aip、aitemplate 等工程模板xsd、xml、json 等配置与架构文件以及 msi、msm、exe 等安装产物为主另含多语言 ail 本地化文件与 rtf、html 说明文档覆盖从界面设计到打包输出的完整链路。已有 1448 人学习下载。借助其中的工程模板与多语言资源读者可快速理解安装向导定制、快捷方式与注册表项配置、静默安装与命令行模式等关键环节并参考现有工程结构完成自身项目的打包与测试减少从零搭建安装工程的时间成本。1. Advanced Installer 22.5 打包 Windows 安装包从踩坑到交付的完整路径第一次用 Advanced Installer 22.5 打包 Windows 安装包很多人以为拖几个文件、点一下 Build 就完事结果装到客户机器上不是缺 DLL就是服务起不来卸载还留一堆注册表垃圾。这个工具真正的价值不在“能生成 exe”而在把安装、升级、卸载、依赖检测、权限申请这些脏活一次性配置清楚。它适合两类人一类是手里有 C#/C/Python 打包需求、被 Inno Setup 或 NSIS 脚本折腾过的开发者另一类是需要给企业内部分发软件、要求静默安装和版本回滚的运维。下面按“先理解工程结构再动手配置最后排错交付”的顺序把 Advanced Installer 22.5 的实操路径拆开讲。2. 先搞懂 Advanced Installer 的工程模型为什么不能直接拖文件2.1 工程文件、资源树和构建产物三者的关系Advanced Installer 的工程文件扩展名是.aip它本质是一个 XML 描述文件记录了你对安装包的所有配置哪些文件进哪个目录、写哪些注册表、装哪些服务、什么条件下弹窗。资源树Files and Folders只是这个 XML 的可视化映射不是真实文件系统。构建产物默认落在工程目录下的Setup Files文件夹里里面通常有xxx.msi和xxx.exe两个东西——MSI 是 Windows Installer 的标准数据库EXE 是带引导程序的封装负责先决条件检测和 UI 引导。很多人第一次翻车是因为把 Debug 目录整个拖进资源树结果把.pdb、.xml文档、甚至vshost.exe都打进去了。正确做法是只拖发布目录publish 或 Release 下经过裁剪的文件夹并且在资源树里右键设置“Synchronize Folder”让 Advanced Installer 按规则自动同步而不是手动一个个加。2.2 三种安装类型怎么选MSI、EXE 引导、单文件在 Advanced Installer 22.5 新建工程时向导会让你选安装类型。常见的有类型适用场景注意点MSI only企业域环境、SCCM 分发不能自动装 .NET 运行时需要管理员手动推EXE with MSI面向普通用户、需要先决条件检测体积大但能自动下载或内嵌运行时Single EXE绿色分发、U 盘拷贝解压到临时目录再装启动稍慢我一般选 EXE with MSI因为可以在 Prerequisites 页面把 .NET Desktop Runtime 或 VC Redistributable 勾上让安装包自己处理依赖。如果目标机器完全离线就把运行时包内嵌进去别选“Download from URL”否则客户内网直接卡死。2.3 用命令行先跑通一次最小构建在动手点 UI 之前建议先用命令行验证工程能不能构建这样后面接 CI 也方便。Advanced Installer 自带AdvancedInstaller.com命令行工具路径通常在安装目录下。:: 进入 Advanced Installer 安装目录 cd C:\Program Files (x86)\Caphyon\Advanced Installer 22.5\bin\x86 :: 用命令行构建工程/build 表示执行完整构建 AdvancedInstaller.com /build D:\Projects\MyApp\MyApp.aip :: 如果只想重新生成 MSI 不跑先决条件用 /rebuild AdvancedInstaller.com /rebuild D:\Projects\MyApp\MyApp.aip :: 查看构建日志排查失败原因 type D:\Projects\MyApp\Setup Files\build.log逻辑说明/build会按工程里配置的 Build 顺序执行包括先决条件打包、文件同步、MSI 生成、EXE 引导封装。/rebuild跳过先决条件重新打包适合只改了文件列表的场景。参数里工程路径必须用绝对路径相对路径在 CI 里容易因为工作目录变化而找不到。构建日志默认在Setup Files下如果没生成检查工程属性里 Logging 是否开启。3. 文件、注册表和服务的配置细节把安装包当程序来写3.1 文件同步规则过滤 Debug 符号和配置文件在 Files and Folders 页面右键目标文件夹选 Properties可以设置 File Synchronization。我一般加三条过滤Exclude:*.pdb;*.xml;*.vshost.*—— 去掉调试符号和文档Exclude:appsettings.Development.json—— 开发环境配置不进安装包Include:appsettings.json—— 只保留生产配置模板同步模式选“Synchronize”而不是“Add”这样源目录删了文件安装包里也会跟着删避免残留旧版本 DLL 导致运行时加载错版本。这个坑很隐蔽客户机器上装了旧版新版安装包没覆盖某个 DLL程序启动就报Could not load file or assembly。3.2 注册表写入用组件隔离避免卸载残留Advanced Installer 的 Registry 页面可以写注册表但关键是要把注册表项和文件组件关联起来。在 Organization 页面每个文件可以设置一个 Component注册表项也挂到同一个 Component 下。这样卸载时 Windows Installer 会按组件引用计数决定是否删除不会出现“文件删了注册表还在”的情况。!-- 这是 .aip 工程里注册表项的简化描述实际在 UI 里配置 -- RegistryKey KeySoftware\MyCompany\MyApp RootHKCU RegistryValue NameInstallPath Typestring Value[APPDIR] / RegistryValue NameVersion Typestring Value[ProductVersion] / /RegistryKey逻辑说明[APPDIR]是 Advanced Installer 的预定义属性指向安装目录[ProductVersion]来自 Product Details 页面。用属性而不是硬编码路径升级时路径变了注册表也能自动更新。注意 HKCU 和 HKLM 的区别HKCU 不需要管理员权限适合用户级配置HKLM 需要提权适合服务或全局配置。3.3 安装 Windows 服务启动类型和失败恢复如果打包的是 Windows 服务在 Services 页面添加服务时有几个参数必须调Start Type: Automatic (Delayed Start) —— 避免开机时和服务抢资源Failures: 第一次失败重启服务第二次失败重启服务后续失败不操作Dependencies: 如果依赖 SQL Server 或消息队列在这里加依赖项我见过最典型的翻车是服务装完启动不了事件日志报“服务没有及时响应启动或控制请求”。原因通常是服务 OnStart 里做了耗时操作比如连数据库超过了 Windows 默认 30 秒超时。解决办法是在服务代码里用ServiceBase.RequestAdditionalTime或者在 Advanced Installer 里把服务启动超时调大——但后者治标不治本还是改代码靠谱。4. 升级、卸载和静默安装交付前必须验证的三件事4.1 升级策略Major Upgrade 和 Patch 怎么选Advanced Installer 的 Upgrades 页面支持三种升级方式Major Upgrade换 ProductCode保留 UpgradeCode适合大版本更新Minor Upgrade保留 ProductCode改 ProductVersion适合小补丁Patch生成 .msp 文件适合紧急修复我一般用 Major Upgrade并且勾选“Remove older versions”这样装新版时自动卸旧版。但要注意如果旧版是用户手动装的新版安装包可能找不到旧版的 ProductCode导致两个版本共存。解决办法是在 Upgrades 页面手动添加旧版的 ProductCode或者用“Detect and upgrade”让安装包自己搜。4.2 静默安装参数企业分发的硬需求企业内部分发通常要求静默安装Advanced Installer 生成的 EXE 支持这些参数:: 静默安装不弹任何 UI MyAppSetup.exe /exenoui /qn :: 静默安装并指定安装目录 MyAppSetup.exe /exenoui /qn APPDIRD:\MyApp :: 静默卸载 MyAppSetup.exe /exenoui /qn /x :: 只解压不安装用于绿色部署 MyAppSetup.exe /extract D:\ExtractFolder逻辑说明/exenoui告诉 EXE 引导程序不显示 UI/qn传给底层 MSI 表示完全静默。APPDIR是公共属性可以在安装时覆盖默认路径。/x是卸载。注意/qn和/qb的区别/qn无 UI/qb有进度条但无交互。如果安装包里有自定义动作需要用户输入静默安装会跳过所以自定义动作要设计成有默认值。4.3 卸载验证用日志确认没有残留卸载后残留是客户投诉重灾区。验证方法是装完再卸然后检查三个地方安装目录是否清空除了用户自己生成的数据注册表HKLM\Software\MyCompany和HKCU\Software\MyCompany是否删除服务是否停止并删除Advanced Installer 可以生成卸载日志:: 带日志卸载日志落在 %TEMP% MyAppSetup.exe /exenoui /qn /x /l*v %TEMP%\uninstall.log :: 查看日志里是否有残留文件未删除 findstr /i Note: 1: %TEMP%\uninstall.log逻辑说明/l*v生成详细日志Note: 1:是 Windows Installer 标记“文件被保留”的格式。如果日志里出现这个说明文件被判定为“用户数据”或“被其他组件引用”需要检查组件引用计数和 Permanent 属性。5. 避坑与排查五个让安装包翻车的典型场景5.1 安装时报“另一个版本已安装”但控制面板找不到现象装新版时弹窗说已安装旧版但控制面板里没有旧版条目。原因通常是旧版卸载不干净注册表里残留了 ProductCode但 MSI 数据库已损坏。解决用 Microsoft 的msizap工具清理或者在 Advanced Installer 的 Upgrades 页面勾选“Allow side by side installs”先绕过装完再手动清注册表。5.2 自定义动作在静默安装时卡死现象带 UI 安装正常静默安装卡在某个自定义动作。原因自定义动作里弹了 MessageBox 或等待用户输入静默模式下没人点。解决在 Custom Actions 页面给每个动作加执行条件比如UILevel 3才执行交互动作静默时走默认分支。5.3 安装包体积暴涨到几百 MB现象明明程序只有 20 MB安装包却 200 MB。原因把整个bin目录拖进去了包含roslyn编译器、node_modules、甚至packages缓存。解决用发布裁剪只保留运行时需要的文件在 Advanced Installer 里用“Best Practices”扫描它会列出可以排除的文件类型。5.4 服务安装后启动账户不对现象服务装完启动报“登录失败”。原因Advanced Installer 默认用 LocalSystem但程序需要访问网络共享或数据库LocalSystem 没有网络凭据。解决在 Services 页面把 Start Type 改成“User Account”填入域账号和密码。注意密码会存在 MSI 里如果安全要求高改用服务首次启动时用sc config动态设置。5.5 数字签名后安装包反而报错现象没签名时安装正常签名后 Windows SmartScreen 拦截或报“文件损坏”。原因签名时用了 SHA-1 算法或者时间戳服务器不可达导致签名不完整。解决在 Digital Signature 页面选 SHA-256时间戳用http://timestamp.digicert.com签名后右键安装包看属性里的数字签名是否有效。6. 进阶技巧用 PowerShell 自动构建和验证安装包6.1 在 CI 里调用 Advanced Installer 命令行如果团队用 Azure DevOps 或 Jenkins可以把构建步骤写成 PowerShell 脚本# 定义 Advanced Installer 路径和工程路径 $aiPath C:\Program Files (x86)\Caphyon\Advanced Installer 22.5\bin\x86\AdvancedInstaller.com $projectPath D:\Projects\MyApp\MyApp.aip $outputDir D:\Projects\MyApp\Setup Files # 执行构建/build 会跑完整流程 $aiPath /build $projectPath # 检查构建是否成功$LASTEXITCODE 为 0 表示成功 if ($LASTEXITCODE -ne 0) { Write-Error Advanced Installer 构建失败退出码$LASTEXITCODE exit 1 } # 验证 MSI 文件是否生成 $msiFile Get-ChildItem -Path $outputDir -Filter *.msi | Select-Object -First 1 if (-not $msiFile) { Write-Error 未找到生成的 MSI 文件 exit 1 } Write-Host 构建成功MSI 路径$($msiFile.FullName)逻辑说明$LASTEXITCODE是命令行工具返回码非 0 即失败。Get-ChildItem检查产物是否存在避免构建“假成功”。这个脚本可以直接放进 CI 的构建步骤后面接签名和分发。6.2 用 PowerShell 做安装包冒烟测试构建完不验证等于没构建。我一般写一个冒烟测试脚本在干净虚拟机上跑# 静默安装 Start-Process -FilePath D:\Setup Files\MyAppSetup.exe -ArgumentList /exenoui /qn -Wait # 检查安装目录是否存在 $installPath C:\Program Files\MyCompany\MyApp if (-not (Test-Path $installPath)) { Write-Error 安装目录不存在 exit 1 } # 检查服务是否启动 $service Get-Service -Name MyAppService -ErrorAction SilentlyContinue if ($service.Status -ne Running) { Write-Error 服务未启动当前状态$($service.Status) exit 1 } # 静默卸载 Start-Process -FilePath D:\Setup Files\MyAppSetup.exe -ArgumentList /exenoui /qn /x -Wait # 检查安装目录是否清空 if (Test-Path $installPath) { Write-Warning 卸载后安装目录仍存在检查是否有残留文件 }逻辑说明Start-Process -Wait等待安装完成再继续。Get-Service检查服务状态如果服务名不对会返回 null所以加-ErrorAction SilentlyContinue。卸载后目录可能因为用户数据保留而存在这里只警告不报错具体看业务需求。6.3 版本号自动注入别手动改 ProductVersion每次发版手动改版本号容易漏。可以在构建前用 PowerShell 从程序集或 CI 变量里读版本号写回.aip文件# 从 CI 变量读取版本号比如 1.2.3 $version $env:BUILD_VERSION # 读取 .aip 文件内容 $aipContent Get-Content -Path $projectPath -Raw # 替换 ProductVersion 节点注意 XML 命名空间 $aipContent $aipContent -replace ProductVersion[^]/ProductVersion, ProductVersion$version/ProductVersion # 写回文件 Set-Content -Path $projectPath -Value $aipContent -Encoding UTF8逻辑说明.aip是 XMLProductVersion节点可以直接正则替换。注意编码用 UTF8否则中文路径可能乱码。这个步骤放在构建之前确保安装包版本和程序版本一致。我自己的习惯是每次改完.aip先跑一次命令行构建确认没报错再提交然后在干净虚拟机上跑冒烟测试通过后才签名分发。这套流程跑了两年客户投诉从每月几次降到几乎为零。希望帮到你。本文还有配套的精品资源点击获取