pdf

  
Bibliothèque permettant d'ajouter des fonctionnalités d'affichage de PDF dans des applications.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
4 septembre 2024 - - - 1.0.0-alpha02

Déclarer des dépendances

Pour ajouter une dépendance au 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-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

  • Le problème d'image PDF floue lors de la rotation du mode portrait en mode paysage et de la mise en veille de l'application a été résolu.
  • Le menu "Rechercher dans le fichier" permet désormais de gérer 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 composés d'une seule page.
  • Les problèmes de chevauchement entre la barre de recherche dans le fichier et FloatingActionButton ont été résolus.
  • Le texte et les annotations de mise en surbrillance peuvent désormais être affichés dans la visionneuse.
  • Nous avons amélioré l'accessibilité de la barre de recherche dans un fichier.
  • Des correctifs ont été appliqués à l'interface utilisateur pour la rotation, y compris la préservation du nombre de résultats, la suppression du menu de sélection de texte qui disparaît et la résolution du problème de chevauchement des boutons d'action flottants.
  • Correction du problème lié au menu "Rechercher dans les fichiers" qui était masqué par le clavier en mode Paysage.

Problèmes connus

  • Les images 3D des documents PDF ne sont pas affichées dans la visionneuse.
  • PdfViewerFragment rencontre 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 d'PDFViewer inclut des implémentations en preview anticipé qui permettent de lire les PDF dans les principaux scénarios. Veuillez noter que PdfViewerFragment n'est actuellement compatible qu'avec les versions d'Android V (SDK 35). La prise en charge des 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'une visionneuse de PDF à votre activité et permet aux utilisateurs d'interagir comme suit:
    • Zoomer: pincez l'écran vers l'avant ou vers l'arrière pour ajuster les niveaux de zoom afin d'offrir un confort de lecture agréable, et appuyez deux fois pour faire un zoom avant/arrière rapide sur l'état par défaut.
    • Navigation: faites défiler l'écran à l'état par défaut/avec zoom. PdfViewerFragment offre une barre de lecture rapide pour faire défiler rapidement les pages.
    • Actions sur le texte: appuyer de manière prolongée sur le texte pour le sélectionner, ce qui permet aux utilisateurs d'utiliser des options telles que "Copier" et "Tout sélectionner" sur la page actuelle.
    • Documents protégés par un mot de passe: PdfViewerFragment affiche une boîte de dialogue permettant à l'utilisateur de saisir le mot de passe et d'ouvrir le document.
    • Liens hypertextes navigables: les utilisateurs peuvent accéder aux URL Web ou aux favoris en appuyant sur les liens hypertextes dans le PDF.
    • Raccourci vers le mode Annotations: le mode Édition n'est pas encore disponible dans 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, ce qui permet l'entrée, l'affichage du nombre total de correspondances, la navigation entre les résultats et leur fermeture.
  • Ajout de rappels onDocumentLoadSuccess et onDocumentLoadError, qui sont appelés après l'affichage réussi du document ou lorsqu'une erreur est générée avant le rendu.

Problèmes connus

  • Dans certains cas, la barre de recherche dans le fichier chevauche l'élément FloatingActionButton.
  • L'icône FloatingActionButton n'est pas visible pour les PDF composés d'une seule page.
  • Le nombre de résultats n'est pas conservé en cas de modification de la configuration via le menu "Rechercher dans le fichier".
  • Un scintillement apparaît lorsque vous fermez le menu "Rechercher dans le fichier".
  • Les images 3D des documents PDF ne sont pas affichées dans la visionneuse.
  • Les fonctionnalités d'accessibilité seront activées dans les versions suivantes.
  • L'image PDF devient floue lorsque l'utilisateur passe du mode portrait au mode paysage.
  • Incompatibilité avec les annotations de texte et de surlignage.
  • PdfViewerFragment rencontre des problèmes de performances sur les documents PDF très volumineux (> 250 Mo)

Note

  • Remplacez compileSdk par 35 5dc41be