CefSharp的引用、配置、实例

不念不忘少年蓝@ 2022-05-23 11:54 587阅读 0赞

CefSharp的引用，配置，实例

阅读目录  
  
一，1，关于CefSharp   
二，2，CefSharp项目源码下载  
三，3，Winfrom项目引入CefSharp   
四，4，Winfrom下载CefSharp的基本使用  
1.4.1显示一个页面  
2.4.2 JavaScript调用异步C＃方法  
3.4.3 JavaScript调用带参数C＃方法  
4.4.4 JavaScript调用委托C＃方法  
5.4.6 ChromiumWebBrowser控件扩展IContextMenuHandler接口实现禁用右键按钮菜单  
6.4.6 WebGL页面渲染  
五，5，依赖项  
1.5。 1必需的运行环境  
2.5.2内容依赖排错  
六，图6，总结  
七，7，源码下载与参考资料  
1.7.1提供了两个版本  
2.7.2参考资料  
CefSharp的引用，配置，实例与报错排除（源码）  
Winform下CefSharp的引用，配置，实例与报错排除  
  
  
本文详细介绍了CefSharp在vs2013，.net4.0环境下，创建Winfrom项目，引用CefSharp的方法，演示了winfrom下CefSharp的基本使用，包括显示网页的网址/本地HTML显示，JavaScript的调用异步C＃方法，JavaScript的调用带参数C＃方法，JavaScript的调用委托C＃方法，JavaScript的调用C＃返回实体对象，ChromiumWebBrowser控件扩展IContextMenuHandler接口实现禁用右击按钮菜单，简单介绍WebGL的页面渲染;详细介绍了的CefSharp依赖项，常见报错查看与必要依赖项分析，最后进行了简单总结，并提供了源码的下载。  
  
  
\[TOC\]   
  
  
返回顶部  
1，关于CefSharp   
装一手，比较简单的英语  
CefSharp让你在.NET应用中嵌入Chromium。它是由Marshall A. Greenblatt编写的Chromium嵌入式框架（CEF）的一个轻量级.NET封装。大约30％的绑定是用C ++ / CLI编写的，这里的大部分代码都是C＃。它可以从C＃或VB，或任何其他CLR语言中使用。CefSharp提供了WPF和WinForms Web浏览器控件实现。  
  
  
CefSharp获得BSD许可，因此可用于专有和免费/开源应用程序。有关详细信息，请参阅LICENSE文件。  
  
  
自己  
总结的：CefShar是一个提供了Chromium嵌入式框架（CEF）的.NET接口的开源项目，提供了Winform，WPF封装，可以用来替代微软的WebBrowser，浏览网页，尤为强大的是实现了C＃，VB等VS支持的语言与JavaScript的的交互方法。  
  
  
返回顶部  
2，CefSharp源码项目下载  
源码下载github上托管地址目前最新v53.0.1   
源码结构介绍构建基于铬的应用程序-猫不理饼  
返回顶部  
3，Winfrom项目引入CefSharp   
我的开发环境vs2013，.net4.0，Nugget中搜索CefSharp显示的版本是v53，然而v51.0.0-pre01的Breaking Changes里面有这么一句  
  
  
CefSharp至少需要。 Net 4.5.2（支持.NET 4.0的最新版本是49）  
  
  
不想安装.net4.5.2，所以只能通过工具 - 程序包管理器 - 程序包管理控制台手动命令行导入版本v49.0.1的，输入命令Install-Package CefSharp.WinForms -Version 49.0.1回车等待执行完成，我这里已经安装过了。  
  
  
  
  
  
  
其他版本命令请参考http://www.nuget.org/packages/CefSharp.WinForms。  
等待导入成功，生成一下...报错...   
  
  
CefSharp.Common在'AnyCPU'平台上无法正常工作。你需要指定平台（x86 / x64）。  
  
  
嗯？!!!   
  
  
cefsharp不支持anycup，还需要设置一下目标平台为x86或x64   
  
  
如果你以前只是在项目名右击 - 属性 - 生成 - 目标平台改为x86就太天真了....   
反正我试了不行...   
正确的姿zhi势shi：解决方案名右击 - 属性 - 配置属性 - 配置，右边平台选择x86或x64，什么？选不到？  
  
  
点击当前界面右上角配置管理器-活动解决方案平台下拉新建，在x86 / x64随便选，回来这边下拉已经可以选择了，完事左下角确定，生成再一下试试吧  
  
  
以上看不懂的参考这里.NET使用cefsharp开源库开发chrome浏览器（二）  
  
  
返回顶部  
4，Winfrom下载CefSharp的基本使用  
4.1显示一个页面  
4.1.1 使用CefSharp.WinForms来显示网页对象  
在下一个窗体中的对应位置添加代码  
  
  
       ;   
       公共部分类Form1：Form   
        \{   
            ChromiumWebBrowser webBrower = null;   
            public Form1（）  
            \{   
                InitializeComponent（）;   
                加载+ = Form\_Load;   
            \}   
            private void Form\_Load（object sender，EventArgs e）  
            \{   
                string path =“www.baidu.com”;                    
                webBrower =新的ChromiumWebBrowser（路径）;   
                webBrower.Dock = DockStyle.Fill; //   
                填充方式this.Controls.Add（webBrower）;   
            \}   
        \}直接  
运行就OK了  
  
  
  
  
4.1.2显示一个本地html   
把路径改为File协议就行，例如：显示程序下的文件夹html中的test.html   
  
  
//获取文件的物理路径  
字符串路径= AppDomain.CurrentDomain.BaseDirectory +“\\\\ html \\\\ test.html”;   
//转换为文件协议路径  
path =“file：//”+ path.Replace（“\\\\”，“/”）;    
如果实在不知道怎么写的话，建议直接用浏览器把html打开，地址栏里面显示的文件：//链接就是文件协议路径  
  
  
需要在test.html文件上右击 - 属性 - 复制到输出目录改为始终复制，这样调试时调试下面才会有这个文件  
  
  
推荐个CCS3动画的html，直接右击保存到本地就行了大风车CCS3动画，修改完成，同样运行就可以看到页面了，运行还是挺流畅的。  
  
  
  
  
4.2 JavaScript调用异步C＃方法  
走弯路后的说明：BoundObject等这三个类以及里面的方法都是可以自己任意定义实现的，和普通的方法类没有太大区别，没有必要去源码中过过来。  
  
  
从源码的CefSharp.Example中找到三个类BoundObject，SubBoundObject，ExceptionTestBoundObject的源码拷过来，记得对应着自己的项目把命名空间名改了。  
  
  
如果是.net4.0，TestCallback，TestCallbackException两个方法有提示异步/等待，Task.Run的报错，处理方式：直接  
  
  
升级到.NET Framework 4.5：从用户安装便捷性上讲，个人感觉完全没必要  
直接修改掉，因为这是测试的代码，可自己写不用Task.Run，详情请参阅CSDN论坛-Task.Factory.StartNew（）和Task.Run（）有什么区别，CSDN论坛-task .run必须是4.5框架，4.0里没有;如果是想在.net4.0下使用异步/ AWAIT还有别的方法-直接的NuGet搜索安装Microsoft.Bcl.Async，如果搜索太慢或者搜索不到可以直接在的NuGet控制台执行Install-Package Microsoft.Bcl.Async。如果和我一样提示Nuget版本2.7太低，至少需要2.8的，需要卸载升级Nuget，步骤：  
卸载：打开VS->打开菜单“工具” - “扩展管理器” - >选择“NuGet Package Manager” - >点击“卸载”，然后会提示重启，不自动重启的话可以自己手动重新  
下载新版本nugethttps：//dist.nuget.org/index.html，根据你的vs版本选择下载后缀是.vsix，直接安装就行，装完最好再重启一下与  
我这里选择不升级.NET 4.5后面一种方法，同时安装Microsoft.Bcl.Async。  
  
  
这里实现的是一个延时回调 例子，即点一个按钮，调用绑定的C＃方法在3秒后显示一条消息同时调用JS方法立即显示一条消息。  
测试内容准备：  
  
  
BoundObject中定义回调方法（可以自己定义一个空的BoundObject类，增加一下内容）  
public void TestCallback（IJavascriptCallback javascriptCallback）  
\{   
//.net 4.0的写法  
const int taskDelay = 3000;   
Task.Factory.StartNew（async（）=>   
\{   
Delay（taskDelay）;   
using（javascriptCallback）  
\{   
// var response = new CallbackResponseStruct（“This callback from C＃was delayed”+ taskDelay +“ms”）;   
await javascriptCallback.ExecuteAsync （“来自C＃的返回值，在当前延迟”+ taskDelay +“ms”）;   
\}   
\}）;   
/ \*   
//.net 4.5的写法  
const int taskDelay = 1500;   
Task.Run（async（）=>   
\{   
await Task.Delay（taskDelay）;   
  
  
            using（javascriptCallback）  
            \{   
                //注意：不支持类，简单结构是  
                var response = new CallbackResponseStruct（“这个来自C＃的回调被延迟了”+ taskDelay +“ms”）;   
                等待javascriptCallback.ExecuteAsync（response）;   
            \}   
        \}）;   
         \* /   
    \}   
在Form中给ChromiumWebBrowser增加绑定，第三个参数false忽略方法名大小写建议不要忘记，否则JS中掉用时方法名默认区分  
大小写webBrower.RegisterJsObject（“bound”，new BoundObject（）， false）;   
新建个html，body中录入一下内容  
  
  
    <p> Javascript回调测试</ p>   
<script type =“text / javascript”>   
    function callback（s）\{   
        var result = document.getElementById（'show'）;   
        result.innerText + =“callback返回值：”+ s.toString（）+“时间：”+ Date（）;  
  
  
        //调用后台C＃方法TestCallback，返回结果回调方法callback   
        bound.TestCallback（callback）;   
        var result = document.getElementById（'show'）;   
        result.innerText =“方法返回时间：”+ Date（）+“\\ n”;   
        //window.location.assign("http://www.baidu.com“）;   
    \}   
</ script>    
<button onclick =“TestCallback（）”> TestCallBakck </ button>   
<br />   
<span id =“show”> </ span>    
可以运行一下了，点击一下TestCallBakck按钮，会首先显示一行内容与时间，3秒后显示第二行内容。  
  
  
  
  
4.3 JavaScript调用带参数C＃方法  
准备内容：  
  
  
BoundObject添加重复方法  
  
  
        public string重复（string str，int n）  
    \{   
        string result = String.Empty;   
        for（int i = 0; 我<n;   
        i ++） \{   
            结果+ = str;   
        \}   
        返回结果;   
    \}   
html内容  
  
  
    <p>带参数调用C＃重复方法</   
span>    
<script type =“text / javascript”>   
    var result = bound.Repeat（“hello”，6 ）;   
    document.getElementById（“content”）。innerHTML =“”+ result +“”;   
</ script>    
执行结果  
  
  
  
  
4.4 JavaScript调用委托C＃方法  
这里将一个方法returnJsonEmployeeList作为参数进行传递，并返回一个json数据进行解析展示  
  
  
BoundObject中添加方法  
  
  
    public string ReturnJsonEmployeeList（）  
\{   
    return“\{\\”employees \\“： \{\\“firstName \\”：\\“John \\”，\\“lastName \\”：\\“Doe \\”\}，\{\\“ firstname \\“：\\”Anna \\“，\\”lastName \\“：\\”Smith \\“\}，\{\\”firstName \\“：\\”Peter \\“，\\”lastName \\“：\\”Jones \\“\}\]\} “;   
\}   
html内容  
  
  
     委托C＃方法 - 返回json字符串</ p>   
    <script type =“text / javascript”>   
    函数myfunc（fucPara）\{   
        return fucPara（）;   
    \}   
    var res = myfunc（bound.ReturnJsonEmployeeList）;   
    document.write（“委托输出结果：”+ res +“<br>”）;   
    var json = JSON.parse（res）; // eval（“'”+ res +“'”）;   
    document.write（“employees数量：”+ json.employees.length +“<br>”）;   
    document.write（“json.employees \[0\] .lastName：”+ json.employees \[0\] .lastName）;   
</ script>   
运行结果：  
  
  
  
  
4。  
5 JavaScript调用C＃返回实体对象准备内容  
新建类SubBoundObject，对照添加以下内容  
  
  
             public class SubBoundObject   
    \{   
        public string SimpleProperty \{get; 组; \}  
        public SubBoundObject（）  
        \{   
            SimpleProperty =“这是一个非常简单的属性。”;   
        \}   
        public string GetMyType（）  
        \{   
            return“My Type is”+ GetType（）;   
        \}   
        public string EchoSimpleProperty（）  
        \{   
            return SimpleProperty;   
        \}   
    \}   
BoundObject中添加内容  
  
  
        public SubBoundObject SubObject \{get; 组; \}   
 public SubBoundObject GetSubObject（）  
    \{   
        return SubObject;   
    \}   
html中添加内容  
  
  
     <p>返回实体对象</ p>   
<script type =“text / javascript”>  
    document.write（“bound.GetSubObject（）。SimpleProperty：”+ bound.GetSubObject（）。SimpleProperty）;   
</ script>    
运行结果：  
  
  
  
  
4.6 ChromiumWebBrowser控件扩展IContextMenuHandler接口实现禁用右击按钮菜单  
禁用右键菜单需要创建一个类实现接口IContextMenuHandler，然后把这个类型赋值给ChromiumWebBrowser的MenuHandler即可。这里创建类MenuHandler：  
  
  
     内部类MenuHandler：IContextMenuHandler   
     \{    
        公共无效OnBeforeContextMenu（IWebBrowser browserControl，IBrowser浏览器，IFrame框架，IContextMenuParams参数，IMenuModel模型）  
        \{   
            model.Clear（）;   
        \}     
        公共布尔OnContextMenuCommand（IWebBrowser browserControl，IBrowser浏览器，IFrame框架，IContextMenuParams参数，CefMenuCommand commandId，CefEventFlags eventFlags）  
        \{   
            返回false;         （IWebBrowser browserControl，IBrowser浏览器，IFrame框架，IContextMenuParams参数，IMenuModel模型，IRunContextMenuCallback回调）        \{             return false;    
        \}      
        公共无效OnContextMenuDismissed（IWebBrowser browserControl，IBrowser浏览器，IFrame框架）  
        \{    
        \}           \}      \} 配置到ChromiumWebBrowser：webBrower.MenuHandler = new Class.MenuHandler（）;  
  
  
  
  
  
  
  
  
  
这里只是禁用了菜单，也可以在相关事件里面增加内容，实现自定义右击菜单，不同页面的不同右击菜单。  
  
  
4.6 WebGL页面渲染  
WebGL（全写Web图形库）是一种3D绘图标准，这种绘图技术标准允许把JavaScript和OpenGL ES 2.0结合在一起，通过增加OpenGL ES 2.0的一个JavaScript绑定，WebGL可以为HTML5帆布提供硬件3D加速渲染，这样的Web开发人员就可以借助系统显卡来在浏览器里更流畅地展示3D场景和模型了，还能创建复杂的导航和数据视觉化。显然，WebGL的技术标准免去了开发网页专用渲染插件的麻烦，可被用于创建具有复杂3D结构的网站页面，甚至可以用来设计3D网页游戏等等。  
  
  
使用的WebGL可以实现很炫的页面效果，以下这些实例都可以直接应用到一个引入了CefSharp的WinFrom桌面程序上面。  
9个令人震惊的WebGL示例  
20个使用WebGL和Three.js实现的网页场景  
  
  
返回顶部  
5，依赖项  
5.1必需的运行环境  
CefSharp官方文件readme.txt中有以下要求：  
  
  
根据X86 / X64安装对应的Visual用于Visual Studio 2013的C ++可再发行组件包  
安装.Net 4.0或者.Net 4.0客户端配置文件必需  
的依赖项  
libcef.dll（CEF代码）  
icudtl.dat（Unicode支持数据）  
CefSharp.Core.dll，CefSharp.dll，  
CefSharp.BrowserSubprocess.exe，CefSharp.BrowserSubProcess.Core.dll   
根据不同的开发平台CefSharp.WinForms.dll，CefSharp.Wpf.dll，CefSharp.OffScreen.dll至少有一个  
5.2依赖排错内容  
重要说明：不想看高（旦）达（旦）上（10克）分析的，请直接看5.3列表依赖  
因为我这的英文的NuGet引入的，调试/发布生成的内容很多，直接运行也是成功的，因此我以发布为例，实际和调试/释放下的调试是一样的。  
首先发布好的内容的英文这样的  
  
  
直接运行SETUP.EXE会有很多报错，因为VS的发布过程中忽略很多依赖内容，下面介绍一下怎么一步步定位到缺少的依赖项：  
  
  
运行生成的exe文件，报错会这个  
  
  
遇到这个问题的肯定没好好看上边的内容，从源码或者调试/发布下找到libcef.dll，icudtl.dat考到EXE下目录错误这个就没有了  
运行exe文件会有新的问题，XXX已停止工作-点击关闭程序，注意目录下出现了一个的debug.log，打开显   
FATAL：v8\_initializer.cc（155）无法打开V8文件'd：\\项目\\ 2013 \\ CefSharpDemo \\ CefSharpDemo \\发布\\应用程序文件\\ CefSharpDemo\_1\_0\_0\_7 \\ natives\_blob.bin'（原因：-4）  
说明缺少natives\_blob.bin，上边同直接拷贝产品过来  
  
  
继续运行EXE，form1中出现了但是没有内容，这时候看日志是没有新的报错的，但是请持续观察，报错需要等一会儿才会进来  
\[142128分之1226：警告：resource\_bundle.cc（311）\] locale\_file\_path.empty（）for语言环境  
\[1226/142128：ERROR：main\_delegate.cc（724）\]无法加载en-US的语言环境pak   
\[1226/142128：错误：main\_delegate.cc（ 731）\]无法加载cef.pak   
\[1226/142128：错误：main\_delegate.cc（748）\]无法加载cef\_100\_percent.pak   
\[1226/142128：错误：main\_delegate.cc（766）\]无法加载cef\_extensions.pak   
根据报错加入locales \\ en-US.pak，cef.pak，cef\_100\_percent.pak，cef\_extensions.pak   
继续运行exe，form1出现了但是没有内容，仔细研究日志  
\[1226/142128：ERROR：child\_process\_launcher.cc（443）\] Failed启动子进程  
\[1226/142129：错误：child\_process\_launcher.cc（443）\]无法启动子进程  
\[1226/142925：错误：child\_process\_launcher.cc（443）\]无法启动子进程  
\[1226/142926：错误：child\_process\_launcher.cc（443） ）\]无法启动子进程  
\[1226/143326：错误：child\_process\_launcher.cc（443）\]无法启动子进程  
\[1226/143327：错误：child\_process\_launcher.cc（443）\]无法启动子进程  
\[1226/143502：错误：child\_process\_launcher.cc（443）\]无法启动子进程  
\[1226/143503：ERROR：child\_process\_launcher.cc（443）\]无法启动子进程  
看懂了吗，没看懂？好吧  
，我也没看懂....只好把debug / release下的文件往这边边粘贴然后试试，然后在粘了CefSharp.BrowserSubprocess.Core.dll CefSharp.BrowserSubprocess.exe两个之后奇迹发生了....抓紧把之前粘的全删了...  
现在已经正常了，但是，但是log里面还有报错  
  
  
\[1226/145245：ERROR：gpu\_child\_thread.cc（260）\]由于初始化过程中的错误而退出GPU进程  
\[1226/145245：ERROR：browser\_gpu\_channel\_host\_factory.cc（133）\] Failed推出GPU处理。  
好了不废话了，经过我的九牛二虎之力，发现加入libEGL.dll，libGLESv2.dll，d3dcompiler\_43.dll，d3dcompiler\_47.dll就OK了  
  
  
5.3文件依赖列表  
总结一下，CefSharp必有的文件：  
\--- locales   
| | --en-US.pak   
| --cef.pak   
| --cef\_100\_percent.pak   
| --cef\_extensions.pak   
| --CefSharp.BrowserSubprocess.Core.dll   
| --CefSharp.BrowserSubprocess.exe   
| --CefSharp.Core .dll   
| --CefSharp.dll   
| --CefSharp.WinForms.dll   
| --d3dcompiler\_43.dll   
| --d3dcompiler\_47.dll   
| --icudtl.dat  
| --libcef.dll   
| --libEGL.dll   
| --libGLESv2.dll   
| --natives\_blob.bin   
补充一下，运行环境vs2013，.NET4.0，Winfrom，CefSharp v40.0.1。  
  
  
返回顶部  
6，总结  
根据今天初步的部署，测试，感觉CefSharp可以算是比较成熟的CEF的在.NET下的实现了，JavaScript的和C＃的交互做的简单易用，感觉可以比较容易的将一个网络应用的资源经过一定的重新整合打造成为一个桌面程序。  
  
  
吐槽：一个字大，因为从根本上是集成了一个铬浏览器，所以以上简单的演示的发布程序的64位，释放版本就达到了99.5M，360压缩，7Z格式压缩后30.6米，正式项目增加了代码，引入了其他的DLL，资源文件等会更大;知道不有没有方法可以做精简  
  
  
以上均为个人看法，大各路神请指点  
  
  
报道查看顶部  
7，源码下载与参考资料  
7.1提供了两个版本  
    CefSharpDemo20161227包含包157M   
    CefSharpDemo20161227不包131K   
下载请去原文：http：//huisky.com/blog/16122515111968   
  
  
7.2 参考资料  
CefSharp初识 - 把网页移到桌面 - stoneniqiu   
.NET4.0中使用4.5中的异步/等待功能实现异步  
关于CefSharp的坎坷之路