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")
}

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

反馈

您的反馈将帮助我们改进 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 中包含这些提交内容。

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 简化了将 PDF 查看器集成到 activity 中的过程，并可让用户通过以下方式进行互动： <ph type="x-smartling-placeholder">
      </ph>
    • 缩放：双指张合可调整缩放级别，可获得舒适的阅读体验；点按两次可快速放大/缩小至默认状态。
    • 导航：在默认/缩放状态下滚动。PdfViewerFragment 提供了快速滚动条，可在页面之间快速滚动。
    • 文字操作：长按文字即可将其选中，这让用户可以使用当前页面上的“复制”和“全选”等选项。
    • 受密码保护的文档：PdfViewerFragment 提供了一个对话框，供用户输入密码并打开文档。
    • 可浏览的超链接：用户可通过点按 PDF 中的超链接导航到网址或书签。
    • 注释模式的快捷方式：PdfViewerFragment 尚不支持修改模式。相反，PdfViewerFragment 会显示一个 FloatingActionButton，它会通过文档 URI 触发隐式 android.intent.action.ANNOTATE intent。

API 变更

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

已知问题

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

备注

  • 将 compileSdk 更新为 35 5dc41be