【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-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

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

2. 代码

2.1 在 Application 初始化 x5 内核接口

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

            @Override
            public void onCoreInitFinished() {
    
    
            }
        };
        QbSdk.setTbsListener(new TbsListener() {
    
    
            @Override
            public void onDownloadFinish(int i) {
    
    
                Log.i("kevin", "onDownloadFinish: " + i);
            }

            @Override
            public void onInstallFinish(int i) {
    
    
                Log.i("kevin", "onInstallFinish: " + i);
            }

            @Override
            public void onDownloadProgress(int i) {
    
    
                Log.i("kevin", "onInstallFinish: " + i);
            }
        });

        QbSdk.initX5Environment(getApplicationContext(), callback);

2.2 初始化 WebSettings

private void initWebSettings() {
    
    
    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
 */
public class ProgressWebView extends WebView {
    
    
    //进度条
    private ProgressBar progressbar;

    //进度条的高度，默认10px
    private int progressHeight = 10;

    public ProgressWebView(Context context) {
    
    
        this(context,null);
    }

    public ProgressWebView(Context context, AttributeSet attributeSet) {
    
    
        super(context, attributeSet);
        initView(context);
    }

    private void initView(Context context) {
    
    
        //创建进度条
        progressbar = new ProgressBar(context, null,
                android.R.attr.progressBarStyleHorizontal);
        //设置加载进度条的高度
        progressbar.setLayoutParams(new AbsoluteLayout.LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT, progressHeight, 0, 0));

        Drawable drawable = context.getResources().getDrawable(R.drawable.progress_bar_states);
        progressbar.setProgressDrawable(drawable);

        //添加进度到WebView
        addView(progressbar);

        //初始化 WebSettings
        initWebSettings();


        setWebChromeClient(new WVChromeClient());
        setWebViewClient(new WVClient());
    }

    private void initWebSettings() {
    
    
        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);
    }



    //进度显示
    private class WVChromeClient extends WebChromeClient {
    
    


        @Override
        public void onProgressChanged(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);
        }

    }

    private class WVClient extends WebViewClient {
    
    

        @Override
        public boolean shouldOverrideUrlLoading(WebView view, String url) {
    
    

            //在当前Activity打开
            view.loadUrl(url);
            return true;
        }

        @Override
        public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
    
    
            //https忽略证书问题
            handler.proceed();
        }

        @Override
        public void onPageFinished(WebView view, String url) {
    
    

            progressbar.setVisibility(GONE);
            if (mListener != null) {
    
    
                mListener.onPageFinish(view);
            }

            super.onPageFinished(view, url);

        }

    }

    private onWebViewListener mListener;

    public void setOnWebViewListener(onWebViewListener listener) {
    
    
        this.mListener = listener;
    }

    //进度回调接口
    public interface onWebViewListener {
    
    
        void onProgressChange(WebView view, int newProgress);

        void onPageFinish(WebView view);
    }
}