Android 中 显示 PDF 文件内容（AndroidPdfViewer 库）

已于 2025-05-16 17:44:54 修改
阅读量245 收藏 3
点赞数 3
分类专栏： 新起点 Android Kotlin 文章标签： android pdf
于 2025-05-16 09:22:03 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/casual_clover/article/details/147986100
版权

PDFView 是一个用于在 Android 应用中显示 PDF 文档的库。它提供了丰富的功能和灵活的配置选项，使得开发者能够轻松地在应用中嵌入 PDF 阅读器。

一、 添加依赖

  • 在模块的 build.gradle 文件中添加以下依赖：
	// pdf
    implementation("com.github.barteksc:android-pdf-viewer:3.2.0-beta.1")

二、添加 阿里云 Maven 仓库

  • 此时编译时会报错，提示无法找到该库：
* What went wrong:
Execution failed for task ':app:mergeDebugNativeLibs'.
> Could not resolve all files for configuration ':app:debugRuntimeClasspath'.
   > Could not find com.github.barteksc:android-pdf-viewer:3.2.0-beta.1.
     Searched in the following locations:
       - https://dl.google.com/dl/android/maven2/com/github/barteksc/android-pdf-viewer/3.2.0-beta.1/android-pdf-viewer-3.2.0-beta.1.pom
       - https://repo.maven.apache.org/maven2/com/github/barteksc/android-pdf-viewer/3.2.0-beta.1/android-pdf-viewer-3.2.0-beta.1.pom
     Required by:
         project :app
  • 在项目的 settings.gradle.kts 文件中增加 阿里云 Maven 仓库 支持。
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()

        // 阿里云 Maven 仓库
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        maven { url = uri("https://maven.aliyun.com/repository/central") }
    }
}

三、解决库冲突问题

  • 下载 android-pdf-viewer 依赖库后，编译提示 “com.android.support” 库冲突：
* What went wrong:
Execution failed for task ':app:checkDebugDuplicateClasses'.
> A failure occurred while executing com.android.build.gradle.internal.tasks.CheckDuplicatesRunnable
   > Duplicate class android.support.v4.app.AppLaunchChecker found in modules support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0) and support-core-utils-26.1.0.aar -> support-core-utils-26.1.0-runtime (com.android.support:support-core-utils:26.1.0)
     Duplicate class android.support.v4.app.FrameMetricsAggregator found in modules support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0) and support-core-utils-26.1.0.aar -> support-core-utils-26.1.0-runtime (com.android.support:support-core-utils:26.1.0)
     Duplicate class android.support.v4.app.FrameMetricsAggregator$FrameMetricsApi24Impl found in modules support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0) and support-core-utils-26.1.0.aar -> support-core-utils-26.1.0-runtime (com.android.support:support-core-utils:26.1.0)
     Duplicate class android.support.v4.app.FrameMetricsAggregator$FrameMetricsApi24Impl$1 found in modules support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0) and support-core-utils-26.1.0.aar -> support-core-utils-26.1.0-runtime (com.android.support:support-core-utils:26.1.0)
     Duplicate class android.support.v4.app.FrameMetricsAggregator$FrameMetricsBaseImpl found in modules support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0) and support-core-utils-26.1.0.aar -> support-core-utils-26.1.0-runtime (com.android.support:support-core-utils:26.1.0)
     Duplicate class android.support.v4.app.FrameMetricsAggregator$MetricType found in modules support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0) and support-core-utils-26.1.0.aar -> support-core-utils-26.1.0-runtime (com.android.support:support-core-utils:26.1.0)
     Duplicate class android.support.v4.app.INotificationSideChannel found in modules core-1.13.1.aar -> core-1.13.1-runtime (androidx.core:core:1.13.1) and support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0)
     Duplicate class android.support.v4.app.INotificationSideChannel$Stub found in modules core-1.13.1.aar -> core-1.13.1-runtime (androidx.core:core:1.13.1) and support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0)
     Duplicate class android.support.v4.app.INotificationSideChannel$Stub$Proxy found in modules core-1.13.1.aar -> core-1.13.1-runtime (androidx.core:core:1.13.1) and support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0)
     Duplicate class android.support.v4.app.NavUtils found in modules support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0) and support-core-utils-26.1.0.aar -> support-core-utils-26.1.0-runtime (com.android.support:support-core-utils:26.1.0)
     Duplicate class android.support.v4.app.TaskStackBuilder found in modules support-compat-28.0.0.aar -> support-compat-28.0.0-runtime (com.android.support:support-compat:28.0.0) and support-core-utils-26.1.0.aar -> support-core-utils-26.1.0-runtime (com.android.support:support-core-utils:26.1.0)
     ......
     Duplicate class androidx.versionedparcelable.VersionedParcelParcel found in modules versionedparcelable-1.1.1.aar -> versionedparcelable-1.1.1-runtime (androidx.versionedparcelable:versionedparcelable:1.1.1) and versionedparcelable-28.0.0.aar -> versionedparcelable-28.0.0-runtime (com.android.support:versionedparcelable:28.0.0)
     Duplicate class androidx.versionedparcelable.VersionedParcelStream found in modules versionedparcelable-1.1.1.aar -> versionedparcelable-1.1.1-runtime (androidx.versionedparcelable:versionedparcelable:1.1.1) and versionedparcelable-28.0.0.aar -> versionedparcelable-28.0.0-runtime (com.android.support:versionedparcelable:28.0.0)
     Duplicate class androidx.versionedparcelable.VersionedParcelStream$FieldBuffer found in modules versionedparcelable-1.1.1.aar -> versionedparcelable-1.1.1-runtime (androidx.versionedparcelable:versionedparcelable:1.1.1) and versionedparcelable-28.0.0.aar -> versionedparcelable-28.0.0-runtime (com.android.support:versionedparcelable:28.0.0)
     Duplicate class androidx.versionedparcelable.VersionedParcelable found in modules versionedparcelable-1.1.1.aar -> versionedparcelable-1.1.1-runtime (androidx.versionedparcelable:versionedparcelable:1.1.1) and versionedparcelable-28.0.0.aar -> versionedparcelable-28.0.0-runtime (com.android.support:versionedparcelable:28.0.0)
     Duplicate class androidx.versionedparcelable.VersionedParcelize found in modules versionedparcelable-1.1.1.aar -> versionedparcelable-1.1.1-runtime (androidx.versionedparcelable:versionedparcelable:1.1.1) and versionedparcelable-28.0.0.aar -> versionedparcelable-28.0.0-runtime (com.android.support:versionedparcelable:28.0.0)

错误分析

  • 这个错误是由于新增的依赖库中包含了Android Support Library 的依赖，跟项目中使用的 AndroidX 发生了类冲突。从 Android 9.0（API 级别 28）开始，Android Support Library 已被废弃，Google 推荐使用 AndroidX 来替代。

解决方法

  • 在项目的 gradle.properties 文件中增加自动迁移配置，此时重新编译，即可编译通过：
	android.useAndroidX=true
	android.enableJetifier=true
  • android.useAndroidX=true：启用 AndroidX。
  • android.enableJetifier=true：启用 Jetifier 工具，自动迁移项目中的第三方库依赖。

四、配置文件权限

1、确保应用有权限读取 PDF 文件，在 AndroidManifest.xml 中添加以下权限：

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

2、如果文件存储在外部存储中，还需要动态申请权限：

	// 运行时权限
    private val requestPermissionLauncher = registerForActivityResult(
        ActivityResultContracts.RequestPermission()
    ) { isGranted ->
        if (isGranted) {
            // 权限被授予
            Toast.makeText(this, "Permission granted", Toast.LENGTH_SHORT).show()
        } else {
            // 权限被拒绝
            Toast.makeText(this, "Permission denied", Toast.LENGTH_SHORT).show()
        }
    }
    
    /**
     * 动态申请权限
     */
    private fun requestPermission1() {
        requestPermissionLauncher.launch(Manifest.permission.READ_EXTERNAL_STORAGE)
    }

3、手动申请 “所有文件访问权限”

  • 从 Android 10（API 级别 29）开始，引入了分区存储（Scoped Storage），限制了应用对外部存储的访问权限。只有 READ_EXTERNAL_STORAGE 权限，无法打开 PDF 文件，还需要申请 MANAGE_EXTERNAL_STORAGE 权限，并且手动引导用户手动开启 “所有文件访问权限”。
	/**
	* 申请 所有文件访问权限
	*/
	private fun requestManagerPermission() {
	   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
	       if (!Environment.isExternalStorageManager()) {
	           val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION)
	           val applicationId = "com.example.helloworld"//BuildConfig.APPLICATION_ID
	           intent.data = "package:$applicationId".toUri()
	           startActivity(intent)
	       }
	   }
	}

五、PDFView 常用方法

  • fromFile(File file)：从文件路径加载 PDF 文件。
	val filePath = "$filesDir/example.pdf"
	pdfView.fromFile(new File(filePath ))
	      .load();
  • fromAsset(String assetName)：从 assets 目录（res/main/assets/example.pdf）加载 PDF 文件。
	pdfView.fromAsset("example.pdf")
      .load();

  • fromUri(Uri uri)：从 URI 加载 PDF 文件。

  • defaultPage(int page)：设置默认显示的页面。

  • enableSwipe(boolean swipe)：启用或禁用滑动翻页。

  • enableDoubletap(boolean doubletap)：启用或禁用双击放大。

  • zoom(float scale)：设置 PDFView 的初始缩放比例。

  • rotate(int degrees)：设置 PDFView 的初始旋转角度。

  • onPageChange(OnPageChangeListener listener)：设置页面改变时的监听器。

  • onError(OnErrorListener listener)：设置错误监听器。

  • enableAnnotationRendering(boolean enabled)：启用注释渲染。

  • setOffscreenPageLimit(int limit)：设置预加载页数，避免 OOM 问题。

6、代码示例

android 在线解析pdf文件格式,Android 实现应用内在线查看 PDF 文件
weixin_34319902的博客
05-26 545
8种机械键盘轴体对比本人程序员，要买一个写代码的键盘，请问红轴和茶轴怎么选？最近有个需求，在 App 内查看使用第三方签名的电子协议，电子协议为 PDF 文件。上网查了一下，要实现 App 内在线查看 PDF，主要思路都是先把 PDF 文件下载下来，再通过 GitHub 第三方的库，打开 PDF 文件。参考文章常用的第三库：PdfViewPagerhttps://github.com/voghD...
android 展示pdf,Android中显示在线PDF
weixin_28721917的博客
05-27 884
Android中显示PDFiOS的WebView能从线上url直接显示pdf,而Android的WebView不能直接显示,Android的WebView要显示pdf需要拼接url到google的一个url显示,国内需要…所以这条路肯定走不通了urlWebView.loadUrl("http://docs.google.com/gview?embedded=true&url="+ "YOU...
android pdf显示不全,Android 显示 PDF 文件
weixin_39948442的博客
05-27 704
package zyj.com.myapplication;import android.graphics.Canvas;import android.os.Bundle;import android.support.v7.app.AppCompatActivity;import android.widget.Toast;import com.joanzapata.pdfview.PDFView;...
Android 上显示 PDF 文件
佛系编码
03-28 573
使用 WebView 配合 pdf.js 在 Android 上显示 PDF 文件
AndroidPdfViewer：一款功能强大的Android PDF查看器库
最新发布
gitblog_01051的博客
01-14 368
AndroidPdfViewer：一款功能强大的Android PDF查看器库 AndroidPdfViewerV2 Android view for displaying PDFs rendered with PdfiumAndroid ...
android pdf文件预览
xia09222826的专栏
05-23 903
首先需要项目里面有pdf文件，或者手机本地有pdf文件，如果只是测试可以直接引入pdf文件到项目的assets目录下，如果是服务器上的pdf需要先下载到手机本地然后使用文件路径。2）Android 6.0新特性，一些保护权限，除了要在AndroidManifest中声明权限，还需要在activity中使用代码动态获取权限。5.关闭pdf文件读取，一般activity销毁时需要使用。1.引入build.gradle中引入需要的包。如果是服务器文件需要下载，还需声明网络权限。以上就是pdf文件读取的全流程。
Android在线预览pdf文件的几种方式
也简的博客
04-13 1万+
Android在线预览pdf文件的几种方式
android APP内显示PDF文件
u013605159的博客
08-08 1万+
android APP内显示PDF文件最近公司要做一个小功能，显示在APP内部显示pdf文件，刚接到任务感觉非常简单的一小功能，做的时候才发现在真的很不好实现。 因为android的webView与iOS的UIWebView不一样，不能够直接支持在线观看pdf文件，虽然谷歌官方给了个“http//docs.google.com/gviewembedded=true&url=”这样的解决方案，但是需要
Android 打开网络上pdf文件
东子的博客 细节决定成败，点滴铸就辉煌。
12-29 9017
之前写过一篇Android打开本地pdf文件的文章，最后总结的时候说，后面一定要拓展库，让其也能打开网络的的pdf文件。今天终于可以兑现承诺了。frok一份代码https://github.com/JoanZapata/android-pdfview，开始改造一番。1.基本思路： 打来网络pdf 思路整体还是来源与图片的加载。 android中加载网络图片的框架有很多个。如image-laoder，
AndroidPdfViewer.zip_Android PDF Viewer_AndroidPdfViewer_android
09-14
1. PDFium库：PDFium库是Google开源的PDF渲染引擎，它负责读取和解析PDF文件，并将内容渲染到Android的Canvas上。开发者需要集成这个库到项目中，以处理PDF的加载、解码和显示。 2. 页面渲染：Android PdfViewer...
AndroidPdfViewer.rar_Andorid PDF Viewer_AndroidPdfViewer_android
09-14
它使用了开源库如PDFBox或MuPDF来处理PDF文件，这些库能够高效地读取和解析PDF文档的元数据和内容。PDFBox是由Apache软件基金会开发的一个Java库，而MuPDF则是一个轻量级的PDF、XPS和OpenXPS查看器和渲染引擎。 在...
AndroidPdfViewer(new).rar_AndroidPdfViewer_android_android pdf_j
09-22
在源码中，开发者会发现一些关键的类和方法，例如`PdfDocument`代表一个PDF文件，`Page`表示文件中的单个页面，`PdfRenderer`负责渲染页面。此外，`PdfView`是用户界面的主要组件，它管理PDF的显示和用户交互。注释...
Java中String类型与Map类型互转
热门推荐
casual_clover的博客
04-24 11万+
一、mapString与Map之间互转 1、map类型转换成string类型 Map<String, String> map = new HashMap<String, String>(); map.put("key1", "value1"); map.put("key2", "value2"); map.put("key3", "value3"); System.out.println(map.toString()); 执行结果： {key1=value1, key2=value
java.io.IOException:stream closed 异常的原因及处理
casual_clover的博客
09-19 2万+
一、close 顺序异常 FileInputStream inputStream = null; try { inputStream = new FileInputStream("tst.txt"); } catch (FileNotFoundException e) { e.printStackTrace(); } BufferedInputStream bufferedInp...
Java中删除String中空格的多种方法
casual_clover的博客
04-22 1万+
在Java中，要实现删除String中的空格的方法有很多种，具体有： 1、 trim() 删除字符串开头和结尾的空格，Java 1版本引入的接口，这是开发人员最常用的方法。trim移除的空白字符指的是指ASCII值小于或等于32的任何字符(’ U+0020 ')，其中包含了空格、换行、退格等字符。 String value = " Hellow world ! "; System.out.println("before: \'" + value + "\'"); String afterValue = va
Android Studio安装apk失败的几种提示以及解决办法
casual_clover的博客
05-06 5911
一、INSTALL_FAILED_UPDATE_INCOMPATIBLE 原因：之前卸载旧的apk时没卸载彻底。 解决办法：adb uninstall package-name （工程AndroidManifest.xml中package有个属性指定的就是package-name） 二、INSTALL_FAILED_TEST_ONLY 原因：Android Studio 3.0会在debug ap...
Android Studio中配置NDK编译环境（ndk-build方式编译jni）
casual_clover的博客
02-23 5594
Android 项目中使用 jni 有两种编译方案，一种是传统的ndk-build方案，一种是当前推荐使用的 cmake方案，本章主要介绍在Android Studio中采用ndk-build方式编译jni的配置方法，以及在配置过程中遇到的问题及解决方案。 一、 添加jni源码 1、 在工程的app/src/main/目录下新建jni目录，用来存放需要编译的jni的代码； 2、 将jni相关的代码拷贝到jni目录下，需包含Android.mk和Application.mk文件，简单代码如下所示： 1)And
Android之getSharedPreferences与getDefaultSharedPreferences的区别
casual_clover的博客
04-01 5346
SharedPreferences是一个轻量级的存储类，特别适合用于保存软件配置参数。使用SharedPreferences保存数据，其背后是用xml文件存放数据，文件存放在/data/data//shared_prefs目录下。 一、Context的getSharedPreferences方法 public abstract SharedPreferences getSharedPreferen...
在Android Studio中集成AndroidPdfViewer库时，如何解决下载和显示PDF文件过程中遇到的常见错误？
11-09
在Android Studio中集成AndroidPdfViewer库以便在新闻APP中下载和显示PDF文件时，可能会遇到多种错误。为了帮助开发者有效解决这些问题，推荐查看资源《Android Studio集成PDF查看器：AndroidPdfViewer详解与问题解决》。这份资料详细介绍了AndroidPdfViewer库的使用方法和错误解决方案，对解决当前问题非常有帮助。 参考资源链接：[Android Studio集成PDF查看器：AndroidPdfViewer详解与问题解决](https://wenku.csdn.net/doc/42vpj8txbm?spm=1055.2569.3001.10343) 首先，确保在项目的`build.gradle`文件中正确引入了AndroidPdfViewer库及其依赖项。如果遇到找不到插件的错误，如“Plugin with id 'com.github.dcendents.android-maven' not found”，需要在`buildscript`块中添加相应的依赖。此外，还需要确保Gradle版本与AndroidPdfViewer库兼容。 在下载PDF文件的过程中，可能会遇到网络权限问题或文件存储权限问题。在Android 6.0及以上版本，需要在运行时请求用户授权网络和存储权限。同时，为了优化用户体验，可以使用DownloadManager来异步下载文件，并使用AndroidPdfViewer提供的API来渲染和显示PDF。在这个过程中，可以通过监听下载进度和显示进度条来反馈给用户。 在显示PDF文件时，可能会遇到文件未下载完成或路径错误等问题。确保文件下载完成后才能初始化PDF viewer，并检查文件路径是否正确。如果用户尝试打开的PDF文件不存在或损坏，应捕获相应的异常，并向用户显示错误信息。 通过上述步骤，可以解决大部分在集成和使用AndroidPdfViewer时遇到的常见错误。如果需要进一步学习关于AndroidPdfViewer的高级功能和深入问题解决方法，建议详细阅读提供的资源《Android Studio集成PDF查看器：AndroidPdfViewer详解与问题解决》，它将为你提供更全面的知识和技巧，帮助你更有效地在Android应用中实现PDF查看功能。 参考资源链接：[Android Studio集成PDF查看器：AndroidPdfViewer详解与问题解决](https://wenku.csdn.net/doc/42vpj8txbm?spm=1055.2569.3001.10343)
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值