关于CEF基本使用（***）

上一篇文章中介绍到了关于libCEF如何编译以及编译过程中遇到编译错误的问题，紧接着就是对libcef库的使用了，关于libcef使用我也是刚刚了解，从这两天的学习与使用来看，有了基本的总结。在总结网络其他网友的使用，基本情况如下：

     基本框架

1. CEF 使用了多进程。主进程是“browser”进程，负责窗口管理，界面绘制和网络交互， 子进程rederes负责Blink的渲染和Js的执行、Js Binding和对Dom节点的访问, 默认的进程模型中，会为每个标签页创建一个新的"render"进程，除此之外还有plugins, GPU子进程，这些进程按需创建，象管理插件的进程和处理合成加速的进程。
   
2. 在ECF的所有进程中，都可以有多线程。CEF提供了函数和接口在不同的线程中来传递任务。

   • TID_UI ：线程是浏览器的主线程。如果应用程序在调用调用CefInitialize()时，传递CefSettings.multi_threaded_message_loop=false，这个线程也是应用程序的主线程。

   • TID_IO ：线程主要负责处理IPC消息以及网络通信。
   • TID_FILE ：线程负责与文件系统交互
3. 一些回调方法和函数只能在特定线程和进程中使用。在使用API之前请确保仔细阅读注释。

   关键接口

     a. CefHandler

            浏览器通知是通过注册的委托接口由浏览器发到客户端程序的通知， CefHandler是最主要的委托接口, CefJSHandler则用于实现自定义的

       Javascript对象。

       CefHandler支持以下接口：

• 窗口创建之前 (BeforeCreated)，客户端可用之取消与定制浏览器窗口创建过程。
• 窗口创建之后(AfterCreated). 可用于创建自定义的CefJSHandler对象。
• 地址栏更新(AddressChange). 将地址栏更改为指定的字符串，通知发生于导航提交后与页面加载前。
• 标题更新(TitleChange). 将标题更改为指定的字符串，发生在页面加载中。
• 浏览前(BeforeBrowse). 可用于取消导航，该事件的信息包括URL，Post数据，请求头.
• 开始加载(LoadStart). 
• 加载结束 (LoadEnd). 
• 加载错误(LoadError). 加载过程中遇到错误，应用程序可提供自定义的错误页面.
• 资源加载前 (BeforeResourceLoad). 应用程序可提供替代的数据源 (比如内存中的缓存)或者取消加载.
• 显示菜单前(BeforeMenu). 可用于取消上下文菜单显示或定制菜单,默认情况下，浏览器根据上下文显示基本的菜单.
• 获取菜单标签(GetMenuLabel).在默认菜单显示前，每个菜单项调用一次，可用于将英文默认内容改为其它语言.
• 菜单动作(MenuAction). 用户从默认上下文菜单选择了一个选项，可用自己的方式来处理动作。
• 打印选项(PrintOptions). 打印设置对话框显示前调用，可用于定制页面大小、方向与边距等.
• 打印页眉页脚 (PrintHeaderFooter). 在页面视图输出到打印上下文，但是页面结束前，可在预定义的6个位置（上左、上中、上右、下左，下中，下右）插入自定义的页眉、页脚字符串。该事件附带的信息包括当前URL、标题、页码、总页数、打印上下文、页边距与DPI拉伸比.
• JavaScript警告 (JSAlert). 应用程序可自定义Javascript Alert窗口.
• JavaScrip确认 (JSConfirm). 应用程序可自定义Javascript Comfirm窗口
• JavaScrip提示 (JSPrompt). 应用程序可自定义Javascript Prompt窗口
• JavaScript Window 对象绑定 (JSBinding). 应用程序将用户定义的方法和变量附加到frame的window对象上
• Window关闭前 (BeforeWindowClose). 窗口关闭前
• 获得焦点(TakeFocus). 浏览器组件失去焦点前调用
• 设置焦点(SetFocus). 浏览器组件请求焦点前调用
• 键盘事件(KeyEvent). 浏览器组件接收到键盘事件时
• 提示 (Tooltip). 用于修改tooltip文字
• 控制台消息 (ConsoleMessage). 用于显示控制台消息.
• 查询结果(FindResult).用于自定义查找结果显示处理

       CefV8Handler支持以下通知：

• 执行事件(Execute). 应用程序执行指定的函数，该事件提供所有的Javascript参数，而且应用程序能指定返回值

不同版本接口可能会稍微有点差别，但大致的功能是一样的。

     b. CefBrowser、CefFrame

      浏览器事件由客户端应用程序通过CefBrowser和CefFrame的函数发送给浏览器:

• 后退、前进、重新加载与停止加载，用于控制浏览器导航.
• 撤消、重做、剪切、复制、粘贴、删除、全选，用于控制目标区域内容.
• 打印. 打印目标框架.
• 查看源代码. 将目标框架的HTML源代码保存到临时文件，并用默认的文本查看程序打开之
• 加载URL. 在指定框架中加载指定URL
• 载入字符串. 根据一个假URL在指定框架中加载某个字符串
• 加载流. 根据一个假URL，在指定框架中加载二进制数据
• 加载请求. 在指定框架中加载请求(URL, method, request data 与 headers) .
• 执行脚本. 在目标框架中执行任意Javascript命令

        CEF特性

        a.JavaScript扩展

              CEF支持可以和原生应用程序代码交互的Javascript扩展，参见cef.h的CefRegisterExtension() 函数和cefclient示例程序

              的"JavaScriptExtension Handler" 以及 "UI App Example" 测试 .

       b.自定义Schemes

              CEF支持注册与处理自定义scheme,类似于myscheme://mydomain。参见cef.h中的CefRegisterScheme()函数与示例应用程序cefclient中

              的 "Scheme Handler" 测试.

        c.框架实现概览

              CEF所有的类以Cef为前缀.

        d.框架准备与拆卸

              UI消息循环由框架创建的一个单独线程处理,客户端程序应负责通过分别调用CefInitialize()和CefShutdown() 来为每个进程准备与关闭这一

      线程。

        e.引用计数

              所有实现了CefBase接口的框架类与对象指针都由CefRefPtr智能指针实现来处理，通过调用AddRef()和Release()自动处理引用计数。

        f.平台无关

             CEF框架被设计成平台无关，需要当前我们仅支持windows平台，但是我们计划将来支持其它平台。为了尽可能减少双平台支持带来的麻

     烦，框架定义了一系列实现无关的接口与类型定义包装跨平台的行为。

        g.线程安全

            框架的所有接口实现必须是跨线程访问安全的，CefThreadSafeBase 模版提供原子的AddRef() 和 Release() 实现，还提供Lock() 和          

    Unlock()方法以同步方式访问代码块.

        h.框架接口

             框架定义了如下接口：

• CefBrowser 是主要的浏览器host类，通过它的静态方法CefBrowser::CreateBrowser()方法创建新浏览器窗口.
• CefFrame 表示浏览器窗口里的一个框架（frame），每个浏览器窗口都有一个顶级的主框架，可通过CefBrowser::GetMainFrame()方法访问之.
• CefHandler 是传给CefBrowser::CreateBrowser()方法的最主要委托接口.
• CefRequest 表示请求数据，比如url, method, post data 和 headers.
• CefPostData 和 CefPostDataElement 表示可能是请求一部分的post数据.
• CefSchemeHandlerFactory 和 CefSchemeHandler 用于处理像myscheme://mydomain这样的自定义scheme.
• CefStreamReader, CefStreamWriter, CefReadHandler 和 CefWriteHandler 读写数据的简单的接口.
• CefV8Handler 和 CefV8Value 用于创建和访问Javascript对象.

    使用流程

       cefsimple 工程初始化CEF并创建了一个简单的浏览器窗口。

1.  系统在入口点函数中（man或者wWinMain）函数中开启browser进程
2.  入口点函数：
   1. 创建SimpleApp的实例，在这个类中保存process-level callbacks.
   2. 初始化CEF并开启消息循环。
3.  当CEF初始化完毕以后， SimpleApp::OnContextInitialized()会被调用。在这个方法中：
   1. 创建一个单例的SimpleHandler
   2. 由CefBrowserHost::CreateBrowserSync()创建一个浏览器窗口
4.  所有的浏览器共享同一个在SimpleHandler。SimpleHandler负责定制浏览器的行为并保存browser-related callbacks（loading状态，标题行为等）
5.  当浏览器窗口被关闭的时候， SimpleHandler::OnBeforeClose() 被调用。当所有浏览器窗口被关闭，CEF消息循环退出。

     可以看下如下代码：

int APIENTRY wWinMain(HINSTANCE hInstance
                  , HINSTANCE hPrevInstance
                  , LPTSTR lpCmdLine
                  , int nCmdShow)
{
    CefMainArgs args(hInstance);

    CefRefPtr app(new MySimpleApp);

    int exitCode = CefExecuteProcess(args, app, NULL);
    if(exitCode >= 0) return exitCode;
    CefSettings settings;
    CefInitialize(args, settings, app, NULL);

    CefRunMessageLoop();
    CefShutdown();
    return 0;
}

此时进程开启，但是没有任何窗口， 如果我们需要建立窗口需要如下

CefWindowInfo winInfo;
winInfo.SetAsPopup(NULL, "myCefSimple");

CefBrowserSettings browser_settings;

CefRefPtr client(new MySimpleClient());
std::string url = "file:///D:/project/github/cptf/resource/binding.html";

CefBrowserHost::CreateBrowser(winInfo
    , client.get()
    , url
    , browser_settings
    , NULL);

这样就显示出来窗口了。
但是我们发现在关闭的时候进程没有关掉， 所以我们要做如下动作。

class MySimpleClient : public CefClient
                , public CefLifeSpanHandler


void MySimpleClient::OnBeforeClose(CefRefPtr<CefBrowser> browser) {
    CEF_REQUIRE_UI_THREAD();

    CefQuitMessageLoop();
}

   总结

    （1） App和Client是CEF中最重要的两个类。与MFC中的theApp和Dialog差不多，App是初始化实例，client负责消息或事件的响应。

    （2）CefExecuteProcess 和 CefInitialize 是建立app的两个最重要方法。而CreateBrowser 是创建浏览器窗口的最重要方法。