Android预览Office文档

在安卓上预览Office文档如doc，pdf等，我想大部分做安卓开发的小伙伴都会遇到这样的需求，ios有支持在线打开的系统能力，只需要一个链接就可以，而安卓想要实现在线打开，可就非常困难了！

Android实现在线打开PDF

安卓系统本身不提供文档在线打开能力，想要实现，那就需要自己想办法，自己技术团队实现，或者用网上已有的方案比如pdfjs，pdfjs是mozilla实现的一套在线打开pdf的web项目方案，启动项目后只需要在url后面拼上你的pdf链接，即可实现在线打开，pc端打开后大概是这个样子：
在这里插入图片描述

pdfjs可以作为一个功能模块，嵌入到后端原有的项目中，pdfjs的项目结构：

在这里插入图片描述
使用时，只需要在浏览器中加载链接：http://xxx/pdf/web/viewer?filepath=http://xxx.pdf

pdfjs：

优点：部署简单，使用简单！
缺点：
在移动端使用webview加载效率一般，很可能出现加载缓慢的情况；
只能加载pdf文档，不支持其他格式文档的加载；

基于以上的两个缺点，我在实际项目中使用时，也经常被产品吐槽，要求优化，但这并不是一个人就能解决的问题！因项目中确实有在手机端查看各种文档的需求，所以只能更换其他方案实现了！

腾讯TBS

腾讯的tbs服务确实为广大移动端开发者提供了很多便利，比如更强大更统一的webview加载体验，以及各种文档打开能力！

tbs文档地址：https://x5.tencent.com/tbs/product/file.html

这里需要指明的是，tbs并不支持在线打开功能，也就是说你引入的tbs的sdk只能打开本地文档，那么在具体使用时，就只能先把你要打开的文档下载到本地后，方能使用tbs文档能力在手机端打开（安卓端的一些第三方工具如pdfview等一样是需要先下载后打开），可能你会觉得麻烦，但这应该是目前手机端文档打开能力最好的解决方案了，除非你的业务只需要打开pdf文档，并且可以接收pdfjs的缺点，那就可以使用pdfjs在线打开能力！

本篇博客，我将我的项目中的解决方案分享给大家，望对大家有所帮助！

TBS+AgentWeb+pdfjs+系统能力

AgentWeb：一个第三方的工具库https://github.com/Justson/AgentWeb，实现了对原生webview的封装，对一些常用的功能进行简化，并提供文件选择，和下载能力！

TBS中包含的TbsReaderView既为文档能力的关键类！

三者结合使用，使用AgentWeb的下载能力，当发现url是一个文件下载链接时，自动下载文件，并给予前端进度显示，下载成功后自动调用TbsReaderView加载文档，加载成功则已，加载失败时，如果是pdf文档，则调用pdfjs在线打开，如果是其它文档，则调用系统软件打开！

项目结构：

在这里插入图片描述

效果如下，首次启动：

在这里插入图片描述

因tbs初始化需要下载tbs内核，所以为了你的应用能顺利上传应用市场，尽量在用户同意协议后再进行tbs的初始化工作：

public class App extends Application {
    
    

    private static App INSTANCE;

    public static App getContext() {
    
    
        return INSTANCE;
    }

    @Override
    public void onCreate() {
    
    
        super.onCreate();
        INSTANCE = this;
        if (SysUtils.isAppMainProcess()) {
    
    
            initTBS();
        }
    }

    private void initTBS() {
    
    
        if (!SPUtils.getBooleanDefaultFalse("agreement")) return;//未同意隐私协议前不进行初始化
        TBSUtil.init();
    }

}

当然你会问，首次启动难道不加载tbs了？当然不是！这里正好一起说tbs一个比较坑的地方，就是如果你仅靠tbs提供的文档进行初始化，那大概率会出现首次加载tbs内核失败的情况，这样我们就需要主动去下载并加载内核，并且为了保证内核能下载成功，我再MainActivity中再一次执行了tbs的初始化：

public class MainActivity extends AppCompatActivity {
    
    

    ActivityMainBinding vb;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
    
    
        super.onCreate(savedInstanceState);
        vb = ActivityMainBinding.inflate(LayoutInflater.from(this));
        setContentView(vb.getRoot());
        TBSUtil.init();
        vb.btnOpen.setOnClickListener(view -> {
    
    
            if (TextUtils.isEmpty(vb.etContent.getText().toString())) return;
            if (!QbSdk.isTbsCoreInited()) {
    
    
                Toast.makeText(this, "TBS内核未加载成功，请稍后...", Toast.LENGTH_LONG).show();
                return;
            }
            Intent intent = new Intent(this, OfficeWebActivity.class);
            intent.putExtra(OfficeWebActivity.PARAM_URL, vb.etContent.getText().toString());
            startActivity(intent);
        });
    }
}

既首次安装时，application中不执行初始化，而同意协议进入MainActivity后才进行初始化，等下次再打开时，application的初始化操作就会起作用了，同时还要在tbs加载回调中判断，如果加载未成功，则主动去下载tbs内核并加载！

因为本项目中功能简单，启动程序后直接就可以点击打开文档按钮了，但此时tbs内核还并未加载成功，可以通过QbSdk.isTbsCoreInited()来判断，只有TBS内核加载成功后才能使用TbsReaderView！

我将内核下载并加载的日志打印了出来：

在这里插入图片描述

全程大概有20S左右的时间，所以这期间无法使用tbs文档打开功能，但考虑到正常的使用场景下，用户进入app不可能会立马去找到某个文档打开查看，这期间可能要经历登录注册，寻找文档的过程，一般的，这个时间是足够完成tbs内核下载的了，如果真有特殊情况，那就给个等待提示吧！

加载pdf文档效果：

在这里插入图片描述

当然，加载其他tbs支持的文档效果一致，都是先下载后加载！

一旦首次加载成功，既文档已下载到本地，那么再此进入就会直接打开：

在这里插入图片描述

当然，还有tbs不支持的文档文件处理方法，这里测试了一个apk的文件链接：

在这里插入图片描述

项目下载地址：

csdn：https://download.csdn.net/download/baiyuliang2013/85040292

注意：目前tbs的文档预览能力被腾讯作为一个单独的收费模块运营（收割）了，那么如果想继续用这个功能，要么付费，要么集成离线内核（可以百度搜索以前老版本的内核），大概有40多M，这么一来，为了使用pdf预览功能，app要多出40多M，所以这个还需要自己考量。另一个办法是使用开源Android pdfViewer，最后一个办法就是后端集成pdfjs，在线预览。