Skip to content

😊基于腾讯X5浏览器v4.3.0.5封装类,包含资讯类APP新闻详情页,通用WebView。封装常用JS交互操作。

License

Notifications You must be signed in to change notification settings

BzCoder/EasyX5WebView

Repository files navigation

EasyX5WebView

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

示例工程引用以下两个库来完善图片的展示。

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

模块

LibEasyWebview封装类中实现了以下两个功能:

  • 通用展示页BaseX5WebView。

    • 封装了常用的WebView功能以及设置
  • 新闻详情页RichWebView,用来展示新闻资讯,封装了大量JS方法。

    • 设置Html内容
    • 设置默认占位图片
    • 图片文字拉伸对齐
    • 设置字体
    • 图片点击回调JS事件等。

使用方法

Application中初始化X5浏览器

  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,实现IWebViewActivity接口。

新闻详情页RichWebView

参照RichWebViewActivity,其中核心为以下方法。

 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中查看,根据实际需求对js进行编辑。Lib中还放入了字体文件font.tff,可以根据实际需求替换或者删除。

About

😊基于腾讯X5浏览器v4.3.0.5封装类,包含资讯类APP新闻详情页,通用WebView。封装常用JS交互操作。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published