Быстрый PDF вьюер для iOS: лучшие практики 2025

Как создать быстрый и легкий PDF-вьюер для iOS в 2025 году

Если вы когда-нибудь пытались загрузить PDF-файл в ваше iOS-приложение и получали тормозящий интерфейс или зависание на больших документах, вы не одиноки. Вопрос «Fast and Lean PDF Viewer for iPhone / iPad / iOS - tips and hints?» собрал тысячи просмотров на Stack Overflow. Разработчики по всему миру ищут рецепт, как сделать просмотр PDF не просто работающим, а молниеносным и плавным. В этой статье мы разберем лучшие практики 2025 года, основанные на реальном опыте и современных возможностях Swift. Вы узнаете, как избежать типичных ошибок, оптимизировать память и создать вьюер, который будет работать как часы даже на старых устройствах.

Почему стандартный PDF-вьюер часто тормозит

Многие разработчики начинают с использования UIWebView или WKWebView для отображения PDF. Это самый простой путь, но он же и самый ресурсоемкий. WebView загружает целый браузерный движок, который потребляет много оперативной памяти. На больших документах (100+ страниц) это может привести к вылету приложения. Альтернатива — PDFKit, встроенный фреймворк Apple, который появился еще в iOS 11. Он оптимизирован для работы с PDF и использует аппаратное ускорение. Однако даже с PDFKit можно допустить ошибки, которые замедлят работу. Давайте разберемся, как этого избежать.

Основы: настройка PDFView

Сердцем любого PDF-вьюера на iOS является класс PDFView из фреймворка PDFKit. Вот минимальный пример его настройки в Swift:

import PDFKit
import UIKit

class PDFViewController: UIViewController {
    
    var pdfView: PDFView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        pdfView = PDFView(frame: view.bounds)
        pdfView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        view.addSubview(pdfView)
        
        // Настройка отображения
        pdfView.displayMode = .singlePageContinuous
        pdfView.autoScales = true
        pdfView.displayDirection = .vertical
        
        // Загрузка документа
        if let url = Bundle.main.url(forResource: "sample", withExtension: "pdf") {
            if let document = PDFDocument(url: url) {
                pdfView.document = document
            }
        }
    }
}

Этот код создает простой вьюер, который работает неплохо, но далек от идеала. Главный секрет производительности кроется в правильной настройке режимов отображения и управления памятью.

Оптимизация загрузки: ленивая подгрузка страниц

По умолчанию PDFKit загружает все страницы документа в память. Для небольших файлов это нормально, но для больших PDF (например, книги на 500 страниц) это катастрофа. Решение — использовать PDFDocument с настройкой pageDidLoad или, что лучше, отключать кэширование страниц, которые не видны на экране. Однако самый эффективный способ — это ручное управление отображением через PDFPage.

Вот пример, как можно подгружать страницы по мере прокрутки, используя UIScrollViewDelegate:

extension PDFViewController: UIScrollViewDelegate {
    func scrollViewDidScroll(_ scrollView: UIScrollView) {
        guard let currentPage = pdfView.currentPage else { return }
        let pageIndex = currentPage.pageRef?.pageNumber ?? 0
        
        // Освобождаем память для страниц, которые далеко
        let visiblePages = pdfView.visiblePages
        for page in pdfView.document?.pageRefs ?? [] {
            if !visiblePages.contains(page) {
                // Здесь можно очистить кэш рендеринга для page
                // PDFKit сам управляет этим, но мы можем подсказать
            }
        }
    }
}

На практике PDFKit достаточно умен, чтобы не держать в памяти все страницы сразу, если вы используете displayMode = .singlePageContinuous. Но для тонкой настройки вы можете использовать метод pdfView.go(to:) для предзагрузки только нескольких страниц вперед.

Рендеринг на лету: уменьшаем нагрузку на GPU

Каждая страница PDF рендерится в растровое изображение. Если страница содержит сложную графику или векторные элементы, рендеринг может быть тяжелым. Чтобы ускорить этот процесс, используйте PDFPage с низким разрешением для превью, а затем подгружайте полное качество при остановке прокрутки.

Вот пример функции для рендеринга страницы с заданным масштабом:

func renderThumbnail(for page: PDFPage, size: CGSize) -> UIImage? {
    let rect = page.bounds(for: .mediaBox)
    let scale = min(size.width / rect.width, size.height / rect.height)
    let scaledRect = CGRect(x: 0, y: 0, width: rect.width * scale, height: rect.height * scale)
    
    UIGraphicsBeginImageContextWithOptions(scaledRect.size, true, 0.0)
    guard let context = UIGraphicsGetCurrentContext() else { return nil }
    
    context.setFillColor(UIColor.white.cgColor)
    context.fill(scaledRect)
    page.draw(with: .mediaBox, to: context)
    
    let image = UIGraphicsGetImageFromCurrentImageContext()
    UIGraphicsEndImageContext()
    return image
}

Используйте эту функцию для создания миниатюр в коллекции или для быстрой загрузки превью при быстрой прокрутке. Полноценный рендеринг оставьте для момента, когда пользователь остановился на странице.

Работа с памятью: как избежать утечек

PDF-документы могут занимать десятки мегабайт. Если вы держите ссылку на PDFDocument сильно, приложение может вылететь из-за нехватки памяти. Используйте слабые ссылки и очищайте документ, когда он не нужен. Например, при переходе на другой экран:

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    pdfView.document = nil
    pdfView = nil
}

Также полезно использовать autoreleasepool при обработке большого количества страниц в цикле:

for i in 0..

import SwiftUI
import PDFKit

struct PDFKitView: UIViewRepresentable {
    let url: URL
    
    func makeUIView(context: Context) -> PDFView {