Show PDF Download Progress in Swift for iOS

1
//
2
//  Copyright © 2017-2025 PSPDFKit GmbH. All rights reserved.
3
//
4
//  The Nutrient sample applications are licensed with a modified BSD license.
5
//  Please see License for details. This notice may not be removed from this file.
6
//
7

8
import PSPDFKit
9
import PSPDFKitUI
10

11
/// This example showing asynchronous document loading.
12
/// The downloaded document can be modified, such as adding annotations.
13
/// If you don’t need such fine-grained control and the document can be read-only, see the simpler `RemoteDocumentURLExample` instead.
14
class DocumentProgressExample: Example {
15

16
    let destinationFileURL = FileHelper.temporaryPDFFileURL(prefix: "document")
17
    let remoteURL = URL(string: "https://github.com/PSPDFKit/pspdfkit-ios-catalog/raw/master/Samples/Magazine.pdf")!
18
    var downloader: Downloader?
19

20
    override init() {
21
        super.init()
22
        title = "Download and annotate a PDF from a remote URL"
23
        contentDescription = "Downloads a PDF using URLSession. Shows progress using the data provider progress property."
24
        category = .documentDataProvider
25
        priority = 3
26
    }
27

28
    override func invoke(with delegate: ExampleRunnerDelegate) -> UIViewController {
29
        let cancelButton = UIBarButtonItem(title: localizedString("Cancel"), style: .plain, target: self, action: #selector(cancelButtonPressed))
30

31
        downloader?.cleanup()
32
        downloader = Downloader(remoteURL: remoteURL, destinationFileURL: destinationFileURL)
33
        downloader?.didFinishDownloading = { _ in
34
            cancelButton.isEnabled = false
35
        }
36

37
        // Configure the data provider with our NSProgress instance.
38
        let provider = CoordinatedFileDataProvider(fileURL: destinationFileURL, progress: downloader?.progress)
39
        let document = Document(dataProviders: [provider])
40
        let controller = PDFViewController(document: document)
41

42
        controller.navigationItem.setRightBarButtonItems([cancelButton] + controller.navigationItem.rightBarButtonItems!, animated: false)
43

44
        return controller
45
    }
46

47
    @objc func cancelButtonPressed(sender: UIBarButtonItem?) {
48
        sender?.isEnabled = false
49
        guard let downloader = self.downloader else { return }
50
        downloader.progress.cancel()
51
        downloader.cleanup()
52
    }
53
}
54

55
class Downloader: NSObject {
56

57
    let progress = Progress(totalUnitCount: 100)
58
    let downloadProgress = Progress(totalUnitCount: 1)
59
    let moveProgress = Progress(totalUnitCount: 1)
60

61
    let destinationFileURL: URL
62
    let remoteURL: URL
63

64
    var session: URLSession?
65
    var task: URLSessionDownloadTask?
66

67
    var didFinishDownloading: ((_ location: URL) -> Void)?
68

69
    init(remoteURL: URL, destinationFileURL: URL) {
70
        self.remoteURL = remoteURL
71
        self.destinationFileURL = destinationFileURL
72

73
        super.init()
74

75
        // Download the file using URLSession API.
76
        let session = URLSession(configuration: URLSessionConfiguration.default, delegate: self, delegateQueue: OperationQueue.main)
77
        self.session = session
78
        let task = session.downloadTask(with: remoteURL)
79
        self.task = task
80
        task.resume()
81

82
        // Setup progress hierarchy. The download should take much longer than the final move.
83
        progress.addChild(downloadProgress, withPendingUnitCount: 99)
84
        progress.addChild(moveProgress, withPendingUnitCount: 1)
85
    }
86

87
    func cleanup() {
88
        do {
89
            task?.cancel()
90
            session?.invalidateAndCancel()
91

92
            try FileManager().removeItem(at: destinationFileURL)
93
        } catch {
94
            print(error)
95
        }
96
    }
97
}
98

99
extension Downloader: URLSessionDelegate, URLSessionDownloadDelegate {
100

101
    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
102
        do {
103
            try FileManager().moveItem(at: location, to: destinationFileURL)
104
            // We must ensure that the complete progress (`progress`) only completes when the file is already at its final location.
105
            moveProgress.completedUnitCount = moveProgress.totalUnitCount
106
            didFinishDownloading?(location)
107
        } catch {
108
            print(error)
109
        }
110
    }
111

112
    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didWriteData bytesWritten: Int64, totalBytesWritten: Int64, totalBytesExpectedToWrite: Int64) {
113
        downloadProgress.totalUnitCount = totalBytesExpectedToWrite
114
        downloadProgress.completedUnitCount = totalBytesWritten
115
    }
116

117
    func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) {
118
        if let error {
119
            print(error.localizedDescription)
120
            // Complete the progress.
121
            progress.completedUnitCount = progress.totalUnitCount
122
        }
123
    }
124
}