pdf

Abhängigkeiten deklarieren

Für eine Abhängigkeit von PDF musst du deinem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:

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

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

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Lassen Sie es uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können für ein vorhandenes Problem abstimmen, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zur Problemverfolgung.

Für dieses Artefakt gibt es keine Versionshinweise.

Version 1.0

Version 1.0.0-alpha10

16. Juli 2025

androidx.pdf:pdf-*:1.0.0-alpha10 wird veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

Neue Funktionen

• Die Auswahl wurde verbessert. Nutzer können jetzt Text über mehrere Seiten hinweg auswählen, indem sie die Auswahlziehpunkte über die Seitengrenzen hinaus ziehen.
• Anwendungen können jetzt das Verhalten bei Hyperlink-Klicks in PDF-Dokumenten abfangen und anpassen.

API-Änderungen

• Stellt eine zusammensetzbare Funktion zum Präsentieren von PDF-Inhalten bereit (I8e7ee)
• PdfPoint und PdfRect werden in das androidx.pdf.models-Paket (I26cf4) verschoben
• Stellt eine View-Komponente zum Präsentieren von PDF-Inhalten bereit (I9fe27)
• API wird bereitgestellt, um PDF-Ressourcen vorab zu initialisieren und die Kaltstartlatenz zu verringern (a18fa89)
• API zum Überschreiben der Verarbeitung von Hyperlink-Klicks in PDF-Inhalten verfügbar gemacht(6330a8b)
• Es wird ein neues Artefakt „pdf-document-service“ und die entsprechenden APIs PdfLoader, PdfDocument und SandboxedPdfLoader bereitgestellt. Die Schnittstellen können verwendet werden, um die Parsing- und Verarbeitungskomponente des PDF-Dokuments (Ide70d) zu implementieren.
• Stellt eine API zum Festlegen von PdfDocument für PdfView bereit, um das Rendern des Dokuments zu initialisieren (If8738)

Version 1.0.0-alpha09

7. Mai 2025

androidx.pdf:pdf-*:1.0.0-alpha09 wird veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.

Wichtige Änderungen

• Die Codebasis wurde grundlegend überarbeitet und ist jetzt vollständig in Kotlin geschrieben. Dabei werden Coroutines und ViewModel verwendet. Dazu gehört auch eine Neuimplementierung von PdfViewerFragment. Diese Version enthält keine neuen APIs oder Funktionen.

Bekannte Probleme:

• Der Schnell-Scroller und die Seitenanzeige haben keine Schatteneffekte.
• Einseitige PDF-Dokumente werden möglicherweise nicht immer zentriert und auf die Breite der Ansicht skaliert.

API-Änderungen

• Kommentieren Sie containerStyleResId mit @StyleRes. (I88d85)

Version 1.0.0-alpha08

12. März 2025

androidx.pdf:pdf-document-service:1.0.0-alpha08, androidx.pdf:pdf-viewer:1.0.0-alpha08 und androidx.pdf:pdf-viewer-fragment:1.0.0-alpha08 sind veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.

Fehlerkorrekturen

• Die inkonsistente Platzierung des Auswahlmenüs auf verschiedenen Android-Geräten aufgrund von Skalierungsunterschieden wurde behoben. Die Platzierung des Auswahlmenüs ist jetzt auf allen Geräten einheitlich.
• Die Position des Schnellscrollers und der Seitenanzeige wurde bei der Neuerstellung von Fragmenten in Szenarien wie Konfigurationsänderungen usw. angepasst.

Version 1.0.0-alpha07

26. Februar 2025

androidx.pdf:pdf-document-service:1.0.0-alpha07, androidx.pdf:pdf-viewer:1.0.0-alpha07 und androidx.pdf:pdf-viewer-fragment:1.0.0-alpha07 sind veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

Neue Funktionen

• Die PdfViewerFragment unterstützt jetzt StylingOptions (eine Reihe von Stilressourcen-IDs), was benutzerdefiniertes Styling über newInstance oder XML (FragmentContainerView) ermöglicht. Unterklassen können den geschützten Konstruktor für ähnliche Funktionen verwenden.
• StylingOptions verwendet derzeit containerStyle, das Folgendes bietet:
  • Unterstützung benutzerdefinierter Drawables für den Schnellscroll-Griff und die Seitenanzeige.
  • marginEnd-Attribut für die genaue Positionierung des Schnellscrollgriffs und der Seitenanzeige.

API-Änderungen

• Öffentliche Attribute aus PdfView hinzugefügt (I30fc5)
• Es wurden neue APIs StylingOptions für die PDF-Ansicht hinzugefügt. (Id2993)

Fehlerkorrekturen

• Es wurde ein Synchronisationsfehler zwischen dem Sichtbarkeitsstatus des Schnellscrollgriffs und der Seitenanzeige behoben.

Version 1.0.0-alpha06

29. Januar 2025

androidx.pdf:pdf-document-service:1.0.0-alpha06, androidx.pdf:pdf-viewer:1.0.0-alpha06 und androidx.pdf:pdf-viewer-fragment:1.0.0-alpha06 sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

Fehlerkorrekturen

• Behoben: Absturz durch IllegalArgumentException beim Aufheben der Bindung eines nicht registrierten Dienstes (eb4e85)
• Behoben: Absturz von IllegalArgumentException aufgrund von Unterschieden zwischen mMaxPages und numPages. (75d763)

Version 1.0.0-alpha05

11. Dezember 2024

androidx.pdf:pdf-document-service:1.0.0-alpha05, androidx.pdf:pdf-viewer:1.0.0-alpha05 und androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05 sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Fehlerkorrekturen

• In dieser Bibliothek werden jetzt JSpecify-Nullable-Annotationen verwendet, die typbezogen sind. Kotlin-Entwickler sollten das folgende Compiler-Argument verwenden, um die korrekte Verwendung zu erzwingen: -Xjspecify-annotations=strict (dies ist die Standardeinstellung ab Version 2.1.0 des Kotlin-Compilers). (I38301, b/326456246)
• Ein Fehler wurde behoben, durch den nach dem Drehen des Geräts in Android 13 die zuvor geöffnete Seite angezeigt wurde. (Ib03dd)
• Das Problem, dass die Toolbox bei der Rotation verschwand, wurde behoben. (01148f)

Version 1.0.0-alpha04

13. November 2024

androidx.pdf:pdf-viewer:1.0.0-alpha04 und androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04 werden veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Erweiterte Kompatibilität

• Die PDFViewer-Bibliothek unterstützt jetzt die Android-Versionen S, T, U und V. Diese verbesserte Kompatibilität hängt mit dem Update der SDK-Erweiterung 13 zusammen.

API-Änderungen

• Der Mindestwert SdkExtension wurde der Einschränkung PdfViewerFragment hinzugefügt. (I922af)
• Neue APIs für die PDF Viewer-Bibliothek werden bereitgestellt. (I0af57)

Fehlerkorrekturen

• Absturzkorrektur für das Problem mit der Prozessbeendigung.
• UI-Korrekturen im Zusammenhang mit dem Passwortdialogfeld.
• Barrierefreiheitskorrekturen für findInFileView und FastscrollView.

Laufende Entwicklung

• Wir arbeiten aktiv daran, Jetpack Compose in die Bibliothek zu integrieren.

Version 1.0.0-alpha03

18. September 2024

androidx.pdf:pdf-viewer:1.0.0-alpha03 und androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03 werden veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Fehlerkorrekturen

• Das Problem, dass die Tastatur nicht angezeigt wird, wenn die Suche zum ersten Mal geöffnet wird, wurde behoben.
• UI-Korrekturen im Zusammenhang mit der Schriftart der Ansicht „Suchen in Datei“.
• Fehlerkorrekturen an der Benutzeroberfläche für die Textauswahl und den Ziehpunkt.

Bekannte Probleme

• 3D-Bilder in PDF-Dokumenten werden in der Vorschau nicht gerendert.
• PdfViewerFragment hat bei sehr großen PDF-Dokumenten (> 250 MB) einige Leistungsprobleme.

Version 1.0.0-alpha02

4. September 2024

androidx.pdf:pdf-viewer:1.0.0-alpha02 und androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02 werden veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Fehlerkorrekturen

• Das Problem mit dem unscharfen PDF-Bild beim Drehen vom Hoch- ins Querformat und dem Wechsel der App in den Ruhemodus wurde behoben.
• Im Menü „In Datei suchen“ wird die Anzahl der Ergebnisse jetzt auch dann beibehalten, wenn sich die Konfiguration ändert.
• Das Symbol FloatingActionButton ist jetzt für einseitige PDFs verfügbar.
• Überlappende Probleme zwischen der Leiste „In Datei suchen“ und FloatingActionButton wurden behoben.
• Text- und Markierungsanmerkungen können jetzt im Viewer gerendert werden.
• Die Bedienungshilfen für die Leiste „In Datei suchen“ wurden verbessert.
• Es wurden UI-Korrekturen für die Drehung implementiert, darunter das Beibehalten der Anzahl der Suchergebnisse, die Behebung des Problems, dass das Menü für die Textauswahl verschwindet, und die Behebung des Problems, dass sich das FAB überlappt.
• Das Problem, dass das Menü „In Datei suchen“ im Querformat hinter der Tastatur verborgen war, wurde behoben.

Bekannte Probleme

• 3D-Bilder in PDF-Dokumenten werden in der Vorschau nicht gerendert.
• PdfViewerFragment hat bei sehr großen PDF-Dokumenten (> 250 MB) einige Leistungsprobleme.

Version 1.0.0-alpha01

7. August 2024

androidx.pdf:pdf-viewer:1.0.0-alpha01 und androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01 werden veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Die erste Alpha-Version von PDFViewer enthält erste Vorschauimplementierungen, die grundlegende PDF-Leseszenarien ermöglichen. Die PdfViewerFragment wird derzeit nur auf Android V-Versionen (SDK 35) unterstützt. Die Unterstützung für ältere Android-Versionen wird in zukünftigen Releases hinzugefügt.

• Die Funktion PdfViewerFragment wurde eingeführt, mit der Ihre App ein PDF-Dokument rendern kann. PdfViewerFragment vereinfacht die Integration eines PDF-Viewers in Ihre Aktivität und ermöglicht Nutzern die folgenden Interaktionen:
  • Zoomen: Ziehen Sie die Finger zusammen oder auseinander, um die Zoomstufen für ein angenehmes Lesen anzupassen. Durch Doppeltippen können Sie schnell auf die Standardeinstellung heran- oder herauszoomen.
  • Navigation: Scrollen im Standard- oder Zoomstatus. PdfViewerFragment bietet einen schnellen Scrubber zum schnellen Scrollen zwischen Seiten.
  • Textaktionen: Wenn Sie lange auf Text tippen, wird er ausgewählt. Nutzer können dann Optionen wie „Kopieren“ und „Alles auswählen“ auf der aktuellen Seite verwenden.
  • Passwortgeschützte Dokumente: PdfViewerFragment bietet ein Dialogfeld, in dem der Nutzer das Passwort eingeben und das Dokument öffnen kann.
  • Navigierbare Hyperlinks: Nutzer können Web-URLs oder Lesezeichen aufrufen, indem sie in der PDF-Datei auf Hyperlinks tippen.
  • Tastenkombination für den Anmerkungsmodus: Der Bearbeitungsmodus wird in PdfViewerFragment noch nicht unterstützt. Stattdessen wird in PdfViewerFragment ein FloatingActionButton angezeigt, das einen impliziten android.intent.action.ANNOTATE-Intent mit dem Dokument-URI auslöst.

API-Änderungen

• Die Property PdfViewerFragment.documentUri wurde hinzugefügt, um einen Datei- oder Inhalts-URI für das Dokument festzulegen und das Laden des Dokuments zu starten. PdfViewerFragment zeigt ein rotierendes Ladesymbol an, wenn der URI festgelegt ist, was auf die Hintergrundverarbeitung des Dokuments hinweist.
• PdfViewerFragment.isTextSearchActive wurde hinzugefügt, um die Sichtbarkeit des Menüs „Suchen in Datei“ zu ändern. PdfViewerFragment übernimmt den gesamten Ablauf, einschließlich der Eingabe, der Anzeige der Gesamtzahl der Übereinstimmungen, der Navigation zwischen den Ergebnissen und des Beendens des Ablaufs.
• Die Callbacks onDocumentLoadSuccess und onDocumentLoadError wurden hinzugefügt. Sie werden nach dem erfolgreichen Rendern des Dokuments oder nach einem Fehler vor dem Rendern aufgerufen.

Bekannte Probleme

• Die Leiste „Suchen in Datei“ überlappt sich in einigen Fällen mit FloatingActionButton.
• Das FloatingActionButton-Symbol ist für einseitige PDFs nicht sichtbar.
• Die Anzahl der Ergebnisse wird bei einer Konfigurationsänderung im Menü „In Datei suchen“ nicht beibehalten.
• Beim Schließen des Menüs „In Datei suchen“ flackert das Bild
• 3D-Bilder in PDF-Dokumenten werden in der Vorschau nicht gerendert.
• Bedienungshilfen werden in den folgenden Versionen aktiviert.
• Das PDF-Bild wird beim Drehen vom Hoch- ins Querformat unscharf.
• Text- und Markierungsanmerkungen werden nicht unterstützt.
• PdfViewerFragment hat bei sehr großen PDF-Dokumenten (> 250 MB) einige Leistungsprobleme.

Note

• compileSdk auf 35 5dc41be aktualisieren