如何在Visual Studio安装程序的Setup.exe/MSI中集成WebView2并解决兼容警告
解决WebView2纳入安装包及平台兼容警告问题
一、将WebView2纳入安装包
方式1:打包固定版本WebView2运行时
- 打开VB项目的
packages\Microsoft.Web.WebView2.1.0.1054.31目录,找到对应目标平台(x86/x64)的WebView2Loader.dll,以及runtimes文件夹下的对应平台运行时文件; - 把这些文件手动添加到Setup1(Visual Studio Installer)项目的应用程序文件夹中,设置文件的「复制到输出目录」为「始终复制」,确保安装时部署到程序安装目录;
- 在Setup1项目中,将这些文件标记为「必须」安装项,避免遗漏。
方式2:使用Evergreen运行时自动安装
- 下载WebView2官方引导程序
MicrosoftEdgeWebView2Setup.exe; - 在Setup1项目中添加自定义操作:右键项目→视图→自定义操作,在「安装」节点下添加该引导程序,设置安装参数为
/silent /install,实现静默自动安装; - 这种方式无需打包庞大的运行时文件,安装包会自动适配并下载对应版本的WebView2运行时。
修复Setup1依赖检测空白问题
- 将VB项目的主输出(Voetbalbrowser2.exe)添加到Setup1的应用程序文件夹;
- 右键Setup1项目→「检测依赖项」,若仍未识别WebView2,手动将
WebView2Loader.dll添加到依赖项列表,关联到主程序的安装目录。
二、解决平台兼容警告
统一所有项目的目标平台
- 打开VB项目属性:右键项目→属性→编译→目标CPU,选择单一平台(x86或x64,禁止混合);
- 打开Setup1项目属性:右键项目→属性→目标平台,选择与VB项目完全一致的平台;
- 清理解决方案后重新生成,确保所有编译输出的平台架构统一,消除x64/x86不兼容警告。
修复WebView2Loader.dll平台未知问题
- 删除VB项目根目录下的
packages文件夹; - 右键VB项目→管理NuGet程序包,重新安装
Microsoft.Web.WebView2包,安装时确认选择与目标平台匹配的版本; - 重新生成VB项目后,更新Setup1项目中的
WebView2Loader.dll引用,替换为新生成的对应平台文件。
验证步骤
- 重新生成整个解决方案,确认无平台兼容警告;
- 生成MSI安装包,部署到目标笔记本,测试WebView2页面是否正常加载。
内容的提问来源于stack exchange,提问作者Eddy Vlaemynck
相关产品推荐
相关产品推荐

