File Provider Extension: τι είναι και πώς λειτουργεί ο παροχέας αρχείων iOS

Τι είναι το File Provider Extension στο iOS

File Provider Extension είναι μια επέκταση εφαρμογής που προσθέτει νέες πηγές εγγράφων στην εφαρμογή Αρχεία. Μια υπηρεσία cloud — Google Drive, Dropbox, OneDrive ή εταιρική αποθήκη — μπορεί να εμφανίσει τη δομή αρχείων της απευθείας στη διεπαφή συστήματος, χωρίς να ανοίξει μια ξεχωριστή εφαρμογή.

Ο χρήστης εργάζεται με απομακρυσμένα αρχεία ακριβώς όπως με αυτά που είναι αποθηκευμένα στη συσκευή: περιηγείται το περιεχόμενο των φακέλων, σύρει έγγραφα, τα ανοίγει σε οποιαδήποτε συμβατή εφαρμογή και αποθηκεύει τις αλλαγές πίσω στο cloud. Σύμφωνα με το WWDC 2025, το File Provider Extension υποστηρίζει έως 1000 ταυτόχρονες λειτουργίες συγχρονισμού και προσαρμόζεται στην ταχύτητα δικτύου μέσω δυναμικής διαχείρισης προτεραιοτήτων.

Η επέκταση λειτουργεί στο προσκήνιο — το iOS την εκκινεί όταν χρειαστεί συγχρονισμός και μπορεί να την τερματίσει βιαιστικά όταν υπάρχει έλλειψη πόρων. Όλες οι λειτουργίες πρέπει να είναι αδιαφοροποιητικές και να υποστηρίζουν τη συνέχιση από ένα σημείο ελέγχου.

Αρχιτεκτονική και μηχανισμός συγχρονισμού αρχείων

File Provider Extension έχει τριεπίπεδη αρχιτεκτονική: η διεργασία συστήματος Files.app, η επέκταση-παροχέας και ο απομακρυσμένος διακομιστής. Το σύστημα ζητά δεδομένα από την επέκταση, η επέκταση μετατρέπει τα αιτήματα σε κλήσεις API της υπηρεσίας cloud και επιστρέφει αποτελέσματα μέσω NSFileProviderItem.

Αυζητικός συγχρονισμός

Αντί να φορτώνει όλη τη δομή αρχείων σε κάθε ενημέρωση, η επέκταση μεταφέρει μόνο τα τροποποιημένα στοιχεία. Το NSFileProviderManager παρέχει μεθόδους για αποστολή αυξητικών ενημερώσεων — “το αρχείο A προστέθηκε”, “το αρχείο B τροποποιήθηκε”, “ο φάκελος C διαγράφηκε”. Αυτό μειώνει δραστικά την κυκλοφορία και επιταχύνει την εμφάνιση των αλλαγών.

Σύμφωνα με το Apple Engineering, ο αυζητικός συγχρονισμός μειώνει τον όγκο των μεταφερόμενων δεδομένων κατά 60–80% σε σύγκριση με την πλήρη επαναφόρτωση. Συνιστάται η χρήση του NSFileProviderSyncAnchor για σήμανση της κατάστασης συγχρονισμού και ελαχιστοποίηση των διπλών αιτημάτων.

Λερπσρίο στη συσκευή

File Provider Extension μπορεί να αποθηκεύει τοπικά αρχεία στη λερπσρίο για σύνδεση χωρίς σύνδεση. Κατά το άνοιγμα ενός αρχείου, το σύστημα στέλνει αίτημα στην επέκταση, η επέκταση αποφασίζει — να κατεβάσει το περιεχόμενο από τον διακομιστή ή να επιστρέψει την ήδη αποθηκευμένη στη λερπσρίο έκδοση. Το NSFileProviderItem υποδεικνύει το επίπεδο λερπσρίου μέσω των πεδίων isDownloaded και isUploaded.

Η Apple συνιστά τη διαμόρφωση πολιτικής λερπσρίου ανάλογα με το μέγεθος των αρχείων: για εικόνες και έγγραφα — πλήρης αποθήκευση στη λερπσρίο, για βίντεο — μόνο προεπισκόπηση, για αρχεία — κατόπιν αιτήματος του χρήστη.

NSFileProviderManager: διαχείριση του παροχέα αρχείων

NSFileProviderManager είναι η κεντρική κλάση μέσω της οποίας η επέκταση επικοινωνεί με το σύστημα. Παρέχει μεθόδους για ειδοποίηση του συστήματος σχετικά με αλλαγές, δημιουργία νέων στοιχείων, διαχείριση λήψεων και χειρισμό σφαλμάτων. Κάθε παράδειγμα NSFileProviderManager είναι συνδεδεμένο με ένα συγκεκριμένο τομέα.

Βασικές μέθοδοι

signalEnumerator(for:) — ειδοποιεί το σύστημα ότι το περιεχόμενο ενός φακέλου έχει αλλάξει και πρέπει να διαβαστεί ξανά. reimportItem(_:) — επανεισάγει το καθορισμένο στοιχείο μετά από αλλαγή στον διακομιστή. registerURLSessionTask:forItemWithIdentifier: — συνδέει μια λήψη στο προσκήνιο με ένα συγκεκριμένο αρχείο για παρακολούθηση της προόδου.

Σημαντικός περιορισμός: το NSFileProviderManager λειτουργεί μόνο στη διεργασία της επέκτασης. Η κύρια εφαρμογή δεν μπορεί να καλέσει άμεσα τις μεθόδους του για διαχείριση της δομής αρχείων — ο συγχρονισμός πρέπει να ξεκινά από την επέκταση ή το σύστημα.

let manager = NSFileProviderManager.default()
manager.signalEnumerator(for: workingSet) { error in
    if let error = error {
        print("Signal failed: \(error)")
    }
}

Διαχείριση λήψεων

Για λήψη αρχείων στο προσκήνιο, το NSFileProviderManager χρησιμοποιεί URLSession με διαμόρφωση προσκηνίου. Η επέκταση δημιουργεί μια εργασία λήψης και την καταχωρίζει στον διαχειριστή, ο οποίος τη συνδέει με το αντίστοιχο στοιχείο. Το σύστημα παρακολουθεί αυτόματα την πρόοδο και τις προτεραιότητες των λήψεων βάσει της δραστηριότητας του χρήστη.

Υλοποίηση του File Provider Extension

Η δημιουργία ενός File Provider Extension ξεκινά με την προσθήκη ενός νέου target στο Xcode με το πρότυπο File Provider Extension. Το Xcode δημιουργεί αυτόματα μια κλάση που κληρονομεί από το NSFileProviderExtension και ένα ελάχιστο σύνολο μεθόδων για εργασία με στοιχεία.

NSFileProviderItem και μεταδεδομένα

Κάθε στοιχείο της δομής αρχείων — αρχείο ή φάκελος — υλοποιεί το πρωτόκολλο NSFileProviderItem. Το πρωτόκολλο καθορίζει τα υποχρεωτικά πεδία: itemIdentifier, parentItemIdentifier, filename, typeIdentifier και capabilities. Προαιρετικά μπορούν να καθοριστούν το μέγεθος, η ημερομηνία τροποποίησης και οι σημαίες λήψης.

struct CloudItem: NSFileProviderItem {
    let itemIdentifier: NSFileProviderItemIdentifier
    let parentItemIdentifier: NSFileProviderItemIdentifier
    let filename: String
    let typeIdentifier: String
    let capabilities: NSFileProviderItemCapabilities
    let documentSize: NSNumber?
}

Χειρισμός αιτημάτων απαρίθμησης

Η μέθοδος enumerator(for:) επιστρέφει ένα αντικείμενο που υλοποιεί το NSFileProviderEnumerator, το οποίο παρέχει το περιεχόμενο του φακέλου κατόπιν αιτήματος του συστήματος. Το iOS μπορεί να ζητήσει απαρίθμηση για τον ριζικό φάκελο, υποφακέλους και το σύνολο εργασίας — το τελευταίο χρησιμοποιείται για εμφάνιση πρόσφατων ή αγαπημένων αρχείων.

Η Apple συνιστά τη χρήση ασύγχρονων μεθόδων απαρίθμησης με σελιδοποίηση μέσω NSFileProviderPage για να αποφεύγεται η φόρτωση χιλιάδων στοιχείων ταυτόχρονα. Σελίδες 50–100 στοιχείων είναι βαστες για απόδοση.

Τομείς και αρχιτεκτονική πολλαπλών λογαριασμών

NSFileProviderDomain είναι ένας μηχανισμός για τον διαχωρισμό διαφορετικών λογαριασμών μέσα σε μία επέκταση. Εάν ο χρήστης έχει εξουσιοδοτήσει πολλαπλούς λογαριασμούς στην εφαρμογή — προσωπικό και εταιρικό Google Drive — κάθε λογαριασμός δημιουργεί ένα ξεχωριστό τομέα που εμφανίζεται ως ανεξάρτητη πηγή στην εφαρμογή Αρχεία.

Κάθε τομέας έχει ένα μοναδικό αναγνωριστικό, ένα όνομα εμφάνισης και μια κατάσταση. Ο χρήστης μπορεί να απενεργοποιήσει προσωρινά τομείς ή να τους διαγράψει χωρίς να επηρεάσει άλλους λογαριασμούς. Το σύστημα εκκινεί ξεχωριστή διεργασία επέκτασης για κάθε ενεργό τομέα, εξασφαλίζοντας την απόμονωση δεδομένων μεταξύ λογαριασμών.

Σύμφωνα με την Apple, συνιστάται να μην δημιουργείτε πάνω από 10 τομείς ανά επέκταση — ο υπερβολικός αριθμός επιβραδύνει την εκκίνηση της εφαρμογής Αρχεία και αυξάνει την κατανάλωση μνήμης. Για υπηρεσίες με μεγάλο αριθμό λογαριασμών, είναι καλύτερο να τους συγκεντρώσετε σε ένα τομέα με εναλλαγή προφίλ μέσα στην επέκταση.

let domain = NSFileProviderDomain(
    identifier: "work",
    displayName: "Corporate Drive"
)
NSFileProviderManager.add(domain) { error in
    if let error = error {
        print("Failed to add domain: \(error)")
    }
}