【Android -- 开源库】腾讯 TBS 浏览器 SDK 接入

简介

在 Android 开发项目中，经常会用到 Webview 。而 WebView 是出了名的坑，各种 Bug。腾讯 TBS 浏览服务面向应用开发商和广大开发者，提供浏览增强，内容框架，广告体系，H5游戏分发，大数据等服务，能够帮助应用开发商大幅改善应用体验，有效提升开发，运营，商业化的效率。

官网地址: https://x5.tencent.com

1. 优势

• 速度快：相比系统webview的网页打开速度有30+%的提升；
• 省流量：使用云端优化技术使流量节省20+%；
• 更安全：安全问题可以在24小时内修复；
• 更稳定：经过亿级用户的使用考验，CRASH率低于0.15%；
• 兼容好：无系统内核的碎片化问题，更少的兼容性问题；
• 体验优：支持夜间模式、适屏排版、字体设置等浏览增强功能；
• 功能全：在Html5、ES6上有更完整支持；
• 更强大：集成强大的视频播放器，支持视频格式远多于系统webview；
• 视频和文件格式的支持x5内核多于系统内核
• 防劫持是x5内核的一大亮点

其中，X5云端服务包括云加速、云安全、云转换三大功能。云加速是通过首屏加速、智能路由、图片压缩等技术保障网页浏览的快、省、悦；云安全是通过代理加密、URL安全检测、JS黑名单管理、负载监控等防范网页被劫持插入广告、保障网页浏览的安全稳定；云转换是使用URL聚合+XPATH的解决方案，解决移动阅读难题。

2. 运行环境

• Android 版本： Android 4.0 ~ Android 12.0
• CPU 架构：armeabi、armeabi-v7a、arm64-v8a

使用

1. 基础配置

1.1 SDK 接入

方式一：jar包方式集成（推荐）

您可将官网下载的jar包复制到您的App的libs目录，并且通过Add As Library的方式集成TBS SDK。

前往官网下载SDK

方式二：自动集成
使用 mavenCentral 仓库

在项目级别（通常是根目录下）的 build.gradle 中添加：

repositories {google()// 增加这行mavenCentral()}

在应用级别（通常是 app 模块下）的 build.gradle 中添加依赖：

dependencies {...// 增加这行
    implementation 'com.tencent.tbs:tbssdk:44286'}

1.2 权限配置

在

AndroidManifest.xml

里权限声明

<uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/><uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE"/><uses-permissionandroid:name="android.permission.ACCESS_WIFI_STATE"/><uses-permissionandroid:name="android.permission.INTERNET"/><uses-permissionandroid:name="android.permission.READ_PHONE_STATE"/><!-- 硬件加速对X5视频播放非常重要，建议开启 --><uses-permissionandroid:name="android.permission.GET_TASKS"/>

2. 代码

2.1 在 Application 初始化 x5 内核接口

/**
         * 搜集本地tbs内核信息并上报服务器，服务器返回结果决定使用哪个内核。
         */QbSdk.PreInitCallback callback =newQbSdk.PreInitCallback(){@OverridepublicvoidonViewInitFinished(boolean arg){//x5內核初始化完成的回调，// true表示x5内核加载成功，// false表示x5内核加载失败，会自动切换到系统内核。Log.i("kevin","X5内核是否成功加载= "+ arg);}@OverridepublicvoidonCoreInitFinished(){}};QbSdk.setTbsListener(newTbsListener(){@OverridepublicvoidonDownloadFinish(int i){Log.i("kevin","onDownloadFinish: "+ i);}@OverridepublicvoidonInstallFinish(int i){Log.i("kevin","onInstallFinish: "+ i);}@OverridepublicvoidonDownloadProgress(int i){Log.i("kevin","onInstallFinish: "+ i);}});QbSdk.initX5Environment(getApplicationContext(), callback);

2.2 初始化 WebSettings

privatevoidinitWebSettings(){WebSettings webSetting =this.getSettings();
    webSetting.setJavaScriptEnabled(true);
    webSetting.setJavaScriptCanOpenWindowsAutomatically(true);
    webSetting.setAllowFileAccess(true);
    webSetting.setLayoutAlgorithm(LayoutAlgorithm.NARROW_COLUMNS);
    webSetting.setSupportZoom(true);
    webSetting.setBuiltInZoomControls(true);
    webSetting.setUseWideViewPort(true);
    webSetting.setSupportMultipleWindows(true);
    webSetting.setAppCacheEnabled(true);
    webSetting.setDomStorageEnabled(true);
    webSetting.setGeolocationEnabled(true);
    webSetting.setAppCacheMaxSize(Long.MAX_VALUE);
    webSetting.setPluginState(WebSettings.PluginState.ON_DEMAND);
    webSetting.setCacheMode(WebSettings.LOAD_NO_CACHE);}

2.3 简单封装

如果在项目中使用，一般来说最好是封装多一层。

• 防止和原生的WebView搞混
• 有什么问题，一改全改。
• 可以添加一些功能，例如进度条等。

/**
 * author: Kevin_Gong
 * date: 2023/6/1
 * desc: 封装一个带进图条的 WebView
 */publicclassProgressWebViewextendsWebView{//进度条privateProgressBar progressbar;//进度条的高度，默认10pxprivateint progressHeight =10;publicProgressWebView(Context context){this(context,null);}publicProgressWebView(Context context,AttributeSet attributeSet){super(context, attributeSet);initView(context);}privatevoidinitView(Context context){//创建进度条
        progressbar =newProgressBar(context,null,android.R.attr.progressBarStyleHorizontal);//设置加载进度条的高度
        progressbar.setLayoutParams(newAbsoluteLayout.LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT, progressHeight,0,0));Drawable drawable = context.getResources().getDrawable(R.drawable.progress_bar_states);
        progressbar.setProgressDrawable(drawable);//添加进度到WebViewaddView(progressbar);//初始化 WebSettingsinitWebSettings();setWebChromeClient(newWVChromeClient());setWebViewClient(newWVClient());}privatevoidinitWebSettings(){WebSettings webSetting =this.getSettings();
        webSetting.setJavaScriptEnabled(true);
        webSetting.setJavaScriptCanOpenWindowsAutomatically(true);
        webSetting.setAllowFileAccess(true);
        webSetting.setLayoutAlgorithm(WebSettings.LayoutAlgorithm.NARROW_COLUMNS);
        webSetting.setSupportZoom(true);
        webSetting.setBuiltInZoomControls(true);
        webSetting.setUseWideViewPort(true);
        webSetting.setSupportMultipleWindows(true);
        webSetting.setAppCacheEnabled(true);
        webSetting.setDomStorageEnabled(true);
        webSetting.setGeolocationEnabled(true);
        webSetting.setAppCacheMaxSize(Long.MAX_VALUE);
        webSetting.setPluginState(WebSettings.PluginState.ON_DEMAND);
        webSetting.setCacheMode(WebSettings.LOAD_NO_CACHE);}//进度显示privateclassWVChromeClientextendsWebChromeClient{@OverridepublicvoidonProgressChanged(WebView view,int newProgress){if(newProgress ==100){
                progressbar.setVisibility(GONE);}else{if(progressbar.getVisibility()== GONE){
                    progressbar.setVisibility(VISIBLE);}
                progressbar.setProgress(newProgress);}if(mListener !=null){
                mListener.onProgressChange(view, newProgress);}super.onProgressChanged(view, newProgress);}}privateclassWVClientextendsWebViewClient{@OverridepublicbooleanshouldOverrideUrlLoading(WebView view,String url){//在当前Activity打开
            view.loadUrl(url);returntrue;}@OverridepublicvoidonReceivedSslError(WebView view,SslErrorHandler handler,SslError error){//https忽略证书问题
            handler.proceed();}@OverridepublicvoidonPageFinished(WebView view,String url){

            progressbar.setVisibility(GONE);if(mListener !=null){
                mListener.onPageFinish(view);}super.onPageFinished(view, url);}}private onWebViewListener mListener;publicvoidsetOnWebViewListener(onWebViewListener listener){this.mListener = listener;}//进度回调接口publicinterface onWebViewListener {voidonProgressChange(WebView view,int newProgress);voidonPageFinish(WebView view);}}