# cordova-plugin-x5engine-webview

**Repository Path**: liukaiming/cordova-plugin-x5engine-webview

## Basic Information

- **Project Name**: cordova-plugin-x5engine-webview
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-04-06
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cordova-plugin-x5engine-webview

Makes your Cordova application use the [TBS X5  WebView](http://x5.tencent.com/index)
instead of the System WebView. Requires cordova-android 4.0 or greater.

## 腾讯浏览服务X5SDK
[腾讯浏览服务X5SDK](http://x5.tencent.com/index)是通过调用微信/手机QQ/空间的X5内核，解决系统webview兼容性差、加载速度慢、功能缺陷等问题，开发接入便捷，大小只有253K，仅需几行代码，即可解决一切令开发者们头疼的问题，为用户提供最优秀的浏览体验。

腾讯浏览服务官方只提供了如何把系统Webview替换成X5的接入文档，并没有提供Cordova集成的方法。现在Hybrid App项目经常使用很多Cordoca插件提供拍照，扫二维码，App支付宝支付等功能，因此就需要把cordova和x5结合起来。

Cordova框架现在已经很完善，Cordova的Web Engine也是基于接口开发的，因此我参考系统engine的实现，写了一个x5engine插件，解决了Cordova调用X5内核的问题。

## 问题背景
熟悉Cordova生态圈的朋友可能听说过Crosswalk，[Crosswalk](https://crosswalk-project.org/documentation/cordova.html)是Intel维护的Webkit开源项目，可以通过插件安装命令` cordova plugin add cordova-plugin-crosswalk-webview` 安装，它的缺点就是太大了，集成后apk会增加20M，安装后会占用50M空间，因此一般不推荐普通App使用Crosswalk。

### Benefits
* 同时享受Cordova平台完善的生态系统和腾讯X5内核的兼容性和稳定性，大量的Cordova插件仍然可用， Apk size只增加250k。
* 微信/手机QQ/空间装机量很大，足够覆盖大多数国内用户
* 使用X5内核的播放器增强H5视频播放能力


### Drawbacks

* Increased APK size (about 250Kb)

### Install

The following directions are for cordova-cli (most people).  

* Open an existing cordova project, with cordova-android 4.0.0+, and using the latest CLI. TBS X5  variables can be configured as an option when installing the plugin
* Add this plugin

```
$ cordova plugin add  https://github.com/offbye/cordova-plugin-x5engine-webview.git
```

* Build
```
$ cordova build android
```

### Known issue
1. 64位手机上加载包含x5 so文件的插件报错
`TBS:initX5Core -- loadSucc: false; exception: java.lang.reflect.InvocationTargetException; cause: java.lang.UnsatisfiedLinkError: dlopen failed: "/data/data/com.tencent.mm/app_tbs/core_share/libmttwebview.so" is 32-bit instead of 64-bit
                                                                          `
解决办法是在libs/armeabi目录下增加一个32位的JNI so， 随便弄个小一点的so加上就可以，如果已经用了其它的JNI so应该不会有这个错误。

2. X5内核不支持file://本地域url，但支持本地相对路径。

---
### 关于项目 clone自
共发现3个项目：
1. https://github.com/offbye/cordova-plugin-x5engine-webview，原始版本（2，3都是基于offbye额修改而来的）
2. https://github.com/zsxsoft/cordova-plugin-x5engine-webview（解决：(使用Cordova 6.4.0版本create新App的bug)[https://github.com/offbye/cordova-plugin-x5engine-webview/issues/4]）
3. https://github.com/Im-Kevin/cordova.plugins.X5WebView (解决问题:同2，只是有点小小不一样),作者web前端牛逼
4. https://github.com/micrqwe/cordova-plugin-x5engine-webview 在off bye的基础上 什么都没修改

- 目前我用的Cordova版本:npm info Cordova version 输出 6.5.0

#### 17-4-6 zsxsoft的跟offbye的区别 还有Im-Kevin
> 使用Cordova 6.4.0版本create新App的bug

- zsxsoft的解决方法

```
解决bug的代码:
他在X5WebViewEngine.java 加上
    if (Build.VERSION.SDK_INT > Build.VERSION_CODES.JELLY_BEAN_MR2)
      nativeToJsMessageQueue.addBridgeMode(new NativeToJsMessageQueue.EvalBridgeMode(this, cordova));
    bridge = new CordovaBridge(pluginManager, nativeToJsMessageQueue);
    exposeJsInterface(webView, bridge);
  }


  @Override
  public void evaluateJavascript(String js, android.webkit.ValueCallback<String> callback) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
      webView.evaluateJavascript(js, (com.tencent.smtt.sdk.ValueCallback<String>) callback);
    } else {
      Log.d(TAG, "This webview is using the old bridge");
    }
  }


```
- Im-Kevin版本的

```
@Override
    public void setPaused(boolean value) {
        if (value) {
            webView.onPause();
            webView.pauseTimers();
        } else {
            webView.onResume();
            webView.resumeTimers();
        }
    }
@Override
    public void evaluateJavascript(String js,final ValueCallback<String> callback) {
        if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            webView.evaluateJavascript(js, new com.tencent.smtt.sdk.ValueCallback<String>() {
              @Override
              public void onReceiveValue(String s) {
                if(callback != null)
                {
                  callback.onReceiveValue(s);
                }
              }
            });
        }
        else
        {
            LOG.d(TAG, "This webview is using the old bridge");
        }
    }
```

### 使用
腾讯x5的libs已经被我删除了，以项目module的形式存在。
- 因为x5sdk是需要配置一些东西的。
- 理论支撑x5的版本：tbs_sdk_thirdapp_v3.1.0.1034_43100_sharewithdownload_obfs_20170301_182143.jar