# EasyX5WebView

**Repository Path**: jyunlee/EasyX5WebView

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-11-25
- **Last Updated**: 2024-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasyX5WebView
EasyX5WebView是基于腾讯X5浏览器v4.3.0.5的轻量级封装，主要为了易于使用，功能基本上也是够用就行。这里同样站在了前人的肩膀上。
本库很多内容是来自于[WebViewStudy](https://github.com/BzCoder/WebViewStudy)，其中还演示了许多WebView的使用方法，本项目也是以此为基础进行结构优化的改造。

示例工程引用以下两个库来完善图片的展示。
- [EasyGlide](https://github.com/BzCoder/EasyGlide)
- [BigImageViewPager](https://github.com/BzCoder/BigImageViewPager)

## ISSUE
- 2019.7.25 : X5内核SDK v4.3.0加载失败，暂时先切换回v3.6.0版本
- 2020.4.23 : 改为远程依赖，删除jar & so文件，升级X5内核版本至v4.3.0.5

## 关于X5内核加载原理
- 如果手机上未安装微信，手Q或者QQ浏览器。第三方接入X5应用会自己去下载X5内核，并在应用重启后启用
- 如果手机上安装了手Q或者微信或者浏览器。则会去寻找共享的X5内核，而不会自己下载新X5内核
- 如果手Q或者微信没打开过网页，则内核还是不会启用。需要手动点开网页先
- 如果你应用依赖的是手Q的内核，在手Q被卸载掉之后，应用会去寻找其他共享X5内核。走第2步
- 以上过程可以通过Log过滤"tbs"查看

## 演示


|  通用展示页BaseX5WebView                  | 新闻详情页RichWebView                    | 
|:------------------------------:|:---------------------------------:|
|![](art/CommonWebView.gif) | ![](art/RichWebView.gif) |


## 模块
LibEasyWebview封装类中实现了以下两个功能：
- 通用展示页BaseX5WebView。
   - 封装了常用的WebView功能以及设置
   
- 新闻详情页RichWebView，用来展示新闻资讯，封装了大量JS方法。
   - 设置Html内容
   - 设置默认占位图片
   - 图片文字拉伸对齐
   - 设置字体 
   - 图片点击回调JS事件等。

## 使用方法

### Application中初始化X5浏览器

```java

  private void initX5() {
        //搜集本地tbs内核信息并上报服务器，服务器返回结果决定使用哪个内核。
        QbSdk.PreInitCallback cb = new QbSdk.PreInitCallback() {

            @Override
            public void onViewInitFinished(boolean arg0) {
                //x5內核初始化完成的回调，为true表示x5内核加载成功，否则表示x5内核加载失败，会自动切换到系统内核。
                Log.d("app", " onViewInitFinished is " + arg0);
            }

            @Override
            public void onCoreInitFinished() {
            }
        };
        //x5内核初始化接口
        QbSdk.initX5Environment(getApplicationContext(),  cb);
    }
 ```
    
###  通用展示页WebViews
参照[X5WebViewActivity](https://github.com/BzCoder/EasyX5WebView/blob/master/app/src/main/java/me/bzcoder/webview/tencentx5/X5WebViewActivity.java),实现IWebViewActivity接口。

###  新闻详情页RichWebView
参照[RichWebViewActivity](https://github.com/BzCoder/EasyX5WebView/blob/master/app/src/main/java/me/bzcoder/webview/tencentx5/RichWebViewActivity.java),其中核心为以下方法。

```
 private void initData() {
        webView.setShow(getHtmlData("data.txt"));
        //获取所有图片
        webView.getImageList();
        //设置图片点击回调
        webView.setImageClickListener();
        //设置错误图片
        webView.setLoadImgError();
        //设置字体
        webView.setTagFontFamily("p");
        webView.setTagFontFamily("span");
        //设置字体大小
        webView.setFontSize(6);
    }
```
 
## 建议
由于WebView需求繁多，一套JS不能满足所有需求，所以推荐直接Clone到本地使用该库，JS方法可以在[rich_editor](https://github.com/BzCoder/EasyX5WebView/blob/master/LibEasyWebview/src/main/assets/rich_editor.js)中查看，根据实际需求对js进行编辑。Lib中还放入了字体文件font.tff，可以根据实际需求替换或者删除。