pdf

  
用于在应用中添加 PDF 查看功能的库。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2024 年 12 月 11 日 - - - 1.0.0-alpha05

声明依赖项

如需添加 pdf 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
    implementation "androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05"
}

Kotlin

dependencies {
    implementation("androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

此工件没有版本说明。

版本 1.0

版本 1.0.0-alpha05

2024 年 12 月 11 日

发布了 androidx.pdf:pdf-document-service:1.0.0-alpha05、androidx.pdf:pdf-viewer:1.0.0-alpha05 和 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05。版本 1.0.0-alpha05 包含这些提交内容。

bug 修复

  • 此库现在使用 JSpecify nullness annotations，即类型使用。Kotlin 开发者应使用以下编译器参数来强制执行正确的用法：-Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode（I38301、b/326456246）
  • 修复了在 Android 13 中旋转后显示之前打开的页面的问题。(Ib03dd)
  • 修复了旋转时工具箱消失的问题。(01148f)

版本 1.0.0-alpha04

2024 年 11 月 13 日

发布了 androidx.pdf:pdf-viewer:1.0.0-alpha04 和 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04。版本 1.0.0-alpha04 包含这些提交内容。

更好的兼容性

  • PDFViewer 库现在支持 Android 版本 S、T、U 和 V。这种增强的兼容性与 SDK 扩展 13 更新相关联。

API 变更

  • 向 PdfViewerFragment 添加了最小 SdkExtension 约束条件。(I922af)
  • 公开了 PDF 查看器库的新 API。(I0af57)

bug 修复

  • 修复了进程终止问题的崩溃问题。
  • 修复了与密码对话框相关的界面问题。
  • 修复了 findInFileView 和 FastscrollView 的无障碍功能问题。

正在开发中

  • 我们正在积极努力将 Jetpack Compose 纳入该库。

版本 1.0.0-alpha03

2024 年 9 月 18 日

发布了 androidx.pdf:pdf-viewer:1.0.0-alpha03 和 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03。版本 1.0.0-alpha03 包含这些提交内容。

bug 修复

  • 解决了首次打开搜索时键盘不显示的问题
  • 修复了与 FindInFile 视图字体相关的界面问题。
  • 修复了文本选择和拖动手柄的界面问题。

已知问题

  • PDF 文档中的 3D 图片无法在查看器中呈现。
  • PdfViewerFragment 在处理非常大的 PDF 文档（大于 250 MB）时存在一些性能问题

版本 1.0.0-alpha02

2024 年 9 月 4 日

发布了 androidx.pdf:pdf-viewer:1.0.0-alpha02 和 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02。版本 1.0.0-alpha02 包含这些提交内容。

bug 修复

  • 解决了从竖屏旋转为横屏且应用进入休眠状态时 PDF 图片模糊不清的问题。
  • 现在，即使配置发生变化，“在文件中查找”菜单也会保留结果数。
  • FloatingActionButton 图标现已适用于单页 PDF 文件。
  • 修复了“在文件中查找”栏和 FloatingActionButton 之间出现的重叠问题。
  • 现在，文本和突出显示注释可以在查看器中呈现。
  • 改进了“在文件中查找”栏的无障碍功能。
  • 已针对旋转实现界面修复，包括保留查找次数、解决文本选择菜单消失的问题，以及解决 FAB 重叠问题。
  • 修复了在横屏模式下“在文件中查找”菜单隐藏在键盘后面的问题。

已知问题

  • PDF 文档中的 3D 图片无法在查看器中呈现。
  • PdfViewerFragment 在处理非常大的 PDF 文档（大于 250 MB）时存在一些性能问题

版本 1.0.0-alpha01

2024 年 8 月 7 日

发布了 androidx.pdf:pdf-viewer:1.0.0-alpha01 和 androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01。版本 1.0.0-alpha01 包含这些提交内容。

新功能

PDFViewer 的初始 Alpha 版包含可实现核心 PDF 阅读场景的早期预览版实现。请注意，目前只有 Android V (SDK 35) 版本支持 PdfViewerFragment。我们将在即将发布的版本中添加对较低版本 Android 的支持。

  • 引入了 PdfViewerFragment，应用可以用它来呈现 PDF 文档。PdfViewerFragment 简化了在 activity 中集成 PDF 查看器的操作，并允许用户通过以下方式进行互动：
    • 缩放：双指张合和张合可调整缩放级别，以获得舒适的阅读体验；点按两次可快速将内容放大/缩小到默认状态。
    • 导航：在默认/放大状态下滚动。PdfViewerFragment 提供了一个快速刮刀，可在页面之间快速滚动。
    • 文本操作：长按文本可将其选中，让用户能够使用“复制”和“全选”等选项来处理当前页面上的文本。
    • 受密码保护的文档：PdfViewerFragment 会提供一个对话框，供用户输入密码并打开文档。
    • 可导航的超链接：用户可以点按 PDF 中的超链接，前往网址或书签。
    • 注释模式快捷方式：PdfViewerFragment 尚不支持编辑模式。而是显示一个 FloatingActionButton，用于使用文档 URI 触发隐式 android.intent.action.ANNOTATE intent。PdfViewerFragment

API 变更

  • 添加了 PdfViewerFragment.documentUri 属性，用于为文档设置文件或内容 URI 并发起文档加载。设置 URI 后，PdfViewerFragment 会显示一个旋转图标，表示正在后台处理文档。
  • 添加了 PdfViewerFragment.isTextSearchActive，用于切换“在文件中查找”菜单的显示状态。PdfViewerFragment 会处理整个流程，包括允许输入、显示匹配项总数、在结果之间导航以及退出。
  • 添加了 onDocumentLoadSuccess 和 onDocumentLoadError 回调，这些回调会在文档成功呈现后或在呈现前抛出错误后调用。

已知问题

  • 在某些情况下，“在文件中查找”栏会与 FloatingActionButton 重叠。
  • 单页 PDF 文件不显示 FloatingActionButton 图标。
  • 在“在文件中查找”菜单中更改配置时，结果数不会保留。
  • 关闭“在文件中查找”菜单时出现闪烁
  • PDF 文档中的 3D 图片无法在查看器中呈现。
  • 我们将在后续版本中启用无障碍功能。
  • 从纵向旋转为横向时，PDF 图片会变模糊。
  • 不支持文本/突出显示注释。
  • PdfViewerFragment 在处理非常大的 PDF 文档（大于 250 MB）时存在一些性能问题

备注

  • 将 compileSdk 更新为 35 5dc41be