pdf

Déclarer des dépendances

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

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

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

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-alpha13

11 février 2026

Publication d'androidx.pdf:pdf-*:1.0.0-alpha13. Liste des commits de la version 1.0.0-alpha13

Nouvelles fonctionnalités

• Introduction de EditablePdfViewerFragment, qui étend la norme PdfViewerFragment pour fournir des fonctionnalités d'édition de PDF, y compris les annotations et le remplissage de formulaires.
• Annotations : utilise la bibliothèque androidx.ink pour fournir une prise en charge complète des annotations PDF. Une barre d'outils dédiée, déclenchée par l'icône Modifier FloatingActionButton, donne accès à des outils spécialisés, y compris :
  • Stylo : permet d'écrire et de dessiner à main levée directement sur le document. Les utilisateurs peuvent personnaliser le trait du stylet en ajustant son épaisseur et en choisissant parmi une large palette de couleurs.
  • Surligneur : permet de surligner du texte à main levée ou de manière précise, et est disponible en plusieurs couleurs.
  • Gomme : supprime précisément des annotations spécifiques.
  • Annuler et Rétablir : offre des fonctionnalités intégrées permettant d'annuler ou de rétablir facilement les modifications les plus récentes.
• Remplissage de formulaires : possibilité de cliquer sur les champs de formulaire et de les modifier (champs de texte, menus déroulants, cases à cocher et boutons radio, par exemple).
  • Le EditablePdfViewerFragment est compatible avec les fonctionnalités de remplissage de formulaires intégrés, ce qui offre une expérience utilisateur fluide. Cette fonctionnalité est contrôlée par l'API isFormFillingEnabled dans PdfView.
  • EditablePdfDocument : nouvelle interface étendant PdfDocument pour gérer et appliquer les modifications apportées aux données du formulaire.
  • Le composable PdfViewer permet d'interagir avec les champs de formulaire, contrôlables via le paramètre isFormFillingEnabled.
• Enregistrer les modifications : PdfWriteHandle permet d'enregistrer le contenu modifié dans un fichier spécifié.
• Sélection d'images : ajout de la possibilité de sélectionner des images par appui prolongé dans les documents PDF. Cette fonctionnalité est activée via la propriété isImageSelectionEnabled dans les composables PdfView et PdfViewer. Les données résultantes sont exposées via le modèle ImageSelection dans OnSelectionChangedListener.
• Mise en page sur deux pages : ajout d'un mode de mise en page côte à côte pour les appareils à grand écran, configurable à l'aide de la propriété pagesPerRow dans PdfView et du composable PdfViewer.

Modifications apportées à l'API

• Présentation de l'API Image Selection dans la bibliothèque Jetpack PDF (Iee0b9, b/470897750)
• Rendre publiques les API de la couche de traitement du remplissage de formulaires. (Iec39c, b/474260451)
• Ajout du paramètre renderParams à l'API openDocument dans SandboxedPdfLoader (If9344, b/438269273)
• Ajout d'API de couche présentation pour le remplissage de formulaires (I829c5, b/449869703)
• Ajout de l'annotation @MainThread sur les méthodes de rappel de OnFirstContentLoadListener et OnSelectionChangedListener (I4cf10, b/466965940)
• Constructeur ApplyInProgressException marqué comme interne, empêchant l'instanciation externe (I5cc66, b/465414484)
• Ajout de l'annotation @MainThread sur les méthodes de rappel des écouteurs dans PdfView (Ie7201, b/429407597)
• Ajout d'API pour les fonctionnalités d'édition native via EditablePdfViewerFragment. (Ifae6c, b/462049364)
• Ajout de l'API FirstContentLoad à PdfView et PdfViewer (Icf63d, b/461666545)
• [2Page] Ajout de l'API de mise en page sur deux pages à la bibliothèque PdfViewer (I8d7f1, b/452517650)

Correction de bugs

• Correction d'une exception due à la fermeture de la page avant la récupération du bitmap (b/475255729)

Version 1.0.0-alpha12

3 décembre 2025

Publication d'androidx.pdf:pdf-*:1.0.0-alpha12. Liste des commits de la version 1.0.0-alpha12

Modifications apportées à l'API

• Supprimer la fonction textAsString de TextSelection dans androidx-main
• Changement de nom : clearSelection devient clearCurrentSelection. (I3a318, b/429407597)
• Suppression de la fonction textAsString de TextSelection. (I1305d, b/429407798)

Correction de bugs

• Correction d'un problème qui empêchait le défilement rapide dans PdfView d'être visible par défaut. (I7fb0e)
• Correction d'un plantage dans TextSelectionMenuProvider pour la sélection avec texte nul. (I855df)

Version 1.0.0-alpha11

22 octobre 2025

Publication d'androidx.pdf:pdf-*:1.0.0-alpha11. Liste des commits de la version 1.0.0-alpha11

Nouvelles fonctionnalités

• Activation des éléments de menu intelligents sur la sélection de contenu PDF.
• Activation de la sélection de liens hypertexte et de liens "Accéder à" dans les PDF.
• Exposition de l'API du menu de sélection fromPdfView et du composable PdfViewer, qui permet aux développeurs d'ajouter des éléments de menu de sélection.
• Ajout d'une API d'alignement des pages dans PdfView et PdfViewer Composable, qui permet aux développeurs de choisir l'alignement des pages lorsque la hauteur du contenu est inférieure à la hauteur de la fenêtre d'affichage.

Modifications apportées à l'API

• contentDesc est désormais nullable et la valeur par défaut a été supprimée. (I86f8c, b/441973880)
• Exposer PdfSelectionMenuKeys pour les éléments de menu de sélection de liens (Ic9b05, b/447079082)
• Ajouter l'API PageAlignment à PdfView et PdfViewer dans androidx-main
• Modifiez l'API liée à l'angle pour qu'elle utilise des degrés et inclue l'unité dans les noms, soyez clair sur les unités dans les utilitaires de conversion d'angle et prenez en charge les degrés et les radians, modifiez l'API StockBrushes pour qu'elle prenne la version du pinceau de stock en tant que paramètre de fonction de fabrique et exposez le contrôle du comportement de chevauchement automatique pour les pinceaux de surligneur, renommez MutableAffineTransform.populateFromTranslate en populateFromTranslation, supprimez InProgressStrokesView.setRenderFactory/getRenderFactory. (Id9eab, b/436656418)
• Ajout de l'API PageAlignment à PdfView et PdfViewer (I9c9a5, b/438065228)
• Exposer l'API du menu de sélection à partir du composable PdfViewer (Id9b0f, b/407663999)
• Définissez PdfView comme ViewGroup. Aucune compatibilité avec les enfants arbitraires. (Ib51d8, b/410008792)
• Exposition de HyperLinkSelection et GoToLinkSelection à partir de PdfView (I378c4, b/441280002)
• Refactorisation de PdfPageContent pour prendre en charge les sélections génériques (I28f16, b/437845185)
• Exposer l'API du menu de sélection à partir de PdfView (Idd547, b/407663737)
• Déplacement des classes liées à la sélection vers un package dédié (I953cb, b/436157691)
• Ajout de onPdfViewCreated expérimental pour l'accès PdfView dans PdfViewerFragment. (I86715, b/422620454)
• Ajout de l'API FileDescriptor à PdfLoader (I60b8d)

Correction de bugs

• Amélioration de la modélisation des entrées pour que les traits reflètent plus précisément les entrées (I93097)

Contribution externe

• Exposer PdfSelectionMenuKeys pour les éléments de menu de sélection de lien
• Exposer l'API du menu de sélection à partir du composable PdfViewer
• Exposer l'API du menu de sélection à partir de PdfView

Version 1.0.0-alpha10

16 juillet 2025

Publication d'androidx.pdf:pdf-*:1.0.0-alpha10. Liste des commits de la version 1.0.0-alpha10

Nouvelles fonctionnalités

• Sélection améliorée permettant aux utilisateurs de sélectionner du texte sur plusieurs pages en faisant glisser les poignées de sélection au-delà des limites des pages.
• Les applications peuvent désormais intercepter et personnaliser la gestion des clics sur les liens hypertexte dans les documents PDF.

Modifications apportées à l'API

• Expose un composable pour présenter le contenu PDF (I8e7ee)
• Déplacement de PdfPoint et PdfRect vers le package androidx.pdf.models (I26cf4)
• Expose un composant View pour présenter le contenu PDF (I9fe27)
• Expose l'API pour initialiser les ressources PDF à l'avance et réduire la latence de démarrage à froid (a18fa89)
• Expose l'API pour remplacer la gestion des clics sur les liens hypertexte dans le contenu PDF(6330a8b)
• Expose un nouvel artefact pdf-document-service et les API correspondantes : PdfLoader, PdfDocument et SandboxedPdfLoader. Les interfaces peuvent être utilisées pour implémenter le composant d'analyse et de traitement du document PDF (Ide70d).
• Expose une API pour définir PdfDocument sur PdfView afin d'initialiser le rendu du document (If8738)

Version 1.0.0-alpha09

7 mai 2025

Publication d'androidx.pdf:pdf-*:1.0.0-alpha09. Liste des commits de la version 1.0.0-alpha09

Modifications majeures

• La base de code a été largement refactorisée et est désormais entièrement écrite en Kotlin, à l'aide de coroutines et de ViewModel. Cela inclut une réimplémentation de PdfViewerFragment. Cette version n'inclut aucune nouvelle API ni fonctionnalité.

Problèmes connus :

• Les effets d'ombre sont manquants dans le sélecteur rapide et l'indicateur de page.
• Il est possible que les documents PDF d'une seule page ne soient pas toujours centrés ni mis à l'échelle de la largeur de la vue.

Modifications apportées à l'API

• Annotez la variable containerStyleResId avec @StyleRes. (I88d85)

Version 1.0.0-alpha08

12 mars 2025

Publication d'androidx.pdf:pdf-document-service:1.0.0-alpha08, androidx.pdf:pdf-viewer:1.0.0-alpha08 et androidx.pdf:pdf-viewer-fragment:1.0.0-alpha08. Liste des commits de la version 1.0.0-alpha08

Correction de bugs

• Résolution du placement incohérent du menu de sélection entre différents appareils Android en raison de différences de mise à l'échelle. L'emplacement du menu de sélection est désormais cohérent sur tous les appareils.
• Alignement de la position du sélecteur rapide et de l'indicateur de page lors de la recréation du fragment dans des scénarios tels que le changement de configuration, etc.

Version 1.0.0-alpha07

26 février 2025

Publication d'androidx.pdf:pdf-document-service:1.0.0-alpha07, androidx.pdf:pdf-viewer:1.0.0-alpha07 et androidx.pdf:pdf-viewer-fragment:1.0.0-alpha07. Liste des commits de la version 1.0.0-alpha07

Nouvelles fonctionnalités

• PdfViewerFragment est désormais compatible avec StylingOptions (un ensemble d'ID de ressources de style), ce qui permet de personnaliser le style via newInstance ou XML (FragmentContainerView). Les sous-classes peuvent utiliser le constructeur protégé pour une fonctionnalité similaire.
• StylingOptions accepte actuellement containerStyle, qui fournit les éléments suivants :
  • Prise en charge des drawables personnalisés pour la poignée de défilement rapide et l'indicateur de page.
  • Attribut marginEnd pour un positionnement précis de la poignée de défilement rapide et de l'indicateur de page.

Modifications apportées à l'API

• Ajout d'attributs publics à partir de PdfView. (I30fc5)
• Ajout de nouvelles API StylingOptions pour l'affichage des PDF. (Id2993)

Correction de bugs

• Correction d'une incohérence de synchronisation entre la poignée de défilement rapide et l'état de visibilité de l'indicateur de page.

Version 1.0.0-alpha06

29 janvier 2025

Publication d'androidx.pdf:pdf-document-service:1.0.0-alpha06, androidx.pdf:pdf-viewer:1.0.0-alpha06 et androidx.pdf:pdf-viewer-fragment:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06

Correction de bugs

• Correction : plantage causé par IllegalArgumentException lors de la dissociation d'un service non enregistré (eb4e85)
• Correction : plantage IllegalArgumentException en raison d'une différence entre mMaxPages et numPages. (75d763)

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. Liste des commits de la version 1.0.0-alpha05

Correction de bugs

• Cette bibliothèque utilise désormais les annotations de nullité JSpecify, qui sont de type "type-use". Les développeurs Kotlin doivent utiliser l'argument de compilateur suivant pour garantir une utilisation correcte : -Xjspecify-annotations=strict (il s'agit de la valeur par défaut à partir de la version 2.1.0 du compilateur Kotlin). (I38301, b/326456246)
• Correction de l'affichage de la page précédemment ouverte après une rotation dans Android 13. (Ib03dd)
• Correction de la 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. Liste des commits de la version 1.0.0-alpha04

Compatibilité étendue

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

Modifications apportées à l'API

• Ajout de la contrainte minimale SdkExtension à PdfViewerFragment. (I922af)
• Exposition de nouvelles API pour la bibliothèque PDF Viewer. (I0af57)

Correction de bugs

• Correction d'un plantage lié à un problème d'arrêt du processus.
• Corrections de l'UI liées à la boîte de dialogue du mot de passe.
• Correction de 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. Liste des commits de la version 1.0.0-alpha03

Correction de bugs

• Résolution du problème lié au clavier qui ne s'affiche pas 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 de texte et la poignée de déplacement.

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 très grands documents PDF (> 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. Liste des commits de la version 1.0.0-alpha02

Correction de bugs

• Le problème d'image PDF floue lors du passage du mode Portrait au mode Paysage et de la mise en veille de l'application a été résolu.
• Le menu "Rechercher dans les fichiers" conserve désormais le nombre de résultats même lorsque la configuration change.
• L'icône FloatingActionButton est désormais disponible pour les PDF d'une seule page.
• Les problèmes de chevauchement entre la barre "Rechercher dans le fichier" et FloatingActionButton ont été résolus.
• Les annotations de texte et de surbrillance peuvent désormais être affichées dans le lecteur.
• Des améliorations ont été apportées à l'accessibilité de la barre "Rechercher dans le fichier".
• Des corrections de l'UI ont été implémentées pour la rotation, y compris la conservation du nombre de résultats, la résolution du problème de disparition du menu de sélection de texte et la résolution du problème de chevauchement du bouton d'action flottant.
• Correction du problème lié au masquage du menu "Rechercher dans le fichier" derrière le clavier en mode paysage.

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 très grands documents PDF (> 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. Liste des commits de la version 1.0.0-alpha01

Nouvelles fonctionnalités

La première version alpha 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'une visionneuse de PDF dans votre activité et permet aux utilisateurs d'interagir de différentes manières :
  • Zoom : pincez l'écran pour faire un zoom avant ou arrière et ajuster le niveau de zoom pour une lecture confortable. Vous pouvez également appuyer deux fois pour faire un zoom avant ou arrière rapide et revenir à l'état par défaut.
  • Navigation : faites défiler l'écran dans l'état par défaut/zoomé. PdfViewerFragment fournit un sélecteur rapide pour faire défiler rapidement les pages.
  • Actions sur le texte : un appui prolongé sur du texte le sélectionne, 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 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 hypertexte permettant la navigation : 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 disponible dans PdfViewerFragment. Au lieu de cela, 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'intégralité du flux, en permettant la saisie, en affichant le nombre total de correspondances, en permettant la navigation entre les résultats et en quittant le flux.
• Ajout des rappels onDocumentLoadSuccess et onDocumentLoadError, qui sont appelés après le rendu réussi du document ou après le déclenchement d'une erreur avant le rendu.

Problèmes connus

• Dans certains cas, la barre "Rechercher dans le fichier" se chevauche avec 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é lors d'un changement de configuration dans le menu "Rechercher dans les fichiers".
• Des scintillements sont observés lors de la fermeture du 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 prochaines versions.
• L'image PDF devient floue lorsque vous passez du mode Portrait au mode Paysage.
• Les annotations de texte/surlignage ne sont pas acceptées.
• PdfViewerFragment présente des problèmes de performances sur les très grands documents PDF (> 250 Mo).

Commentaire

• Mettre à jour compileSdk vers 35 5dc41be