pdf

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:

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

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

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-alpha09

7 de maio de 2025

Lançamento de androidx.pdf:pdf-*:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estas confirmações.

Principais mudanças

• A base de código passou por uma grande refatorização e agora está totalmente escrita em Kotlin, usando corrotinas e ViewModel. Isso inclui uma nova implementação do PdfViewerFragment. Esta versão não inclui APIs ou recursos novos.

Problemas conhecidos:

• O scroller rápido e o indicador de página não têm efeitos de sombra.
• Documentos PDF de uma página nem sempre são centralizados e dimensionados para a largura da visualização.

Mudanças na API

• Inclua a anotação @StyleRes na containerStyleResId. (I88d85).

Versão 1.0.0-alpha08

12 de março de 2025

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

Correções de bugs

• A posição inconsistente do menu de seleção foi resolvida entre diferentes dispositivos Android devido a diferenças de escalonamento. O posicionamento do menu de seleção agora é consistente em todos os dispositivos.
• A posição do indicador de página e do controle de rolagem rápida foram alinhadas na recriação de fragmentos em cenários como mudança de configuração etc.

Versão 1.0.0-alpha07

26 de fevereiro de 2025

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

Novos recursos

• Agora, o PdfViewerFragment oferece suporte a StylingOptions (um conjunto de IDs de recursos de estilo), permitindo o estilo personalizado por newInstance ou XML (FragmentContainerView). As subclasses podem usar o construtor protegido para uma funcionalidade semelhante.
• No momento, StylingOptions usa containerStyle, que oferece:
  • Suporte a drawable personalizado para a alça de rolagem rápida e o indicador de página.
  • Atributo marginEnd para posicionamento preciso da alça de rolagem rápida e do indicador de página.

Mudanças na API

• Atributos públicos foram adicionados de PdfView (I30fc5).
• Foram adicionadas novas APIs StylingOptions para visualização de PDF. (Id2993).

Correções de bugs

• Correção de discrepância de sincronização entre a alça de rolagem rápida e o estado de visibilidade do indicador da página.

Versão 1.0.0-alpha06

29 de janeiro de 2025

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

Correções de bugs

• Correção: falha causada por IllegalArgumentException ao desvincular um serviço que não está registrado (eb4e85).
• Correção: falha IllegalArgumentException devido à diferença entre mMaxPages e numPages. (75d763).

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 o seguinte argumento do compilador para aplicar o uso correto: -Xjspecify-annotations=strict (este é o padrão a partir da versão 2.1.0 do compilador Kotlin). (I38301, b/326456246).
• Correção de um problema em que a página aberta anteriormente era mostrada 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 do 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.
• 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 resoluçã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.
• 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 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 leitor de PDF na sua atividade e permite que os usuários interajam das seguintes maneiras:
  • Zoom: faça o 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.
• PdfViewerFragment tem alguns problemas de desempenho em documentos PDF muito grandes (mais de 250 MB)

Observação

• Atualização de compileSdk para 35 5dc41be