如何编译JCEF以及内嵌到桌面应用程序中

前言 在项目中需要在桌面应用程序中内嵌浏览器, 尝试了几种解决方案,有:javafx, DJNativeSwing,CEF等。觉得CEF效果最好。本文目的是介绍如何编译和使用jCEF。
主要参考和翻译了这篇文章java-cef
背景说明 什么是CEF?
CEF是Chromium Embedded Framework的缩写,是个基于Google Chromium项目的开源Web browser控件,支持Windows, Linux, Max平台。除了提供C/C++接口外,也有其他语言的移植版。比如JCEF。
因为基于Chromium,所以CEF支持Webkit & Chrome中实现的HTML5的特性,并且在性能上面,也比较接近Chrome。
谁在用CEF?

  1. 各种浏览器
早期的双核浏览器(IE + Webkit),有些使用了CEF来作为Webkit内核浏览器控件。
不过对于浏览器来说,直接在Chrome上面扩展,其实才是王道,大家现在都这么做了(各种极速浏览器)。
  1. Evernote Client (on Windows)
Evernote允许用户将网页粘贴到笔记中,还提供了插件用来将网页保存为笔记。
那肯定是需要在Client上面可以正确的渲染页面咯,这个任务就交给了CEF。
  1. GitHub Client (on Windows)
GitHub也打包了libCEF.dll,从表现上面看,用来展示项目的ReadMe页面的,肯定是CEF,其他地方的UI,可能部分也是用页面来实现的。
  1. QQ
QQ很早之前就通过内嵌IE来实现一些功能和界面。从2013年开始,QQ引入了CEF,对一些之前用IE的地方进行了替换,这样就可以使用一些基于Webkit的新特性,同时也获得了速度、稳定性、兼容性方面的优势。
什么是JCEF?
简单来说,JCEF是对CEF进行了一层Java封装。使用JNI调用CEF的功能。目标是让java开发者能够使用CEF框架来开发web browser控件。
如编译和使用JCEF? 目前JCEF保持了一个开发分支对CEF进行跟进,在不断的develop中。我们可以下载JCEF源码按照下面的步骤手动编译。
1. 准备环境
需要编译JCEF需要你的电脑上有如下的开发环境:
  • CMake version 2.8.12.2 or newer.
  • Git.
  • Java version 1.7 or newer.
  • Python version 2.6 or newer.
对于linux系统,下面几个发行版是支持的:
  • Debian Wheezy, Ubuntu Precise, and related.
对于windows系统:
  • 因为JCEF的开发者用Visual Studio 2013 作为开发工具,所以你得准备一个VS2013 来编译JCEF,否则用其他的编译器可能会出问题。
对于MAC系统:
  • 需要Apache Ant
2. 下载JCEF源码
  1. 使用git下载JCEF源码:
    #The JCEF source code will exist at `/path/to/java-cef/src`cd /path/to/java-cefgit clone https://bitbucket.org/chromiumembedded/java-cef.git src

  2. 下载CEF源码:
访问cef, 根据目标平台(windows or linux or mac)去下载cef最近稳定的分支下载完成后,按照README.jcef描述的文件结构,将下载的内容解压,并重命名文件夹。
比如,对于win64的版本,文件夹目录会是如下的结构/path/to/java-cef/src/third_party/cef/win64/cefclient.gyp
其中third_party文件夹包含的是JCEF引用的第三方库文件。
  1. 对于linux系统,需要创建symlinks。执行如下指令:
    $ sudo ln -s /path/to/java-cef/src/third_party/cef/linux64/Resources/icudtl.dat /usr/lib/jvm/java-7-oracle/jre/bin/icudtl.dat$ sudo ln -s /path/to/java-cef/src/third_party/cef/linux64/Debug/natives_blob.bin /usr/lib/jvm/java-7-oracle/jre/bin/natives_blob.bin$ sudo ln -s /path/to/java-cef/src/third_party/cef/linux64/Debug/snapshot_blob.bin /usr/lib/jvm/java-7-oracle/jre/bin/snapshot_blob.bin

3. 手动编译
  1. 运行cmake生成目标平台的项目文件,然后编译这些项目文件去生成本地的代码,比如生成jcef和jcef_helper两个项目的本地代码。
    # Enter the JCEF source code directory.cd /path/to/java-cef/src# Create and enter the `jcef_build` directory.# The `jcef_build` directory name is required by other JCEF tooling# and should not be changed.mkdir jcef_build && cd jcef_build# Linux: Generate 64-bit Unix Makefiles.# Set the JAVA_HOME environment variable if necessary.export JAVA_HOME=/usr/lib/jvm/java-7-oraclecmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Debug ..# Build using Make.make -j4# Mac OS X: Generate 64-bit Xcode project files.cmake -G "Xcode" -DPROJECT_ARCH="x86_64" ..# Open jcef.xcodeproj in Xcode and select Product > Build.# Windows: Generate 64-bit VS2013 project files.cmake -G "Visual Studio 12 Win64" ..# Open jcef.sln in Visual Studio and select Build > Build Solution.

  2. 在windows或者linux上,使用compile.[bat|sh]工具来build JCEF的JAVA classes,在MAC上不需要如下步骤,因为java classes已经被cmake生成。
    cd /path/to/java-cef/src/toolscompile.bat win64

  3. 测试结果是否正确。
    使用 run.[bat|sh] 工具来测试JCEF是否工作。
    cd /path/to/java-cef/src/toolsrun.bat win64 Release detailed

    正确结果会得到一个java窗口程序,如图:
    如何编译JCEF以及内嵌到桌面应用程序中
    文章图片

到此为止,我们已经把jcef编译成为目标平台的本地代码了。
在eclipse里使用jcef
其实在jcef源码里,就有java代码的示例。
  1. 打开eclipse 新建一个工程,base目录选择/path/to/java-cef/src/java
  2. 点击工程,邮件选择build path > configure build path
  3. 选择Librares页签,添加两个第三方jar。在上文提到的third_party中,分别如下:
    /path/to/java-cef/src/third_party/jogamp/jar/gluegen-rt.jar/path/to/java-cef/src/third_party/jogamp/jar/jogl-all.jar
  4. 在source页签下, 为Native library location 添加一个地址,如下:
    /path/to/java-cef/src/jcef_build/native/Release
  5. 运行tests.simple或者是tests.detail里的mainFrame。
结果如下:
【如何编译JCEF以及内嵌到桌面应用程序中】如何编译JCEF以及内嵌到桌面应用程序中
文章图片

    推荐阅读