pdf

  
一个用于在应用内添加 pdf 查看功能的库。
最新更新 稳定版 候选版本 Beta 版 Alpha 版
2024 年 9 月 4 日 - - - 1.0.0-alpha02

声明依赖项

要添加对 pdf 的依赖项，您必须将 Google Maven 存储库添加到您的项目中。阅读Google 的 Maven 存储库以获取更多信息。

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

Groovy

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

Kotlin

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

有关依赖项的更多信息，请参阅添加构建依赖项。

反馈

您的反馈有助于改进 Jetpack。如果您发现新问题或有改进此库的想法，请告诉我们。在创建新问题之前，请查看此库中现有的问题。您可以通过单击星形按钮为现有问题添加您的投票。

创建新问题

有关更多信息，请参阅问题跟踪器文档。

此构件没有发行说明。

版本 1.0

版本 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 包含这些提交。

错误修复

  • 已解决从纵向旋转到横向以及应用进入睡眠状态时 PDF 图像模糊的问题。
  • 查找文件菜单现在即使在配置更改时也能保持结果计数。
  • 现在，单页 PDF 可使用FloatingActionButton图标。
  • 已修复查找文件栏和FloatingActionButton之间的重叠问题。
  • 现在可以在查看器中渲染文本和高亮注释。
  • 已对查找文件栏进行了辅助功能改进。
  • 已针对旋转实施了 UI 修复，包括保留查找计数、解决消失的文本选择菜单以及解决 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 阅读场景的早期预览实现。请注意，PdfViewerFragment 当前仅在 Android V（SDK 35）版本上受支持。后续版本中将添加对旧版 Android 版本的支持。

  • 引入了 PdfViewerFragment，您的应用可以使用它来渲染 PDF 文档。PdfViewerFragment 简化了在您的 Activity 中集成 PDF 查看器的操作，并允许用户以以下方式进行交互
    • 缩放：捏合以调整缩放级别，获得舒适的阅读体验，以及双击快速缩放至默认状态。
    • 导航：在默认/缩放状态下滚动。PdfViewerFragment 提供了一个快速滑块，用于在页面之间快速滚动。
    • 文本操作：长按文本会选中它，允许用户使用当前页面上的复制和全选等选项。
    • 受密码保护的文档：PdfViewerFragment 提供了一个对话框，供用户输入密码并打开文档。
    • 可导航的超链接：用户可以通过点击 PDF 中的超链接导航到 Web URL 或书签。
    • 注释模式快捷方式：PdfViewerFragment 中尚不支持编辑模式。相反，PdfViewerFragment 显示一个 FloatingActionButton，该按钮会使用文档 URI 发出隐式 android.intent.action.ANNOTATE 意图。

API 更改

  • 添加了 PdfViewerFragment.documentUri 属性来设置文档的文件或内容 URI 并启动文档加载。PdfViewerFragment 在设置 URI 时显示加载微调器，指示文档的后台处理。
  • 添加了 PdfViewerFragment.isTextSearchActive 来切换“在文件中查找”菜单的可见性。PdfViewerFragment 处理整个流程 - 允许输入、显示匹配总数、启用结果之间的导航并退出。
  • 添加了 onDocumentLoadSuccess 和 onDocumentLoadError 回调，它们在成功渲染文档或在渲染之前抛出错误后被调用。

已知问题

  • 在某些情况下，“在文件中查找”栏与 FloatingActionButton 重叠。
  • FloatingActionButton 图标在单页 PDF 中不可见。
  • 在“在文件中查找”菜单中，结果计数在配置更改时未保留。
  • 关闭“在文件中查找”菜单时观察到闪烁。
  • PDF 文档中的 3D 图像在查看器中未渲染。
  • 将在后续版本中启用辅助功能。
  • 从纵向旋转到横向时，PDF 图像变得模糊。
  • 不支持文本/高亮注释。
  • PdfViewerFragment 在非常大的 PDF 文档（> 250 MB）上存在一些性能问题

注意

  • 将 compileSdk 更新到 35 5dc41be