pdf

  
Una libreria per aggiungere funzionalità di visualizzazione di PDF all'interno delle app.
Ultimo aggiornamento Release stabile Candidato per la release Versione beta Versione alpha
11 dicembre 2024 - - - 1.0.0-alpha05

Dichiarazione delle dipendenze

Per aggiungere una dipendenza da pdf, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli elementi necessari nel file build.gradle per la tua app o il tuo modulo:

Alla moda

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

Kotlin

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

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di compilazione.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Monitoraggio problemi.

Non sono disponibili note di rilascio per questo elemento.

Versione 1.0

Versione 1.0.0-alpha05

11 dicembre 2024

androidx.pdf:pdf-document-service:1.0.0-alpha05, androidx.pdf:pdf-viewer:1.0.0-alpha05 e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05 vengono rilasciati. La versione 1.0.0-alpha05 contiene questi commit.

Correzioni di bug

  • Questa libreria ora utilizza le annotazioni di nullità JSpecify, che sono di tipo di utilizzo. Gli sviluppatori Kotlin devono utilizzare i seguenti argomenti del compilatore per applicare l'utilizzo corretto: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (I38301, b/326456246)
  • È stato corretto il problema per cui la pagina aperta in precedenza veniva visualizzata dopo la rotazione in Android 13. (Ib03dd)
  • È stato risolto il problema relativo alla scomparsa della cassetta degli attrezzi durante la rotazione. (01148f)

Versione 1.0.0-alpha04

13 novembre 2024

androidx.pdf:pdf-viewer:1.0.0-alpha04 e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04 vengono rilasciati. La versione 1.0.0-alpha04 contiene questi commit.

Compatibilità estesa

  • La libreria PDFViewer ora supporta le versioni Android S, T, U e V. Questa compatibilità migliorata è collegata all'aggiornamento dell'estensione SDK 13.

Modifiche all'API

  • È stato aggiunto il vincolo minimo SdkExtension a PdfViewerFragment. (I922af)
  • Sono state esposte nuove API per la libreria del visualizzatore PDF. (I0af57)

Correzioni di bug

  • Correzione dell'arresto anomalo per il problema di interruzione del processo.
  • Correzioni all'interfaccia utente relative alla finestra di dialogo della password.
  • Correzioni relative all'accessibilità per findInFileView e FastscrollView.

Sviluppo continuo

  • Stiamo lavorando attivamente per integrare Jetpack Compose nella libreria.

Versione 1.0.0-alpha03

18 settembre 2024

androidx.pdf:pdf-viewer:1.0.0-alpha03 e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03 vengono rilasciati. La versione 1.0.0-alpha03 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema relativo alla mancata visualizzazione della tastiera quando la ricerca viene aperta per la prima volta
  • Correzioni all'interfaccia utente relative al carattere della visualizzazione TrovaInFile.
  • Correzioni all'interfaccia utente per la selezione del testo e il cursore di trascinamento.

Problemi noti

  • Le immagini 3D nei documenti PDF non vengono visualizzate nel visualizzatore.
  • PdfViewerFragment presenta alcuni problemi di prestazioni con i documenti PDF di grandi dimensioni (> 250 MB)

Versione 1.0.0-alpha02

4 settembre 2024

androidx.pdf:pdf-viewer:1.0.0-alpha02 e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02 vengono rilasciati. La versione 1.0.0-alpha02 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema relativo all'immagine PDF sfocata quando si ruota da verticale a orizzontale e l'app entra in modalità di sospensione.
  • Il menu Trova nel file ora mantiene il conteggio dei risultati anche quando la configurazione cambia.
  • L'icona FloatingActionButton è ora disponibile per i PDF di una sola pagina.
  • I problemi di sovrapposizione tra la barra Trova nel file e FloatingActionButton sono stati risolti.
  • Ora le annotazioni di testo ed evidenziazione possono essere visualizzate nel visualizzatore.
  • Sono stati apportati miglioramenti all'accessibilità della barra Trova nel file.
  • Sono state implementate correzioni all'interfaccia utente per la rotazione, tra cui il mantenimento del conteggio delle ricerche, la correzione del menu di selezione del testo che scompare e la risoluzione del problema di sovrapposizione del FAB.
  • È stato corretto il problema relativo al menu Trova nel file che si nascondeva dietro la tastiera in modalità Orizzontale.

Problemi noti

  • Le immagini 3D nei documenti PDF non vengono visualizzate nel visualizzatore.
  • PdfViewerFragment presenta alcuni problemi di prestazioni con i documenti PDF di grandi dimensioni (> 250 MB)

Versione 1.0.0-alpha01

7 agosto 2024

androidx.pdf:pdf-viewer:1.0.0-alpha01 e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01 vengono rilasciati. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

La versione alpha iniziale di PDFViewer include implementazioni di anteprime iniziali che consentono scenari di lettura di PDF di base. Tieni presente che PdfViewerFragment è attualmente supportato solo sulle versioni Android V (SDK 35). Il supporto per le versioni precedenti di Android verrà aggiunto nelle release future.

  • È stato introdotto PdfViewerFragment, che la tua app può utilizzare per eseguire il rendering di un documento PDF. PdfViewerFragment semplifica l'integrazione di un visualizzatore di PDF nella tua attività e consente agli utenti di interagire nei seguenti modi:
    • Zoom: pizzica per aumentare e diminuire lo zoom per un'esperienza di lettura confortevole e tocca due volte per aumentare/diminuire rapidamente lo zoom allo stato predefinito.
    • Navigazione: scorri nello stato predefinito/con zoom. PdfViewerFragment fornisce un cursore rapido per scorrere rapidamente tra le pagine.
    • Azioni sul testo: se tocchi a lungo il testo, questo viene selezionato e gli utenti possono utilizzare opzioni come Copia e Seleziona tutto nella pagina corrente.
    • Documenti protetti da password: PdfViewerFragment fornisce una finestra di dialogo in cui l'utente deve inserire la password per aprire il documento.
    • Link ipertestuali navigabili: gli utenti possono accedere a URL web o preferiti toccando i link ipertestuali all'interno del PDF.
    • Scorciatoia per la modalità di annotazione: la modalità di modifica non è ancora supportata in PdfViewerFragment. PdfViewerFragment mostra invece un FloatingActionButton che attiva un'intent android.intent.action.ANNOTATE implicita con l'URI del documento.

Modifiche all'API

  • È stata aggiunta la proprietà PdfViewerFragment.documentUri per impostare un URI file o dei contenuti per il documento e avviarne il caricamento. PdfViewerFragment mostra un indicatore di caricamento quando l'URI è impostato, a indicare 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: consente l'input, mostra il numero totale di corrispondenze, consente la navigazione tra i risultati ed esce.
  • Sono stati aggiunti i callback onDocumentLoadSuccess e onDocumentLoadError che vengono richiamati dopo il rendering riuscito del documento o dopo l'emissione di un errore prima del rendering.

Problemi noti

  • In alcuni casi la barra Trova nel file si sovrappone a FloatingActionButton.
  • L'icona FloatingActionButton non è visibile per i PDF di una sola pagina.
  • Il conteggio dei risultati non viene mantenuto in caso di modifica della configurazione nel menu Trova nel file.
  • Si verifica un tremolio durante la chiusura del menu Trova nel file
  • Le immagini 3D nei documenti PDF non vengono visualizzate nel visualizzatore.
  • Le funzionalità di accessibilità verranno attivate nelle release successive.
  • L'immagine PDF diventa sfocata quando viene ruotata da verticale a orizzontale.
  • Non è supportata l'annotazione di testo/evidenziazione.
  • PdfViewerFragment presenta alcuni problemi di prestazioni con i documenti PDF di grandi dimensioni (> 250 MB)

Nota

  • Aggiorna compileSdk alla versione 35 5dc41be