File Provider Extension: ano ito, extension ng pag-access sa file ng iOS

Ano ang File Provider Extension sa iOS?

File Provider Extension ay isang extension ng app sa iOS at macOS na nagpapahintulot sa app na magbigay ng access sa mga file mula sa panlabas na mga mapagkukunan sa pamamagitan ng system app na Files. Lumitaw ito sa iOS 11 at pinalitan ang mekanismo ng Document Provider, nagdagdag ng suporta para sa pag-sync, paghahanap, at mga tag.

Ang pangunahing gawain ng File Provider Extension ay kumilos bilang tulay sa pagitan ng panlabas na imbakan (cloud server, corporate NAS, FTP) at Files.app. Nakikita ng user ang mga file at folder na parang naka-imbak nang lokal, bagaman ang data ay maaaring nasa isang malayuang server. Ang extension ay gumagana sa background, nagsi-sync ng nilalaman kung kinakailangan.

Ayon sa WWDC 2024, aktibong binuo ng Apple ang FileProvider API: idinagdag ang suporta para sa incremental na pag-sync, pinabuting pagganap para sa malalaking direktoryo, at kakayahang gumawa ng mga group operation. Ginagawa nitong ang File Provider Extension ang ginustong paraan ng pagsasama ng mga panlabas na file sa ecosystem ng Apple.

Paano gumagana ang File Provider Extension

Arkitektura ng File Provider Extension ay binubuo ng dalawang bahagi: ang pangunahing extension (uri ng file provider) at opsiyonal na UI extension para sa pagpapatotoo at configuration. Ang pangunahing extension ay nagpapatupad ng NSFileProviderExtension protocol at pinoproseso ang lahat ng kahilingan mula sa Files.app.

import FileProvider

class CloudFileProvider: NSFileProviderExtension {
    override func item(for identifier: NSFileProviderItemIdentifier) throws -> NSFileProviderItem {
        guard let item = storage
            .item(for: identifier) else {
            throw NSError(domain: NSFileProviderErrorDomain,
                              code: NSFileProviderError.noSuchItem.rawValue)
        }
        return item
    }

    override func urlForItem(with identifier: NSFileProviderItemIdentifier) -> URL {
        return fileCoordinator.urlForItem(with: identifier)
    }
}

Kapag binuksan ng user ang Files.app at pinili ang iyong provider, sisimulan ng system ang extension sa isang background process. Ang extension ay walang user interface — ito ay isang headless process na nagpoproseso ng mga kahilingan para sa pagbasa, pagsulat, pagpapalit ng pangalan, at pagtanggal ng mga file. Lahat ng operasyon ay isinasagawa nang asynchronous sa pamamagitan ng NSFileProviderManager.

Mahalagang tala: Ang File Provider Extension ay nabubuhay sa isang hiwalay na proseso at maaaring tapusin ng system kapag kulang ang memorya. Kaya naman, ang provider ay dapat na makapag-restore ng estado pagkatapos ng restart, na nag-iimbak ng mga identifier at sync cache sa persistent storage.

Modelo ng NSFileProviderItem: mga file at folder

NSFileProviderItem ay isang protocol na naglalarawan ng isang indibidwal na file o folder sa hierarchy ng provider. Bawat elemento ay may natatanging identifier, pangalan, uri (file o folder), mga petsa ng paggawa at pagbabago, laki, at mga flag (available offline, read-only).

Sinusuportahan din ng protocol ang mga advanced na kakayahan sa pamamagitan ng NSFileProviderItemProtocol: mga tag (may kulay na marka), mga icon, versioning, at custom na aksyon. Para sa malalaking file, ipinapatupad ang suporta para sa resumable transfers sa pamamagitan ng NSFileProviderService.

Ayon sa WWDC 2023, inirerekomenda ng Apple ang paggamit ng mga closure (NSFileProviderItemFields) para i-update lamang ang mga nabagong property, hindi ang buong object. Ito ay makabuluhang nagpapabilis ng pag-sync sa mga batch update — halimbawa, kapag nagbago lamang ang laki ng isang grupo ng mga file.

Engine ng pag-sync at NSFileProviderManager

NSFileProviderManager — sentral na klase para sa pamamahala ng lifecycle ng extension. Nagbibigay ito ng mga pamamaraan para sa pagsenyas ng mga pagbabago sa system, paghawak ng mga collaborative conflict, at pamamahala ng mga download. Awtomatikong sinusubaybayan ng manager ang mga aktibong transfer at pinaprioridad ang mga file na nakikita ng user.

class SyncManager {
    let providerManager = NSFileProviderManager.default

    func signalUpdate(for item: NSFileProviderItemIdentifier) {
        providerManager.signalEnumerator(
            for: item.parentItemIdentifier
        ) { error in
            if let error = error {
                Logger.sync.error(
                    "Failed to signal: \(error.localizedDescription)"
                )
            }
        }
    }

    func uploadItem(at url: URL, itemId: NSFileProviderItemIdentifier) {
        providerManager.registerURLBasedItem(
            with: itemId,
            url: url
        )
    }
}

Engine ng pag-sync — ito ang lohika na independiyenteng ipinapatupad ng developer. Hindi nagbibigay ang Apple ng built-in na mekanismo ng pag-sync — tanging API para sa pag-notify sa system tungkol sa mga pagbabago. Ang provider mismo ang nagpapasya kung paano mag-download ng mga file mula sa server, i-cache ang mga ito nang lokal, at lutasin ang mga conflict sa pag-edit.

Mga conflict: sinusuportahan ng system ang pagtuklas ng mga version conflict sa pamamagitan ng NSFileProviderSyncAnchor. Kapag ang isang file ay binago nang sabay-sabay nang lokal at malayuan, ginagamit ng provider ang sync anchor upang matukoy ang huling na-sync na bersyon at lutasin ang conflict sa pamamagitan ng estratehiyang “ang huling sumulat ang panalo” o sa pamamagitan ng paggawa ng conflict copy.

Seguridad at sandbox ng extension

File Provider Extension ay gumagana sa loob ng mahigpit na sandbox ng iOS. Ang extension ay walang direktang access sa file system ng host app at vice versa — hindi direktang mababasa ng app ang mga file ng provider. Lahat ng palitan ng data ay dumadaan sa system APIs ng Files.app.

Ang access sa mga file ng user ay posible lamang sa pamamagitan ng malinaw na interaksyon: binuksan ng user ang isang file mula sa Files.app sa isang app, at ang system ay gumagawa ng pansamantalang kopya ng file sa isang nakahiwalay na container. Ang receiving app ay gumagana sa kopyang ito, hindi sa orihinal sa imbakan ng provider.

Ayon sa Apple Security Guide, 2024, ang provider ay kinakailangang magpatupad ng encryption ng data sa panahon ng transmisyon (TLS 1.3) at maaaring opsyonal na magdagdag ng disk encryption para sa mga naka-cache na file. Ang pagpapatotoo ng user ay ginagawa sa pamamagitan ng isang hiwalay na UI component na FileProviderUI, na inilulunsad sa labas ng sandbox ng extension para sa ligtas na pagpasok ng mga kredensyal.

Pangunahing limitasyon: ang extension ay hindi maaaring magpatakbo ng arbitrary code — pinoproseso lamang nito ang mga kahilingan sa pamamagitan ng NSFileProviderManager. Anumang lohika na lampas sa mga file operation ay dapat ipatupad sa pangunahing app at tawagin sa pamamagitan ng app groups o XPC services.