Visualizador rápido de PDF para iOS: melhores práticas 2025

Como criar um visualizador de PDF rápido e leve para iOS em 2025

Se você já tentou carregar um arquivo PDF no seu aplicativo iOS e obteve uma interface lenta ou travamento em documentos grandes, você não está sozinho. A pergunta «Fast and Lean PDF Viewer for iPhone / iPad / iOS - tips and hints?» reuniu milhares de visualizações no Stack Overflow. Desenvolvedores ao redor do mundo buscam a receita para tornar a visualização de PDF não apenas funcional, mas rápida e suave. Neste artigo, vamos analisar as melhores práticas de 2025, baseadas em experiência real e nos recursos modernos do Swift. Você aprenderá como evitar erros comuns, otimizar a memória e criar um visualizador que funcione como um relógio, mesmo em dispositivos antigos.

Por que o visualizador de PDF padrão frequentemente trava

Muitos desenvolvedores começam usando UIWebView ou WKWebView para exibir PDF. Este é o caminho mais simples, mas também o que mais consome recursos. O WebView carrega um motor de navegador inteiro, que consome muita memória RAM. Em documentos grandes (100+ páginas), isso pode causar o fechamento do aplicativo. A alternativa é o PDFKit, um framework nativo da Apple que existe desde o iOS 11. Ele é otimizado para trabalhar com PDF e usa aceleração de hardware. No entanto, mesmo com o PDFKit, é possível cometer erros que diminuem a velocidade. Vamos entender como evitar isso.

Fundamentos: configurando o PDFView

O coração de qualquer visualizador de PDF no iOS é a classe PDFView do framework PDFKit. Aqui está um exemplo mínimo de sua configuração em Swift:

import PDFKit\nimport UIKit\n\nclass PDFViewController: UIViewController {\n    \n    var pdfView: PDFView!\n    \n    override func viewDidLoad() {\n        super.viewDidLoad()\n        \n        pdfView = PDFView(frame: view.bounds)\n        pdfView.autoresizingMask = [.flexibleWidth, .flexibleHeight]\n        view.addSubview(pdfView)\n        \n        // Configuração de exibição\n        pdfView.displayMode = .singlePageContinuous\n        pdfView.autoScales = true\n        pdfView.displayDirection = .vertical\n        \n        // Carregar documento\n        if let url = Bundle.main.url(forResource: "sample", withExtension: "pdf") {\n            if let document = PDFDocument(url: url) {\n                pdfView.document = document\n            }\n        }\n    }\n}\n

Este código cria um visualizador simples que funciona razoavelmente, mas está longe do ideal. O segredo principal do desempenho está na configuração correta dos modos de exibição e no gerenciamento de memória.

Otimização de carregamento: carregamento preguiçoso de páginas

Por padrão, o PDFKit carrega todas as páginas do documento na memória. Para arquivos pequenos, isso é normal, mas para PDFs grandes (por exemplo, um livro de 500 páginas), é um desastre. A solução é usar PDFDocument com a configuração pageDidLoad ou, melhor ainda, desabilitar o cache de páginas que não estão visíveis na tela. No entanto, a maneira mais eficaz é o gerenciamento manual da exibição através de PDFPage.

Aqui está um exemplo de como carregar páginas conforme a rolagem, usando UIScrollViewDelegate:

extension PDFViewController: UIScrollViewDelegate {\n    func scrollViewDidScroll(_ scrollView: UIScrollView) {\n        guard let currentPage = pdfView.currentPage else { return }\n        let pageIndex = currentPage.pageRef?.pageNumber ?? 0\n        \n        // Libera memória para páginas distantes\n        let visiblePages = pdfView.visiblePages\n        for page in pdfView.document?.pageRefs ?? [] {\n            if !visiblePages.contains(page) {\n                // Aqui você pode limpar o cache de renderização para page\n                // O PDFKit gerencia isso, mas podemos sugerir\n            }\n        }\n    }\n}\n

Na prática, o PDFKit é inteligente o suficiente para não manter todas as páginas na memória de uma vez, se você usar displayMode = .singlePageConti