pdf

  
Uma biblioteca para adicionar recursos de visualização de PDF nos apps.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
4 de setembro de 2024 - - - 1.0.0-alpha02

Declarar dependências

Para adicionar uma dependência a um 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-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 com a imagem desfocada em PDF ao alternar do modo retrato para paisagem e o app entrar no modo de suspensão foi resolvido.
  • O menu "Localizar no arquivo" agora mantém a contagem de resultados mesmo quando a configuração muda.
  • O ícone do FloatingActionButton agora está disponível para PDFs de página única.
  • Correção de problemas sobrepostos entre a barra "Localizar no arquivo" e o FloatingActionButton.
  • Anotações de texto e destaque agora podem ser renderizadas no visualizador.
  • Fizemos melhorias na acessibilidade da barra "Encontrar no arquivo".
  • Correções de interface foram implementadas para rotação, incluindo a preservação da contagem de localização, o tratamento do menu de seleção de texto que desapareceu e a resolução do problema de sobreposição do FAB.
  • O menu "Localizar no arquivo" 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.
  • PdfViewerFragment tem problemas de desempenho em documentos PDF muito grandes (> 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 do PDFViewer inclui implementações de pré-lançamento antecipado que permitem os principais cenários de leitura de PDF. No momento, o PdfViewerFragment só tem suporte nas versões do Android V (SDK 35). A compatibilidade com versões mais antigas do Android será adicionada nas próximas versões.

  • Introdução de PdfViewerFragment, que seu app pode usar para renderizar um documento PDF. O PdfViewerFragment simplifica a integração de um visualizador de PDF à sua atividade e permite que os usuários interajam das seguintes maneiras:
    • Aumentando o zoom: faça o gesto de pinça para ajustar os níveis de zoom e proporcionar uma experiência de leitura confortável. Você também pode tocar duas vezes para aumentar ou diminuir o zoom rapidamente para o estado padrão.
    • Navegação: role no estado padrão/com zoom. O PdfViewerFragment fornece uma barra de progressão rápida para rolar rapidamente entre as páginas.
    • Ações de texto: tocar e manter pressionado o texto seleciona o texto. Assim, os usuários podem usar opções como "Copiar" e "Selecionar tudo" na página atual.
    • Documentos protegidos por senha: o PdfViewerFragment oferece uma caixa de diálogo para o usuário inserir a senha e abrir o documento.
    • Hiperlinks navegáveis: os usuários podem navegar para 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 está disponível no PdfViewerFragment. Em vez disso, PdfViewerFragment exibe uma FloatingActionButton que dispara uma intent android.intent.action.ANNOTATE implícita com o URI do documento.

Mudanças na API

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

Problemas conhecidos

  • A função de localização na barra de arquivos se sobrepõe ao FloatingActionButton em alguns casos.
  • O ícone do FloatingActionButton não é visível em PDFs de página única.
  • A contagem de resultados não é preservada quando a configuração muda no menu "Localizar no arquivo".
  • Observamos uma tremulação ao fechar o menu "Localizar no arquivo"
  • 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 em PDF fica desfocada ao girar do modo retrato para paisagem.
  • As anotações de texto/destaque não são compatíveis.
  • PdfViewerFragment tem problemas de desempenho em documentos PDF muito grandes (> 250 MB)

Observação

  • Atualize o compileSdk para 35 5dc41be.