File Provider Extension: nó là gì và cách hoạt động của nhà cung cấp tệp iOS

File Provider Extension trong iOS là gì

File Provider Extension là một tiện ích mở rộng ứng dụng thêm các nguồn tài liệu mới vào ứng dụng Files. Một dịch vụ đám mây — Google Drive, Dropbox, OneDrive hoặc kho lưu trữ doanh nghiệp — có thể hiển thị cấu trúc tệp của mình trực tiếp trong giao diện hệ thống mà không cần mở ứng dụng riêng.

Người dùng làm việc với các tệp từ xa giống hệt như với các tệp được lưu trên thiết bị: duyệt nội dung thư mục, kéo và thả tài liệu, mở chúng trong bất kỳ ứng dụng tương thích nào và lưu các thay đổi trở lại đám mây. Theo WWDC 2025, File Provider Extension hỗ trợ tới 1000 thao tác đồng bộ đồng thời và thích ứng với tốc độ mạng thông qua quản lý ưu tiên động.

Tiện ích mở rộng chạy trong nền — iOS khởi chạy nó khi cần đồng bộ hóa và có thể buộc kết thúc khi tài nguyên thấp. Tất cả các thao tác phải có tính chất lũy đẳng và hỗ trợ tiếp tục từ điểm kiểm tra.

Kiến trúc và cơ chế đồng bộ hóa tệp

File Provider Extension có kiến trúc ba tầng: tiến trình hệ thống Files.app, tiện ích mở rộng nhà cung cấp và máy chủ từ xa. Hệ thống yêu cầu dữ liệu từ tiện ích mở rộng, tiện ích mở rộng chuyển đổi yêu cầu thành lệnh gọi API của dịch vụ đám mây và trả về kết quả qua NSFileProviderItem.

Đồng bộ hóa gia tăng

Thay vì tải toàn bộ cấu trúc tệp mỗi khi cập nhật, tiện ích mở rộng chỉ truyền các mục đã thay đổi. NSFileProviderManager cung cấp các phương thức để gửi bản cập nhật gia tăng — “tệp A đã được thêm”, “tệp B đã được sửa đổi”, “thư mục C đã bị xóa”. Điều này giảm đáng kể lưu lượng truy cập và tăng tốc hiển thị thay đổi.

Theo Apple Engineering, đồng bộ hóa gia tăng giảm khối lượng dữ liệu truyền đi 60–80% so với tải lại toàn bộ. Nên sử dụng NSFileProviderSyncAnchor để đánh dấu trạng thái đồng bộ và giảm thiểu các yêu cầu trùng lặp.

Bộ nhớ đệm trên thiết bị

File Provider Extension có thể lưu trữ tệp vào bộ nhớ đệm cục bộ để truy cập ngoại tuyến. Khi một tệp được mở, hệ thống gửi yêu cầu đến tiện ích mở rộng và tiện ích mở rộng quyết định tải nội dung từ máy chủ hay trả về phiên bản đã được lưu trong bộ nhớ đệm. NSFileProviderItem chỉ ra mức độ lưu trữ đệm thông qua các trường isDownloaded và isUploaded.

Apple khuyến nghị cấu hình chính sách bộ nhớ đệm dựa trên kích thước tệp: đối với hình ảnh và tài liệu — lưu trữ đệm toàn bộ, đối với video — chỉ xem trước, đối với tệp lưu trữ — theo yêu cầu của người dùng.

NSFileProviderManager: quản lý nhà cung cấp tệp

NSFileProviderManager là lớp trung tâm mà qua đó tiện ích mở rộng tương tác với hệ thống. Nó cung cấp các phương thức để thông báo cho hệ thống về các thay đổi, tạo mục mới, quản lý tải xuống và xử lý lỗi. Mỗi phiên bản NSFileProviderManager được gắn với một miền cụ thể.

Các phương thức chính

signalEnumerator(for:) — thông báo cho hệ thống rằng nội dung thư mục đã thay đổi và cần được đọc lại. reimportItem(_:) — nhập lại mục đã chỉ định sau khi thay đổi ở phía máy chủ. registerURLSessionTask:forItemWithIdentifier: — liên kết tải xuống nền với một tệp cụ thể để theo dõi tiến trình.

Hạn chế quan trọng: NSFileProviderManager chỉ hoạt động trong tiến trình của tiện ích mở rộng. Ứng dụng chính không thể gọi trực tiếp các phương thức của nó để quản lý cấu trúc tệp — đồng bộ hóa phải được khởi tạo bởi tiện ích mở rộng hoặc hệ thống.

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

Quản lý tải xuống

Để tải tệp xuống trong nền, NSFileProviderManager sử dụng URLSession với cấu hình nền. Tiện ích mở rộng tạo một tác vụ tải xuống và đăng ký nó với trình quản lý, trình quản lý liên kết nó với mục tương ứng. Hệ thống tự động theo dõi tiến trình và mức độ ưu tiên tải xuống dựa trên hoạt động của người dùng.

Triển khai File Provider Extension

Việc tạo File Provider Extension bắt đầu bằng cách thêm một target mới trong Xcode với mẫu File Provider Extension. Xcode tự động tạo một lớp kế thừa từ NSFileProviderExtension và một bộ phương thức tối thiểu để làm việc với các mục.

NSFileProviderItem và siêu dữ liệu

Mỗi mục trong cấu trúc tệp — một tệp hoặc thư mục — triển khai giao thức NSFileProviderItem. Giao thức xác định các trường bắt buộc: itemIdentifier, parentItemIdentifier, filename, typeIdentifier và capabilities. Ngoài ra, bạn có thể chỉ định kích thước, ngày sửa đổi và cờ tải xuống.

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

Xử lý yêu cầu liệt kê

Phương thức enumerator(for:) trả về một đối tượng triển khai NSFileProviderEnumerator, cung cấp nội dung thư mục theo yêu cầu của hệ thống. iOS có thể yêu cầu liệt kê cho thư mục gốc, thư mục con và một tập hợp làm việc — tập hợp sau được sử dụng để hiển thị các tệp gần đây hoặc yêu thích.

Apple khuyến nghị sử dụng các phương thức liệt kê bất đồng bộ với phân trang qua NSFileProviderPage để tránh tải hàng nghìn mục cùng một lúc. Các trang có 50–100 mục là tối ưu cho hiệu suất.

Miền và kiến trúc đa tài khoản

NSFileProviderDomain là cơ chế tách biệt các tài khoản khác nhau trong cùng một tiện ích mở rộng. Nếu người dùng đã ủy quyền nhiều tài khoản trong một ứng dụng — Google Drive cá nhân và doanh nghiệp — mỗi tài khoản tạo một miền riêng biệt, xuất hiện như một nguồn riêng trong ứng dụng Files.

Mỗi miền có một định danh duy nhất, tên hiển thị và trạng thái. Người dùng có thể tạm thời vô hiệu hóa miền hoặc xóa chúng mà không ảnh hưởng đến các tài khoản khác. Hệ thống khởi chạy một tiến trình tiện ích mở rộng riêng cho mỗi miền đang hoạt động, đảm bảo cách ly dữ liệu giữa các tài khoản.

Theo Apple, khuyến nghị không tạo quá 10 miền cho mỗi tiện ích mở rộng — số lượng quá nhiều làm chậm khởi động ứng dụng Files và tăng mức tiêu thụ bộ nhớ. Đối với các dịch vụ có số lượng lớn tài khoản, nên tổng hợp chúng vào một miền duy nhất với khả năng chuyển đổi hồ sơ trong tiện ích mở rộng.

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