File Provider Extension: nó là gì, phần mở rộng truy 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 trong iOS và macOS cho phép một ứng dụng cung cấp quyền truy cập vào các tệp từ nguồn bên ngoài thông qua ứng dụng Tệp của hệ thống. Nó được giới thiệu trong iOS 11 và thay thế cơ chế Document Provider, bổ sung hỗ trợ đồng bộ hóa, tìm kiếm và thẻ.

Nhiệm vụ chính của File Provider Extension là đóng vai trò cầu nối giữa bộ nhớ ngoài (máy chủ đám mây, NAS doanh nghiệp, FTP) và Files.app. Người dùng nhìn thấy các tệp và thư mục như thể chúng được lưu trữ cục bộ, mặc dù dữ liệu có thể nằm trên máy chủ từ xa. Tiện ích mở rộng hoạt động ở chế độ nền, đồng bộ hóa nội dung khi cần thiết.

Theo WWDC 2024, Apple đang tích cực phát triển FileProvider API: đã bổ sung hỗ trợ đồng bộ hóa tăng dần, cải thiện hiệu suất cho các thư mục lớn và các thao tác hàng loạt hiện đã khả dụng. Điều này làm cho File Provider Extension trở thành cách ưu tiên để tích hợp các tệp bên ngoài vào hệ sinh thái Apple.

Cách File Provider Extension hoạt động

Kiến trúc của File Provider Extension bao gồm hai thành phần: tiện ích mở rộng chính (loại nhà cung cấp tệp) và tiện ích mở rộng giao diện người dùng tùy chọn cho xác thực và cấu hình. Tiện ích mở rộng chính triển khai giao thức NSFileProviderExtension và xử lý tất cả các yêu cầu từ 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)
    }
}

Khi người dùng mở Files.app và chọn nhà cung cấp của bạn, hệ thống sẽ khởi chạy tiện ích mở rộng trong một tiến trình nền. Tiện ích mở rộng không có giao diện người dùng — đó là một tiến trình không đầu xử lý các yêu cầu đọc, ghi, đổi tên và xóa tệp. Tất cả các thao tác được thực hiện bất đồng bộ thông qua NSFileProviderManager.

Sắc thái quan trọng: File Provider Extension sống trong một tiến trình riêng biệt và có thể bị hệ thống kết thúc khi bộ nhớ thấp. Do đó, nhà cung cấp phải có khả năng khôi phục trạng thái sau khi khởi động lại bằng cách lưu các định danh và bộ nhớ đệm đồng bộ vào bộ nhớ liên tục.

Mô hình NSFileProviderItem: tệp và thư mục

NSFileProviderItem là một giao thức mô tả một tệp hoặc thư mục riêng lẻ trong hệ phân cấp nhà cung cấp. Mỗi mục có một định danh duy nhất, tên, loại (tệp hoặc thư mục), ngày tạo và sửa đổi, kích thước và các cờ (khả dụng ngoại tuyến, chỉ đọc).

Giao thức cũng hỗ trợ các khả năng mở rộng thông qua NSFileProviderItemProtocol: thẻ (nhãn màu), biểu tượng, quản lý phiên bản và các hành động tùy chỉnh. Đối với các tệp lớn, hỗ trợ truyền tiếp tục được triển khai thông qua NSFileProviderService.

Theo WWDC 2023, Apple khuyến nghị sử dụng bao đóng (NSFileProviderItemFields) để chỉ cập nhật các thuộc tính đã thay đổi thay vì toàn bộ đối tượng. Điều này tăng tốc đáng kể việc đồng bộ hóa trong các bản cập nhật hàng loạt — ví dụ, khi chỉ có kích thước của một nhóm tệp thay đổi.

Cơ chế đồng bộ và NSFileProviderManager

NSFileProviderManager là lớp trung tâm để quản lý vòng đời của tiện ích mở rộng. Nó cung cấp các phương thức để thông báo cho hệ thống về các thay đổi, xử lý xung đột cộng tác và quản lý tải xuống. Trình quản lý tự động theo dõi các truyền đang hoạt động và ưu tiên các tệp hiển thị cho người dùng.

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

Cơ chế đồng bộ là logic mà nhà phát triển triển khai một cách độc lập. Apple không cung cấp cơ chế đồng bộ tích hợp sẵn — chỉ có API để thông báo cho hệ thống về các thay đổi. Nhà cung cấp tự quyết định cách tải tệp từ máy chủ, lưu vùng đệm cục bộ và giải quyết xung đột chỉnh sửa.

Xung đột: hệ thống hỗ trợ phát hiện xung đột phiên bản thông qua NSFileProviderSyncAnchor. Khi một tệp được thay đổi đồng thời ở cục bộ và từ xa, nhà cung cấp sử dụng mốc đồng bộ để xác định phiên bản được đồng bộ hóa gần đây nhất và giải quyết xung đột bằng chiến lược người ghi cuối cùng thắng hoặc tạo bản sao xung đột.

Bảo mật và hộp cát của tiện ích mở rộng

File Provider Extension hoạt động trong một hộp cát nghiêm ngặt của iOS. Tiện ích mở rộng không có quyền truy cập trực tiếp vào hệ thống tệp của ứng dụng chủ và ngược lại, ứng dụng không thể đọc trực tiếp các tệp của nhà cung cấp. Tất cả trao đổi dữ liệu đều thông qua API hệ thống của Files.app.

Quyền truy cập vào các tệp của người dùng chỉ có thể thông qua tương tác rõ ràng: người dùng mở một tệp từ Files.app trong một ứng dụng và hệ thống tạo một bản sao tạm thời của tệp trong một vùng chứa cách ly. Ứng dụng nhận làm việc với bản sao này, không phải bản gốc trong bộ nhớ của nhà cung cấp.

Theo Apple Security Guide, 2024, nhà cung cấp phải triển khai mã hóa dữ liệu trong quá trình truyền (TLS 1.3) và có thể tùy chọn thêm mã hóa đĩa cho các tệp được lưu trong bộ nhớ đệm. Xác thực người dùng được thực hiện thông qua một thành phần FileProviderUI riêng biệt, chạy bên ngoài hộp cát của tiện ích mở rộng để nhập thông tin xác thực an toàn.

Hạn chế chính: tiện ích mở rộng không thể chạy mã tùy ý — nó chỉ xử lý các yêu cầu thông qua NSFileProviderManager. Bất kỳ logic nào ngoài các thao tác tệp phải được triển khai trong ứng dụng chính và được gọi thông qua nhóm ứng dụng hoặc dịch vụ XPC.