【WinForm】WebView2-个性化浏览器-桌面程序开发详解

news2024/11/20 2:19:16

这是一个桌面程序上的浏览器，是用插件WebView2开发的浏览器桌面程序，功能体验堪比Edge浏览器，相比使用Chrome内核插件开发浏览器来说，还是用插件WebView2开发来得简单一些，接下来讲一讲实现过程。

开发之前，建议先看看微软的 WebView2 开发文档，很有帮助

使用Visual Studio开发工具，新建一个项目，项目模板选Windows 窗体应用(.Net Framework)，"C#"编程语言，桌面应用，

例如，作者填写的解决方案和项目名称均为 WindowsFormsWebView2，如下图
在这里插入图片描述

注意目标框架，要选webview2支持的.NET Framework 4.7.2 以上，

页面布局

在Form1的设计窗口中，拖拉放置需要的一些组件，布局完成如下图所示
在这里插入图片描述

工具条显示的一些图标文件都存放在项目源码的资源文件夹里，可以自己在网上找来用

webview2插件

接下来就是写代码了，不忙不忙，要去找webview2插件来引用，

选中项目名，点鼠标右键，打开项目的管理NuGet程序包，如下图所示
在这里插入图片描述
搜索一下webview2，找到它，点击安装按钮，安装好如下图所示

点击重新编译项目，编译输出结果如果报错的话，那很不幸，
可能过程不顺利，请排查是什么错误引起的，试试提高程序项目的NET框架版本

页面逻辑

开始写逻辑代码，

从页面开始加载时处理初始化和注册事件，到页面关闭时需要释放浏览器资源，代码如下

public partial class Form1 : Form {

		/// <summary>
        /// 浏览器列表
        /// </summary>
        private List<WebView2> webViewList = new List<WebView2>();
		//...其它定义省略了
		
		public Form1()
        {
            InitializeComponent();
            //初始化...
        }

		/// <summary>
        /// 页面加载
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void Form1_Load(object sender, EventArgs e){
			//...初始化页面
		}

		/// <summary>
        /// 页面关闭
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void Form1_FormClosed(object sender, FormClosedEventArgs e){
			//...释放浏览器资源
			foreach (var wv in webViewList)
            {
                wv.Dispose();
            }
		}
		//...还有...
}

百度一下

看看首页布局，点击百度一下按钮，实现点击事件，代码如下

private void button1_Click(object sender, EventArgs e)
{
    var url = textBox1.Text;
    if (!url.StartsWith("http"))
    {
        url = "https://www.baidu.com/s?wd=" + url;
    }
    addNewTabPage(url);
}

打开浏览器

其中方法addNewTabPage(url)，是添加标签卡，调用webview2插件打开浏览器，代码如下

private void addNewTabPage(string url)
{
	//引用webview2插件
     var webView = new WebView2();
     //将webview添加到新标签卡下...
     addWebView(webView);
	 //向多标签容器控件添加新标签卡
     var title = url.Substring(0, Math.Min(url.Length, 12));
     tabControl1.TabPages.Add(title);
	 //...
	 //再将webview添加到新标签卡下...
     page.Controls.Add(webView);
     //切换到新标签卡
     tabControl1.SelectedIndex = index;
	 //...
     updateInputUrlBox(url);
     loadUri(url);
 }

其中的两个方法updateInputUrlBox(url)和loadUri(url)，看名知意，这里就不展开讲

接下来，讲一讲这个方法addWebView(webView)是怎么做的，代码如下

private void addWebView(WebView2 webView)
{
	//绑定 浏览器初始化完成事件
    webView.CoreWebView2InitializationCompleted += webView21_CoreWebView2InitializationCompleted;
    //绑定 浏览器地址导航开始加载事件
    webView.NavigationStarting += webView_NavigationStarting;
    //绑定 浏览器地址导航加载完成事件
    webView.NavigationCompleted += webView_NavigationCompleted;
    //添加到列表中
    webViewList.Add(webView);
}

主要是第一个初始化事件，很重要，其它事件不是重要的，这里不再一一展开讲

初始化浏览器

看看浏览器初始化完成事件做了什么，代码如下

private void webView21_CoreWebView2InitializationCompleted(object sender, Microsoft.Web.WebView2.Core.CoreWebView2InitializationCompletedEventArgs e)
{
	 //获取webview2对象实例
     var webView = sender as WebView2;
     //获取浏览器内核对象
     var core = webView.CoreWebView2;
	 //...
	 //连接地址跳转事件
     core.NewWindowRequested += (sender2, e2) => coreWebView2_NewWindowRequested(webView, e2);
     //底部状态栏改变事件
     core.StatusBarTextChanged += (sender2, e2) => coreWebView2_StatusBarTextChanged(webView, e2);
     //浏览历史改变事件
     core.HistoryChanged += (sender2, e2) => coreWebView2_HistoryChanged(webView, e2);
     //下载开始事件
     core.DownloadStarting += coreWebView2_DownloadStarting;
     //...
 }

这是对内核的初始化，获得浏览器内核并绑定一些事件，
内核就是调用的浏览器程序，调用的其实就是它，可以把webview2看作是对浏览器的包装

浏览器跳转

由于很多网页内部点击链接会打开新窗口，会影响体验，需要对绑定跳转事件做一下处理，代码如下

private void coreWebView2_NewWindowRequested(WebView2 webView, Microsoft.Web.WebView2.Core.CoreWebView2NewWindowRequestedEventArgs e)
{
    e.Handled = true;//停止弹窗
    addNewTabPage(e.Uri.ToString());
}