pdf

  
Bibliothèque permettant d'ajouter des fonctionnalités de visionnage de PDF dans les applications.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
11 décembre 2024 - - - 1.0.0-alpha05

Déclarer des dépendances

Pour ajouter une dépendance à pdf, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

Groovy

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

Kotlin

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

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Aucune note de version pour cet artefact.

Version 1.0

Version 1.0.0-alpha05

11 décembre 2024

Publication d'androidx.pdf:pdf-document-service:1.0.0-alpha05, androidx.pdf:pdf-viewer:1.0.0-alpha05 et androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05. La version 1.0.0-alpha05 contient ces commits.

Correction de bugs

  • Cette bibliothèque utilise désormais les annotations de nullité JSpecify, qui sont des annotations de type. Les développeurs Kotlin doivent utiliser les arguments de compilation suivants pour appliquer une utilisation correcte: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (I38301, b/326456246)
  • Correction d'un problème qui entraînait l'affichage de la page précédemment ouverte après la rotation dans Android 13. (Ib03dd)
  • Correction du problème de disparition de la boîte à outils lors de la rotation. (01148f)

Version 1.0.0-alpha04

13 novembre 2024

Publication d'androidx.pdf:pdf-viewer:1.0.0-alpha04 et d'androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04. La version 1.0.0-alpha04 contient ces commits.

Compatibilité étendue

  • La bibliothèque PDFViewer est désormais compatible avec les versions Android S, T, U et V. Cette compatibilité améliorée est liée à la mise à jour de l'extension 13 du SDK.

Modifications apportées à l'API

  • Ajout d'une contrainte SdkExtension minimale à PdfViewerFragment. (I922af)
  • Exposition de nouvelles API pour la bibliothèque du lecteur PDF. (I0af57)

Correction de bugs

  • Correction d'un plantage lié à l'arrêt du processus.
  • Corrections de l'UI liées à la boîte de dialogue de mot de passe.
  • Correction des problèmes d'accessibilité pour findInFileView et FastscrollView.

Développement en cours

  • Nous travaillons activement à l'intégration de Jetpack Compose dans la bibliothèque.

Version 1.0.0-alpha03

18 septembre 2024

Publication d'androidx.pdf:pdf-viewer:1.0.0-alpha03 et d'androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03. La version 1.0.0-alpha03 contient ces commits.

Correction de bugs

  • Résolution du problème de non-affichage du clavier lorsque la recherche est ouverte pour la première fois
  • Corrections de l'UI liées à la police de la vue "FindInFile".
  • Correction de l'interface utilisateur pour la sélection du texte et la poignée de glissement.

Problèmes connus

  • Les images 3D des documents PDF ne sont pas affichées dans le lecteur.
  • PdfViewerFragment présente des problèmes de performances sur les documents PDF très volumineux (> 250 Mo)

Version 1.0.0-alpha02

4 septembre 2024

Publication d'androidx.pdf:pdf-viewer:1.0.0-alpha02 et d'androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02. La version 1.0.0-alpha02 contient ces commits.

Correction de bugs

  • Résolution du problème d'image PDF floue lors de la rotation du mode portrait au mode paysage et de la mise en veille de l'application.
  • Le menu "Rechercher dans le fichier" conserve désormais le nombre de résultats, même en cas de modification de la configuration.
  • L'icône FloatingActionButton est désormais disponible pour les PDF d'une seule page.
  • Les problèmes de chevauchement entre la barre de recherche dans le fichier et FloatingActionButton ont été résolus.
  • Les annotations textuelles et en surbrillance peuvent désormais être affichées dans le lecteur.
  • La barre de recherche dans le fichier a été améliorée en termes d'accessibilité.
  • Des corrections ont été apportées à l'interface utilisateur pour la rotation, y compris la conservation du nombre de recherches, la résolution du problème de disparition du menu de sélection du texte et la résolution du problème de chevauchement du bouton d'action flottant.
  • Le menu "Rechercher dans le fichier" qui se cachait derrière le clavier en mode paysage a été corrigé.

Problèmes connus

  • Les images 3D des documents PDF ne sont pas affichées dans le lecteur.
  • PdfViewerFragment présente des problèmes de performances sur les documents PDF très volumineux (> 250 Mo)

Version 1.0.0-alpha01

7 août 2024

Publication d'androidx.pdf:pdf-viewer:1.0.0-alpha01 et d'androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01. La version 1.0.0-alpha01 contient ces commits.

Nouvelles fonctionnalités

La version alpha initiale de PDFViewer inclut des implémentations en preview anticipée qui permettent les principaux scénarios de lecture de PDF. Veuillez noter que PdfViewerFragment n'est actuellement compatible qu'avec les versions Android V (SDK 35). La compatibilité avec les anciennes versions d'Android sera ajoutée dans les prochaines versions.

  • Introduction de PdfViewerFragment, que votre application peut utiliser pour afficher un document PDF. PdfViewerFragment simplifie l'intégration d'un lecteur PDF dans votre activité et permet aux utilisateurs d'interagir comme suit :
    • Zoom: pincez pour faire un zoom avant ou arrière afin d'ajuster le niveau de zoom pour une expérience de lecture confortable. Appuyez deux fois pour faire un zoom avant ou arrière rapide et revenir à l'état par défaut.
    • Navigation: faites défiler l'écran à l'état par défaut/zoomé. PdfViewerFragment fournit un outil de balayage rapide pour faire défiler les pages.
    • Actions sur le texte: appuyez de manière prolongée sur du texte pour le sélectionner. Les utilisateurs peuvent alors utiliser des options comme "Copier" et "Tout sélectionner" sur la page en cours.
    • Documents protégés par mot de passe: PdfViewerFragment fournit une boîte de dialogue permettant à l'utilisateur de saisir le mot de passe et d'ouvrir le document.
    • Liens hypertexte cliquables: les utilisateurs peuvent accéder à des URL Web ou à des favoris en appuyant sur des liens hypertexte dans le PDF.
    • Raccourci vers le mode annotations: le mode Édition n'est pas encore compatible avec PdfViewerFragment. À la place, PdfViewerFragment affiche un FloatingActionButton qui déclenche un intent android.intent.action.ANNOTATE implicite avec l'URI du document.

Modifications apportées à l'API

  • Ajout de la propriété PdfViewerFragment.documentUri pour définir un URI de fichier ou de contenu pour le document et lancer le chargement du document. PdfViewerFragment affiche une icône de chargement lorsque l'URI est défini, ce qui indique le traitement en arrière-plan du document.
  • Ajout de PdfViewerFragment.isTextSearchActive pour activer/désactiver la visibilité du menu "Rechercher dans le fichier". PdfViewerFragment gère l'ensemble du flux : il permet la saisie, affiche le nombre total de correspondances, permet de naviguer entre les résultats et de quitter la page.
  • Ajout de rappels onDocumentLoadSuccess et onDocumentLoadError qui sont appelés après l'affichage réussi du document ou après qu'une erreur a été générée avant l'affichage.

Problèmes connus

  • Dans certains cas, la barre de recherche dans le fichier chevauche FloatingActionButton.
  • L'icône FloatingActionButton n'est pas visible pour les PDF d'une seule page.
  • Le nombre de résultats n'est pas conservé en cas de modification de la configuration dans le menu "Rechercher dans le fichier".
  • Un scintillement est observé lorsque vous fermez le menu "Rechercher dans le fichier".
  • Les images 3D des documents PDF ne sont pas affichées dans le lecteur.
  • Les fonctionnalités d'accessibilité seront activées dans les versions suivantes.
  • L'image PDF devient floue lorsque vous passez du mode portrait au mode paysage.
  • Les annotations de texte/mise en surbrillance ne sont pas acceptées.
  • PdfViewerFragment présente des problèmes de performances sur les documents PDF très volumineux (> 250 Mo)

Note

  • Mise à jour de compileSdk vers 35 5dc41be