Confirguring PDF Reader 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 uses the following Nutrient features:
12
/// - Viewer
13
/// - Annotations
14
/// - Document Editor
15
/// - Reader View
16
///
17
/// See https://www.nutrient.io/sdk/ios for the complete list of Nutrient iOS SDK’s features.
18

19
class EreaderExample: IndustryExample {
20

21
    var pdfController: PDFViewController!
22

23
    override init() {
24
        super.init()
25

26
        title = "E-Reader"
27
        contentDescription = "Shows how to configure Nutrient as an e-reader."
28
        category = .industryExamples
29
        targetDevice = [.vision, .phone, .pad]
30
        priority = 4
31
        wantsModalPresentation = true
32
        customizations = { container in
33
            container.modalPresentationStyle = .fullScreen
34
        }
35
        extendedDescription = "This example shows how to customize document viewing options to create an optimum user experience for reading research papers."
36
        url = URL(string: "https://www.nutrient.io/blog/industry-solution-ereader-ios/")!
37
        image = UIImage(systemName: "doc.richtext")
38
    }
39

40
    override func invoke(with delegate: ExampleRunnerDelegate) -> UIViewController? {
41
        return EreaderPDFViewController(with: self)
42
    }
43
}
44

45
private class EreaderPDFViewController: PDFViewController {
46

47
    /// Used for showing the more info alert.
48
    private var moreInfo: MoreInfoCoordinator!
49

50
    init(with example: IndustryExample) {
51
        let document = AssetLoader.writableDocument(for: .psychologyResearch, overrideIfExists: false)
52
        document.autodetectTextLinkTypes = .all
53

54
        let configuration = PDFConfiguration {
55
            // Configure the document presentation options.
56
            // See https://www.nutrient.io/guides/ios/customizing-the-interface/document-presentation-options/ for more details.
57
            $0.pageTransition = .scrollContinuous
58
            $0.scrollDirection = .vertical
59

60
            // Miscellaneous configuration options.
61
            $0.isRenderAnimationEnabled = false
62
            $0.shouldHideNavigationBarWithUserInterface = false
63
            $0.shouldHideStatusBarWithUserInterface = false
64
        }
65

66
        super.init(document: document, configuration: configuration)
67

68
        // Customize the toolbar.
69
        // See https://www.nutrient.io/guides/ios/customizing-the-interface/customizing-the-toolbar/ for more details.
70
        moreInfo = MoreInfoCoordinator(with: example, presentationContext: self)
71

72
        #if os(visionOS)
73
        setMainToolbarOrnamentItems([backOrnamentItem, moreInfo.barOrnamentItem, titleOrnamentItem, readerViewOrnamentItem, annotationToolsOrnamentItem, shareOrnamentItem, outlineOrnamentItem, searchOrnamentItem, thumbnailsOrnamentItem], for: .document)
74
        #else
75
        navigationItem.setLeftBarButtonItems([moreInfo.barButton, brightnessButtonItem, readerViewButtonItem], for: .document, animated: false)
76
        setUpdateSettingsForBoundsChange { [weak self] _ in
77
            self?.updateBarButtonItems()
78
        }
79
        #endif
80
    }
81

82
    required init?(coder: NSCoder) {
83
        fatalError("init(coder:) has not been implemented")
84
    }
85

86
    override func viewWillAppear(_ animated: Bool) {
87
        super.viewWillAppear(animated)
88
        updateBarButtonItems()
89
    }
90

91
    override func viewDidAppear(_ animated: Bool) {
92
        super.viewDidAppear(animated)
93
        moreInfo.showAlertIfNeeded()
94
    }
95

96
    // MARK: Customization
97

98
    private func updateBarButtonItems() {
99
        let availableWidth = view.bounds.inset(by: view.safeAreaInsets).width
100

101
        // Show more items on wide screens. 430 is the minimum width needed to show 9 items including the close button.
102
        if availableWidth > 430 {
103
            navigationItem.setRightBarButtonItems([thumbnailsButtonItem, searchButtonItem, outlineButtonItem, activityButtonItem, annotationButtonItem], for: .document, animated: false)
104
        } else {
105
            navigationItem.setRightBarButtonItems([thumbnailsButtonItem, annotationButtonItem], for: .document, animated: false)
106
        }
107
    }
108
}