File Provider Extension: ano ito at paano gumagana ang tagapagbigay ng file ng iOS

Ano ang File Provider Extension sa iOS

File Provider Extension ay isang extension ng application na nagdaragdag ng mga bagong mapagkukunan ng dokumento sa application na Files. Ang isang serbisyo ng cloud — Google Drive, Dropbox, OneDrive o corporate storage — ay maaaring magpakita ng istraktura ng file nito nang direkta sa system interface, nang hindi binubuksan ang isang hiwalay na application.

Ang user ay gumagana sa mga malalayong file nang eksakto tulad ng sa mga naka-save sa device: tumitingin ng nilalaman ng folder, nag-drag ng mga dokumento, nagbubukas ng mga ito sa anumang katugmang application at nag-save ng mga pagbabago pabalik sa cloud. Ayon sa WWDC 2025, sinusuportahan ng File Provider Extension ang hanggang 1000 sabay-sabay na pag-sync na operasyon at umaangkop sa bilis ng network sa pamamagitan ng dynamic na pamamahala ng priyoridad.

Ang extension ay gumagana sa background — inilulunsad ito ng iOS kapag kinakailangan ang pag-sync at maaaring pilitin itong tapusin kapag kulang ang mga mapagkukunan. Ang lahat ng operasyon ay dapat na idempotent at sumusuporta sa pagpapatuloy mula sa isang checkpoint.

Arkitektura at mekanismo ng pag-sync ng file

File Provider Extension ay may tatlong antas na arkitektura: system process Files.app, provider-extension at malayuang server. Humihingi ang system ng data mula sa extension, ginagawang API tawag ng cloud service ang extension at ibinabalik ang mga resulta sa pamamagitan ng NSFileProviderItem.

Incremental na pag-sync

Sa halip na i-load ang buong istraktura ng file sa bawat pag-update, ang extension ay nagpapadala lamang ng mga nabagong elemento. Nagbibigay ang NSFileProviderManager ng mga pamamaraan para sa pagpapadala ng mga incremental na update — “nadagdag ang file A”, “nabago ang file B”, “nataggal ang folder C”. Ito ay lubhang nagbabawas ng trapiko at pinapabilis ang pagpapakita ng mga pagbabago.

Ayon sa Apple Engineering, ang incremental na pag-sync ay nagbabawas ng dami ng ipinadalang data ng 60–80% kumpara sa buong pag-reload. Inirerekomenda na gamitin ang NSFileProviderSyncAnchor para sa pagmamarka ng status ng pag-sync at pag-minimize ng mga duplicate na kahilingan.

Caching sa device

File Provider Extension ay maaaring mag-cache ng mga file nang lokal para sa offline na pag-access. Kapag nagbubukas ng file, ang system ay nagpapadala ng kahilingan sa extension, nagpapasya ang extension — i-download ang nilalaman mula sa server o ibalik ang naka-cache nang bersyon. Ang NSFileProviderItem ay nagpapahiwatig ng antas ng caching sa pamamagitan ng mga field na isDownloaded at isUploaded.

Inirerekomenda ng Apple na i-configure ang patakaran sa caching depende sa laki ng file: para sa mga larawan at dokumento — buong caching, para sa video — preview lamang, para sa mga archive — kapag hiniling ng user.

NSFileProviderManager: pamamahala ng tagapagbigay ng file

NSFileProviderManager ay ang sentral na klase kung saan nakikipag-ugnayan ang extension sa system. Nagbibigay ito ng mga pamamaraan para sa pag-notify sa system tungkol sa mga pagbabago, paglikha ng mga bagong elemento, pamamahala ng mga pag-download at paghawak ng mga error. Ang bawat instance ng NSFileProviderManager ay nakatali sa isang partikular na domain.

Mga pangunahing pamamaraan

signalEnumerator(for:) — nag-aabiso sa system na ang nilalaman ng isang folder ay nagbago at ang listahan ay kailangang basahin muli. reimportItem(_:) — muling nag-i-import ng tinukoy na elemento pagkatapos ng pagbabago sa server. registerURLSessionTask:forItemWithIdentifier: — nagbubuklod ng background download sa isang partikular na file para sa pagsubaybay ng progreso.

Mahalagang limitasyon: ang NSFileProviderManager ay gumagana lamang sa proseso ng extension. Ang pangunahing application ay hindi maaaring direktang tumawag sa mga pamamaraan nito para sa pamamahala ng istraktura ng file — ang pag-sync ay dapat na simulan ng extension o system.

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

Pamamahala ng pag-download

Para sa pag-download ng mga file sa background, gumagamit ang NSFileProviderManager ng URLSession na may background configuration. Gumagawa ang extension ng download task at nagrerehistro nito sa manager, na nagbubuklod nito sa kaukulang elemento. Awtomatikong sinusubaybayan ng system ang progreso at mga priyoridad ng pag-download batay sa aktibidad ng user.

Pagpapatupad ng File Provider Extension

Ang paggawa ng File Provider Extension ay nagsisimula sa pagdagdag ng bagong target sa Xcode gamit ang template ng File Provider Extension. Awtomatikong bubuo ang Xcode ng isang klase na nagmamana mula sa NSFileProviderExtension at isang minimal na set ng mga pamamaraan para sa pagtatrabaho sa mga elemento.

NSFileProviderItem at metadata

Ang bawat elemento ng istraktura ng file — file o folder — ay nagpapatupad ng protokol na NSFileProviderItem. Tinutukoy ng protokol ang mga mandatoryong field: itemIdentifier, parentItemIdentifier, filename, typeIdentifier at capabilities. Opsyonal na maaaring tukuyin ang laki, petsa ng pagbabago at mga flag ng pag-download.

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

Pagproseso ng mga kahilingan sa enumerasyon

Ang pamamaraang enumerator(for:) ay nagbabalik ng isang bagay na nagpapatupad ng NSFileProviderEnumerator, na nagbibigay ng nilalaman ng folder kapag hiniling ng system. Maaaring humiling ang iOS ng enumerasyon para sa root folder, mga subfolder at working set — ang huli ay ginagamit para sa pagpapakita ng mga kamakailan o paboritong file.

Inirerekomenda ng Apple ang paggamit ng mga asynchronous na pamamaraan ng enumerasyon na may pagination sa pamamagitan ng NSFileProviderPage upang maiwasan ang pag-load ng libu-libong elemento nang sabay-sabay. Ang mga pahina ng 50–100 elemento ay optimal para sa pagganap.

Mga domain at multi-account na arkitektura

NSFileProviderDomain ay isang mekanismo para sa paghihiwalay ng iba't ibang account sa loob ng isang extension. Kung ang user ay nag-authorize ng maraming account sa application — personal at corporate Google Drive — bawat account ay lumilikha ng isang hiwalay na domain na ipinapakita bilang isang hiwalay na mapagkukunan sa application na Files.

Ang bawat domain ay may natatanging identifier, display name at status. Maaaring pansamantalang i-disable ng user ang mga domain o tanggalin ang mga ito nang hindi naaapektuhan ang ibang mga account. Ang system ay naglulunsad ng isang hiwalay na proseso ng extension para sa bawat aktibong domain, na tinitiyak ang paghihiwalay ng data sa pagitan ng mga account.

Ayon sa Apple, inirerekomenda na huwag lumikha ng higit sa 10 domain bawat extension — ang sobrang dami ay nagpapabagal sa pagsisimula ng application na Files at nagpapataas ng konsumo ng memorya. Para sa mga serbisyo na may maraming account, mas mainam na pagsamahin ang mga ito sa isang domain na may paglipat ng profile sa loob ng extension.

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