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
7 août 2024 - - - 1.0.0-alpha01

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 {
    //TODO: Confirm these dependencies
    implementation "androidx.pdf:pdf:1.0.0-alpha01"
}

Kotlin

dependencies {
    //TODO: Confirm these dependencies
    implementation("androidx.pdf:pdf:1.0.0-alpha01")
}

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-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 : - Zoom: pincez l'écran vers l'avant ou vers l'arrière pour ajuster le niveau 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 à des URL Web ou à des 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 : autoriser la saisie, afficher le nombre total de correspondances, naviguer entre les résultats et quitter celui-ci.
  • 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 lors de la fermeture du menu de recherche 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