pdf

  
Uma biblioteca para adicionar recursos de visualização de PDF em apps.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
11 de dezembro de 2024 - - - 1.0.0-alpha05

Declarar dependências

Para adicionar uma dependência a pdf, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

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

Kotlin

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

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Não há notas de versão para este artefato.

Versão 1.0

Versão 1.0.0-alpha05

11 de dezembro de 2024

Lançamento de 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. A versão 1.0.0-alpha05 contém estas confirmações.

Correções de bugs

  • Essa biblioteca agora usa anotações de nulidade JSpecify, que são de uso de tipo. Os desenvolvedores Kotlin precisam usar os seguintes argumentos do compilador para aplicar o uso correto: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (I38301, b/326456246).
  • Correção de um problema em que a página aberta anteriormente era exibida após a rotação no Android 13. (Ib03dd).
  • Correção da caixa de ferramentas que desaparece ao girar. (01148f).

Versão 1.0.0-alpha04

13 de novembro de 2024

Lançamento de androidx.pdf:pdf-viewer:1.0.0-alpha04 e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estas confirmações.

Compatibilidade expandida

  • A biblioteca PDFViewer agora oferece suporte às versões S, T, U e V do Android. Essa compatibilidade aprimorada está vinculada à atualização da extensão 13 do SDK.

Mudanças na API

  • A restrição mínima SdkExtension foi adicionada a PdfViewerFragment. (I922af).
  • Exposição de novas APIs para a biblioteca de visualizador de PDF. (I0af57).

Correções de bugs

  • Correção de falha para o problema de encerramento do processo.
  • Correções na interface relacionadas à caixa de diálogo de senha.
  • Correções de acessibilidade para findInFileView e FastscrollView.

Desenvolvimento em andamento

  • Estamos trabalhando ativamente para incorporar o Jetpack Compose à biblioteca.

Versão 1.0.0-alpha03

18 de setembro de 2024

Lançamento de androidx.pdf:pdf-viewer:1.0.0-alpha03 e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estas confirmações.

Correções de bugs

  • O teclado não aparece quando a pesquisa é aberta pela primeira vez é resolvido
  • Correções na interface relacionadas à fonte da visualização FindInFile.
  • Correções na interface para seleção de texto e alça de arrasto.

Problemas conhecidos

  • As imagens 3D em documentos PDF não são renderizadas no visualizador.
  • O PdfViewerFragment tem alguns problemas de desempenho em documentos PDF muito grandes (mais de 250 MB).

Versão 1.0.0-alpha02

4 de setembro de 2024

Lançamento de androidx.pdf:pdf-viewer:1.0.0-alpha02 e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Correções de bugs

  • O problema de imagem de PDF desfocada ao girar de retrato para paisagem e o app entrar em suspensão foi resolvido.
  • O menu "Encontrar no arquivo" agora mantém a contagem de resultados mesmo quando a configuração muda.
  • O ícone FloatingActionButton agora está disponível para PDFs de uma página.
  • Os problemas de sobreposição entre a barra "Encontrar no arquivo" e o FloatingActionButton foram corrigidos.
  • As anotações de texto e destaque agora podem ser renderizadas no visualizador.
  • Melhorias na acessibilidade foram feitas na barra "Encontrar no arquivo".
  • Correções de interface foram implementadas para a rotação, incluindo a preservação da contagem de resultados, a correção do menu de seleção de texto que desaparece e a resolução do problema de sobreposição do botão flutuante.
  • O menu "Encontrar no arquivo" que fica oculto atrás do teclado no modo paisagem foi corrigido.

Problemas conhecidos

  • As imagens 3D em documentos PDF não são renderizadas no visualizador.
  • O PdfViewerFragment tem alguns problemas de desempenho em documentos PDF muito grandes (mais de 250 MB).

Versão 1.0.0-alpha01

7 de agosto de 2024

Lançamento de androidx.pdf:pdf-viewer:1.0.0-alpha01 e androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Novos recursos

A versão Alfa inicial de PDFViewer inclui implementações de pré-lançamento antecipado que permitem cenários de leitura de PDF. No momento, o PdfViewerFragment tem suporte apenas para versões do Android V (SDK 35). O suporte para versões mais antigas do Android será adicionado nas próximas versões.

  • O PdfViewerFragment foi introduzido. Ele pode ser usado pelo app para renderizar um documento PDF. O PdfViewerFragment simplifica a integração de um visualizador de PDF na sua atividade e permite que os usuários interajam das seguintes maneiras:
    • Zoom: faça um gesto de pinça para ajustar os níveis de zoom e ter uma experiência de leitura confortável. Também é possível tocar duas vezes para aumentar/diminuir o zoom rapidamente e voltar ao estado padrão.
    • Navegação: role no estado padrão/com zoom. PdfViewerFragment oferece um seletor rápido para rolar rapidamente entre as páginas.
    • Ações de texto: tocar e manter pressionado o texto para selecioná-lo, permitindo que os usuários usem opções como "Copiar" e "Selecionar tudo" na página atual.
    • Documentos protegidos por senha: PdfViewerFragment fornece uma caixa de diálogo para o usuário inserir a senha e abrir o documento.
    • Hiperlinks navegáveis: os usuários podem navegar até URLs da Web ou favoritos tocando em hiperlinks no PDF.
    • Atalho para o modo de anotações: o modo de edição ainda não é compatível com PdfViewerFragment. Em vez disso, PdfViewerFragment mostra um FloatingActionButton que aciona uma intent android.intent.action.ANNOTATE implícita com o URI do documento.

Mudanças na API

  • Adicionamos a propriedade PdfViewerFragment.documentUri para definir um URI de conteúdo ou arquivo para o documento e iniciar o carregamento dele. PdfViewerFragment mostra um ícone de carregamento quando o URI é definido, indicando o processamento em segundo plano do documento.
  • PdfViewerFragment.isTextSearchActive foi adicionado para alternar a visibilidade do menu "Encontrar no arquivo". PdfViewerFragment processa todo o fluxo, permitindo a entrada, exibindo o número total de correspondências, permitindo a navegação entre os resultados e saindo deles.
  • Foram adicionados callbacks onDocumentLoadSuccess e onDocumentLoadError que são invocados após a renderização bem-sucedida do documento ou após um erro ser gerado antes da renderização.

Problemas conhecidos

  • A barra "Encontrar no arquivo" se sobrepõe ao FloatingActionButton em alguns casos.
  • O ícone FloatingActionButton não aparece em PDFs de página única.
  • A contagem de resultados não é preservada na mudança de configuração no menu "Encontrar no arquivo".
  • O menu "Encontrar no arquivo" fica piscando ao fechar.
  • As imagens 3D em documentos PDF não são renderizadas no visualizador.
  • Os recursos de acessibilidade serão ativados nas próximas versões.
  • A imagem do PDF fica desfocada ao girar de retrato para paisagem.
  • Não há suporte para anotações de texto/destaque.
  • O PdfViewerFragment tem alguns problemas de desempenho em documentos PDF muito grandes (mais de 250 MB).

Observação

  • Atualização de compileSdk para 35 5dc41be