本篇简介

上一节中我们讲解了基于CEF浏览器开发的基本方法，并实现了QCefView控件和其核心组件QCefClient。>>点这里回顾上节内容

先来回顾一下上一节中提到的CEF3应用整体结构：

• 提供一个入口方法初始化CEF，并执行CEF的消息循环；
• 提供CefApp的实现，以处理进程相关(process-specific)的回调；
• 提供CefClient的实现，以处理浏览器实例相关(browser-instance-specific)的回调。

其中第三条浏览器实例相关的实现在上一节中已经完成了，本篇我们将继续完成另一个核心组件QCefApp的开发，并通过实际使用QCefView，展示如何提供CEF初始化入口，最终完成浏览器核心功能和基本UI的开发。

本篇的小目标：

• 实现QCefApp组件
• 实现CEF程序入口
• 使用封装好的QCefView，完成浏览器开发

实现QCefApp组件

和CefClient类似，我们的应用程序需要提供一个CefApp的封装，来处理进程相关的回调——这里进程相关的回调对于我们要实现的简单浏览器而言，就是对浏览器进程本身的管理。因此，我们的QCefApp组件头文件声明如下：

class QCefApp: public CefApp,
        public CefBrowserProcessHandler
{
public:
    QCefApp();
    virtual ~QCefApp();

    // CefApp接口
    virtual CefRefPtr<CefBrowserProcessHandler> GetBrowserProcessHandler()
        OVERRIDE { return this; }

    // CefBrowserProcessHandler接口:
    virtual void OnContextInitialized() OVERRIDE;

    //　创建浏览器进程的工厂方法
    CefRefPtr<QCefClient> addBrowser(QList<QSslCertificate> caCerts = QList<QSslCertificate>());
    
    //　关闭所有浏览器进程
    void closeAllBrowser();

   private:
    bool m_contextReady;
    QQueue<CefRefPtr<QCefClient> > m_clients;
    // Include the default reference counting implementation.
    IMPLEMENT_REFCOUNTING(QCefApp)
};

和CefClient类似，CefApp也可以通过继承多个接口的方式实现进程级的各类管理。因为我们要实现的简单浏览器暂时不涉及太多复杂的管理，所以这里只简单实现了浏览器进程处理和上下文初始化的接口。同样和CefClient类似，对于CefXXXHandler接口，只需要将引用设为本实例，即可重载对应接口所提供的方法了。

额外说明一点：这里的创建浏览器进程方法里有一个添加ca证书的方法，目前先作为预留，有关ca证书和https的话题在之后的小节中会有专门的讲解。

浏览器上下文初始化、添加和关闭浏览器接口的具体实现如下：

void QCefApp::OnContextInitialized()
{
    CEF_REQUIRE_UI_THREAD();
    m_contextReady = true;
}

CefRefPtr<QCefClient> QCefApp::addBrowser(QList<QSslCertificate> caCerts)
{
    if (m_contextReady)
    {
        // 创建本地窗口所需的信息
        CefWindowInfo windowInfo;

#if defined(OS_WIN)
        // 针对Windows系统，需要指定特殊的标识，
        // 这个标识会被传递给CreateWindowEx()方法
        windowInfo.SetAsPopup(NULL, "QCefView");
#endif
        // 初始化cef client方法
        CefRefPtr<QCefClient> client(new QCefClient());
        client->setCaCerts(caCerts);
        // 指定CEF浏览器设置
        CefBrowserSettings browserSettings;
        std::string url = "data:text/html,chromewebdata";
        // 创建浏览器窗口
        CefBrowserHost::CreateBrowser(windowInfo, client.get(), url, browserSettings, NULL);
        // 将浏览器引用添加到浏览器队列
        m_clients.enqueue(client);
        return client;
    }
    return NULL;
}

void QCefApp::closeAllBrowser()
{
    while (!m_clients.empty())
    {
        m_clients.dequeue()->browser()->GetHost()->CloseBrowser(true);
    }
}

通过上面的实现可以看出，添加浏览器实例进程实际上就是创建了一个QCefClient的引用，并将这个引用和浏览器相关的一些设置传入到静态方法CefBrowserHost::CreateBrowser中。而OnContextInitialized方法通过设置m_contextReady标志确保在创建浏览器实例时CEF上下文已初始化完成。

CEF程序入口

在完成CefApp组件的实现后，我们已经基本凑齐了启动CEF所需的零件。最后让我们来看看如何把这些零件借助CEF程序入口组装起来。

首先，声明一个QCefContext类，来封装CEF程序入口所需的基本设置和初始化方法：

class QCefContext
{
public:
    QCefContext(CefSettings* settings);
    ~QCefContext();

    //初始化 Cef
    int initCef(int argc, char *argv[]);

public:
    CefRefPtr<QCefApp> cefApp() const;

private:
    int initCef(CefMainArgs& mainArgs);

private:
    CefSettings* m_settings;
    CefRefPtr<QCefApp> m_cefApp;
    CefRefPtr<CefCommandLine> m_cmdLine;
};

其中，负责初始化CEF的initCef方法实现如下：

int QCefContext::initCef(int argc, char *argv[])
{
    // 创建CEF默认命令行参数.
    m_cmdLine = CefCommandLine::CreateCommandLine();
#ifdef CEF_LINUX
    CefMainArgs mainArgs(argc, argv);
    m_cmdLine->InitFromArgv(argc, argv);
#else
    // 兼容WINDOWS系统
    HINSTANCE hInstance = (HINSTANCE)GetModuleHandle(NULL);
    CefMainArgs mainArgs(hInstance);
    m_cmdLine->InitFromString(::GetCommandLineW());
#endif
    return initCef(mainArgs);
}

int QCefContext::initCef(CefMainArgs& mainArgs)
{
    CefRefPtr<CefApp> app;

    // 创建一个正确类型的App Client
    if (!m_cmdLine->HasSwitch("type"))
    {
      app = new QCefApp();
      m_cefApp = CefRefPtr<QCefApp>((QCefApp*)app.get());
    }

    int result = CefExecuteProcess(mainArgs, app, NULL);
    if (result >= 0)
    {
      return result;
    }

    // 初始化CEF
    CefInitialize(mainArgs, *m_settings, app.get(), NULL);

    return -1;
}

这个初始化方法包含了下面流程：

• 创建CEF默认命令行参数，并将应用程序本身的参数也提供给CEF上下文
• 根据命令行参数类型，实例化对应类型的CefApp

这里需要特别说明的是，CEF应用在默认情况下包含很多子进程（渲染进程、插件、GPU进程等等），这些进程会共享同一个执行入口。这里我们简单起见，仅就主进程进行处理——从上面的实现可以看到，当检测到当前进程为主进程时，创建一个CefApp的实例即可。这个实例的引用会通过cefApp()方法提供给需要获取CefApp的其他组件使用。

QCefView控件的使用

接下来我们来看看如何实际使用上面封装好的程序入口。

首先声明一个继承了QDialog的主窗口MainDlg:

namespace Ui {
class MainDlg;
}

class MainDlg : public QDialog
{
    Q_OBJECT
public:
    explicit MainDlg(CefRefPtr<QCefApp> cefApp, QWidget *parent = 0);
    ~MainDlg();

private:
    void initWebview(CefRefPtr<QCefApp> cefApp);

private:
    Ui::MainDlg *ui;
    QCefView* m_webview;
};

在这个主窗口的构造方法中，会调用初始化QCefView的方法initWebview：

MainDlg::MainDlg(CefRefPtr<QCefApp> cefApp, QWidget* parent) : QDialog(parent), ui(new Ui::MainDlg)
{
    ui->setupUi(this);
    initWebview(cefApp);
}

initWebview方法包含了QCefView界面布局相关的一些设置，这里我们略过这些实现，只专注于QCefView本身初始化的流程：

void MainDlg::initWebview(CefRefPtr<QCefApp> cefApp)
{
    // 省略界面布局的设置
    ...
    // 初始化QCefView
    m_webview = new QCefView(cefApp->addBrowser(), upperFrame);

    connect(m_webview, SIGNAL(cefEmbedded()), this, [this]() {
        show();
    });

    connect(ui->btnGo, &QPushButton::clicked, this, [this]() {
        m_webview->load(QUrl(ui->editAddress->text()));
    });

    // 省略界面布局的设置
    ...
}

从上面的实现可以看出，这里我们只需要通过CefApp的添加浏览器方法获取QCefClient的引用，并将其提供给QCefView，就能简单完成QCefView控件的创建。

回到整个应用程序的入口，也就是main函数，除了传统Qt应用的实现之外，还需要添加一下CEF入口相关（也就是我们上一小节封装好的QCefContext）的实现：

int main(int argc, char *argv[])
{
    int result = 0;

    CefSettings settings;
    // 禁用日志
    settings.log_severity = LOGSEVERITY_DISABLE;
    // 设置CEF资源路径(cef.pak和/或devtools_resources.pak)
    CefString(&settings.resources_dir_path) = CefString();
    // 本地化资源路径
    CefString(&settings.locales_dir_path) = CefString();

    QCefContext* cef = new QCefContext(&settings);
    result = cef->initCef(argc, argv);
    if (result >= 0)
        return result;

    QApplication a(argc, argv);
    QApplication::addLibraryPath(".");

    MainDlg* browser = new MainDlg(cef->cefApp());
    result = a.exec();

    delete browser;
    delete cef;

    CefShutdown();

    return result;
}

至此，我们的浏览器应用初版终于完成了。运行一下看看效果：

cef_browser.png

流程总结

本节所涉及到的组件及其流程可以总结为下面的时序图：

QCefBrowser应用时序图.png

有关基于CEF的浏览器基本功能的实现，就讲解到这里了。下一节我们将介绍如何基于CEF实现浏览器与页面的互相通信。
>>返回系列索引

参考链接

[1] Chromium Embedded Framework官网
[2] Chromium Embedded Framework官方教程