File Provider Extension: bu nədir, iOS fayllarına giriş genişlənməsi

iOS-da File Provider Extension nədir?

File Provider Extension iOS və macOS-da proqram genişlənməsidir ki, proqrama xarici mənbələrdən fayllara sistem Fayllar proqramı vasitəsilə giriş təmin etməyə imkan verir. O, iOS 11-də ortaya çıxdı və Document Provider mexanizmini əvəz edərək sinxronizasiya, axtarış və etiketlər üçün dəstək əlavə etdi.

File Provider Extension-in əsas vəzifəsi xarici anbar (bulud serveri, korporativ NAS, FTP) ilə Files.app arasında körpü rolunu oynamaqdır. İstifadəçi faylları və qovluqları sanki lokal olaraq saxlanılmış kimi görür, halbuki məlumatlar uzaq serverdə yerləşə bilər. Genişlənmə fon rejimində işləyir, məzmunu lazım olduqca sinxronlaşdırır.

WWDC 2024-ə əsasən, Apple FileProvider API-ni fəal şəkildə inkişaf etdirir: artımlı sinxronizasiya dəstəyi, böyük qovluqlar üçün təkmilləşdirilmiş performans və qrup əməliyyatları imkanı əlavə edilib. Bu, File Provider Extension-i Apple ekosistemində xarici faylları inteqrasiya etmək üçün üstünlük verilən üsula çevirir.

File Provider Extension necə işləyir

Arxitektura: File Provider Extension iki komponentdən ibarətdir: əsas genişlənmə (fayl təchizatçısı növü) və autentifikasiya və konfiqurasiya üçün isteğe bağlı UI genişlənməsi. Əsas genişlənmə NSFileProviderExtension protokolunu tətbiq edir və Files.app-dən gələn bütün sorğuları emal edir.

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)
    }
}

İstifadəçi Files.app-i açıb sizin təchizatçınızı seçdikdə, sistem genişlənməni fon prosesində işə salır. Genişlənmənin UI-i yoxdur — bu, faylların oxunması, yazılması, adının dəyişdirilməsi və silinməsi sorğularını emal edən headless prosesdir. Bütün əməliyyatlar NSFileProviderManager vasitəsilə asinxron şəkildə yerinə yetirilir.

Vacib qeyd: File Provider Extension ayrı bir prosesdə işləyir və yaddaş çatışmazlığı zamanı sistem tərəfindən dayandırıla bilər. Buna görə təchizatçı yenidən başlatmadan sonra vəziyyəti bərpa edə bilməli, identifikatorları və sinxronizasiya keşini daimi yaddaşda saxlamalıdır.

NSFileProviderItem modeli: fayllar və qovluqlar

NSFileProviderItem təchizatçı iyerarxiyasında ayrıca fayl və ya qovluğu təsvir edən protokoldur. Hər bir elementin unikal identifikatoru, adı, növü (fayl və ya qovluq), yaradılma və dəyişdirilmə tarixləri, ölçüsü və bayraqları (oflayn əlçatan, yalnız oxumaq üçün) var.

Protokol həmçinin NSFileProviderItemProtocol vasitəsilə genişləndirilmiş imkanları dəstəkləyir: etiketlər (rəngli işarələr), nişanlar, versiyalaşdırma və xüsusi hərəkətlər. Böyük fayllar üçün NSFileProviderService vasitəsilə davam etdirilə bilən transferlər (resumable transfers) dəstəklənir.

WWDC 2023-ə əsasən, Apple bütün obyekti deyil, yalnız dəyişmiş xüsusiyyətləri yeniləmək üçün bağlanmalardan (NSFileProviderItemFields) istifadə etməyi tövsiyə edir. Bu, toplu yeniləmələrdə sinxronizasiyanı əhəmiyyətli dərəcədə sürətləndirir — məsələn, yalnız fayl qrupunun ölçüsü dəyişdikdə.

Sinxronizasiya mühərriki və NSFileProviderManager

NSFileProviderManager — genişlənmənin həyat dövrünü idarə etmək üçün mərkəzi sinifdir. O, sistemə dəyişikliklər barədə siqnal vermək, əməkdaşlıq konfliktlərini emal etmək və yükləmələri idarə etmək üçün metodlar təqdim edir. Menecer aktiv transferləri avtomatik izləyir və istifadəçiyə görünən fayllara üstünlük verir.

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
        )
    }
}

Sinxronizasiya mühərriki — bu, tərtibatçının özünün həyata keçirdiyi məntiqdir. Apple daxili sinxronizasiya mexanizmi təqdim etmir — yalnız dəyişikliklər barədə sistemə məlumat vermək üçün API təqdim edir. Təchizatçı serverdən faylları necə yükləyəcəyinə, onları lokal olaraq keşləyəcəyinə və redaktə konfliktlərini həll edəcəyinə özü qərar verir.

Konfliktlər: sistem NSFileProviderSyncAnchor vasitəsilə versiya konfliktlərinin aşkarlanmasını dəstəkləyir. Fayl eyni anda həm lokal, həm də uzaqda dəyişdirildikdə, təchizatı sinxronizasiya ankerindən son sinxronlaşdırılmış versiyanı müəyyən etmək və konflikti „son yazan qazanır" strategiyası ilə və ya konflikt nüsxəsi yaratmaqla həll etmək üçün istifadə edir.

Təhlükəsizlik və genişlənmə sandboxu

File Provider Extension iOS-un ciddi sandbox (karantin) mühitində işləyir. Genişlənmənin host-proqramın fayl sisteminə birbaşa girişi yoxdur və əksinə — proqram təchizatçının fayllarını birbaşa oxuya bilməz. Bütün məlumat mübadiləsi Files.app-in sistem API-ləri vasitəsilə aparılır.

İstifadəçi fayllarına giriş yalnız açıq qarşılıqlı əlaqə ilə mümkündür: istifadəçi Files.app-dən bir proqramda fayl açır və sistem təcrid olunmuş konteynerdə faylın müvəqqəti nüsxəsini yaradır. Qəbul edən proqram bu nüsxə ilə işləyir, təchizatçı anbarındakı orijinal ilə deyil.

Apple Security Guide, 2024-ə əsasən, təchizatçı məlumat ötürülməsi zamanı şifrələməni (TLS 1.3) tətbiq etməlidir və keşlənmiş fayllar üçün diskdə şifrələmə əlavə edə bilər. İstifadəçi autentifikasiyası FileProviderUI-nin ayrıca UI komponenti vasitəsilə həyata keçirilir ki, bu da etimad məlumatlarının təhlükəsiz daxil edilməsi üçün genişlənmə sandboxından kənarda işə salınır.

Əsas məhdudiyyət: genişlənmə ixtiyari kod işlədə bilməz — o, yalnız NSFileProviderManager vasitəsilə sorğuları emal edir. Fayl əməliyyatları çərçivəsindən kənara çıxan hər hansı məntiq əsas proqramda tətbiq edilməli və app groups və ya XPC services vasitəsilə çağırılmalıdır.