基于腾讯x5的文档阅读器

前言

鹅厂的东西确实是好东西，文档也确实真的烂

x5WebView加载本地文档

x5是腾讯用来替代Andorid系统webview，具备打开本地文档的功能。具体文档请移步：https://x5.tencent.com/tbs/index.html

首先接入x5

具体步骤

打开文档的核心代码

 public void openFile(Activity activity, String path) {
        if (tbsReaderView == null) {
            tbsReaderView = new TbsReaderView(activity, new TbsReaderView.ReaderCallback() {
                @Override
                public void onCallBackAction(Integer integer, Object o, Object o1) {
                }
            });

            addView(tbsReaderView, new LinearLayout.LayoutParams(-1, -1));
        }

        String bsReaderTemp = "/storage/emulated/0/TbsReaderTemp";
        File bsReaderTempFile = new File(bsReaderTemp);
        if (!bsReaderTempFile.exists()) {
            boolean mkdir = bsReaderTempFile.mkdir();
            if (!mkdir) {
                Toast.makeText(getContext(), "发生了错误，请稍后重试", Toast.LENGTH_SHORT).show();
                return;
            }
        }
        //加载文件
        Bundle localBundle = new Bundle();
        localBundle.putString("filePath", path);
        localBundle.putString("tempPath", Environment.getExternalStorageDirectory() + "/" +
                "TbsReaderTemp");

        boolean canOpen = tbsReaderView.preOpen(getFileType(path), false);
        if (canOpen) {
            tbsReaderView.openFile(localBundle);
        } else {
            Toast.makeText(getContext(), "无法打开此文件", Toast.LENGTH_SHORT).show();
        }

    }

注意 SDK提供的TbsReaderView无法在xml中直接使用，如果在xml中实例化会报错，其构造方法要求context必须是Activity

源码如下：

    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 bg(this);
        }
    }

我封装了一个view

上代码

public class DocPreview extends FrameLayout {


    private TbsReaderView tbsReaderView;

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

    public DocPreview(Context context, AttributeSet attrs) {
        this(context, attrs, -1);
    }

    public DocPreview(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);

    }

    public static void init(final Context context) {
        QbSdk.initX5Environment(context, new QbSdk.PreInitCallback() {
            @Override
            public void onCoreInitFinished() {

            }

            @Override
            public void onViewInitFinished(boolean b) {

                Toast.makeText(context, "加载" + b, Toast.LENGTH_SHORT).show();
            }
        });
    }


    public void openFile(Activity activity, String path) {

        if (tbsReaderView == null) {

            tbsReaderView = new TbsReaderView(activity, new TbsReaderView.ReaderCallback() {
                @Override
                public void onCallBackAction(Integer integer, Object o, Object o1) {

                }
            });

            addView(tbsReaderView, new LinearLayout.LayoutParams(-1, -1));
        }

        String bsReaderTemp = "/storage/emulated/0/TbsReaderTemp";
        File bsReaderTempFile = new File(bsReaderTemp);
        if (!bsReaderTempFile.exists()) {
            boolean mkdir = bsReaderTempFile.mkdir();
            if (!mkdir) {
                Toast.makeText(getContext(), "发生了错误，请稍后重试", Toast.LENGTH_SHORT).show();
                return;
            }
        }

        //加载文件
        Bundle localBundle = new Bundle();
        localBundle.putString("filePath", path);
        localBundle.putString("tempPath", Environment.getExternalStorageDirectory() + "/" +
                "TbsReaderTemp");

        boolean canOpen = tbsReaderView.preOpen(getFileType(path), false);

        if (canOpen) {
            tbsReaderView.openFile(localBundle);
        } else {
            Toast.makeText(getContext(), "无法打开此文件", Toast.LENGTH_SHORT).show();
        }
    }


    /***
     * 获取文件类型
     *
     * @param paramString
     * @return
     */
    private String getFileType(String paramString) {
        String str = "";

        if (TextUtils.isEmpty(paramString)) {
            return str;
        }
        int i = paramString.lastIndexOf('.');
        if (i <= -1) {

            return str;
        }
        str = paramString.substring(i + 1);
        return str;
    }


    public void onDestroy() {
        if (tbsReaderView != null) {
            tbsReaderView.onStop();
        }
    }
    
}

在使用前请先调用init 初始化 ,还有注意关闭页面的时候调用onDestroy()
这里有几个坑，使用的时候一定要注意已经申请了读写权限，第一次加载的时候需要下载文档插件也要注意一定要在可以上网的环境，我在集成的时候做测试的时候一遍就通了完全没问题，但是集成到项目里的时候初始化总是失败，后来反复删了几遍有稀里糊涂好了。

我把DocPreview做成了一个module，如果集成过程中出现各种奇怪错误，可以直接下载DocPreview然后依赖。

代码传送门

相关资料

Android应用内展示word、excel、pdf、ppt等文件
superFileView
Android 展示本地或网络pdf文件