File Provider Extension: apa itu dan cara kerja penyedia file iOS

Apa itu File Provider Extension di iOS

File Provider Extension adalah ekstensi aplikasi yang menambahkan sumber dokumen baru ke aplikasi File. Layanan cloud — Google Drive, Dropbox, OneDrive atau penyimpanan perusahaan — dapat menampilkan struktur file mereka langsung di antarmuka sistem, tanpa membuka aplikasi terpisah.

Pengguna bekerja dengan file jarak jauh persis seperti dengan file yang disimpan di perangkat: melihat isi folder, menyeret dokumen, membukanya di aplikasi kompatibel mana pun dan menyimpan perubahan kembali ke cloud. Menurut WWDC 2025, File Provider Extension mendukung hingga 1000 operasi sinkronisasi simultan dan beradaptasi dengan kecepatan jaringan melalui manajemen prioritas dinamis.

Ekstensi bekerja di latar belakang — iOS menjalankannya saat sinkronisasi diperlukan dan dapat mengakhirinya secara paksa saat sumber daya tidak mencukupi. Semua operasi harus idempoten dan mendukung kelanjutan dari titik pemeriksaan.

Arsitektur dan mekanisme sinkronisasi file

File Provider Extension memiliki arsitektur tiga tingkat: proses sistem Files.app, ekstensi-penyedia dan server jarak jauh. Sistem meminta data dari ekstensi, ekstensi mengubah permintaan menjadi panggilan API layanan cloud dan mengembalikan hasil melalui NSFileProviderItem.

Sinkronisasi inkremental

Alih-alih memuat seluruh struktur file setiap kali diperbarui, ekstensi hanya mengirimkan elemen yang diubah. NSFileProviderManager menyediakan metode untuk mengirim pembaruan inkremental — “file A ditambahkan”, “file B diubah”, “folder C dihapus”. Ini secara drastis mengurangi lalu lintas dan mempercepat tampilan perubahan.

Menurut Apple Engineering, sinkronisasi inkremental mengurangi volume data yang dikirim sebesar 60–80% dibandingkan dengan pemuatan ulang penuh. Disarankan untuk menggunakan NSFileProviderSyncAnchor untuk menandai status sinkronisasi dan meminimalkan permintaan duplikat.

Caching di perangkat

File Provider Extension dapat menyimpan file secara lokal dalam cache untuk akses offline. Saat membuka file, sistem mengirimkan permintaan ke ekstensi, ekstensi memutuskan — mengunduh konten dari server atau mengembalikan versi yang sudah di-cache. NSFileProviderItem menunjukkan tingkat caching melalui bidang isDownloaded dan isUploaded.

Apple merekomendasikan untuk mengonfigurasi kebijakan caching tergantung pada ukuran file: untuk gambar dan dokumen — caching penuh, untuk video — hanya pratinjau, untuk arsip — atas permintaan pengguna.

NSFileProviderManager: mengelola penyedia file

NSFileProviderManager adalah kelas pusat yang digunakan ekstensi untuk berkomunikasi dengan sistem. Ini menyediakan metode untuk memberi tahu sistem tentang perubahan, membuat elemen baru, mengelola unduhan dan menangani kesalahan. Setiap instance NSFileProviderManager terikat pada domain tertentu.

Metode utama

signalEnumerator(for:) — memberi tahu sistem bahwa isi folder telah berubah dan daftar perlu dibaca ulang. reimportItem(_:) — mengimpor ulang elemen yang ditentukan setelah perubahan di server. registerURLSessionTask:forItemWithIdentifier: — mengikat unduhan latar belakang ke file tertentu untuk melacak kemajuan.

Batasan penting: NSFileProviderManager hanya bekerja di dalam proses ekstensi. Aplikasi utama tidak dapat langsung memanggil metodenya untuk mengelola struktur file — sinkronisasi harus dimulai oleh ekstensi atau sistem.

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

Manajemen unduhan

Untuk mengunduh file di latar belakang, NSFileProviderManager menggunakan URLSession dengan konfigurasi latar belakang. Ekstensi membuat tugas unduhan dan mendaftarkannya di manajer, yang mengikatnya ke elemen yang sesuai. Sistem secara otomatis melacak kemajuan dan prioritas unduhan berdasarkan aktivitas pengguna.

Implementasi File Provider Extension

Membuat File Provider Extension dimulai dengan menambahkan target baru di Xcode dengan templat File Provider Extension. Xcode secara otomatis menghasilkan kelas yang mewarisi NSFileProviderExtension dan serangkaian metode minimal untuk bekerja dengan elemen.

NSFileProviderItem dan metadata

Setiap elemen struktur file — file atau folder — mengimplementasikan protokol NSFileProviderItem. Protokol mendefinisikan bidang wajib: itemIdentifier, parentItemIdentifier, filename, typeIdentifier dan capabilities. Secara opsional dapat ditentukan ukuran, tanggal perubahan dan bendera unduhan.

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

Penanganan permintaan enumerasi

Metode enumerator(for:) mengembalikan objek yang mengimplementasikan NSFileProviderEnumerator, yang menyediakan isi folder atas permintaan sistem. iOS dapat meminta enumerasi untuk folder root, subfolder dan set kerja — yang terakhir digunakan untuk menampilkan file terbaru atau favorit.

Apple merekomendasikan penggunaan metode enumerasi asinkron dengan penomoran halaman melalui NSFileProviderPage untuk menghindari memuat ribuan elemen sekaligus. Halaman 50–100 elemen optimal untuk kinerja.

Domain dan arsitektur multi-akun

NSFileProviderDomain adalah mekanisme untuk memisahkan akun yang berbeda dalam satu ekstensi. Jika pengguna telah mengotorisasi beberapa akun di aplikasi — pribadi dan perusahaan Google Drive — setiap akun membuat domain terpisah yang ditampilkan sebagai sumber terpisah di aplikasi File.

Setiap domain memiliki pengidentifikasi unik, nama tampilan dan status. Pengguna dapat menonaktifkan sementara domain atau menghapusnya tanpa memengaruhi akun lain. Sistem menjalankan proses ekstensi terpisah untuk setiap domain aktif, memastikan isolasi data antar akun.

Menurut Apple, disarankan untuk tidak membuat lebih dari 10 domain per ekstensi — jumlah berlebihan memperlambat startup aplikasi File dan meningkatkan konsumsi memori. Untuk layanan dengan banyak akun, lebih baik menggabungkannya ke dalam satu domain dengan peralihan profil di dalam ekstensi.

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