基于腾讯浏览服务 TBS 实现应用内打开并浏览 Office 文件

众所周知，Android App 在国内环境下实现应用内打开本地或位于远程服务器上 word、excel、pdf 等 Office 文档的功能远远没有 iOS 系统方便得多。以前也写过一篇文章，罗列出现有解决方案间的优劣对比。直到最近，在网上又发现一种新的解决方案：腾讯浏览服务（简称：TBS）。

TBS 简单介绍

---

正如官网所言，依托 X5 内核强大的能力，TBS 致力于提供优化移动端浏览体验的整套解决方案。TBS 虽然核心在于提供一套 SDK 解决传统 WebView 的诸多使用问题。可是，利用其加强浏览能力，咱们还可以使用这套 SDK 实现应用内的文件浏览功能、视频播放功能等。更多详细功能，能够参考官网介绍：

x5.tencent.com/tbs/product…

然而，美中不足的是，在浏览文件方面，官方没有提供完善的使用文档和 Demo 案例。通过一番折腾，和借鉴这篇文章 ，总算可以实现应用内打开 Office 文档的功能，因而整理于此。

本地文件浏览

---

注意：TBS 只能打开浏览本地文件，对于位于服务器的远程文件，没法实如今线预览，只能经过先下载再打开的方式进行浏览。这里咱们先来看看如何使用 TBS 打开本地文件。

首先仍是添加 SDK 依赖。下载 TBS 提供的 jar 包和 so 文件，添加到工程中对应的 libs 和 jniLibs 目录下。如图：

而后在 app/build.gradle 文件中对 libs 目录中 jar 文件的依赖能够是这样：

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
}复制代码

须要注意的是：TBS 目前只提供 armeabi 类型 CPU 架构的 so 库。固然，也能够将 so 文件放置于 libs 目录下，只不过须要在 app/build.gradle 中额外修改 so 文件依赖配置：

android {
    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }
}复制代码

配置完成以后，再来看看如何使用。这里主要使用的是 TbsReaderView 类。在宿主 Activity 中实现 ReaderCallback 接口，并经过 Java 代码动态建立 TbsReaderView 对象，将其添加到 content view 当中。好比：

mTbsReaderView = new TbsReaderView(this, this);
RelativeLayout rootRl = (RelativeLayout) findViewById(R.id.rl_root);
rootRl.addView(mTbsReaderView, new RelativeLayout.LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT))复制代码

ReaderCallback 接口提供的方法能够不予处理（目前不知道有什么用途，可是必定要实现这个接口类）：

@Override
public void onCallBackAction(Integer integer, Object o, Object o1) {

}复制代码

可能你会有疑惑，为何不将 TbsReaderView 放在 layout 布局文件中，而是在代码中手动 add 进去。经测试，这么作会报错，提示找不到这个类。而后咱们查看 TbsReaderView 源码，发现只有这么一个构造函数：

public TbsReaderView(Context var1, TbsReaderView.ReaderCallback var2) {
  super(var1.getApplicationContext());
  if(!(var1 instanceof Activity)) {
    throw new RuntimeException("error: unexpect context(none Activity)");
  } else {
    this.d = var2;
    this.a = var1;
    this.e = new au(this);
  }
}复制代码

而没有提供含 AttributeSet 类型参数的构造函数，也就是说，这个版本的 TBS 只容许咱们经过 new 的方式建立 TbsReaderView 实例并使用。

说完这个，再接着看如何打开本地文件。代码也很简单：

private void displayFile() {
  Bundle bundle = new Bundle();
  bundle.putString("filePath", getLocalFile().getPath());
  bundle.putString("tempPath", Environment.getExternalStorageDirectory().getPath());
  boolean result = mTbsReaderView.preOpen(parseFormat(mFileName), false);
  if (result) {
    mTbsReaderView.openFile(bundle);
  }
}复制代码

能够看到，经过 Bundle 类型参数的形式向 TbsReaderView 对象传递文件地址和另外一个临时目录地址。这两个数据，缺一不可。

这里可能你们又有疑问，没有文档介绍，咱们是如何知道 Bundle 参数传递哪些数据的呢？仍是查看 TbsReaderView 源码，在该类中存在这两个成员变量：

public static final String KEY_FILE_PATH = "filePath";
public static final String KEY_TEMP_PATH = "tempPath";复制代码

第一个参数很好理解，第二个参数不知道什么意思，根据名字须要的应该是一个临时目录地址，反正传上就对了。这里顺便教你们两个技巧，之后阅读 Jar 包源码时也许可以用得上：

1，如何搜索 jar 包中的指定类文件？

使用 jar -tf 命令可以列出 jar 包中的内容，若是再配上 grep 命令便能搜索指定类文件，如：

yifeng:desktop yifeng $ jar -tf tbs_sdk_thirdapp.jar | grep -i TbsReaderView
com/tencent/smtt/sdk/TbsReaderView$ReaderCallback.class
com/tencent/smtt/sdk/TbsReaderView.class复制代码

2，如何搜索 jar 包中的指定字符串？

使用 zipgrep 命令，若是搜索的关键字包含空格，则须要使用引号：

yifeng:desktop yifeng $ zipgrep filePath tbs_sdk_thirdapp.jar
com/tencent/smtt/sdk/TbsReaderView.class:Binary file (standard input) matches复制代码

回到 TBS 使用上，最后别忘了在 onDestroy() 生命周期函数中添加：

@Override
protected void onDestroy() {
  super.onDestroy();
  mTbsReaderView.onStop();
}复制代码

至此，使用 TBS 实现应用内打开预览本地 Office 文件的所有过程结束，咱们来看一下效果图：

能够看到，第一次使用须要下载腾讯提供的 pdf 浏览插件，以后打开时则无需再次加载。

更多时候，咱们预览的文件都位于远程服务器上。因此，咱们须要预先下载文件，下载完成以后再使用 TBS 打开本地文件。感兴趣的话，不妨继续来看。

远程文件下载

---

Android App 下载文件的方式有不少，这里咱们使用一种最简单的方式来作，利用系统提供的 DownloadManager 类来实现下载功能，并监听下载进度。

先来看看如何利用 DownloadManager 下载文件。根据使用场景，这里我屏蔽默认的通知栏提示消息，并设置本地存放位置，相关代码以下：

mDownloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
DownloadManager.Request request = new DownloadManager.Request(Uri.parse(mFileUrl));
request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, mFileName);
request.allowScanningByMediaScanner();
request.setNotificationVisibility(Request.VISIBILITY_HIDDEN);
mRequestId = mDownloadManager.enqueue(request);复制代码

而后是监听下载进度，使用的是 ContentObserver 类。自定义一个继承自 ContentObserver 的监听类：

private class DownloadObserver extends ContentObserver {

  private DownloadObserver(Handler handler) {
    super(handler);
  }

  @Override
  public void onChange(boolean selfChange, Uri uri) {
    queryDownloadStatus();
  }
}复制代码

在 onChange() 回调方法中实时查询下载进度。当查询到下载完成时，使用 TBS 打开下载到本地对应目录的文件：

private void queryDownloadStatus() {
    DownloadManager.Query query = new DownloadManager.Query().setFilterById(mRequestId);
    Cursor cursor = null;
    try {
      cursor = mDownloadManager.query(query);
      if (cursor != null && cursor.moveToFirst()) {
        //已经下载的字节数
        int currentBytes = cursor.getInt(cursor.getColumnIndexOrThrow(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR));
        //总需下载的字节数
        int totalBytes = cursor.getInt(cursor.getColumnIndexOrThrow(DownloadManager.COLUMN_TOTAL_SIZE_BYTES));
        //状态所在的列索引
        int status = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS));
        Log.i("downloadUpdate: ", currentBytes + " " + totalBytes + " " + status);
        mDownloadBtn.setText("正在下载：" + currentBytes + "/" + totalBytes);
        if (DownloadManager.STATUS_SUCCESSFUL == status && mDownloadBtn.getVisibility() == View.VISIBLE) {
          mDownloadBtn.setVisibility(View.GONE);
          mDownloadBtn.performClick();
        }
      }
    } finally {
      if (cursor != null) {
        cursor.close();
      }
    }
  }复制代码

作好这些准备后，在下载文件的时候注册监听：

mDownloadObserver = new DownloadObserver(new Handler());
getContentResolver().registerContentObserver(Uri.parse("content://downloads/my_downloads"), true, mDownloadObserver);复制代码

并在 onDestroy() 方法中取消监听：

@Override
protected void onDestroy() {
  super.onDestroy();
  if (mDownloadObserver != null) {
    getContentResolver().unregisterContentObserver(mDownloadObserver);
  }
}复制代码

最后，别忘记在 Manifest 清单文件中添加相应使用权限（权限含义，就再也不一一介绍）：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.DOWNLOAD_WITHOUT_NOTIFICATION"/>
<uses-permission android:name="android.permission.ACCESS_DOWNLOAD_MANAGER"/>
<uses-permission android:name="android.permission.WRITE_SETTINGS"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>复制代码

整体来看，TBS 提供的文件浏览功能仍是很强大的。据官网介绍，目前可以支持 42 种不一样格式的文件。除此以外，TBS 还有一些其余的用途也很是值得尝试。只是，期待官方可以提供更多的使用文档介绍，帮助咱们更方便地使用起来。

备注：

本文相关代码已上传至 GitHub 网站，有须要的朋友能够访问地址：

github.com/Mike-bel/Tb…

关于我：亦枫，博客地址：yifeng.studio/，新浪微博：IT亦枫

微信扫描二维码，欢迎关注个人我的公众号：安卓笔记侠

不只分享个人原创技术文章，还有程序员的职场遐想