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 { implementation "androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01" }
Kotlin
dependencies { implementation("androidx.pdf:pdf-viewer-fragment: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.
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:- 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 unFloatingActionButton
qui déclenche un intentandroid.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
etonDocumentLoadError
, 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