Jcef内嵌浏览器windows版本的编译及使用

Posted 2020-09-11 木字旁

背景

　　去年年底接到的新需求，需要将原来用Swing做的桌面应用中的一个功能做成Web版的，并且要集成到原应用中，换言之就是要使用内嵌浏览器。最开始考虑的是JavaFx提供的WebView，优点是不需要其他第三方库，jdk1.7开始集成。但是开发完成之后发现两个比较严重的问题，一是界面有一个比较复杂的曲线图会严重卡顿，另一个是有几率会导致虚拟机崩溃，并且速度上也不是很让人满意。最后只能考虑换一个内嵌浏览器框架，然后就找到jcef，基于chrome，速度兼容性都很好。

　　关于jcef就不多作介绍，不了解的可以戳这里java-cef，本文主要讲解jcef的编译过程，由于产品只支持windows平台使用的是32位的jre，所以只编了win32的版本，64位编译过程基本相同，只需要改变下参数。

编译环境

• CMake 2.8.12.2或者更新的版本（我用的免装版，bin目录要手动配置环境变量）
• Git
• Visual Studio 2015（官网推荐2015，原因是开发者使用的就是2015版本，实测VS2010和VS2013编译均会报错）
• Java 1.8 32位 （官网写的是1.7或者1.8，实际上使用1.7编译java部分会有语法错误，可以修改源码规避，建议使用1.8，编译64位版本使用64位的jdk）
• Python 2.6或者更新的版本（不支持Python3）

编译过程

　　1. 源码下载　　　　

　　使用Git将下载jcef源码，clone地址：https://bitbucket.org/chromiumembedded/java-cef.git，当然也可以直接下载Jcef源码。这里建议使用Git Clone，因为在使用CMake构建的时候需要用到.git目录下面的文件中当前节点的信息来构建jcef_version.h头文件，如果不是git clone的代码，没有git相关的文件编译会出错，这个应该是可以通过修改编译脚本规避，把通过git文件获取的信息写死，没有试过，不细表。　　　　

　　　　

　　2. CMake构建VS工程

　　在源码目录下创建新目录jcef_build（不可随意命名），打开DOS进入到新目录中，输入命令cmake -G "Visual Studio 14 2015" ..，回车开始构建。此处有坑，我编的时候新装的VS2015这里报错，找不到编译器，研究了老半天最后找到一句话，VS2015默认安装不包含C++支持……当时整个人都不好了。如果要编64位的话命 令换成这样：cmake -G "Visual Studio 14 Win64" .. 。这里还有一个注意的地方是，这个过程会自动去下载当前Jcef对应的CEF的版本，若果下载不成功可以自己下载之后放到/java-cef/third_party/cef目录中。CEF版本号可以从源码目录下的CMakeLists.txt文件中找到。

CEF下载地址：http://opensource.spotify.com/cefbuilds/index.html  (经常打不开，我FQ才能稳定打开)

 

CMake构建后的C++项目: 

　　

　　3. VS构建

　　使用VS打开jcef_build中的jcef.sln文件，选择"生成-->配置管理器-->修改为Release和Win32"，然后选择"生成-->生成解决方案"，然后等待构建完成。

　　4. 编译java代码

　　使用dos进入到源码目录的tools目录里，执行命令compile.bat win32

　　5. 测试运行

　　同样是tools目录，执行run.bat win32 Release simple或者run.bat win32 Release detailed，浏览器正常运行，编译成功。

  　　

　　6. 打包

　　tools目录下执行 make_distrib.bat win32，源码目录下会自动创建打包目录binary_distrib，里面包含了api文档，浏览器Demo，使用到的jar和dll以及资源文件。

使用方法

　　需要用到的jar: \\java-cef\\binary_disrib\\win32\\bin里面的相关jar包

　　

　　动态库以及资源文件等：\\java-cef\\binary_disrib\\win32\\bin\\lib\\win32里面的所以内容

 　　

　　编码时导入jcef即可编译成功，运行时classpath指定上述jar包，将上面的dll等文件win32目录下的所以内容放在一个目录中,然后将其指定为-Djava.library.path的值即可，可以参考\\java-cef\\binary_distrib\\win32里面的run.bat。

一键编译脚本

　　build_jcef.bat win32一键编译，脚本是按照可编译64位写的，参数用win64就行了，不过笔者没试过......　　

@echo on
@rem 设置路径
set SRC_PATH=D:\\java-cef
set VS_PATH=C:\\Develop\\VS2015

if "%1" == "" (
echo ERROR: Please specify a target platform: win32 or win64
set ERRORLEVEL=1
goto end
)

cd /d %SRC_PATH%
mkdir %SRC_PATH%\\jcef_build
cd /d %SRC_PATH%\\jcef_build

@rem CMake构建
cmake -G "Visual Studio 14 2015" ..

@rem VS编译
@echo VS Building Start
%VS_PATH%\\Common7\\IDE\\devenv.exe %SRC_PATH%\\jcef_build\\jcef.sln /rebuild "Release|%1"
@echo VS Building End

@rem 编译java部分
cd /d %SRC_PATH%\\tools 
call compile.bat %1

@rem 打包
call make_distrib.bat %1

:end
Exit /B

View Code

 

 结语

　　从编译到开发，以及解决各种bug，jcef的资料太少，走过不少弯路。不过项目总算是顺利完成交付，这里做个笔记，也分享给需要的人，希望能有所帮助。