Aggiornamento più recente | Release stabile | Candidato per l'uscita | Versione beta | Release alpha |
---|---|---|---|---|
7 agosto 2024 | - | - | - | 1.0.0-alpha01 |
Dichiarazione delle dipendenze
Per aggiungere una dipendenza ai file PDF, devi aggiungere il Repository Maven di Google al tuo progetto. Consulta il Repository Maven di Google per ulteriori informazioni.
Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle
per
l'app o il modulo:
Trendy
dependencies { implementation "androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01" }
Kotlin
dependencies { implementation("androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01") }
Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze build.
Feedback
Il tuo feedback ci aiuta a migliorare Jetpack. Non esitare a contattarci in caso di nuovi problemi o idee per migliorare questa raccolta. Dai un'occhiata alle problemi esistenti in questa raccolta, prima di crearne uno nuovo. Puoi aggiungere il tuo voto a un problema esistente tramite facendo clic sul pulsante a forma di stella.
Consulta la documentazione di Issue Tracker per ulteriori informazioni.
Nessuna nota di rilascio per questo elemento.
Versione 1.0
Versione 1.0.0-alpha01
7 agosto 2024
Vengono rilasciate le versioni androidx.pdf:pdf-viewer:1.0.0-alpha01
e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01
. La versione 1.0.0-alpha01 contiene questi commit.
Nuove funzionalità
La versione alpha iniziale di PDFViewer
include implementazioni in anteprima che consentono i principali scenari di lettura di PDF. Tieni presente che PdfViewerFragment
è attualmente supportato solo sulle versioni Android V (SDK 35). Il supporto per le versioni precedenti di Android verrà aggiunto nelle prossime release.
- È stato introdotto il file
PdfViewerFragment
, che la tua app può utilizzare per eseguire il rendering di un documento PDF.PdfViewerFragment
semplifica l'integrazione di un visualizzatore di PDF nelle tue attività e consente agli utenti di interagire nei seguenti modi:- Zoom: pizzica avanti e indietro per regolare i livelli di zoom per un'esperienza di lettura confortevole e tocca due volte per aumentare/diminuire rapidamente lo zoom sullo stato predefinito.
- Navigazione: scorri in stato predefinito/con zoom.
PdfViewerFragment
fornisce uno scrubber rapido per scorrere rapidamente tra le pagine. - Azioni testo: tocca a lungo il testo per selezionarlo, consentendo agli utenti di utilizzare opzioni come Copia e Seleziona tutto nella pagina corrente.
- Documenti protetti da password:
PdfViewerFragment
fornisce una finestra di dialogo in cui l'utente può inserire la password e aprire il documento. - Link ipertestuali navigabili: gli utenti possono raggiungere URL web o preferiti toccando i link ipertestuali all'interno del PDF.
- Scorciatoia per la modalità Annotazioni: la modalità di modifica non è ancora supportata in
PdfViewerFragment
.PdfViewerFragment
mostra invece unFloatingActionButton
che attiva un intentandroid.intent.action.ANNOTATE
implicito con l'URI del documento.
Modifiche alle API
- È stata aggiunta la proprietà
PdfViewerFragment.documentUri
per impostare un URI del file o dei contenuti per il documento e avviarne il caricamento. Quando l'URI è impostato,PdfViewerFragment
mostra una rotellina di caricamento che indica l'elaborazione in background del documento. - È stato aggiunto
PdfViewerFragment.isTextSearchActive
per attivare/disattivare la visibilità del menu Trova nel file.PdfViewerFragment
gestisce l'intero flusso, consentendo l'inserimento, visualizzando il numero totale di corrispondenze, consentendo la navigazione tra i risultati e l'uscita. - Aggiunti i callback
onDocumentLoadSuccess
eonDocumentLoadError
, che vengono attivati dopo aver visualizzato correttamente il documento o dopo che viene generato un errore prima del rendering.
Problemi noti
- In alcuni casi, Trova nella barra dei file si sovrappone a
FloatingActionButton
. - L'icona
FloatingActionButton
non è visibile per i PDF di una singola pagina. - Il conteggio dei risultati non viene conservato in caso di modifica della configurazione nel menu Trova nel file.
- Durante la chiusura del menu Trova nel file si nota uno sfarfallio
- Le immagini 3D nei documenti PDF non vengono visualizzate nel visualizzatore.
- Le funzioni di accessibilità verranno attivate nelle release successive.
- L'immagine PDF diventa sfocata ruotando dall'orientamento verticale a quello orizzontale.
- Nessun supporto per l'annotazione di testo/evidenziazione.
PdfViewerFragment
presenta alcuni problemi di prestazioni per i documenti PDF di grandi dimensioni (> 250 MB)
Nota:
- Aggiorna
compileSdk
a 35 5dc41be