当前位置：首页 > news >正文

Android 中实现 PDF 预览三种方式

news 2025/7/2 2:58:44

1. 使用第三方库 PdfRenderer（适用于 Android 5.0 及以上）

PdfRenderer 是 Android 系统自带的一个用于渲染 PDF 文件的 API，它允许你将 PDF 页面渲染到 Bitmap 上，然后在 ImageView 中显示。

步骤：

添加权限：在 AndroidManifest.xml 中添加读取外部存储的权限（如果 PDF 文件存放在外部存储）。

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

布局文件：创建一个简单的布局文件 activity_main.xml，包含一个 ImageView 用于显示 PDF 页面。

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="match_parent"><ImageViewandroid:id="@+id/pdfImageView"android:layout_width="match_parent"android:layout_height="match_parent" />
</RelativeLayout>

Java 代码实现：在 MainActivity.java 中实现 PDF 预览功能。

import android.content.res.AssetManager;
import android.graphics.Bitmap;
import android.graphics.pdf.PdfRenderer;
import android.os.Bundle;
import android.os.ParcelFileDescriptor;
import android.widget.ImageView;
import androidx.appcompat.app.AppCompatActivity;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;public class MainActivity extends AppCompatActivity {private ImageView pdfImageView;private PdfRenderer pdfRenderer;private PdfRenderer.Page currentPage;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);pdfImageView = findViewById(R.id.pdfImageView);try {openPdfFromAssets();} catch (IOException e) {e.printStackTrace();}}private void openPdfFromAssets() throws IOException {// 从 assets 文件夹中复制 PDF 文件到应用的缓存目录AssetManager assetManager = getAssets();InputStream inputStream = assetManager.open("example.pdf");File outputFile = new File(getCacheDir(), "example.pdf");FileOutputStream outputStream = new FileOutputStream(outputFile);byte[] buffer = new byte[1024];int length;while ((length = inputStream.read(buffer)) > 0) {outputStream.write(buffer, 0, length);}inputStream.close();outputStream.close();// 打开 PDF 文件ParcelFileDescriptor fileDescriptor = ParcelFileDescriptor.open(outputFile, ParcelFileDescriptor.MODE_READ_ONLY);pdfRenderer = new PdfRenderer(fileDescriptor);// 显示第一页showPage(0);}private void showPage(int index) {if (currentPage != null) {currentPage.close();}currentPage = pdfRenderer.openPage(index);Bitmap bitmap = Bitmap.createBitmap(currentPage.getWidth(), currentPage.getHeight(), Bitmap.Config.ARGB_8888);currentPage.render(bitmap, null, null, PdfRenderer.Page.RENDER_MODE_FOR_DISPLAY);pdfImageView.setImageBitmap(bitmap);}@Overrideprotected void onDestroy() {super.onDestroy();if (currentPage != null) {currentPage.close();}if (pdfRenderer != null) {pdfRenderer.close();}}
}

2. 使用第三方库 MuPDF

MuPDF 是一个轻量级的 PDF 查看器库，支持多种文档格式，并且提供了丰富的功能。

步骤：

添加依赖：在 build.gradle 文件中添加 MuPDF 库的依赖。

implementation 'com.artifex.mupdf:mupdf-android:1.19.0'

布局文件：创建一个简单的布局文件 activity_main.xml，包含一个 MuPDFReaderView 用于显示 PDF 文件。

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="match_parent"><com.artifex.mupdf.fitz.android.AndroidMuPDFReaderViewandroid:id="@+id/pdfReaderView"android:layout_width="match_parent"android:layout_height="match_parent" />
</RelativeLayout>

Java 代码实现：在 MainActivity.java 中实现 PDF 预览功能。

import android.os.Bundle;
import android.os.Environment;
import androidx.appcompat.app.AppCompatActivity;
import com.artifex.mupdf.fitz.Document;
import com.artifex.mupdf.fitz.MuPDFCore;
import com.artifex.mupdf.fitz.android.AndroidMuPDFReaderView;
import java.io.File;public class MainActivity extends AppCompatActivity {private AndroidMuPDFReaderView pdfReaderView;private MuPDFCore muPDFCore;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);pdfReaderView = findViewById(R.id.pdfReaderView);try {// 打开 PDF 文件File pdfFile = new File(Environment.getExternalStorageDirectory(), "example.pdf");muPDFCore = new MuPDFCore(this, pdfFile.getAbsolutePath());// 设置 PDF 阅读器的核心pdfReaderView.setCore(muPDFCore);} catch (Exception e) {e.printStackTrace();}}@Overrideprotected void onDestroy() {super.onDestroy();if (muPDFCore != null) {muPDFCore.destroy();}}
}

3. 使用第三方库 PdfiumAndroid

PdfiumAndroid 是一个基于 Pdfium 库的 Android 封装，用于在 Android 应用中渲染 PDF 文件。

步骤：

添加依赖：在 build.gradle 文件中添加 PdfiumAndroid 库的依赖。

implementation 'com.github.barteksc:android-pdf-viewer:3.2.0-beta.1'

布局文件：创建一个简单的布局文件 activity_main.xml，包含一个 PDFView 用于显示 PDF 文件。

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="match_parent"><com.github.barteksc.pdfviewer.PDFViewandroid:id="@+id/pdfView"android:layout_width="match_parent"android:layout_height="match_parent" />
</RelativeLayout>

Java 代码实现：在 MainActivity.java 中实现 PDF 预览功能。

import android.os.Bundle;
import android.os.Environment;
import androidx.appcompat.app.AppCompatActivity;
import com.github.barteksc.pdfviewer.PDFView;
import java.io.File;public class MainActivity extends AppCompatActivity {private PDFView pdfView;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);pdfView = findViewById(R.id.pdfView);// 打开 PDF 文件File pdfFile = new File(Environment.getExternalStorageDirectory(), "example.pdf");pdfView.fromFile(pdfFile).defaultPage(0).enableSwipe(true).swipeHorizontal(false).load();}
}