.NET 6上的WebView2体验

Posted 2023-03-31

参考技术A

上次说为了不想在web端登录博客园，我想着还是继续使用 MarkWord 编写博客，不过在使用的过程中，如果markdown文件的目录中有中文的话，Markdown预览就不能够显示粘贴的图片了，原因是之前.NET Framework的WeBrowser库太老了，应该升级一下。

替换WebBrowser的方案很多，在Stackoverflow上有人推荐使用WebView2，我就直接用了，也没有多想，实际上使用的问题还是不少的，简单记录一下。

这个东西是微软推出基于Edge或者说是基于chromium内核的浏览器组件，可以提供现代的浏览器体验，用于集成到.NET程序中，实现.NET对web的访问与调用，或者反过来也行。这个东西感觉是CefSharp的有利竞争者呀，虽然我也没咋用过CefSharp。

迁移的第一步是引用的替换，WebBrowser在System.Windows.Forms.WebBrowser命名空间，如果使用WPF的话，需要使用WindowsFormsHost，这个就体验不是那么好了，WPF下，有Microsoft.Web.WebView2.Wpf，可以提供给WPF原生的访问，赞一个。

然后就是出现的错误了，最难受的是，WebView2 不提供对DOM的访问权限！ ，WebBrowser可以直接通过Document来访问DOM节点，而WebView2只能设置访问的Uri信息，然后控制导航与调用js。

为了实现动态的控制预览框的内容，访问DOM是必须的，如果我动态的渲染一个文件，然后随时再构造Uri，再传递到WebView2中，那太啰嗦了。由于这个东西可以直接调用JS，那么我们换一个思路：通过WebView2调用JS，然后使用Js操作DOM，曲线实现控制DOM的目标。废话不多说，直接上代码。

WebView2除了直接在传递js的函数体以外，还可以调用页面中的顶级JS函数，具体使用方法参见后面的参考文献或者园子里面的这篇文章，反正我这么使用之后中文目录的问题就解决了，不过右侧渲染如果有回车换行的话，就经常会卡死，好像是引擎就崩溃了。

经过debug，发现WebView2在运行的过程中，需要渲染的html内，标签之间不能有r 之类的东西，如果有就寄了。而使用CommonMark.CommonMarkConverter.Convert方法转换的markdown文件都会有这个东西...

这个库时间也比较久远了，经过简单研究，我换成了Markdig这个库，二者兼容，而且Markdig还提供了更多定制的地方，我这里将所有的换行，替换为空字符。

这样，换行就没啥问题了，但是在初次使用时，会出现WebView2无法正常渲染的问题。

WebView2的初始化和其他的库有点不同，它提供了一个EnsureCoreWebView2Async的方法，对它的操作，请一定等这个方法返回。可以使用await，也可以和我一样，使用TPL。

注意我这里使用加载了一个本地的模板HTML文件，访问本地文件的时候，需要使用Uri的方式访问。

经过了一番折腾，终于是能够继续使用MarkWord写博客了，虽然我更换了主题之后，滚动不是很利索了，另外渲染代码换行好像还有点问题，不过好歹能用了，以后再折腾吧。

作者：波多尔斯基

出处：https://www.cnblogs.com/podolski/p/16199151.html

.NET平台系列26：在 Windows 上安装 .NET Core/.NET5/.NET6

系列目录     【已更新最新开发文章，点击查看详细】

　　本文介绍如何在 Windows 上安装 .NET。 .NET 由运行时和 SDK 组成。 运行时用于运行 .NET 应用，应用可能包含也可能不包含它。 SDK 用于创建 .NET 应用和库。 .NET 运行时始终随 SDK 一起安装。当前最新版本的 .NET 是 5.0。点击此处，下载.NET Core/.NET。

支持的版本

　　下表列出了当前支持的 .NET 版本以及支持它们的 Windows 版本。 这些版本在 .NET 版本达到支持终止日期或 Windows 版本达到生命周期之前仍受支持。

Windows 10 版本终止服务日期按版本分段。 下表中仅考虑家庭版、专业版、专业教育版和专业工作站版。 查看 Windows 生命周期事实表单，了解具体的详细信息。

 

不支持的版本

以下 .NET 版本 ❌ 不再受到支持：

• 3.0
• 2.2
• 2.0

所以，如果新建.NET Core 项目，建议直接使用.NET5 或者 .NET Core 3.1版本。

运行时信息

　　运行时用于运行使用 .NET 创建的应用。 应用作者发布应用时，可以在其应用中包含运行时。 如果作者未包含运行时，则由用户安装运行时。

可以在 Windows 上安装三个不同的运行时：

• ASP.NET Core 运行时
  运行 ASP.NET Core 应用。 包括 .NET 运行时。

• 桌面运行时
  运行适用于 Windows 的 .NET WPF 和 Windows 窗体桌面应用。 包括 .NET 运行时。

• .NET 运行时
  此运行时是最简单的运行时，不包括任何其他运行时。 强烈建议同时安装 ASP.NET Core 运行时和桌面运行时，以最大限度地提升与 .NET 应用的兼容性 

SDK信息

　　SDK 用于生成和发布 .NET 应用和库。 安装 SDK 会包含三个运行时：ASP.NET Core、桌面和 .NET。

运行时下载地址：https://dotnet.microsoft.com/download/dotnet

依赖项（+表示最低版本）

.NET 5.0 支持下列 Windows 版本。有关 .NET 5.0 支持的操作系统、发行版和生命周期策略的详细信息，请参阅 .NET 5.0 支持的 OS 版本。

.NET Core 3.1 支持下列 Windows 版本：有关 .NET Core 3.1 支持的操作系统、发行版和生命周期策略的详细信息，请参阅 .NET Core 3.1 支持的 OS 版本。

• Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2

如果要在以下 Windows 版本上安装 .NET SDK 或运行时，则需要其他依赖项：

如果收到与以下 dll 之一相关的错误，也需要满足上述要求：

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

使用 PowerShell 自动化安装

dotnet-install 脚本用于运行时的 CI 自动化和非管理员安装。 可从 dotnet-install 脚本引用页下载该脚本。

此脚本默认安装最新的长期支持 (LTS) 版本，即 .NET Core 3.1。 可通过指定 Channel 开关以选择特定版本。 包括 Runtime 开关以安装运行时。 否则，该脚本安装 SDK。

dotnet-install.ps1 -Channel 5.0 -Runtime aspnetcore

通过省略 -Runtime 开关来安装 SDK。 在此示例中将 -Channel 开关设置为 Current，这将安装受支持的最新版本。

dotnet-install.ps1 -Channel Current

使用 Visual Studio 安装

如果要使用 Visual Studio 开发 .NET 应用，请参阅下表，了解不同目标 .NET SDK 版本所需的 Visual Studio 最低版本。

如果你已安装 Visual Studio，则可以使用以下步骤检查你的版本。

1. 打开 Visual Studio。
2. 选择“帮助” > “Microsoft Visual Studio”。
3. 从“关于”对话框中读取版本号。

Visual Studio 可安装最新的 .NET SDK 和运行时。

Visual Studio 下载地址：https://visualstudio.microsoft.com/zh-hans/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2019

• 选择工作负载

安装或修改 Visual Studio 时，根据要生成的应用程序的类型，选择以下一个或多个工作负载：

• “其他工具集”部分中的“.NET Core 跨平台开发”工作负荷 。
• “Web 和云”部分中的“ASP.NET 和 Web 开发”工作负荷 。
• “Web 和云”部分中的“Azure 开发”工作负载 。
• “桌面和移动”部分中的“NET 桌面开发”工作负载 。

随 Visual Studio Code 一起安装

Visual Studio Code 是一个功能强大的轻量级源代码编辑器，可在桌面上运行。 Visual Studio Code 适用于 Windows、macOS 和 Linux。

虽然 Visual Studio Code 不像 Visual Studio 一样附带自动的 .NET Core 安装程序，但添加 .NET Core 支持非常简单。

1. 下载并安装 Visual Studio Code。
2. 下载并安装 .NET Core SDK。
3. 从 Visual Studio Code 市场安装 C# 扩展。

Windows Installer

　　适用于 .NET 的下载页面提供了 Windows Installer 可执行文件。使用 Windows 安装程序安装 .NET 时，可以通过设置 DOTNETHOME_X64 和 DOTNETHOME_X86 参数来自定义安装路径：

dotnet-sdk-3.1.301-win-x64.exe DOTNETHOME_X64="F:\\dotnet\\x64" DOTNETHOME_X86="F:\\dotnet\\x86"

如果要以无提示方式安装 .NET（例如在生产环境中）或要支持持续集成，请使用以下开关：

• /install
  安装 .NET。

• /quiet
  禁止显示任何 UI 和提示。

• norestart
  禁止任何重启尝试。

dotnet-sdk-3.1.301-win-x64.exe /install /quiet /norestart

有关详细信息，请参阅标准安装程序命令行选项。

提示：安装程序返回退出代码 0 以表示成功，返回退出代码 3010 以表示需要重启。 任何其他值通常都是错误代码。

下载并手动安装

　　除了使用适用于 .NET 的 Windows 安装程序，还可以下载并手动安装 SDK 或运行时。 手动安装通常作为持续集成测试的一部分执行。 对于开发人员或用户，一般使用安装程序会更好。

在下载 .NET SDK 和 .NET 运行时后，可以手动安装它们。 如果安装 .NET SDK，则无需安装相应的运行时。 首先，从以下站点之一下载 SDK 或运行时的二进制版本：

• .NET 5.0 下载
• .NET Core 3.1 下载
• .NET Core 2.1 下载
• 所有 .NET Core 下载项

创建要将 .NET 提取到的目录，例如 %USERPROFILE%\\dotnet。 然后，将下载的 zip 文件提取到该目录中。

默认情况下，.NET CLI 命令和应用不会使用通过这种方式安装的 .NET，并且你必须显式选择才能使用它。 为此，请更改用于启动应用程序的环境变量：

set DOTNET_ROOT=%USERPROFILE%\\dotnet
set PATH=%USERPROFILE%\\dotnet;%PATH%
set DOTNET_MULTILEVEL_LOOKUP=0

使用此方法可以将多个版本安装到不同的位置，然后通过使用指向安装位置的环境变量运行应用程序来明确选择应用程序应使用哪个安装位置。

将 DOTNET_MULTILEVEL_LOOKUP 设置为 0 时，.NET 将忽略任何全局安装的 .NET 版本。 删除环境设置，让 .NET 在选择用于运行应用程序的最佳框架时考虑默认的全局安装位置。 默认值通常为 C:\\Program Files\\dotnet，这是安装 .NET 的安装程序所在的位置。

Docker 容器

　　容器提供了一种将应用程序与主机系统的其余部分隔离的轻量级方法。 同一计算机上的容器只共享内核，并使用为应用程序提供的资源。

　　.NET 可在 Docker 容器中运行。 官方 .NET Docker 映像发布到 Microsoft 容器注册表 (MCR)，用户可在 Microsoft.NET Docker Hub 存储库中找到这些映像。 每个存储库包含 .NET（SDK 或运行时）和可以使用的操作系统的不同组合的映像。

Microsoft 提供适合特定场景的映像。 例如，ASP.NET Core 存储库提供针对在生产环境中运行 ASP.NET Core 应用生成的映像。

有关在 Docker 容器中使用 .NET 的详细信息，请参阅 .NET 和 Docker 简介和示例。

后续步骤

• 如何检查是否已安装 .NET。
• 教程：Hello World 教程。
• 教程：使用 Visual Studio Code 创建一个新应用。
• 教程：使 .NET Core 应用容器化。

 

---

参考文献：

• https://docs.microsoft.com/zh-cn/dotnet/core/install/windows?tabs=net50

 

系列目录     【已更新最新开发文章，点击查看详细】

.NET Core 3.1 支持下列 Windows 版本：