pdf

一个用于在应用内添加 pdf 查看功能的库。

最新更新	稳定版	候选版	Beta 版	Alpha 版
2024 年 11 月 13 日	-	-	-	1.0.0-alpha04

声明依赖项

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

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

Groovy

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

Kotlin

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

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

反馈

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

创建新的问题

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

此构件没有发行说明。

1.0 版

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)

错误修复

修复了进程死亡问题导致的崩溃。
修复了与密码对话框相关的UI问题。
修复了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版本包含这些提交。

错误修复

已解决首次打开搜索时键盘不弹出的问题。
修复了与“查找文件中”视图字体相关的UI问题。
修复了文本选择和拖动句柄的UI问题。

已知问题

PDF文档中的3D图像无法在查看器中渲染。
对于非常大的PDF文档（> 250 MB），PdfViewerFragment存在一些性能问题。

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图像无法在查看器中渲染。
对于非常大的PDF文档（> 250 MB），PdfViewerFragment存在一些性能问题。

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

注意

将compileSdk更新到35 5dc41be