Customize PDF Sharing Options in Swift for iOS

1
//
2
//  Copyright © 2018-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
class CustomSharingOptionsExample: Example {
12

13
    var pdfController: PDFViewController!
14
    var document: Document!
15
    var otherDocument: Document!
16

17
    override init() {
18
        super.init()
19

20
        title = "Custom Sharing Options"
21
        contentDescription = "Customzies the sharing options for documents in different ways."
22
        category = .sharing
23
        priority = 900
24
    }
25

26
    override func invoke(with delegate: ExampleRunnerDelegate) -> UIViewController {
27
        document = AssetLoader.document(for: .welcome)
28
        otherDocument = AssetLoader.document(for: .annualReport)
29

30
        pdfController = PDFViewController(document: document)
31

32
        let shareButton = UIBarButtonItem(image: SDK.imageNamed("share"), style: .done, target: self, action: #selector(shareButtonTapped(sender:)))
33

34
        /// This button works similarly to that of exporting multiple documents,
35
        /// but the PDFDocumentSharingViewController delegate implemented below is called.
36
        /// In the delegate callback below, you can also access the files about to be exported.
37
        let onlyExportButton = UIBarButtonItem(title: "Only Export the Files", style: .done, target: self, action: #selector(CustomSharingOptionsExample.onlyExportFiles(sender:)))
38

39
        pdfController.navigationItem.rightBarButtonItems = [shareButton, onlyExportButton]
40
        return pdfController
41
    }
42

43
    @objc
44
    fileprivate func shareButtonTapped(sender: Any) {
45
        guard let sender = sender as? UIBarButtonItem else {
46
            return
47
        }
48

49
        let alertController = UIAlertController(title: nil, message: nil, preferredStyle: .actionSheet)
50
        alertController.popoverPresentationController?.barButtonItem = sender
51

52
        // Add Email option if available
53
        if MFMailComposeViewController.canSendMail() {
54
            let emailAction = UIAlertAction(title: "Email", style: .default) { _ in
55
                self.emailTapped(sender: sender)
56
            }
57
            alertController.addAction(emailAction)
58
        }
59

60
        // Add Export option
61
        let exportAction = UIAlertAction(title: "Export", style: .default) { _ in
62
            self.exportTapped(sender: sender)
63
        }
64
        alertController.addAction(exportAction)
65

66
        // Add Multiple Documents option
67
        let multipleDocumentsAction = UIAlertAction(title: "Multiple Documents", style: .default) { _ in
68
            self.exportMultipleDocuments(sender: sender)
69
        }
70
        alertController.addAction(multipleDocumentsAction)
71

72
        // Cancel
73
        let cancelAction = UIAlertAction(title: "Cancel", style: .cancel)
74
        alertController.addAction(cancelAction)
75

76
        // Present the alert
77
        pdfController.present(alertController, animated: true)
78
    }
79

80
    @objc
81
    fileprivate func emailTapped(sender: Any) {
82
        let sharingConfiguration = DocumentSharingConfiguration {
83
            $0.destination = .email
84
            $0.annotationOptions.remove(.embed)
85
        }
86

87
        let shareController = PDFDocumentSharingViewController(documents: [document], sharingConfigurations: [sharingConfiguration])
88
        shareController.present(from: pdfController, sender: sender)
89
    }
90

91
    @objc
92
    fileprivate func exportTapped(sender: Any) {
93
        let sharingConfiguration = DocumentSharingConfiguration {
94
            $0.destination = .export
95
            $0.annotationOptions = [.flatten]
96
        }
97

98
        let shareController = PDFDocumentSharingViewController(documents: [document], sharingConfigurations: [sharingConfiguration])
99
        shareController.present(from: pdfController, sender: sender)
100
    }
101

102
    @objc
103
    fileprivate func exportMultipleDocuments(sender: Any) {
104
        let shareController = PDFDocumentSharingViewController(documents: [document, otherDocument])
105
        shareController.present(from: pdfController, sender: sender)
106
    }
107

108
    @objc
109
    fileprivate func onlyExportFiles(sender: Any) {
110
        let shareController = PDFDocumentSharingViewController(documents: [document, otherDocument])
111
        shareController.delegate = self
112
        shareController.present(from: pdfController, sender: sender)
113
    }
114
}
115

116
extension CustomSharingOptionsExample: PDFDocumentSharingViewControllerDelegate {
117
    internal func documentSharingViewController(_ shareController: PDFDocumentSharingViewController, shouldShare files: [File], toDestination destination: DocumentSharingConfiguration.Destination) -> Bool {
118
        pdfController.dismiss(animated: true, completion: nil)
119

120
        // Retrieve the files and copy them to a safe location
121

122
        return false
123
    }
124
}