Import and export annotations in XFDF using Swift for iOS

1
//
2
//  Copyright © 2014-2026 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
// MARK: - XFDF Annotation Provider
12

13
class XFDFAnnotationProviderExample: Example {
14

15
    override init() {
16
        super.init()
17
        contentDescription = "XFDF is an XML-based Adobe standard and is well suited for importing and exporting for integration with third-party PDF applications."
18
        category = .annotationProviders
19
        priority = 80
20
    }
21

22
    // This example shows how you can create an XFDF provider instead of the default file-based one.
23
    // XFDF is an industry standard and the file will be interoperable with Adobe Acrobat or any other standards-compliant PDF framework.
24
    override func invoke(with delegate: ExampleRunnerDelegate?) -> UIViewController? {
25
        let documentURL = AssetLoader.assetURL(for: .annualReport)
26

27
        // Load from an example XFDF file.
28
        let docsFolder = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
29
        let fileXML = docsFolder.appendingPathComponent("XFDFTest.xfdf")
30
        print("Using XFDF file at \(fileXML.path)")
31

32
        // DEBUG HELPER: Delete the existing file.
33
        // try? FileManager.default.removeItem(at: fileXML)
34

35
        // Create an example XFDF from the current document if one doesn't already exist.
36
        if !FileManager.default.fileExists(atPath: fileXML.path) {
37
            // Collect all existing annotations from the document.
38
            let tempDocument = Document(url: documentURL)
39
            let annotations = tempDocument.allAnnotations(of: .all).values.flatMap { $0 }
40

41
            // Write the annotations to the disk creating a new XFDF file.
42
            do {
43
                let dataSink = try FileDataSink(fileURL: fileXML)
44
                try XFDFWriter().write(annotations, to: dataSink, documentProvider: tempDocument.documentProviders.first!)
45
            } catch {
46
                print("Failed to write XFDF file: \(error.localizedDescription)")
47
                return nil
48
            }
49
        }
50

51
        // Create document and set up the XFDF provider.
52
        let document = Document(url: documentURL)
53
        document.annotationSaveMode = .externalFile
54
        document.didCreateDocumentProviderBlock = { documentProvider in
55
            let XFDFProvider = XFDFAnnotationProvider(documentProvider: documentProvider, fileURL: fileXML)
56
            // Note that if the document you're opening has form fields which you wish to be usable when using XFDF, you should also add the file annotation
57
            // provider to the annotation manager's `annotationProviders` array:
58
            //
59
            // let fileProvider = documentProvider.annotationManager.fileAnnotationProvider!
60
            // documentProvider.annotationManager.annotationProviders = [XFDFProvider, fileProvider]
61

62
            documentProvider.annotationManager.annotationProviders = [XFDFProvider]
63
        }
64

65
        let controller = PDFViewController(document: document)
66

67
        let saveButton = UIBarButtonItem(title: "Save", primaryAction: UIAction { _ in
68
            document.save { result in
69

70
                switch result {
71
                case .success:
72
                    let attributes = try? Foundation.FileManager.default.attributesOfItem(atPath: fileXML.path)
73
                    let XFDFFileSize = attributes?[.size] as? UInt64 ?? 0
74
                    print("Saving done. (XFDF file size: \(XFDFFileSize) bytes)")
75

76
                case .failure(let error):
77
                    print("Saving failed: \(error.localizedDescription)")
78
                }
79
            }
80
        })
81
        controller.navigationItem.leftBarButtonItems = [controller.closeButtonItem, saveButton]
82
        return controller
83
    }
84
}