Android集成腾讯X5实现文档浏览功能

150 阅读 0 评论 99 点赞

我是靠谱客的博主积极发带，最近开发中收集的这篇文章主要介绍Android集成腾讯X5实现文档浏览功能，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

Android内部没有控件来直接显示文档，跳转WPS或其他第三方文档App体验性不好，使用腾讯X5内核能很好的解决的这一问题。

一、下载腾讯X5内核

1.前往https://x5.tencent.com/下载Android的内核，新版本的腾讯X5可以直接在bulid.gradle集成 api 'com.tencent.tbs.tbssdk:sdk:43697'，如果是在App里集成可以把api换成implementation

2.AndroidStudio导入腾讯X5

a.把下载好的jar包导入libs，然后run as，再把jnilibs导入main包下

b. module的build.gradle添加cpu适配

3.Application中腾讯X5初始化,在onCreate()方法调用init方法

QbSdk.initX5Environment(this, new QbSdk.PreInitCallback() {
   @Override
   public void onCoreInitFinished() {
 
   }
 
   @Override
   public void onViewInitFinished(boolean b) {
    Log.e("xxx","hasLoad"+b); 
   //此处将内核加载是否成功的状态保存到本地，SharePreference工具类可换为自己的
    SharedPreferenceUtils.saveBoolean(getApplicationContext(),"hasLoad",b);
   }
  });

4.应用内调用，无论是否加载内核，都是把在线的文档下载到本地然后打开，不同的是，未加载内核会借助QQ浏览器或其他App的文件浏览功能类似微信（这个调用，腾讯X5已自动处理，我们无需关心），而加载内核后，使用X5的TbsReaderView来打开文件，接下来就是具体代码。

a.bulid.gradle中集成Retrofit，RxJava和进度管理器ProgressManager

 implementation 'io.reactivex:rxandroid:1.2.1'
 implementation 'com.squareup.retrofit2:converter-gson:2.3.0'
 implementation 'com.squareup.retrofit2:adapter-rxjava:2.1.0'
 implementation 'com.squareup.retrofit2:retrofit:2.3.0'
 implementation 'io.reactivex:rxjava:1.2.6'
 implementation 'me.jessyan:progressmanager:1.5.0'

写网络下载工具

public interface LoadFileApi {
 @GET
 Call<ResponseBody> loadPdfFile(@Url String fileUrl);
}
public class LoadFileModel {
 //使用该方法来下载文件
 public static void loadPdfFile(String url, Callback<ResponseBody> callback) {
  Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://www.baidu.com/")
    .client(ProgressManager.getInstance().with(new OkHttpClient.Builder())
      .build())
    .addConverterFactory(GsonConverterFactory.create())
    .build();
  LoadFileApi mLoadFileApi = retrofit.create(LoadFileApi.class);
  if (!TextUtils.isEmpty(url)) {
   Call<ResponseBody> call = mLoadFileApi.loadPdfFile(url);
   call.enqueue(callback);
  }
 }
}

b.具体调用

首先注册文件进度下载监听

private ProgressDialog commonProgressDialog;//切换为自己的进度控件
 private ProgressInfo mLastDownloadingInfo;
 ProgressManager.getInstance().addResponseListener(url, new ProgressListener() {
            @Override
            public void onProgress(ProgressInfo progressInfo) {
             if (mLastDownloadingInfo == null) {
              mLastDownloadingInfo = progressInfo;
             }
             //因为是以请求开始时的时间作为 Id ,所以值越大,说明该请求越新
             if (progressInfo.getId() < mLastDownloadingInfo.getId()) {
              return;
             } else if (progressInfo.getId() > mLastDownloadingInfo.getId()) {
              mLastDownloadingInfo = progressInfo;
             }
             int progress = mLastDownloadingInfo.getPercent();
             commonProgressDialog.setProgress(progress);
             Log.d("xxx", "--Download-- " + progress + " % " + mLastDownloadingInfo.getSpeed() + " byte/s " + mLastDownloadingInfo.toString());
             if (mLastDownloadingInfo.isFinish()) {
              //说明已经下载完成
              commonProgressDialog.dismiss();
              Log.d("xxx", "--Download-- finish");
             }
            }
            @Override
            public void onError(long id, Exception e) {
             e.printStackTrace();
             new Handler().post(new Runnable() {
              @Override
              public void run() {
                commonProgressDialog.dismiss();
              }
             });
            }
           });
          }

然后打开文件

private static final String DOWN_DIR = Environment.getExternalStorageDirectory()
   + File.separator+"Download"; //文件下载的路径，可以自定义
//打开文件
 private void openFile(String filePath,String fileName) {
  boolean hasLoad = SharedPreferenceUtils.getBoolean(mContext, "hasLoad");//是否记载内核
  if (hasLoad){
  //展示文件的Activity
   Intent intentDoc = new Intent(this,FileDisplayActivity.class);
   intentDoc.putExtra("path",filePath);
   intentDoc.putExtra("fileName",fileName);
   startActivity(intentDoc);
  }else {
   if(!Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)){
    Toast.makeText(this,"当前SD不可用",Toast.LENGTH_LONG).show();
    return;
   }
   try {
    File file = new File(DOWN_DIR, fileName);
    if (file.exists()){
     QbSdk.openFileReader(this, file.getAbsolutePath(), null, new ValueCallback<String>() {
      @Override
      public void onReceiveValue(String s) {
       Log.e("xxx",s);
      }
     });
    } else {
     downLoadFile(filePath,fileName);
    }
   } catch (Exception e) {
    e.printStackTrace();
    ToastUtils.showShortToast(mContext, "已下载过了");
   }
  }
 }
 private void downLoadFile(final String url, final String fileName) {
  commonProgressDialog.show();
  LoadFileModel.loadPdfFile(url, new Callback<ResponseBody>() {
   @Override
   public void onResponse(@NonNull Call<ResponseBody> call, @NonNull Response<ResponseBody> response) {
    InputStream is = null;
    byte[] buf = new byte[2048];
    int len;
    FileOutputStream fos = null;
    try {
     ResponseBody responseBody = response.body();
     if (responseBody != null) {
      is = responseBody.byteStream();
      final File file = new File(DOWN_DIR, fileName);
      fos = new FileOutputStream(file);
      while ((len = is.read(buf)) != -1) {
       fos.write(buf, 0, len);
      }
      fos.flush();
      //未加载内核调用方法
      QbSdk.openFileReader(mContext, file.getAbsolutePath(), null, new ValueCallback<String>() {
       @Override
       public void onReceiveValue(String s) {
        Log.e("xxx",s);
       }
      });
      ToastUtils.showLongToast(MeetingDetailActivity.this, "下载成功,保存在Download文件夹下");
     }
    } catch (Exception e) {
     commonProgressDialog.dismiss();
     ProgressManager.getInstance().notifyOnErorr(url,e);
     ToastUtils.showLongToast(MeetingDetailActivity.this, "下载失败");
    } finally {
     try {
      if (is != null)
       is.close();
     } catch (IOException e) {
      e.printStackTrace();
     }
     try {
      if (fos != null)
       fos.close();
     } catch (IOException e) {
      e.printStackTrace();
     }
    }
   }
   @Override
   public void onFailure(@NonNull Call<ResponseBody> call, @NonNull Throwable t) {
    t.printStackTrace();
    ToastUtils.showShortToast(MeetingDetailActivity.this, "下载失败");
    commonProgressDialog.dismiss();
   }
  });
 }

FileDisplayActivity代码,对于一些包名可以切换为自己的包名，还有一些第三方库像进度展示，也可以切换为自己的进度控件

import android.content.Intent;
import android.os.Bundle;
import android.os.Environment;
import android.os.Handler;
import android.os.Message;
import android.support.annotation.NonNull;
import android.support.annotation.Nullable;
import android.support.v7.app.AppCompatActivity;
import android.text.TextUtils;
import android.util.Log;
import android.view.View;
import android.view.WindowManager;
import android.widget.TextView;
import com.anshi.oatencentschool.R;
import com.anshi.oatencentschool.utils.DialogBuild;
import com.anshi.oatencentschool.utils.StatusBarUtils;
import com.anshi.oatencentschool.utils.ToastUtils;
import com.anshi.oatencentschool.utils.WeakHandler;
import com.anshi.oatencentschool.utils.filetool.LoadFileModel;
import com.anshi.oatencentschool.utils.filetool.SuperFileView2;
import com.kaopiz.kprogresshud.KProgressHUD;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import me.jessyan.progressmanager.ProgressListener;
import me.jessyan.progressmanager.ProgressManager;
import me.jessyan.progressmanager.body.ProgressInfo;
import okhttp3.ResponseBody;
import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;
public class FileDisplayActivity extends AppCompatActivity {
 private String TAG = "FileDisplayActivity";
 //Tencent 提供的TBS阅读浏览功能，不借助第三方软件打开office和pdf文件
 private SuperFileView2 mSuperFileView;
 private String filePath;
 private TextView mTextView;
 private static final String DOWN_DIR = Environment.getExternalStorageDirectory()
   + File.separator+"Download";
 private String fileName;
 private KProgressHUD commonProgressDialog;
 private WeakHandler weakHandler = new WeakHandler(new Handler.Callback() {
  @Override
  public boolean handleMessage(Message msg) {
   int progress = msg.arg1;
   if (progress==100){
    commonProgressDialog.setProgress(progress);
    commonProgressDialog.dismiss();
   }else {
    commonProgressDialog.setProgress(progress);
   }
   return true;
  }
 });
 @Override
 protected void onCreate(@Nullable Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_file_display);
  getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON|WindowManager.LayoutParams.FLAG_FULLSCREEN);
  commonProgressDialog = DialogBuild.getBuild().createCommonProgressDialog(this, "下载中");
  init();
 }
 /**
  * 初始化
  */
 public void init() {
  mTextView = (TextView) findViewById(R.id.file_album_name);
  fileName = getIntent().getStringExtra("fileName");
  int lastIndexOf = fileName.lastIndexOf(".");
  String substring = fileName.substring(0, lastIndexOf);
  mTextView.setText(substring);
  mSuperFileView = (SuperFileView2) findViewById(R.id.mSuperFileView);
  mSuperFileView.setOnGetFilePathListener(new SuperFileView2.OnGetFilePathListener() {
   @Override
   public void onGetFilePath(SuperFileView2 mSuperFileView2) {
    getFilePathAndShowFile(mSuperFileView);
   }
  });
  Intent intent = this.getIntent();
  String path = (String) intent.getSerializableExtra("path");
  if (!TextUtils.isEmpty(path)) {
   Log.d(TAG, "文件path:" + path);
   setFilePath(path);
  }
  mSuperFileView.show();
  ProgressManager.getInstance().addResponseListener(path, new ProgressListener() {
   @Override
   public void onProgress(ProgressInfo progressInfo) {
    int percent = progressInfo.getPercent();
    Message obtain = Message.obtain();
    obtain.arg1 = percent;
    weakHandler.sendMessage(obtain);
   }
   @Override
   public void onError(long id, Exception e) {
   }
  });
 }
 @Override
 protected void onResume() {
  super.onResume();
  StatusBarUtils.setWindowStatusBarColor(this,R.color.color_main);
 }
 /**
  * 显示文件
  * @param mSuperFileView2 控件
  */
 private void getFilePathAndShowFile(SuperFileView2 mSuperFileView2) {
  if (getFilePath().contains("http")&&!new File(DOWN_DIR, fileName).exists()) {//网络地址要先下载
   downLoadFile(getFilePath(),fileName,mSuperFileView2);
  } else {
   try {
    mSuperFileView2.displayFile(new File(DOWN_DIR, fileName));
   }catch (Exception e){
    e.printStackTrace();
   }
  }
 }
 public void setFilePath(String fileUrl) {
  this.filePath = fileUrl;
 }
 private String getFilePath() {
  return filePath;
 }
 /**
  * 回退上一级菜单
  * @param view 控件
  */
 public void onClick(View view) {
  finish();
 }
 private void downLoadFile(final String url, final String fileName,final SuperFileView2 mSuperFileView2) {
  commonProgressDialog.show();
  LoadFileModel.loadPdfFile(url, new Callback<ResponseBody>() {
   @Override
   public void onResponse(@NonNull Call<ResponseBody> call, @NonNull Response<ResponseBody> response) {
    InputStream is = null;
    byte[] buf = new byte[2048];
    int len;
    FileOutputStream fos = null;
    try {
     ResponseBody responseBody = response.body();
      is = responseBody.byteStream();
     final File file = new File(DOWN_DIR, fileName);
     fos = new FileOutputStream(file);
     while ((len = is.read(buf)) != -1) {
      fos.write(buf, 0, len);
     }
     fos.flush();
     mSuperFileView2.displayFile(file);
     ToastUtils.showLongToast(FileDisplayActivity.this, "下载成功,保存在Download文件夹下");
    } catch (Exception e) {
     commonProgressDialog.dismiss();
     ToastUtils.showLongToast(FileDisplayActivity.this, "下载失败");
    } finally {
     try {
      if (is != null)
       is.close();
     } catch (IOException e) {
      e.printStackTrace();
     }
     try {
      if (fos != null)
       fos.close();
     } catch (IOException e) {
      e.printStackTrace();
     }
    }
   }
   @Override
   public void onFailure(@NonNull Call<ResponseBody> call, @NonNull Throwable t) {
    t.printStackTrace();
    ToastUtils.showShortToast(FileDisplayActivity.this, "下载失败");
    commonProgressDialog.dismiss();
   }
  });
  }
}

布局Layout:

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
 android:id="@+id/activity_file_display"
 android:layout_width="match_parent"
 android:fitsSystemWindows="true"
 android:layout_height="match_parent">
 <android.support.v7.widget.Toolbar
  android:layout_width="match_parent"
  android:layout_height="46dp"
  android:background="@color/color_main"
  android:id="@+id/file_toolbar"
  >
  <TextView
   android:layout_width="wrap_content"
   android:layout_height="match_parent"
   android:id="@+id/file_album_name"
   android:layout_gravity="center"
   android:gravity="center"
   android:maxLines="2"
   android:ellipsize="end"
   android:textSize="14sp"
   android:textColor="#FFF"
   />
 </android.support.v7.widget.Toolbar>
 <FrameLayout
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:layout_below="@id/file_toolbar"
  >
  <com.anshi.oatencentschool.utils.filetool.SuperFileView2
   android:id="@+id/mSuperFileView"
   android:layout_width="match_parent"
   android:layout_height="match_parent"/>
  <RelativeLayout
   android:layout_width="wrap_content"
   android:layout_gravity="center|start"
   android:layout_height="wrap_content">
   <RadioButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:button="@null"
    android:onClick="onClick"
    android:id="@+id/back_icon"
    android:drawableStart="@drawable/svg_left_back_blur"
    android:layout_marginStart="10dp"
    />
  </RelativeLayout>
  <!--<RadioButton-->
   <!--android:layout_width="wrap_content"-->
   <!--android:layout_height="wrap_content"-->
   <!--android:button="@null"-->
   <!--android:visibility="gone"-->
   <!--android:layout_gravity="end|bottom"-->
   <!--android:onClick="saveLocal"-->
   <!--android:layout_marginBottom="10dp"-->
   <!--android:layout_marginEnd="10dp"-->
   <!--android:drawableStart="@drawable/vector_drawable_down_load"-->
   <!--android:layout_marginStart="10dp"-->
   <!--/>-->
 </FrameLayout>
</RelativeLayout>

SuperFileView2代码,这个自定义的类是从https://github.com/ZhongXiaoHong/superFileView导入

import android.content.Context;
import android.os.Bundle;
import android.os.Environment;
import android.text.TextUtils;
import android.util.AttributeSet;
import android.util.Log;
import android.widget.FrameLayout;
import android.widget.LinearLayout;
import com.tencent.smtt.sdk.TbsReaderView;
import java.io.File;
/**
 *
 * Created by 12457 on 2017/8/29.
 */
public class SuperFileView2 extends FrameLayout {
 private static String TAG = "SuperFileView";
 private TbsReaderView mTbsReaderView;
 private Context context;
 public SuperFileView2(Context context) {
  this(context, null, 0);
 }
 public SuperFileView2(Context context, AttributeSet attrs) {
  this(context, attrs, 0);
 }
 public SuperFileView2(Context context, AttributeSet attrs, int defStyleAttr) {
  super(context, attrs, defStyleAttr);
  mTbsReaderView = new TbsReaderView(context, new TbsReaderView.ReaderCallback() {
   @Override
   public void onCallBackAction(Integer integer, Object o, Object o1) {
   }
  });
  this.addView(mTbsReaderView, new LinearLayout.LayoutParams(-1, -1));
  this.context = context;
 }
 private OnGetFilePathListener mOnGetFilePathListener;
 public void setOnGetFilePathListener(OnGetFilePathListener mOnGetFilePathListener) {
  this.mOnGetFilePathListener = mOnGetFilePathListener;
 }
 private TbsReaderView getTbsReaderView(Context context) {
  return new TbsReaderView(context, new TbsReaderView.ReaderCallback() {
   @Override
   public void onCallBackAction(Integer integer, Object o, Object o1) {
   }
  });
 }
 public void displayFile(File mFile) {
  if (mFile != null && !TextUtils.isEmpty(mFile.toString())) {
   //增加下面一句解决没有TbsReaderTemp文件夹存在导致加载文件失败
   String bsReaderTemp = Environment.getExternalStorageDirectory()+ File.separator+"TbsReaderTemp";
   File bsReaderTempFile =new File(bsReaderTemp);
   if (!bsReaderTempFile.exists()) {
    Log.d("xxx","准备创建/storage/emulated/0/TbsReaderTemp！！");
    boolean mkdir = bsReaderTempFile.mkdir();
    if(!mkdir){
     Log.d("xxx","创建/storage/emulated/0/TbsReaderTemp失败！！！！！");
    }
   }
   //加载文件
   Bundle localBundle = new Bundle();
   Log.d("xxx",mFile.toString());
   localBundle.putString("filePath", mFile.toString());
   localBundle.putString("tempPath", bsReaderTemp);
   if (mTbsReaderView == null){
    mTbsReaderView = getTbsReaderView(context.getApplicationContext());
    String fileType = getFileType(mFile.toString());
    boolean bool = mTbsReaderView.preOpen(fileType,false);
    if (bool) {
     try {
      mTbsReaderView.openFile(localBundle);
     }catch (Exception e){
      e.printStackTrace();
     }
    }
   }else {
    String fileType = getFileType(mFile.toString());
    boolean bool = mTbsReaderView.preOpen(fileType,false);
    if (bool) {
     try {
      mTbsReaderView.openFile(localBundle);
     }catch (Exception e){
      e.printStackTrace();
     }
    }
   }
  } else {
   Log.d("xxx","文件路径无效！");
  }
 }
 /***
  * 获取文件类型
  *
  * @param paramString
  * @return
  */
 private String getFileType(String paramString) {
  String str = "";
  if (TextUtils.isEmpty(paramString)) {
   Log.d(TAG, "paramString---->null");
   return str;
  }
  Log.d(TAG, "paramString:" + paramString);
  int i = paramString.lastIndexOf('.');
  if (i <= -1) {
   Log.d(TAG, "i <= -1");
   return str;
  }
  str = paramString.substring(i + 1);
  Log.d(TAG, "paramString.substring(i + 1)------>" + str);
  return str;
 }
 public void show() {
  if(mOnGetFilePathListener!=null){
   mOnGetFilePathListener.onGetFilePath(this);
  }
 }
 /***
  * 将获取File路径的工作，“外包”出去
  */
 public interface OnGetFilePathListener {
  void onGetFilePath(SuperFileView2 mSuperFileView2);
 }
 public void onStopDisplay() {
  if (mTbsReaderView != null) {
   mTbsReaderView.onStop();
  }
 }
}

加载内核后打开文件