如何接入TBS浏览器WebView？——Android开发教程详解

Android接入TBS浏览器WebView教程

一、简介

在Android开发中，WebView组件是一个常用的工具，用于加载和显示网页内容，系统自带的WebView存在各种问题和限制，如性能不稳定、兼容性差等，为了解决这些问题，腾讯推出了TBS（Tencent Browser Service）浏览器服务，它提供了一个更高效、更稳定的WebView控件，本文将详细介绍如何在Android项目中接入和使用TBS浏览器的WebView。

二、准备工作

环境要求

手机ROM版本：高于或等于2.2版本

手机RAM：大于500M

如果不满足上述条件，SDK会自动切换到系统WebView。

下载并导入SDK

从[腾讯浏览服务官网](https://x5.tencent.com/tbs/sdk.html)下载最新的SDK包。

Android Studio用户：

在module的build.gradle文件中添加以下依赖：

api 'com.tencent.tbs.tbssdk:sdk:43903'

Eclipse用户：

手动下载SDK并添加到项目中。

导入so文件

将下载的SDK中的jniLibs文件夹复制到项目的根目录中，与java和res文件夹同级。

配置权限

在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内核

在Application类中初始化X5内核：

import com.tencent.smtt.sdk.QbSdk;
import com.tencent.smtt.sdk.QbSdk.PreInitCallback;
import android.app.Application;
public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化X5内核
        QbSdk.initX5Environment(getApplicationContext(), new PreInitCallback() {
            @Override
            public void onCoreInitFinished() {
                // X5内核初始化完成的回调
            }
            @Override
            public void onViewInitFinished(boolean b) {
                // X5内核加载成功的回调
                Log.e("MyApplication", "X5内核加载成功：" + b);
            }
        });
    }
}

四、使用TBS WebView

布局文件

在布局文件中使用全路径指定TBS的WebView：

<com.tencent.smtt.sdk.WebView
    android:id="@+id/webview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

Activity代码

在Activity中使用WebView：

import android.os.Bundle;
import android.webkit.ValueCallback;
import android.webkit.WebChromeClient;
import android.webkit.WebSettings;
import android.webkit.WebView;
import android.webkit.WebViewClient;
import androidx.appcompat.app.AppCompatActivity;
import com.tencent.smtt.sdk.WebView;
public class MainActivity extends AppCompatActivity {
    private WebView mWebView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mWebView = findViewById(R.id.webview);
        // 启用JavaScript
        WebSettings settings = mWebView.getSettings();
        settings.setJavaScriptEnabled(true);
        mWebView.loadUrl("https://www.example.com");
        // 设置WebViewClient
        mWebView.setWebViewClient(new WebViewClient());
        // 设置WebChromeClient以处理文件选择和视频播放等操作
        mWebView.setWebChromeClient(new WebChromeClient() {
            public void openFileChooser(ValueCallback<Uri> uploadMsg, ValueCallback<Uri[]> uploadMsgs) {
                // 处理文件选择逻辑
            }
        });
    }
}

五、高级功能与注意事项

全屏播放视频

为了实现全屏播放视频，需要在Activity中声明配置变化：

android:configChanges="orientation|screenSize|keyboardHidden"

并在Activity的onCreate方法中设置透明格式：

getWindow().setFormat(PixelFormat.TRANSLUCENT);

还需要禁止某些接口的调用：

webview.setLayerType(View.LAYER_TYPE_SOFTWARE, null);
webview.setDrawingCacheEnabled(true);

自定义User-Agent

可以通过设置WebSettings来实现自定义User-Agent：

settings.setUserAgentString(settings.getUserAgentString() + " MyAppUA");

文件选择器

TBS提供了文件选择器功能，通过重写openFileChooser方法来实现：

mWebView.setWebChromeClient(new WebChromeClient() {
    public void openFileChooser(ValueCallback<Uri> uploadMsg) {
        Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
        intent.setType("image/*");
        startActivityForResult(intent, REQUEST_CODE_FILE_CHOOSER);
    }
});

在onActivityResult中处理文件选择结果：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_CODE_FILE_CHOOSER && resultCode == RESULT_OK) {
        Uri result = data.getData();
        mUploadMessage.onReceiveValue(result);
        mUploadMessage = null;
    } else {
        Toast.makeText(this, "File not selected", Toast.LENGTH_SHOR).show();
    }
}

六、相关问题与解答

Q1: TBS WebView与传统WebView有什么区别？

A1: TBS WebView使用了腾讯自主研发的X5内核，相比传统WebView，具有速度快、省流量、更安全、更稳定、兼容性好等优点，TBS WebView还支持更多的HTML5和ES6特性，并集成了强大的视频播放器，支持多种视频格式。

Q2: 如何判断当前使用的是X5内核还是系统内核？

A2: 可以通过长按网页文字，如果出现水滴状的选择效果，说明使用的是X5内核；如果选择效果是系统原生的，则使用的是系统内核，还可以通过日志输出来判断内核加载是否成功。

以上内容就是解答有关“android接入tbs浏览器webview教程”的详细内容了，我相信这篇文章可以为您解决一些疑惑，有任何问题欢迎留言反馈，谢谢阅读。