Android实现在线预览office文档的示例详解

2025-04-23 17:50

本文主要是介绍Android实现在线预览office文档的示例详解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《Android实现在线预览office文档的示例详解》在移动端展示在线Office文档(如Word、Excel、PPT)是一项常见需求,这篇文章为大家重点介绍了两种方案的实现方法,希望对大家有一定的...

一、项目概述

在移动端展示在线 Office 文档(如 Word、Excel、PPT)是一项常见需求。用户点击链接即可在 App 内预览,无需下载应用或文件到本地。实现该功能主要有两种思路:

WebView + 在线文档服务:利用微软 Office Online 或 Google Docs Viewer,将文档 URL 嵌入预览页面;

第三方 SDK(如腾讯 TBS/wpS):集成浏览器内核或文档 www.chinasem.cnSDK,支持在本地加载远程文档并渲染显示。

本文重点介绍两种方案的实现方法,并给出完整例子。

二、相关技术知识

1.WebView 加载在线预览

Office Online URL 模板:

https://view.officeapps.live.com/op/view.ASPx?src=<URL_ENCODED_DOC_URL>

Google Docs Viewer:

https://docs.google.com/gview?embedded=true&url=<URL_ENCODED_DOC_URL>

WebView 配置:开启 javascript、支持缩放、调整缓存策略等。

2.腾讯 TBS SDK(X5 内核)

TBS 提供的 TbsReaderView 可加载 doc/docx/xls/ppt/pdf 等格式。

需在 App 初始化时预加载内核,并在布局中添加 TbsReaderView。

3.文件访问与权限

在线预览不需读写权限;

若下载到本地后用 SDK 打开,则需申请存储权限(android 6.0+ 运行时权限)。

4.性能与兼容

WebView 方案依赖外部网络和服务;

SDK 方案包体较大但支持离线,可自定义 UI。

三、实现思路

3.1 方案一:WebView + Office Online

在布局中放置一个 WebView。

在 Activity 中取得文档远程 URL,进行 URL 编码后拼接到 Office Online 查看地址。

配置 WebView:启用 JavaScript、DOM 存储、缩放控制。

调用 webView.loadUrl(previewUrl) 即可在线预览。

3.2 方案二:TBS SDK 离线预览

在项目 build.gradle 中引入 TBS SDK 依赖。

在 Application 启动时初始化 X5:调用 QBSDk.initX5Environment(...)。

在布局中添加 TbsReaderView。

在 Activity 中下载或缓存文档到本地,然后调用 tbsView.openFile(bundle, null) 加载预览。

记得在 onDestroy() 中销毁 TbsReaderView。

四、整合代码

4.1 Java 代码(MainActivity.java)

package com.example.officedocpreview;
 
import android.Manifest;
import android.content.pm.PackageManager;
import android.net.Uri;
import android.os.*;
import android.view.View;
import android.webkit.*;
import android.widget.*;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import com.tencent.smtt.sdk.TbsReaderView;
 
import java.io.File;
impjsort java.io.FileOutputStream;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
 
public class MainActivity extends AppCompatActivity {
 
    private static final int REQ_STORAGE = 1001;
    private WebView webView;
    private TbsReaderView tbsView;
    private FrameLayout container;
    private String remoteDocUrl = "https://example.com/test.docx";
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
 
        webView    = findViewById(R.id.web_view);
        tbsView    = findViewById(R.id.tbs_view);
        container  = findVChina编程iewById(R.id.tbs_container);
 
        findViewById(R.id.btn_web_preview).setOnClickListener(v -> previewWithWeb());
        findViewById(R.id.btn_tbs_preview).setOnClickListener(v -> previewWithTbs());
    }
 
    /** 方案一:WebView + Office Online */
    private void previewWithWeb() {
        webView.setVisibility(View.VISIBLE);
        container.setVisibility(View.GONE);
 
        WebSettings ws = webView.getSettings();
        ws.setJavaScriptEnabled(true);
        ws.setBuiltInZoomControls(true);
        ws.setDisplayZoomControls(false);
        ws.setDomStorageEnabled(true);
 
        String urlEncoded = Uri.encode(remoteDocUrl);
        String previewUrl = "https://view.officeapps.live.com/op/view.aspx?src=" + urlEncoded;
        webView.loadUrl(previewUrl);
    }
 
    /** 方案二:TBS SDK 预览,需要存储权限 */
    private void previewWithTbs() {
        webView.setVisibility(View.GONE);
        container.setVisibility(View.VISIBLE);
        if (ContextCompat.checkSelfPermission(this,
            Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQ_STORAGE);
        } else {
            downloadAndOpenWithTbs(remoteDocUrl);
        }
    }
 
    @Override
    public void onRequestPermissionsResult(int req,
        @NonNull String[] perms, @NonNull int[] grantResults) {
        if (req == REQ_STORAGE && grantResults.length>0
            && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            downloadAndOpenWithTbs(remoteDocUrl);
        } else {
            Toast.makeText(this, "存储权限被拒绝", Toast.LENGTH_SHORT).show();
        }
    }
 
    /** 下载到本地后用 TbsReaderView 打开 */
    private void downloadAndOpenWithTbs(String urlStr) {
        new Thread(() -> {
            try {
                URL url = new URL(urlStr);
                HttpURLConnection conn =
                    (HttpURLConnection) url.openConnection();
                conn.connect();
                InputStream is = conn.getInputStream();
                File file = new File(getExternalFilesDir(null), "temp.docx");
                FileOutputStream fos = new FileOutputStream(file);
                byte[] buf = new byte[4096];
                int len;
                while ((len = is.read(buf))>0) fos.write(buf,0,len);
                fos.close();
                isphp.close();
 
                runOnUiThread(() -> openFileInTbs(file.getAbsolutePath()));
            } catch (Exception e) {
                e.printStackTrace();
                runOnUiThread(() ->
                    Toast.makeText(this, "下载失败", Toast.LENGTH_SHORT).show());
            }
        }).start();
    }
 
    private void openFileInTbs(String filePath) {
        Bundle params = new Bundle();
        params.putString(TbsReaderView.KEY_FILE_PATH, filePath);
        params.putString(TbsReaderView.KEY_TEMP_PATH,
            getExternalFilesDir(null).getPath());
        boolean ok = tbsView.preOpen(getFileType(filePath), false);
        if (ok) {
            tbsView.openFile(params);
        } else {
            Toast.makeText(this, "TBS 内核未加载或不支持", Toast.LENGTH_SHORT).show();
        }
    }
 
    private String getFileType(String path) {
        if (path == null || !path.contains(".")) return "";
        return path.substring(path.lastIndexOf('.') + 1);
    }
 
   编程China编程 @Override
    protected void onDestroy() {
        super.onDestroy();
        tbsView.onStop();
    }
}

4.2 XML 布局与 Manifest

<!-- AndroidManifest.xml —— 声明 INTERNET 与读写权限,并注册 TbsReaderView 权限 -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.officedocpreview">
  <uses-permission android:name="android.permission.INTERNET"/>
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
  <application
      android:allowBackup="true"
      android:label="OfficePreview"
      android:icon="@mipmap/ic_launcher"
      android:theme="@style/Theme.AppCompat.Light.NoActionBar">
    <activity android:name=".MainActivity">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>
  </application>
</manifest>

​​​​​​​<!-- activity_main.xml —— 同时包含 WebView 与 TbsReaderView -->
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
 
  <!-- WebView 方式预览 -->
  <WebView
      android:id="@+id/web_view"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:visibility="gone"/>
 
  <!-- TBS SDK 方式预览 -->
  <FrameLayout
      android:id="@+id/tbs_container"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:visibility="gone">
    <com.tencent.smtt.sdk.TbsReaderView
        android:id="@+id/tbs_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
  </FrameLayout>
 
  <!-- 底部按钮 -->
  <LinearLayout
      android:layout_gravity="bottom|center_horizontal"
      android:orientation="horizontal"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:padding="16dp">
    <Button
        android:id="@+id/btn_web_preview"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Web 预览"/>
    <Button
        android:id="@+id/btn_tbs_preview"
        android:layout_marginStart="16dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="TBS 预览"/>
  </LinearLayout>
</FrameLayout>

五、代码解读

1.WebView 方案

将文档 URL 进行 URL 编码后拼接到 Office Online 查看地址;

在 WebView 中启用 JavaScript、缩放支持及 DOM 存储;

直接 loadUrl() 即可,无需额外下载。

2.TBS SDK 方案

需提前在 Application 或任意时机调用 QbSdk.initX5Environment()(省略);

下载文档到 App 私有存储后,通过 TbsReaderView.preOpen() 检测内核支持;

调用 openFile() 加载本地文档,支持 doc、xls、ppt、pdf 等多种格式;

在 onDestroy() 中调用 tbsView.onStop() 释放资源。

3.权限与生命周期

运行时申请写存储权限后才能保存到本地;

在 onPause()/onDestroy() 清理动画和 TBS 资源,避免内存泄漏。

六、项目总结

WebView + Office Online:实现简单、无需集成第三方 SDK,依赖外部服务;

TBS SDK:支持离线预览和更多格式,但包体较大、需初始化内核;

本文示例将两种方案合二为一,按需选择并切换。

七、实践建议与未来展望

UI 优化:增加加载进度条、错误页面提示;

缓存策略:对已下载文件做缓存,下次直接读取;

更多格式:结合 open-source 渲染库(如 Apache POI + PDF 转换)实现更多定制;

Compose 时代:在 Jetpack Compose 中也可直接使用 AndroidView 嵌入 WebView 或 TBS。

到此这篇关于Android实现在线预览office文档的示例详解的文章就介绍到这了,更多相关Android在线预览office内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持China编程(www.chinasem.cn)!

这篇关于Android实现在线预览office文档的示例详解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1154342

相关文章

HTML5 搜索框Search Box详解

《HTML5搜索框SearchBox详解》HTML5的搜索框是一个强大的工具,能够有效提升用户体验,通过结合自动补全功能和适当的样式,可以创建出既美观又实用的搜索界面,这篇文章给大家介绍HTML5... html5 搜索框(Search Box)详解搜索框是一个用于输入查询内容的控件,通常用于网站或应用程

Python实现精准提取 PDF中的文本,表格与图片

《Python实现精准提取PDF中的文本,表格与图片》在实际的系统开发中,处理PDF文件不仅限于读取整页文本,还有提取文档中的表格数据,图片或特定区域的内容,下面我们来看看如何使用Python实... 目录安装 python 库提取 PDF 文本内容:获取整页文本与指定区域内容获取页面上的所有文本内容获取

基于Python实现一个Windows Tree命令工具

《基于Python实现一个WindowsTree命令工具》今天想要在Windows平台的CMD命令终端窗口中使用像Linux下的tree命令,打印一下目录结构层级树,然而还真有tree命令,但是发现... 目录引言实现代码使用说明可用选项示例用法功能特点添加到环境变量方法一:创建批处理文件并添加到PATH1

Java使用HttpClient实现图片下载与本地保存功能

《Java使用HttpClient实现图片下载与本地保存功能》在当今数字化时代,网络资源的获取与处理已成为软件开发中的常见需求,其中,图片作为网络上最常见的资源之一,其下载与保存功能在许多应用场景中都... 目录引言一、Apache HttpClient简介二、技术栈与环境准备三、实现图片下载与保存功能1.

Python中使用uv创建环境及原理举例详解

《Python中使用uv创建环境及原理举例详解》uv是Astral团队开发的高性能Python工具,整合包管理、虚拟环境、Python版本控制等功能,:本文主要介绍Python中使用uv创建环境及... 目录一、uv工具简介核心特点:二、安装uv1. 通过pip安装2. 通过脚本安装验证安装:配置镜像源(可

C++ 函数 strftime 和时间格式示例详解

《C++函数strftime和时间格式示例详解》strftime是C/C++标准库中用于格式化日期和时间的函数,定义在ctime头文件中,它将tm结构体中的时间信息转换为指定格式的字符串,是处理... 目录C++ 函数 strftipythonme 详解一、函数原型二、功能描述三、格式字符串说明四、返回值五

LiteFlow轻量级工作流引擎使用示例详解

《LiteFlow轻量级工作流引擎使用示例详解》:本文主要介绍LiteFlow是一个灵活、简洁且轻量的工作流引擎,适合用于中小型项目和微服务架构中的流程编排,本文给大家介绍LiteFlow轻量级工... 目录1. LiteFlow 主要特点2. 工作流定义方式3. LiteFlow 流程示例4. LiteF

canal实现mysql数据同步的详细过程

《canal实现mysql数据同步的详细过程》:本文主要介绍canal实现mysql数据同步的详细过程,本文通过实例图文相结合给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的... 目录1、canal下载2、mysql同步用户创建和授权3、canal admin安装和启动4、canal

CSS3中的字体及相关属性详解

《CSS3中的字体及相关属性详解》:本文主要介绍了CSS3中的字体及相关属性,详细内容请阅读本文,希望能对你有所帮助... 字体网页字体的三个来源:用户机器上安装的字体,放心使用。保存在第三方网站上的字体,例如Typekit和Google,可以link标签链接到你的页面上。保存在你自己Web服务器上的字

Nexus安装和启动的实现教程

《Nexus安装和启动的实现教程》:本文主要介绍Nexus安装和启动的实现教程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、Nexus下载二、Nexus安装和启动三、关闭Nexus总结一、Nexus下载官方下载链接:DownloadWindows系统根