PDF

Библиотека для добавления возможностей просмотра PDF-файлов внутри приложений.
Последнее обновление Стабильный выпуск Кандидат на выпуск Бета-версия Альфа-релиз
4 сентября 2024 г. - - - 1.0.0-альфа02

Объявление зависимостей

Чтобы добавить зависимость от pdf, вам необходимо добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .

Добавьте зависимости для нужных вам артефактов в файл build.gradle для вашего приложения или модуля:

классный

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

Котлин

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

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.

Создать новую задачу

Дополнительную информацию см. в документации по системе отслеживания проблем .

Для этого артефакта нет примечаний к выпуску.

Версия 1.0

Версия 1.0.0-альфа02

4 сентября 2024 г.

Выпущены androidx.pdf:pdf-viewer:1.0.0-alpha02 и androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит эти коммиты .

Исправления ошибок

  • Устранена проблема с размытым изображением PDF при повороте из книжной ориентации в альбомную и переходе приложения в спящий режим.
  • Меню поиска в файле теперь сохраняет подсчет результатов даже при изменении конфигурации.
  • Значок FloatingActionButton теперь доступен для одностраничных PDF-файлов.
  • Исправлены проблемы с дублированием панели поиска в файле и FloatingActionButton .
  • Текст и аннотации выделения теперь можно отображать в средстве просмотра.
  • Улучшены специальные возможности панели «Найти в файле».
  • Были реализованы исправления пользовательского интерфейса для вращения, включая сохранение счетчика поиска, устранение исчезающего меню выбора текста и решение проблемы перекрытия FAB.
  • Исправлен поиск в меню файлов, скрывающийся за клавиатурой в ландшафтном режиме.

Известные проблемы

  • 3D-изображения в документах PDF не отображаются в средстве просмотра.
  • PdfViewerFragment имеет некоторые проблемы с производительностью при работе с очень большими PDF-документами (> 250 МБ).

Версия 1.0.0-альфа01

7 августа 2024 г.

Выпущены androidx.pdf:pdf-viewer:1.0.0-alpha01 и androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01 . Версия 1.0.0-alpha01 содержит эти коммиты .

Новые возможности

Первоначальная альфа-версия PDFViewer включает ранние реализации предварительного просмотра, которые позволяют использовать основные сценарии чтения PDF-файлов. Обратите внимание, что PdfViewerFragment в настоящее время поддерживается только в версиях Android V (SDK 35). Поддержка старых версий Android будет добавлена ​​в следующих выпусках.

  • Представлен PdfViewerFragment , который ваше приложение может использовать для визуализации PDF-документа. PdfViewerFragment упрощает интеграцию средства просмотра PDF-файлов в вашу деятельность и позволяет пользователям взаимодействовать следующими способами:
    • Масштабирование: увеличивайте и уменьшайте масштаб, чтобы настроить уровень масштабирования для комфортного чтения, а также двойное касание для быстрого увеличения/уменьшения масштаба до состояния по умолчанию.
    • Навигация: прокрутка в состоянии по умолчанию/увеличении. PdfViewerFragment предоставляет быстрый скруббер для быстрой прокрутки между страницами.
    • Действия с текстом: долгое нажатие на текст выделяет его, позволяя пользователям использовать такие параметры, как «Копировать» и «Выбрать все» на текущей странице.
    • Документы, защищенные паролем: PdfViewerFragment предоставляет пользователю диалоговое окно для ввода пароля и открытия документа.
    • Навигационные гиперссылки: пользователи могут переходить к веб-URL-адресам или закладкам, нажимая на гиперссылки в PDF-файле.
    • Ярлык для режима аннотаций: режим редактирования пока не поддерживается в PdfViewerFragment . Вместо этого PdfViewerFragment отображает FloatingActionButton , который запускает неявное намерение android.intent.action.ANNOTATE с URI документа.

Изменения API

  • Добавлено свойство PdfViewerFragment.documentUri , позволяющее установить URI файла или содержимого для документа и инициировать загрузку документа. PdfViewerFragment отображает индикатор загрузки, когда установлен URI, указывающий на фоновую обработку документа.
  • Добавлен PdfViewerFragment.isTextSearchActive для переключения видимости меню поиска в файле. PdfViewerFragment обрабатывает весь поток: разрешает ввод, отображает общее количество совпадений, включает навигацию между результатами и выход из него.
  • Добавлены обратные вызовы onDocumentLoadSuccess и onDocumentLoadError , которые вызываются после успешной отрисовки документа или после возникновения ошибки перед отрисовкой.

Известные проблемы

  • Панель поиска в файле в некоторых случаях перекрывается с FloatingActionButton .
  • Значок FloatingActionButton не отображается для одностраничных PDF-файлов.
  • Количество результатов не сохраняется при изменении конфигурации в меню поиска в файле.
  • Наблюдается мерцание при закрытии меню поиска в файле.
  • 3D-изображения в документах PDF не отображаются в средстве просмотра.
  • Функции специальных возможностей будут включены в следующих выпусках.
  • PDF-изображение становится размытым при повороте из книжной ориентации в альбомную.
  • Нет поддержки текстовых/выделенных аннотаций.
  • PdfViewerFragment имеет некоторые проблемы с производительностью при работе с очень большими PDF-документами (> 250 МБ).

Примечание

  • Обновите compileSdk до версии 35 5dc41be.